-
Notifications
You must be signed in to change notification settings - Fork 19
Project Setup: VS Code
This page will show you how to setting up the VS Code, also how to load an existing Mbed-CE project and develop it using the VS Code IDE.
Tip
Note that VS Code can develop locally, or over an SSH connection to a remote host, or over a connection to Windows Subsystem for Linux if you use it.
You can watch this part in video version - Youtube guide
- If you don't have VS Code, you'll need to install it per the instructions here. Open it, and go through the getting started wizard according to your preferences.
- If connecting to a remote workspace, connect to it now and open the folder with your project.
- Go to the Extensions menu on the left, then search for and install the following extensions. If connected to a remote workspace, make sure to install the extensions for the remote host as well.
- C/C++
- Better C++ Syntax (recommended addon for C/C++)
- CMake Tools (allows building CMake projects)
- CMake (syntax higlighting for CMake)
- Cortex-Debug (allows VS Code to connect to an embedded GDB server).
- NOTE: If you have GDB 8 instead of a newer version (common in older GNU ARM toolchains) you will need to install version 1.4.4 of this extension, future versions dropped support for it.
-
Before you open your project in VS Code, create two more files in your project foler:
-
If the project is new one or does not already contain folder
.vscode
with filesettings.json
which lives inside (.vscode/settings.json
),you will need to create them both and place the content bellow intosettings.json
. Later you can modify this file up to your requirements.{ "cmake.buildDirectory": "${workspaceFolder}/build/${variant:board}-${variant:buildType}", "cmake.generator": "Ninja" }
-
If the project is new one or does not already contain a
cmake-variants.yaml
file, you will need to create one in your project's root directory with content bellow. This file does two things:- It lists the build types (
develop
,debug
,release
) that the project can be built as - It also supplies the CMake options for each Mbed target that you want to build for.
Here's a template for you to use:
buildType: default: Develop choices: Develop: short: Develop long: Emit debug information but also optimize buildType: Develop Debug: short: Debug long: Emit debug information and don't optimize buildType: Debug Release: short: Release long: Optimize generated code buildType: Release board: # Fill name of your targer which has to corespond to # target name in targets.json5 file or custom_targets.json5 in case of custom target. # For simplified just replace every occurrence of YOUR_MBED_TARGET with Mbed target name. # For example LPC1768 or NUCLEO_L452RE_P default: YOUR_MBED_TARGET # default variant (choose) from bellow choices: YOUR_MBED_TARGET: # Name of one variant short: YOUR_MBED_TARGET # Short name of the variant settings: MBED_TARGET: YOUR_MBED_TARGET # Your mbed target name from targets.json5 file # Fill your upload method according to variants bellow # - universal: NONE, MBED, JLINK, PYOCD, OPENOCD # - target specific: STLINK, STM32CUBE, LINKSERVER, PICOTOOL, ARDUINO_BOSSAC # For more visit - https://github.com/mbed-ce/mbed-os/wiki/Upload-Methods#upload-method-list UPLOAD_METHOD: YOUR_UPLOAD_METHOD
Later on, if you want your project to support multiple different Mbed targets, you can add them as entries in the
board:
section as next choice in this file. - It lists the build types (
-
-
Run VS Code and go to File > Open Folder, and browse to the root directory of the Mbed project
-
Click Yes to the trust dialog
-
Close the "Would you like to configure CMake project" popup on the bottom right, we'll be doing this manually.
-
Click on the bottom bar where it says "No Kit Selected". Then, choose "[Unspecified]" from the menu (the Mbed build scripts will find the compilers).
Without this setting, switching between targets requires to clean the build dir and starts always a build all. By using this setting, each variant has its own build dir.
-
Now, select your variant. Use Ctrl-Shift-P and find CMake: Select Variant. Then choose the variant you want. I'd recommend starting with the Develop one for general use.
-
If all goes well, your project should look like bellow and you should see the CMake project successfully configure and load. If not, you may need to double-check the toolchain setup guide to make sure everything is set up OK.
- Your_Poject_Name | |- .vscode/settings.json |- mbed-os/.. |- .gitignore |- CMakeLists.txt |- cmake-variants.yaml |- main.cpp |- mbed_app.json5
Note
When working with Mbed projects, "CMake: Delete Cache and Reconfigure" is your friend if things break. If your project did not find the compilers successfully, or things moved on the disk, or you're getting other errors, make it your first recourse to try this option.
-
To choose your build target, use Ctrl-Shift-P and find "CMake: Set Build Target". Then, choose the target you want from the list. Just like on the command line, targets starting with flash- will upload a program to your Mbed board, while others just build the code.
-
Start a build, either by pressing the Build button on the bottom toolbar or by pressing F7. The code should compile!
- First, if you haven't already, you will need to make sure the project is configured to use an upload method that supports debugging. Read about upload methods on the Upload Methods page, and select a method to use using the
UPLOAD_METHOD:
option in cmake-variants.yaml. - Once this is done, if you go to the "Run and Debug" pane on the left, you should see a list of launch configurations at the top. Simply select your application and press the play button. If all goes well, you should be dropped into a debug session in the application!
Developing in WSL works great, especially with the current feature update 22H2 in Windows 10 or 11. Earlier Versions had problems with USB, now it is even possible to have Linux GUI on the Windows desktop. One big advantage is the much faster compiling speed.
General WSL documentation starts here: https://docs.microsoft.com/en-us/windows/wsl/about
To setup the development environment, there are a few steps neccessary:
-
connect VSCode to your WSL instance, this will install a VSCode server automatically
-
install the gcc toolchain from arm Developer site: https://developer.arm.com/downloads/-/arm-gnu-toolchain-downloads
-
install python modules as described in the command line tools setup
-
install cmake, use a current Linux x86_64 version from cmake.org: https://cmake.org/download/
-
install ccache with 'apt-get install ccache'
-
install git with 'apt-get install git'
-
for using STLink, a full installaton of STM32CubeIDE is neccessary. Even if only the gdbserver is needed, it is part of this package.
When VSCode is connected to WSL, install cmake-tools and other desired extensions like gitlens also in VSC under WSL. Then it is important to use the filesystem in WSL, so copy/clone projects into your home directory in WSL. There you will have the benefit of the faster filesystem, which makes compiling about 5 times faster.
To use USB debuging hardware, the USB device must be attached to the Linux VM. There is a bridge 'usbipd', and a few steps to follow: https://learn.microsoft.com/en-us/windows/wsl/connect-usb
An alternative is usbipd-win, available on https://github.com/dorssel/usbipd-win