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 |
| Ultra/Ultra Wide | BlueSCSI_Ultra*.uf2 / BlueSCSI_Ultra_Wide*.uf2 |
SD Card Method
Requires release v2025.07.07 and later.
- Download the latest
.zipfrom 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!
If you are having issues updating via the SD Card please use the USB method instead.
USB Method
- Download the latest
.uf2from 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.
- The BlueSCSI will appear as a USB drive labeled “RPI-RP2”. You can now release the button.
-
Copy the
.uf2file 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 thelog.txtfile 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
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.
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 1060 times by 108 people like you. Edit this page.
Generated 2026-09-15.