Working with Zephyr® RTOS projects using West

1. Install Zephyr, West, and Python dependencies on your system.

2. Install Zephyr SDK on your system.

1. Click Open on the Welcome screen or select File | Open from the main menu.

2. Select a directory with a Zephyr project that contains the CMakeLists.txt file.

3. Open your project settings via Settings | Build, Execution, Deployment | Embedded Development | West.

   tip

   You may see the following CMake error message in the West tool window when opening a Zephyr West directory for the first time:

   BOARD is not being defined on the CMake command-line, in the environment or by the app. Fix...

   This means you have not yet configured your board in the West project settings. Click Fix…, and the West dialog with your project settings will open.

   

4. CLion will automatically fill in the Toolchain, West executable, and Build directory fields with default values in the West dialogue. You can change them if necessary.

5. Select your board name in the corresponding field if it has not already been selected automatically.

6. Click OK. CLion will load the project and display the results in the West tool window:

   

CLion detects the project build targets and creates the native West configurations for them. To set up additional parameters:

1. Select Run / Debug Configurations | Edit Configurations… from the main toolbar or Run | Edit Configurations… from the main menu. The West Run/Debug Configurations dialog will open.

   

2. Copy the command line arguments you use to run the west flash and west debug commands in the Terminal. Paste them into the Flash options and Debug options fields, respectively. If you select the Launch Run and Debug on the QEMU emulator option, the Flash options and Debug options fields will become unavailable.

3. Click OK, and your program will be ready to run and debug.

To run or debug your program, you can use the configuration widget (click or ), the Run menu, or the gutter icons next to the program’s entry point.

Here is an example of debugging a Zephyr program:

note

CLion supports multi-threaded RTOS debugging, which allows you to view each thread separately. To do this:

1. Enable the RTOS integration in Settings | Build, Execution, Deployment | Embedded Development | RTOS Integration.

2. Set CONFIG_THREAD_MONITOR and CONFIG_THREAD_NAME in your prj.conf files.