Quick Installation Guide

• For the following supported coprocessors

  • Raspberry Pi 3,4,5

  • Orange Pi 5, 5B, 5 Pro

  • Limelight 2, 2+, 3, 3G, 4

  • Rubik Pi 3

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

Note

In order to mount the Limelight 4 on your computer, it’s necessary to use rpiboot. To do this, follow the instructions here.

Limelights have a different installation processes. Simply connect the limelight to your computer using the proper usb cable. Select the compute module in the Raspberry Pi Imager. If it doesn’t show up after 30s try using another USB port, initialization may take a while. If prompted, install the recommended missing drivers. Select the image, and flash.

Note

Limelight 2, 2+, and 3 will need a custom hardware config file for lighting 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.