Latest Development Version

This release contains the latest version of Photon Vision based on the code on the master branch. This code is not as well-tested as the latest stable release! Use at your own risk.

v2024.3.1

First major release in way too long! Includes critical bug fixes for Orange Pi object detection crashing/showing no stream/heartbeat freezing, and a new base Orange Pi image. The new base image boots faster without networking and includes other improvements.

Important

Teams with Orange Pis will need to reflash using the v2024.3.1 image. Make sure to export your settings (and keep a backup somewhere safe) prior to doing this. If you've got a spare SD card, try to flash it instead so you've got a known-good hot-spare.

Important

The Orange Pi NetworkManager interface name changed to "netplan-zz-all-eth" -- make sure to have this selected in the dropdown

Note

Teams not using Orange Pi's probably don't need to update, and base images have not changed so a reflash is not required.

Major changes

• Run resize in CPU to avoid RGA-crash/lockup by @mcm001 in #1287
• Bump orange pi images to v1.33 by @mcm001 in #1276

Other changes

• Bump WPILib to 2024.3.2 by @mcm001 in #1283
• Opencv cal: CALIB_USE_LU and use camera focal length guess by @mcm001 in #1268
• Disable camera orientation option when camera is calibrated by @philltran in #1277
• Add proper exposure range for OV2311 by @gautvm in #1282
• Set default pipeline idx in PipelineManager constructor by @mcm001 in #1286
• Free native resources in apriltag pipelines by @mcm001 in #1272
• Release letterboxed frame in rknn pipe by @mcm001 in #1289
• Recreate user pipeline on type change by @mcm001 in #1290
• Fix wpiformat by @mcm001 in #1291

New Contributors

• @philltran made their first contribution in #1277

Full Changelog: v2024.2.9...v2024.3.1

v2024.3.0

First major release in way too long! Includes critical bug fixes for Orange Pi object detection crashing/showing no stream/heartbeat freezing, and a new base Orange Pi image. The new base image boots faster without networking and includes other improvements.

Important

Teams with Orange Pis will need to reflash using the v2024.3.0 image. Make sure to export your settings (and keep a backup somewhere safe) prior to doing this. If you've got a spare SD card, try to flash it instead so you've got a known-good hot-spare.

Important

The Orange Pi NetworkManager interface name changed to "netplan-zz-all-eth" -- make sure to have this selected in the dropdown

Note

Teams not using Orange Pi's probably don't need to update, and base images have not changed so a reflash is not required.

Known issues

• RKNN pipeline doesn't release the letterboxed frame
• On first boot, camera will not switch pipelines without toggling drivermode on and then off

Major changes

• Run resize in CPU to avoid RGA-crash/lockup by @mcm001 in #1287
• Bump orange pi images to v1.33 by @mcm001 in #1276

Other changes

• Bump WPILib to 2024.3.2 by @mcm001 in #1283
• Opencv cal: CALIB_USE_LU and use camera focal length guess by @mcm001 in #1268
• Disable camera orientation option when camera is calibrated by @philltran in #1277
• Add proper exposure range for OV2311 by @gautvm in #1282
• Set default pipeline idx in PipelineManager constructor by @mcm001 in #1286
• Free native resources in apriltag pipelines by @mcm001 in #1272

New Contributors

• @philltran made their first contribution in #1277

Full Changelog: v2024.2.9...v2024.3.0

v2024.2.9

Fixes mrcal calibration bug with non-square calibration targets, and implements a incrementally expanding optimization approach to match the behavior of mrcal-calibrate-cameras. We solve first for chessboard pose only, then board pose and pinhole coefficients, then board pose and full camera intrinsics with outlier rejection (but not board warp), and then finally everything.

What's Changed

• Create smoketest mode by @mcm001 in #1264
• Pipe cscore logs through photonvision by @mcm001 in #1260
• Bump mrcal to include solver fixes by @mcm001 in #1265

Full Changelog: v2024.2.8...v2024.2.9

