Updating Firmware

You can easily update the BlueSCSI v2 firmware via a USB cable or through the SD card.

Get the latest firmware from the downloads page.

Which Firmware File to Use

For most users, choose the Universal firmware file. It supports all standard BlueSCSI features.

The Audio SPDIF files are only needed if you have a DAC connected for CD audio playback via SPDIF. Using Audio SPDIF firmware without a DAC is harmless but disables I2C support (used for OLED displays and Qwiic accessories).

Your Hardware	Firmware File
Any board, SD card update	`BlueSCSI_v*.zip`
V2 (Pico 1/1W or Pico 2/2W)	`BlueSCSI_V2_Universal_*.uf2`
V2 + DAC for SPDIF audio	`BlueSCSI_V2_Audio_SPDIF_*.uf2`
Ultra	`BlueSCSI_Ultra_*.uf2`
Ultra Wide	`BlueSCSI_Ultra_Wide_*.uf2`

Optionally the .bin can be extracted from the .zip and used on its own.

SD Card Method

Requires release v2025.07.07 and later.

Download the latest .zip from the downloads page and place it on the root of the SD Card.
Insert the SD card into your BlueSCSI. The next time your BlueSCSI boots up it will flash the latest release. Do not power off the device while it is updating!

📝 Note:

If you are having issues updating via the SD Card please use the USB method instead.

USB Method

Download the latest .uf2 from the downloads page.
To have a log file for the firmware update, insert a properly formatted SD card into the BlueSCSI.
Hold the button on the Pico module, or BOOT on the Ultra/Ultra Wide/SCA while connecting the USB cable to your computer.

Location of the boot button on the Pico

The BlueSCSI will appear as a USB drive labeled “RPI-RP2”. You can now release the button.
Copy the .uf2 file to Pico’s mounted USB drive. After the file has been copied the Pico will automatically eject and restart. If you inserted an SD card before starting the firmware update, you can verify your BlueSCSI has the new version by looking at the log.txt file on the SD card.
If you’re still having an issue you can use the flash_nuke.uf2 file to completely wipe the Pico and start over. This is usually unnecessary but easy to try if you are experiencing an odd issue.

Windows Users

⚠️ Warning:

Windows may display an error message (often around 40% progress) such as “An unexpected error is keeping you from copying the file” when copying the .uf2 file. This is normal and expected. The Pico ejects itself as soon as the firmware is received, which Windows interprets as a copy failure. The flash has completed successfully — check the log.txt file on your SD card to confirm the new version.

📝 Note:

There are many power-only USB cables that will not work as they do not transmit data. If you have an issue please try a different cable.

This wiki has been updated 1077 times by 109 people like you. Edit this page.

Generated 2026-10-18.