This guide will help you install and setup Visual Studio Code for programming and debugging STM32 boards.
I tested this guide under Arch Linux and Ubuntu 18.04. If you get it to work under other setups, please let me know so I will update the steps with more info.
If you were using STM32CubeIDE or SystemWorkbench before, you need to convert your projects in order for them to work. The conversion procedure is fully reversible.
Up until the time of writing this guide, it is not possible to use STM32CubeIDE and Visual Studio Code on the same project unless some configuration changes are made on CubeIDE.
Besides that, it is reccomended that every person that works on a project runs the same working environment.
If you already have CubeMX installed, you can skip this step
Install stm32cubemx from the AUR. If you don't have access to the AUR or you just don't want to use it, follow the step below.
Download the .zip from here (you have to sign up to ST's website) and install the right version for your OS.
These are the tools needed to compile and debug the code.
Install arm-none-eabi-gcc arm-none-eabi-gdb arm-none-eabi-newlib.
Install gcc-arm-none-eabi gdb-multiarch libnewlib-arm-none-eabi.
Install the toolchain from arm's website
Install make from your package manager
Install make from this this page (updated in 2006 though...). It should be possible to get the current version of make through WSL, but I don't have experience with it.
Open On-Chip Debugger is the software that will take care of uploading the compiled software to the STM32, and during debug, it will open the connection between the computer and the STM32.
If you are on Windows you could probably get OpenOCD installed, but I don't have idea on how to do it. Contact me if you're willing to find a way.
Install openocd from your package manager
The next steps aren't really necessary to get the thing working. You could just use the a terminal and your favourite editor and you would have (almost) all the functionality of the complete setup. Visual Studio Code is just a pretty front-end.
This page contains the instructions to install the latest version of VSCode on many distributions.
Download and install the program from the official website.
This extension will take care of intellisense, syntax highlighting and more.
Install this extension in Visual Studio Code.
Same as above, but with this extension.
By default CubeMX generates projects in a format called EWARM. Unfortunately, EWARM is currently not supported by the VSCode extension, but the more generic Makefile structure is. In order to configure CubeMX to support VSCode you have to navigate to Project Manager->Project->Toolchain/IDE and set it to Makefile.
Under the Code generator tab, enable the Copy all used libraries into the project folder option. This step is needed because stm32-for-vscode doesn't support the implicit inclusion of libraries yet.
After doing that, click on GENERATE CODE; You should see the new Makefile project structure being created.
Using the Open folder menu in Visual Studio Code, navigate to your project's root folder and open it.
Now open the command palette (Ctrl+Shift+P or F1) and run Build STM32 Project. A terminal should appear and you will see gcc (hopefully) compiling your project.
After you call Build STM32 Project for the first time, stm32-for-vscode will create two custom tasks (that can be accessed by typing Ctrl+Shift+B) to build your code and to flash it into the STM32 board.
To debug the code just press F5 inside VSCode and the debugger will start automatically. Remember to stop the debugger before flashing new code.
This happnes because you don't have permission to open the serial device. In order to fix this you need to add your user to the group that owns the serial interface. To get the serial interface name you can run dmesg | grep tty after plugging the STM32 in. Read the last line, you should see something like:
cdc_acm 2-2:1.2: ttyACM0: USB ACM device
In this example ttyACM0 is the device name.
Now that you know the name you can get the owner by doing ls -l /dev/ttyACM0. The output looks like this:
crw-rw---- 1 user group 4, 166 set 11 08:45 /dev/ttyACM0
group indicates the group name.
Now you just need to add your user to the group by doing sudo usermod -aG group $USER, substituting group with the group name you have discovered above.
You are done. Log out of your account and log back in to apply the change.
works on xbuntu LTS