v2024.2.8

Addresses a bug in 2024.2.7 that prevented configs for CSI cameras being saved.

What's Changed

• Fix CSI camera matching by @mcm001 in #1258

Full Changelog: v2024.2.7...v2024.2.8

v2024.2.7

Caution

These is a known bug with this release that causes CSI cameras (this includes limelight and raspberry pi cameras) to not be matched to saved configs. A patch is currently in the works.

v2024.2.7

This release contains camera matching updates and other misc changes. The major addition is of the Strictly match ONLY known cameras switch in the device control card, which will ONLY match cameras by the USB port they're plugged into + (basename or USB VID/PID), and never only by the device product string. This also disables automatic detection of new cameras.

Major Changes

• Fix multi-cam matching logic/settings loss bugs by @mcm001 in #1245 and #1238
• [photonlib] Invert simulated target yaw by @amquake in #1243
• Install sqlite3 in install script by @TheTripleV in #1247
• update wpilib to 2024.3.1 by @TheTripleV in #1246
• Bump orange pi image version to include sqlite3, v4l utils by @mcm001 in #1249

Full Changelog: v2024.2.6...v2024.2.7

v2024.2.6

Caution

Please see the known issues, updating to this version may cause setting loss! Use at your own risk.

Contains a pretty fundamental rewrite of camera matching logic to improve robustness. As such treat this release with a decent dose of paranoia and reach out with current run/journalctl logs if things are being weird.

We now match cameras in this priority order, with all cameras being matched by each strategy before trying the next:

• By physical usb port path and base name and USB VID/PID
• by physical usb port path and USB VID/PID
• By base name only (with a toggle switch in the networking card to disable this, and create a new VisionModule instead)

We also now give cscore the /dev/video/by-path camera path on Linux systems, pinning Photon USBCameras to a particular usb port once created instead of the video index (/dev/videoN).

Known issues

• Existing camera settings might not be properly matched on first boot, causing settings/calibrations to be lost in particular setups. Root cause here still under investigation

What's Changed

• Load libwinpthread-1.dll before libgcc_s_seh-1 by @mcm001 in #1228
• Actually properly match cameras by name fr this time by @mcm001 in #1237

Full Changelog: v2024.2.5...v2024.2.6

v2024.2.5

What's Changed

• Check empty mean errors in calibration card by @mcm001 in #1229 . This manifests as a weird empty calibration table with the wrong resolutions.
• fix latency calculation by @gerth2 in #1227
• Fix cpp and java photoncamera names in "Aim at Target" example by @DeltaDizzy in #1230
• Upload docs to VPS via SFTP by @mcm001 in #1235

Full Changelog: v2024.2.4...v2024.2.5

v2024.2.4

What's Changed

Includes a fix for Spinel OV9281s that report duplicate video modes/calibration happening at the wrong resolution. Please create issues/drop by Discord if you still have issues!

• Fix for Spinel camera video mode selection bug (Fixes #1219) by @crschardt in #1221
• fix chessboard gen by @gerth2 in #1217
• Store the last pose on update by @ArchdukeTim in #1207

New Contributors

• @ArchdukeTim made their first contribution in #1207

Full Changelog: v2024.2.3...v2024.2.4

v2024.2.3

More small bugfixes, including reduced bandwidth on initial connection and during calibration to address instability in bandwidth limited setups.

What's Changed

• Add v4l utils to installation script by @gautvm in #1201
• Dont send targets or cal images to UI by @mcm001 in #1200
• Add support for different RKNN YOLO models in the backend by @james20902 in #1205
• Python tweaks by @gerth2 in #1211
• Fix inverted condition in camera calibration table by @mcm001 in #1214
• Add NPU usage to metrics on supported platforms by @mcm001 in #1215

New Contributors

• @gautvm made their first contribution in #1201
• @james20902 made their first contribution in #1205

Full Changelog: v2024.2.2...v2024.2.3