Wireless Programming and Debugging with STM32 and Raspberry Pi
Are you tired of connecting programmer every time you need to change software in you robot? Do you remember when you had to disassemble half of your work just to repair some minor bug in a software? That's not the case anymore! With any microcontroller supporting SWD - Serial Wire Debug - and Raspberry Pi you can easily program and debug your uC using only WiFi connection!
But wait, wireless programming? You're joking...
Yeah, we were also surprised that there is almost nothing on the Internet how it can be achieved. And actually yes, we are joking, because the programming itself is not wireless. Microcontroller has to be connected to some device which will be used as programmer. But if we use it along with Raspberry Pi? And we all know that ssh connection with RPi is pretty easy. So, what do we need more? ;)
Here you can find all the sources which helped us while working on this feature:
Where the last page was the most vital for us. It describes exactly the same what we wanted to achieve, but with Arduino instead of STM32 microcontroller.
Let's start with electronics
First thing to do is to download the datasheet of your microcontroller and find which pins are enabled as SWD:
Now, take a closer look at the RPi pinout presented on the adafruit:
Note the difference in pin numbering! On the adafruit website authors use the numbers directly from the processor, not the header numbers as most of us used to.
Make sure you make the wiring correctly in your project!
The Open On-Chip Debugger (OpenOCD) aims to provide debugging, in-system programming and boundary-scan testing for embedded target devices.
We use OpenOCD defined rules to enable STM32 programming directly from Raspberry Pi microprocessor.
Install OpenOCD on Raspberry Pi
Unfortunately OpenOCD isn't available from the repositories and we need to compile it from scratch. From the other side though, here you can find excellent tutorial how to do it ;)
Find interface and target
Interface describes our programmer - in our case Raspberry Pi. Let's type in Raspberry's console:
Now you should see the supported devices. We are interested in raspberrypi2-native.cfg. Write down the name of the file (ok, you can always copy it later from here ;) )
Note: don't bother if you have Raspberry Pi 3. In RPi 2 and RPi 3 the interfaces are exactly the same, so this file will work for both of them.
Target describes a microcontroller which we want to program. Let's see the supported ones:
Impressive list, right? Find your microcontroller there and write down the filename. In our case stm32f0x.cfg.
Prepare OpenOCD configuration file
Now it's time to write configuration file for our microcontroller. As a good starting point we took the one from adafruit:
source [find interface/raspberrypi2-native.cfg]transport select swdset CHIPNAME at91samd21g18source [find target/at91samdXX.cfg]# did not yet manage to make a working setup using srst#reset_config srst_onlyreset_config srst_nogateadapter_nsrst_delay 100adapter_nsrst_assert_width 100inittargetsreset halt
In case of STM family we don't have to provide CHIPNAME, instead it's crucial to set WORKAREASIZE to 0x2000. The modified file looks as follows:
source [find interface/raspberrypi2-native.cfg]transport select swdset WORKAREASIZE 0x2000 source [find target/stm32f0x.cfg]reset_config srst_only srst_nogateadapter_nsrst_delay 100adapter_nsrst_assert_width 100inittargetsreset halt
Find some cosy place on your SD card, create a file named openocd.cfg and paste there the above code.
To verify whether everything works smooth and nice, go to the directory where you placed openocd.cfg file and type:
Now, you should see something similar:
It's possible, but it's difficult, to flash and debug software directly from the shell. That's why it would be nice to configure Eclipse to be compatible with OpenOCD programming and debugging.
Ensure GDB is able to establish connection with OpenOCD
First of all we need to be sure that nothing (e.g. firewall) blocks the connection
- On Raspberry Pi execute
- On local computer launch
arm-none-eabi-gdband then target remote
192.168.2.109is the IP address of Raspberry Pi
If everything is fine, you should see:
- On local computer
- On Raspberry Pi
The last test is to establish telnet connection from local computer and Raspberry Pi. Leave the OpenOCD running on RPi and on local computer execute:
telnet 192.168.2.109 4444 . Remember to change the IP! You should get the connection now. Type
exit to quit.
Install OpenOCD Eclipse plugin
To use OpenOCD remotely you need to install the GNU ARM C/C++ OpenOCD Debugging plugin. Here you'll find a great tutorial how to do it.
Set Run Configurations
To use wireless programming and debugging in an existing project you have change Run Configurations.
- Open your project in eclipse and select Run -> Run Configurations...
- In the new window right-click on the GDB OpenOCD Debugging and choose New
- Give a good name to the configuration and change the settings in Debugger tab:
- Repeat the above step (with the same configuration) for Debug Configurations -> GDB OpenOCD Debugging
- In the same window add the GDB Hardware Debugging Configuration with following settings:
Write some mind blowing software, run
sudo openocd on Raspberry and run it!
You should be able trace the program and all the registers values in real-time ;)
Wireless debugging opens endless opportunities for hobbyist and professionals. Finally, there is no need to create another interfaces / sockets / wires to flash or debug microcontrollers.
The solution was developed as a part of Turtle Rover software, but is shared open source for everyone's use.
Learn more: http://turtlerover.com and support us on Kickstarter : Turtle Rover - World's First Earth Rover by Kell ideas — Kickstarter