Installing PhotonVision

Because we support several co-processors, there are many ways that you can install PhotonVision, based on the co-processor that you are using. For teams using a Raspberry Pi, we have created a Pi image that you can flash. For teams other co-processors such as Nvidia Jetson, we have an install shell script that you can run.

Raspberry Pi Installation

Because we anticipate that most teams will use a Raspberry Pi as their co-processor, we have created a Pi image that users can flash onto their Raspberry Pi that contains the latest version of PhotonVision along with the setup necessary to automatically start PhotonVision on startup.

Downloading the Pi Image

Download the latest release of the PhotonVision Pi image from the photon-pi-gen releases page to the location of your choice. You do not need to extract the downloaded ZIP file.

Flashing the Pi Image

It is recommended to use Balena Etcher to flash an image onto a Raspberry Pi. Simply select the downloaded .zip file, select your microSD card (we recommend an SD card with a capacity of 8 GB or higher), and flash. For more detailed instructions on using Etcher, please see the Etcher website.

Final Steps

Simply insert the flashed microSD card into your Raspberry Pi and boot it up. After the initial setup process, your Raspberry Pi should be configured for PhotonVision. You can verify this by making sure your Raspberry Pi and computer are connected to the same network and navigating to photonvision.local:5800 in your browser on your computer.

Troubleshooting

If photonvision.local:5800 does not resolve, your mDNS is not set up correctly. To fix this, download Angry IP Scanner to find PhotonVision/your coprocessor on your network. Once you find it, set the IP to your static IP in PhotonVision. If you continue to have issues, do not hesistate to contact us.

Other Debian-Based Co-Processor Installation

We provide an install script for other Debian-based systems (with apt) that will automatically install PhotonVision and make sure that it runs on startup.

$ wget https://git.io/JJrEP -O install.sh
$ sudo chmod +x install.sh
$ sudo ./install.sh
$ sudo reboot now

Note

Your co-processor will require an Internet connection for this process to work correctly.

Note

The install script has only been tested on Debian/Raspberry Pi OS Buster and Ubuntu Bionic. If any issues arise with your specific OS, please open an issue on our issues page.

For installation on any other co-processors, we recommend reading the advanced command line documentation.