Quick Installation Guide
For the following supported coprocessors
For installing on non-supported devices see here.
Download the latest preconfigured image of photonvision for your coprocessor
Coprocessor |
Image filename |
Jar |
|---|---|---|
Raspberry Pi 3, 4, 5 |
photonvision-{version}-linuxarm64_RaspberryPi.img.xz |
photonvision-{version}-linuxarm64.jar |
OrangePi 5 |
photonvision-{version}-linuxarm64_orangepi5.img.xz |
photonvision-{version}-linuxarm64.jar |
OrangePi 5B |
photonvision-{version}-linuxarm64_orangepi5b.img.xz |
photonvision-{version}-linuxarm64.jar |
OrangePi 5 Pro |
photonvision-{version}-linuxarm64_orangepi5pro.img.xz |
photonvision-{version}-linuxarm64.jar |
Limelight 2 |
photonvision-{version}-linuxarm64_limelight2.img.xz |
photonvision-{version}-linuxarm64.jar |
Limelight 3 |
photonvision-{version}-linuxarm64_limelight3.img.xz |
photonvision-{version}-linuxarm64.jar |
Limelight 3G |
photonvision-{version}-linuxarm64_limelight3G.img.xz |
photonvision-{version}-linuxarm64.jar |
Limelight 4 |
photonvision-{version}-linuxarm64_limelight4.img.xz |
photonvision-{version}-linuxarm64.jar |
Rubik Pi 3 |
photonvision-{version}-linuxarm64_rubikpi3.tar.xz |
photonvision-{version}-linuxarm64.jar |
Unless otherwise noted in release notes or if updating from the prior years version, to update PhotonVision after the initial installation, use the offline update option in the settings page with the downloaded jar file from the latest release.
Raspberry Pi and Orange Pi Installation
Use the Raspberry Pi Imager to flash the image onto the coprocessors microSD card. Select the downloaded .img.xz file, select your microSD card, and flash.
Warning
Balena Etcher can also be used, but historically has had issues such as bootlooping (the system will repeatedly boot and restart) when imaging your device. Use at your own risk.
Limelight Installation
In order to flash your Limelight you should follow the instructions on the Limelight documentation for the relevant version. Make sure to replace the Limelight OS image with the relevant PhotonVision image.
Limelight Version |
Limelight Documentation |
PhotonVision Image |
|
|---|---|---|---|
2 |
photonvision-{version}-linuxarm64_limelight2.img.xz |
||
3 |
photonvision-{version}-linuxarm64_limelight3.img.xz |
||
3G |
photonvision-{version}-linuxarm64_limelight3g.img.xz |
||
4 |
photonvision-{version}-linuxarm64_limelight4.img.xz |
Note
Limelight models will need a custom hardware config file for LEDs or other hardware features to work.
Rubik Pi 3 Installation
Warning
The Qualcomm Launcher caches files. If you flash multiple times, you may need to clear the cache by navigating to your temp directory, and deleting the qualcomm-launcher folder.
To flash the Rubik Pi 3 coprocessor, it’s necessary to use the Qualcomm Launcher. Upload a custom image by selecting the Custom option in the launcher. Choose the downloaded PhotonVision .tar.xz file and follow the prompts to complete the installation. It is recommended to skip the Configure Login process, as PhotonVision will handle the necessary settings.