{"id":1011,"date":"2026-05-03T17:31:59","date_gmt":"2026-05-04T00:31:59","guid":{"rendered":"https:\/\/sysprogs.com\/tutorials\/?p=1011"},"modified":"2026-08-27T20:02:59","modified_gmt":"2026-08-28T03:02:59","slug":"creating-embedded-projects-on-linux","status":"publish","type":"post","link":"https:\/\/sysprogs.com\/CodeVROOM\/tutorials\/stm32\/linux\/","title":{"rendered":"Creating Embedded Projects on Linux"},"content":{"rendered":"

This tutorial shows how to create a basic STM32 project on Linux using CodeVROOM.<\/p>\n

Before you begin, install the following packages:<\/p>\n\n\n\n\n\n\n\n\n
Package<\/td>\nName in APT<\/td>\n<\/tr>\n
GCC for ARM<\/td>\ngcc-arm-none-eabi<\/td>\n<\/tr>\n
Ninja<\/td>\nninja-build<\/td>\n<\/tr>\n
CMake<\/td>\ncmake<\/td>\n<\/tr>\n
OpenOCD<\/td>\nopenocd<\/td>\n<\/tr>\n
Embedded GDB<\/td>\ngdb-multiarch<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Also, make sure your system has a functioning xz executable, since CodeVROOM uses it to unpack the device packages.<\/p>\n

Once all the prerequisites have been fulfilled, download<\/a> the latest CodeVROOM archive and unpack it.<\/p>\n

    \n
  1. CodeVROOM for Linux is distributed in .tar.xz<\/strong> files that include all the necessary binaries. To start it, run CodeVROOM-<platform>:\"\"<\/a><\/li>\n
  2. CodeVROOM does not need installation, so you can click “Run without installing”, or install it to any location of your choice:\"\"<\/a><\/li>\n
  3. The installation only takes a few seconds and simply copies the files to another location and creates shortcuts. Once installed, or ran in-place, the main window will look like this:\"\"<\/a><\/li>\n
  4. Select File->New->Project or use the toolbar command to open the project wizard selector. Select the CMake project wizard:\"\"<\/a>
    \n<\/a><\/li>\n
  5. Proceed with the default choices for the project type:\"\"<\/a><\/li>\n
  6. The next page allows selecting a toolchain to use. As of version 0.6, CodeVROOM only supports the embedded ARM toolchain (except the separate ESP32 wizard), and it needs to be pre-installed via a package manager. Once it is selected, CodeVROOM will show a list of devices compatible with the toolchain:\"\"<\/a>Select the device and click “Install” to proceed with the installation.<\/li>\n
  7. Once the package is installed, CodeVROOM will show the configuration options for the device. Proceed with the default ones:\"\"<\/a><\/li>\n
  8. The next page allows choosing between basic project samples and vendor-supplied templates. Select “LEDBlink (FreeRTOS)” sample in the regular list:\"\"<\/a><\/li>\n
  9. Finally, let’s configure debugging settings. On Linux\/Mac CodeVROOM relies on the system-level openocd installation (sudo apt install openocd<\/strong>), so make sure it is installed. The wizard will automatically pre-select the device script, and will show a searchable drop-down of known debugging interfaces:\"\"<\/a><\/li>\n
  10. Select the settings that match your configuration and click “test” to verify them:\"\"<\/a><\/li>\n
  11. Once the project got created, let’s modify it, adding the iteration counters to the threads. Add a g_Stats structure with 2 fields, and update threads to increment them within the loops:\"\"<\/a><\/li>\n
  12. Build the project (Ctrl-Shift-B or Ctrl-B, depending on the selected keyboard layout):\"\"<\/a><\/li>\n
  13. Set a breakpoint before the call to HAL_GPIO_Init() and press F5 (or F11 for Eclipse keyboard layout) to start debugging:\"\"<\/a>Once the breakpoint hits, you can hover the mouse over different expressions to see the values. You can also customize the primary and the secondary value view (e.g. Binary\/Hex or combined) via the Debug Expression Settings command.<\/li>\n
  14. Resume debugging. Try hovering the mouse over g_Stats. CodeVROOM will show the live values of the fields without stopping the program:\"\"<\/a>Note that it only works for global variables that can be evaluated without stopping the target. For complex expressions (e.g. type casts), use the dedicated Live Watch window.<\/li>\n
  15. Use the Debug->Windows->Globals command to open the Globals view:\"\"<\/a><\/li>\n
  16. There you can quickly search for variables containing a particular text. As of v0.6, you need to press Enter to expand the matching nodes, but future versions will support immediate temporary expansion:\"\"<\/a><\/li>\n
  17. You can also use the RTOS Objects view to see a live summary of threads, their stack usage, and global status:\"\"<\/a><\/li>\n
  18. Set a breakpoint in LED_Thread2 and open the Debug->Windows->Threads window:\"\"<\/a><\/li>\n
  19. Search for “Thread”. CodeVROOM will immediately highlight the matching frames: \"\"<\/a><\/li>\n
  20. Once all thread stacks got loaded, CodeVROOM will highlight other thread locations in the code. You can click the links with the thread\/frame info to switch to that frame:\"\"<\/a>If you used VisualGDB with Visual Studio, you could have noticed that viewing multiple threads\/frames slows down stepping. CodeVROOM is designed to completely avoid this bottleneck. Whenever you stop at a breakpoint, it will first show you the location of the stop, and then start loading (and progressively showing) all threads\/frames. If you continue execution before all threads got loaded, the background load will get cancelled, and the program will resume immediately.<\/li>\n
  21. Just like in VisualGDB, you can edit various project properties via the “Properties” command in the Files window:\"\"<\/a>Note that the project, the workspace and the target all have different sets of properties.<\/li>\n<\/ol>\n

     <\/p>\n","protected":false},"excerpt":{"rendered":"

    This tutorial shows how to create a basic STM32 project on Linux using CodeVROOM. Before you begin, install the following<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[64],"tags":[77,74],"_links":{"self":[{"href":"https:\/\/sysprogs.com\/tutorials\/wp-json\/wp\/v2\/posts\/1011"}],"collection":[{"href":"https:\/\/sysprogs.com\/tutorials\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/sysprogs.com\/tutorials\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/sysprogs.com\/tutorials\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/sysprogs.com\/tutorials\/wp-json\/wp\/v2\/comments?post=1011"}],"version-history":[{"count":5,"href":"https:\/\/sysprogs.com\/tutorials\/wp-json\/wp\/v2\/posts\/1011\/revisions"}],"predecessor-version":[{"id":1103,"href":"https:\/\/sysprogs.com\/tutorials\/wp-json\/wp\/v2\/posts\/1011\/revisions\/1103"}],"wp:attachment":[{"href":"https:\/\/sysprogs.com\/tutorials\/wp-json\/wp\/v2\/media?parent=1011"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/sysprogs.com\/tutorials\/wp-json\/wp\/v2\/categories?post=1011"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/sysprogs.com\/tutorials\/wp-json\/wp\/v2\/tags?post=1011"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}