Set up build environment for POSIX platform on Windows

Open a Ubuntu 22.04 shell running in WSL.

Required tools…

  • gcc 11.x or later

  • cmake >= 3.22

  • make

For Ubuntu 22.04, the apt package build-essential includes gcc and make. You can install it as follows…

sudo apt install build-essential ninja-build

You will also need cmake version >= 3.22 . To install it, simply run:

sudo apt install cmake

which (at time of writing) installs cmake version 3.22.1 Once installed, check cmake is found and is version 3.22 or higher…

cmake --version

Once the above tools are installed you should be able to create an image for the POSIX platform. In the base directory of the git clone referenceApp run…

cmake --preset posix
cmake --build --preset posix --parallel

By default release configuration is used. If you want to build debug configuration, use

cmake --build --preset posix --config Debug --parallel

The build files should be written to a new subdirectory named build/posix and the built executable should be found at build/posix/executables/referenceApp/application/Release/app.referenceApp.elf. If you’ve built it with –config Debug, then the executable can be found at build/posix/executables/referenceApp/application/Debug/app.referenceApp.elf. You should be able to run and see output like this in your shell terminal…

$ build/posix/executables/referenceApp/application/Release/app.referenceApp.elf
hello
106367434: RefApp: LIFECYCLE: INFO: Initialize level 1
106367434: RefApp: LIFECYCLE: INFO: Initialize runtime
106367434: RefApp: LIFECYCLE: DEBUG: Initialize runtime done
106367434: RefApp: LIFECYCLE: DEBUG: Initialize level 1 done
106367434: RefApp: LIFECYCLE: INFO: Run level 1
106367434: RefApp: LIFECYCLE: INFO: Run runtime
106367434: RefApp: LIFECYCLE: DEBUG: Run runtime done
106367434: RefApp: LIFECYCLE: DEBUG: Run level 1 done
106367434: RefApp: LIFECYCLE: INFO: Initialize level 2
106367434: RefApp: LIFECYCLE: INFO: Initialize can
...

Press CTRL-C should exit the running application.

Now that you can build the code and run it, you can explore the code, make changes and learn how it works.