Updating Firmware

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

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
Pico 1 or Pico 1W	`BlueSCSI_Universal_Pico1_*.uf2` / `.bin`
Pico 2 or Pico 2W	`BlueSCSI_Universal_Pico2_*.uf2` / `.bin`
Pico 1/1W + DAC for SPDIF audio	`BlueSCSI_Pico1_Audio_SPDIF_*.uf2` / `.bin`
Pico 2/2W + DAC for SPDIF audio	`BlueSCSI_Pico2_Audio_SPDIF_*.uf2` / `.bin`

💡 Tip:

If you’re unsure which file to pick, Universal is almost certainly the right choice.

SD Card Method

Requires release v2025.07.07 and later.

Download the latest .bin (Pico1 or Pico2) from the releases page and place the relevant (Pico or Pico2) .bin on the root of a FAT or ExFAT formatted SD Card.
Insert the SD card into your BlueSCSI. The next time your BlueSCSI boots up it will flash the latest release and remove the bin file. 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 universal .uf2 from the releases 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 1/1w or Pico 2/2w module while connecting the USB cable to your computer.

Location of the boot button on the Pico

The Pico 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.

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 939 times by 97 people like you!
Click here to edit this page.
Generated 2026-03-27