Zephyr Workspace

Workspace for developing Zephyr RTOS applications targeting VS Code as the IDE.

Features

• Easy Zephyr installation via Docker
• VS Code Task configurations for:
  • Building
  • Cleaning
  • Flashing
  • Testing
• VS Code Launch files for:
  • Debugging remotely on target board
  • Debugging natively on host machine

Usage Tutorial

0. Requirements

• VS Code
• Linux environment (supports both native install and WSL2), in which the following are installed;

  • Docker Engine

  • stlink-tools, which can be installed by

    sudo apt install stlink-tools

1. Clone Repository

Clone this repository and change directory to it:

git clone https://github.com/NTURacingTeam/zephyr_workspace.git
cd zephyr_workspace

2. Build and Run Docker Container

Build and run a Docker container named zephyr using Docker Compose:

docker compose up -d

Then, attach to the shell of it:

docker exec -it zephyr bash

3. Initialize Zephyr Workspace

In the /workdir directory of the container, initialize it as Zephyr workspace:

west init -l <application_name>
west update

where <application_name> is the name of the application you want to develop. You may use blink as a reference application included in this repository.

Note

Since every Zephyr application has its own west manifest, when switching to another application, you need to remove the current west configuration and reinitialize it:

# in /workdir
rm -rf .west
west init -l <application_name>
west update

4. Attach VS Code to Container

Attach VS Code to the container we just created named zephyr using both Docker and Dev Containers VS Code Extensions.

Note

If you are using WSL2, you need to install the Remote - WSL extension and attach to the WSL2 instance first before installing the Docker and Dev Containers extensions.

Then open VS Code Workspace using File -> Open Workspace from File from the menu and select /workdir/zephyr.code-workspace.

5. Configure for the Application and Target Board

Before we can build and flash the application to target board, have to edit the zephyr.code-workspace file to match the application and target board we are developing. Change the following settings:

• "folders" -> "path": the path to your application (default to blink reference application)

• "settings" -> "bsp": board support package settings

  • "board": the board you are using
  • "board_root": the path to the board
  • "soc": the soc you are using
  • "vendor": the vendor of the board

  (the default values for NUCLEO-G474RE are suffice for now)

Note

Since VS Code caches settings, you may need to restart VS Code to make the changes take effect after editing settings in zephyr.code-workspace using Developer: Reload Window in Command Palette.

6. Build and Flash Application

First attach target board to your computer.

Note

If you are using WSL2, by default USB devices are not accessible from WSL2. You need to follow this guide first and pass the attached board to WSL2 using usbpid command.

Then you can build and flash the application using the provided Tasks by pressing Ctrl+Shift+P or F1 to open the Command Palette and selecting Tasks: Run Task and then West Build and Flash.

7. Debug Application

You can debug the application using the provided Launch files by pressing F5 or selecting Run and Debug -> Start Debugging from the sidebar.

References

• Project structured as: zephyrproject-rtos/example-application
• VS code workspace config modified from: KozhinovAlexander/zephyr_vscode_workspace