Flashing (Advanced)

This page is for developers ONLY!

If you're a User, CLICK HERE: BlueSCSI-Updater

(DO NOT follow the content below if you are a user!)

---

Developers, you have 2 options to flash BlueSCSI:

1. Flash the .bin file directly from STM32 ST-LINK Utility (windows only) or STM32CubeProgrammer (cross platform). Use this method if you are not a developer and just wish to get the code to the BluePill - and for some reason don't/can't use the BlueSCSI Updater.

2. Flash by setting up the Visual Studio Code IDE, installing the ARM toolchain and PlatformIO extensions, and re-compiling and programming. If you are a developer and plan to contribute this method is what you should use.

---

OPTION 1: Using STLink v2

Setup STLinkV2

See STLink Setup

Procedure (STM32 ST-Link Utility or STM32CubeProgrammer)

• Grab the latest bin file from the Releases page.
• Remove SD Card
• Open STM32 ST-Link Utility or STM32CubeProgrammer
• Move the BOOT0 jumper (furthest from the reset button) to 1
• Connect the BluePill to the STLink
• Press & release the reset button on the BluePill
• Click Connect in STM32 ST-Link Utility or STM32CubeProgrammer
• STM32CubeProgrammer - Goto the Erasing & Programming tab on the Left.
  • File Path: Select the bin file from Step 1
  • Start Address: 0x08000000
  • Checked: Verify programming & Run after Programming
  • Click Start Programming

• After programmed - move BOOT0 jumper back to 0
• Press & release the reset button on the BluePill
• You should see the LED PC_13 flashing 5x indicating no SD Card detected.
• Disconnect the BluePill from the STlink - It's ready to go!

---

OPTION 2: Procedure (PlatformIO)

• Remove SD Card
• Move the BOOT0 jumper (furthest from the button switch) to 1
• Push the reset button on the BluePill
• Run the PlatformIO: Upload task.
  • Expected output:

Uploading .pio/build/genericSTM32F103C8/firmware.elf
xPack OpenOCD, x86_64 Open On-Chip Debugger 0.10.0+dev-00378-ge5be992df (2020-06-26-12:31)
Licensed under GNU GPL v2
For bug reports, read
        http://openocd.org/doc/doxygen/bugs.html
debug_level: 1

0
hla_swd
target halted due to debug-request, current mode: Thread 
xPSR: 0x01000000 pc: 0x08000194 msp: 0x20000690
** Programming Started **
** Programming Finished **
** Verify Started **
** Verified OK **.      <-- Everything flashed OK
** Resetting Target **

• Move BOOT0 jumper back to 0
• Push the reset switch on the BluePill
• You should see the LED PC_13 flashing 5x indicating no SD Card detected.

The following YouTube video demonstrates the steps of flashing & updating your BlueSCSI https://www.youtube.com/watch?v=bRLAOts_MTM

Trouble Shooting

Move the jumper furthest away from the RESET switch to 1. Reset and try to program again.

If the device is not detected you may need to hold reset, click program, once it is detected release reset.

If you are unable to get the device in DFU mode for programming you may need to use STM32CubeProgrammer to erase the chip.

Alternative upload methods

See the uploading documentation on PlatformIO for alternatives.