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.
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.
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
Your co-processor will require an Internet connection for this process to work correctly.
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.