Arduino Nano 33 BLE/IoT Custom Debugging

Arduino IDE

Visual Studio 2017

Female/Female Jumper Wires

Soldering iron (generic)

Solder Wire, Lead Free

Visual Micro

STM32 Flasher

STM32F103CB Blue Pill Board

Nano 33 BLE Sense

When you've finally found you need a debugger, and you're not sure which one to get, there is always the option of making your own from an existing board to at least try it out...Here we debug our Arduino Nano 33 BLE with an STM32 Blue Pill board converted into our <a href="https://github.com/blacksphere/blackmagic">Black Magic Probe</a>. We can then add some custom entries in <a href="https://www.visualmicro.com/page/Arduino-For-Visual-Studio.aspx?source=3059ca">Visual Micro</a> to configure this debugger before appears as standard (coming soon).Don't worry about your Blue Pill board to being a debugger forever, see the Undo section at the bottom to return it back to normal.NOTE - This will get debugging working, but we would recommend buying a <a href="https://github.com/blacksphere/blackmagic/wiki/Debugger-Hardware">purpose built Black Magic Probe</a> for critical applications, which are competitively priced.<h3 >Soldering the Nano 33</h3>Before we can connect our Nano 33 BLE board to our external debugger, we will need to connect some jumper wires onto the pads on the back of the board as shown here:<div id="gallery"><img id="gallery" src=https://projects.arduinocontent.cc/10fc9a45-c050-4325-bf16-8ea0d325c897.png /><figcaption>Location of the solder pads on the Nano 33 BLE (and IoT) board</figcaption><img id="gallery" src=https://projects.arduinocontent.cc/9a3da694-74b9-4947-89f6-3192f0a6ee63.jpg /><figcaption>Jumper wires soldered onto the BLE debugging pads</figcaption></div><h3 >Creating Our External Debugger</h3>Now we can setup our STM32 board as a debugger, using the <a href="https://www.st.com/content/st_com/en/products/development-tools/software-development-tools/stm32-software-development-tools/stm32-programmers/flasher-stm32.html">STLink Flasher Tool</a> to flash the firmware onto the board.Here we will use the GUI as it is easiest to walk through, and we will use pre-compiled images to save having to build them ourselves.1) Download BMP STLink DFU Pre-Compiled BIN files from these links:<a href="http://builds.blacksphere.co.nz/blackmagic/blackmagic-stlink.bin">http://builds.blacksphere.co.nz/blackmagic/blackmagic-stlink.bin</a><a href="http://builds.blacksphere.co.nz/blackmagic/blackmagic_dfu-stlink.bin">http://builds.blacksphere.co.nz/blackmagic/blackmagic_dfu-stlink.bin</a>2) Set Boot 0 Jumper to 1 (red jumper in image for clarity)<figure><img src=https://projects.arduinocontent.cc/b80f56b5-2555-403d-bc95-4f4b7095405b.jpg /><figcaption>BOOT0 Jumper set to 1 for flashing (red jumper)</figcaption></figure>3) Connect Board to PC using FTDI Adapter:<figure><img src=https://projects.arduinocontent.cc/9349e408-5eed-4774-8c92-fdd1295853ff.png /><figcaption>Blue Pill to FTDI Adapter Wiring</figcaption></figure>NOTE: Swap to 3.3v ifneeded with 3.3 pin to right of Gnd4) Run Flash Tool Installation and Open the &#34;<a href="https://www.st.com/en/development-tools/flasher-stm32.html">STMFlashLoader Demo</a>&#34; application<ul ><li >COM Port, Baud 115200</li></ul><ul ><li >Review detected flash size for safety, press Next</li></ul>If your board shows as 64K this may not work!(as we have &gt; 80KB to upload), and could damage your board.There is a possibility it will work (it did for us without any issues)<ul ><li >Select 128K Flash Size (if only 64K this *may* work, or brick board!)</li></ul><ul ><li >Select Download and locate <a href="http://builds.blacksphere.co.nz/blackmagic/blackmagic_dfu-stlink.bin">blackmagic_dfu-stlink.bin</a> File</li></ul><ul ><li >Set start address 0x8000000</li></ul><ul ><li >Select Verify</li></ul><ul ><li >Run</li></ul><div id="gallery"><img id="gallery" src=https://projects.arduinocontent.cc/dfa9903e-b945-496e-86af-31d57c1bc1d7.png /><figcaption>COM Port Settings - amend port for your board</figcaption><img id="gallery" src=https://projects.arduinocontent.cc/7299e20f-50cd-4cc5-8cdb-fec3bec06715.png /><figcaption>Flash size detected as 64KB, but we continued anyway...</figcaption><img id="gallery" src=https://projects.arduinocontent.cc/07182e3f-029e-4e0d-9442-9e7d8d29bdef.png /><figcaption>Flash Loader Target Selection !! READ WARNING ABOVE !!</figcaption><img id="gallery" src=https://projects.arduinocontent.cc/c23ebf60-b8bc-47f7-a2fc-eace34669848.png /><figcaption>Flash Download Settings for DFU Image</figcaption><img id="gallery" src=https://projects.arduinocontent.cc/602b81ac-6443-4c93-bcba-33e13da8fcdc.png /><figcaption>Flashing in progress....</figcaption><img id="gallery" src=https://projects.arduinocontent.cc/05992d9a-c7fe-4caf-9513-52e80c001419.png /><figcaption>Flashing and Verification Success!</figcaption></div>Optional: move BOOT0 Jumper back to 0, re-plug USB and check it shows as Upgrade in Device manager if desired:<figure><img src=https://projects.arduinocontent.cc/7d1a0936-99b6-4074-8e31-c1b1cd7f4a87.png /><figcaption>Optional check for DFU Flash success in device manager</figcaption></figure>5) Ensure BOOT0 Jumper is back to 1, and board reset before repeating for next image, repeating same steps as above, but with a different image file, and start address:use image file <a href="http://builds.blacksphere.co.nz/blackmagic/blackmagic-stlink.bin">blackmagic-stlink.bin</a>Start Address 0x8002000<figure><img src=https://projects.arduinocontent.cc/6de650a8-c2ce-4233-8a49-9cee6a57d953.png /><figcaption>Secondary Black Magic Boot File Options</figcaption></figure>6) Move BOOT0 Jumper back to 0 (now green jumper for clarity)<figure><img src=https://projects.arduinocontent.cc/64793f4b-982f-4f88-b527-ca94d4b7965b.jpg /><figcaption>BOOT0 Jumper in 0 position for flash boot</figcaption></figure>7) Disconnect FTDI adapter from Blue Pill board8) Connect Blue Pill to PC via USB Cable Only using its on-board USB-micro port.You should now see two new COM ports appear (and an additional 2 devices in device manager):NOTE - No Additional drivers are needed for this Debugger, so no changes via Zadig will be needed<h3 >Connecting Debugger and Target</h3>As the Nano33 BLE harnesses the SWD protocol for debugging, we only need to connect 4 wires as shown below:<figure><img src=https://projects.arduinocontent.cc/eaa77f35-d2ab-4b0b-b54e-47919126a57a.png /><figcaption>Connections between our Black Magic Blue Pill, and our Nano 33 BLE Target</figcaption></figure><h3 >Adding Custom Debugger to vMicro</h3>Now we have our hardware connected, we can add in the custom entries for Visual Micro to allow us to use this debugger, before it has been added to the menu as a default option.Open your project and select the Arduino Nano 33 BLE board, and its COM port.Right click on the project and select &#34;Add Custom GDB Debugger (Advanced)&#34;This will automatically add a <a href="http://boards.txt/">boards.txt</a> and a ARDUINO_NANO33BLE.Debug.debugger_launch.json to the project which allow further customisation of the debugging tools in Visual Micro.<h3 >Editing the Launch JSON</h3>Open the JSON file from the solution explorer.As we want to customise our debugger to use the Black Magic GDB Setup, we will need to edit two values:MIDebuggerPathThis needs to reference your particular tool chain's GDB exe, which can be found by enabling vMicro&gt;Compiler&gt;Show Build Properties and Building your program.Then Search in the output window for &#34;runtime.tools.arm-none-eabi-gcc.path&#34;, and you should see something like the below:<pre ><code >runtime.tools.arm-none-eabi-gcc.path=C:\\Users\\Simon\\AppData\\Local\\arduino15\\packages\\arduino\\tools\\arm-none-eabi-gcc\\7-2017q4 </code></pre>This needs to go into our JSON, but we need to escape all &#34;\\&#34; with &#34;\\\\&#34;, and add &#34;\\\\bin\\\\arm-none-eabi-gdb.exe&#34; to the end of this, resulting in our JSON having:<pre ><code >&#34;MIDebuggerPath&#34;: &#34;C:\\\\Users\\\\Simon\\\\AppData\\\\Local\\\\arduino15\\\\packages\\\\arduino\\\\tools\\\\arm-none-eabi-gcc\\\\7-2017q4\\\\bin\\\\arm-none-eabi-gdb.exe&#34;, </code></pre>So now we have our ARM GDB path configured, on to the parameters...MIDebuggerArgsThis line can be replaced as below, just amend the COM port number as needed for Interface 0 of your Black Magic Probe.<pre ><code >&#34;MIDebuggerArgs&#34;: &#34;-nh -b 115200 -ex \\&#34;target extended-remote \\\\\\\\.\\\\COM24\\&#34; -ex \\&#34;monitor swdp_scan\\&#34; -ex \\&#34;attach 1\\&#34; &#34;, </code></pre>That is all that needs changing in the JSON, and no Edits to <a href="http://board.txt/">board.txt</a> are needed (complete JSON example is attached in the files)<h3 >Debugging Setup</h3>Now we are all set up we start debugging straight away.Now set the debugger to &#34;Hardware&#34;Select the Manual/Custom option to use our Launch JSONEnsure the vMicro &gt; Debugger &gt; Optimisation is set to &#34;No Project + Libraries&#34;.Add a break point in where you want to stop initially, these can be moved once you have started the debugger, and there is often a limit of 6 concurrent breakpoints.Now Build &amp; Upload your code via the Nano COM port.Then select Debug &gt; Attach to process to attach the debugger. You can also do this in one step by simply pressing Debug &gt; Start Debugging.<div class="se-component se-video-container __se__float-none" contenteditable="false" style="width: 100%;"><figure style="width: 100%; height: 56.25%; padding-bottom: 56.25%; margin: 0px;"><iframe frameborder="0" allowfullscreen="" src="https://www.youtube.com/embed/cszbvPZ43kE" data-proportion="true" data-percentage="100%,56.25%" data-size="100%,56.25%" data-align="none" style="width: 100%; height: 100%;" data-index="0" data-file-size="0" data-origin="100%,56.25%"></iframe><figcaption contenteditable="true"><div>A video covering all software elements of this tutorial</div></figcaption></figure></div>Tip: This is the same process for other boards which can use the Black Magic probe such as the Arduino Nano 33 IoT for example.<h3 >Undo</h3>If you want your Blue Pill back as it was, simply re-flash it to a standard Blue Pill again, as in <a href="https://github.com/rogerclarkmelbourne/Arduino_STM32/wiki/Flashing-Bootloader-for-BluePill-Boards">this documentation,</a> or using the same Flash Loader process used in this tutorial, with sector 0x8000000.<h3 >Learn More</h3><a href="https://github.com/blacksphere/blackmagic">Black Magic</a><a href="https://www.st.com/en/development-tools/flasher-stm32.html">STM Loader Tool</a><a href="https://www.visualmicro.com/page/DebuggerSupportList.aspx?source=3059ca">Pre-Configured Debugger Support List</a><a href="https://www.visualmicro.com/page/Debugging-Using-Custom-Hardware.aspx?source=3059ca">Further Custom Launch JSON Examples</a>

Blue Pill As Black Magic to Target Wiring

ARDUINO_NANO33BLE.Debug.debugger_launch.json

Arduino Nano 33 BLE/IoT Custom Debugging

Learn how get going with debugging on your Arduino Nano BLE, as well as build your own low cost debugger module in the process!