Skip to content

Doc: Add a warning about versions 2.0.2 and later of the Raspberry Pi Imager not working properly#2340

Merged
Gold856 merged 1 commit intoPhotonVision:mainfrom
DoF-6413:pi-imager-warning
Jan 29, 2026
Merged

Doc: Add a warning about versions 2.0.2 and later of the Raspberry Pi Imager not working properly#2340
Gold856 merged 1 commit intoPhotonVision:mainfrom
DoF-6413:pi-imager-warning

Conversation

@INeedCaffeine
Copy link
Contributor

Description

FRC Team 6413 ran into problems trying to write the 2026.1.1 image using the Raspberry Pi Imager tool. After some investigation we discovered a bug was introduced in v2.0.2 of the imager tool which prevents it from writing the PhotonVision images to any SD card on any Windows 10 or Windows 11 computer.

Attempting to write a custom image (.img and .img.xz) results in the following error dialog appearing as soon as the write action is confirmed:

photonvisionBurnFailure202

Versions 2.0.0 and earlier will successfully write the image files to the selected SD card.

Meta

Merge checklist:

  • Pull Request title is short, imperative summary of proposed changes
  • The description documents the what and why, including events that led to this PR
  • If this PR changes behavior or adds a feature, user documentation is updated
  • If this PR touches photon-serde, all messages have been regenerated and hashes have not changed unexpectedly
  • If this PR touches configuration, this is backwards compatible with all settings going back to the previous seasons's last release (seasons end after champs ends)
  • If this PR touches pipeline settings or anything related to data exchange, the frontend typing is updated
  • If this PR addresses a bug, a regression test for it is added

Added warning about versions 2.0.2 and later of the Raspberry Pi Imager not working properly.
@INeedCaffeine INeedCaffeine requested a review from a team as a code owner January 28, 2026 22:22
@github-actions github-actions bot added the documentation Anything relating to https://docs.photonvision.org label Jan 28, 2026
Copy link
Member

@Gold856 Gold856 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We'll just update this later if they fix it

@Gold856 Gold856 enabled auto-merge (squash) January 28, 2026 22:38
@Gold856 Gold856 disabled auto-merge January 29, 2026 00:45
@Gold856 Gold856 merged commit da88867 into PhotonVision:main Jan 29, 2026
40 of 42 checks passed
@thatcomputerguy0101
Copy link
Contributor

This does not seem to be a problem on macOS, since I have been successfully writing PV images with RPi Imager v2.0.3.

@roberttuttle
Copy link

roberttuttle commented Jan 29, 2026

FWIIW ... 2881 is a Windows-only crew across our team software tools and we have just used Rufus (portable) for years in place of etcher, rpi imager, or other solutions. Never have had one issue and it is super fast / dead simple just like the other tools. Pick your SD card drive, pick your .img file, and go. It has been maintained/loved over many years now.

You might want to consider updating the documentation to suggest fallback alternatives for specific platforms (win, mac, *nix) to the primary recommendation of RaspberryPi Imager when things aren't working out.

Rufus: https://rufus.ie/en/

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Anything relating to https://docs.photonvision.org

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants