Standalone Zephyr application template

This repo can be used as a template and a playground for experimenting with a standalone Zephyr application.

🚀 Getting started

# Create a directory for zephyr projects and switch to it
$ mkdir zephyr-projects
$ cd zephyr-projects

# Create python virtual environment there
$ python3 -m venv zephyr-venv

# Activate it
$ source zephyr-venv/bin/activate

# Install west
(zephyr-venv) $ pip install west

# Initialize workspace for the app (main branch)
(zephyr-venv) $ west init -m https://github.com/kaizoku-oh/zephyr-app-workspace --mr main app-workspace
(zephyr-venv) $ cd app-workspace

# Update Zephyr modules
(zephyr-venv) $ west update

# Install python dependencies for zephyr and mcuboot
(zephyr-venv) $ python -m pip install -r deps/zephyr/scripts/requirements.txt
(zephyr-venv) $ python -m pip install -r deps/bootloader/mcuboot/scripts/requirements.txt

# Build the bootloader (mcuboot)
(zephyr-venv) $ west build deps/bootloader/mcuboot/boot/zephyr -d deps/bootloader/mcuboot/boot/zephyr/build -b nucleo_f767zi

# Flash the bootloader (mcuboot)
(zephyr-venv) $ west flash -d deps/bootloader/mcuboot/boot/zephyr/build

# Build the app
(zephyr-venv) $ west build app -d app/build -b nucleo_f767zi

# Flash the app
(zephyr-venv) $ west flash -d app/build

# Copy vscode workspace file from the app to the outer workspace directory
(zephyr-venv) $ cp app/linux.code-workspace .

# Open vscode workspace
(zephyr-venv) $ code linux.code-workspace

Once vscode is open you can run your workspace tasks.

🔨 Application footprint for NUCLEO-F767ZI

🔨 Bootloader footprint for NUCLEO-F767ZI

✅ ToDo

• [x] Blink board LED

• [x] Shell over UART

• [x] Fix vscode launch with cortex-debug

• [x] Add multithreading code

• [x] Add die temp sensor class

• [x] Add Github CI workflow

• [x] Add GitHub badges to readme

• [x] Enable C++20

• [x] Add lambda callback to Serial class

• [x] Add a simple Network manager class

• [x] Add NVS Storage class

• [x] Add HTTP client class

• [x] Add an IoT app that reads die temperature, store it in NVS, retrieve it, format it then send it

• [x] Add vscode dev container environment

• [x] Build project with MCUBoot

• [ ] Run app in Renode

• [ ] Add configurable vscode tasks

• [ ] Integrate Renode + robot in the CI workflow

• [ ] Solve the Shared Callback Registration problem in the Network class

• [ ] Add native simulator to vscode build task

• [ ] Add a script to download and setup the project (intellisense, structure, venv...)

• [ ] Add static code analysis with CodeChecker

• [ ] Add coverage testing with gcov

• [ ] Add unit tests using Ztest and run them using Twister

• [ ] Add integration tests

• [ ] Add HIL tests using GitHub local runner

• [ ] Add application events manager using zbus

• [ ] Automate updating the README.md Build footprint table automatically by running a post build

• [ ] Add debouncing mechanism to Button class

• [ ] Add OTA update example

• [ ] Add lambda callback to Button class

• [ ] Use the active object design pattern

• [ ] Use an event driven state machine using the SMF OS service and the message queue kernel object

• [ ] Add Local class for managing local time and geo-location

• [ ] Add MQTT client class

• [ ] Add TCP class

• [ ] Add an out-of-tree driver

💳 Credits

This project is generated from the zephyr-vscode-example template by Jonathan Beri.

It is following the Golioth recommended way to structure a zephyr app using manifest files, more on this in this blog post.