Building and Programming an Application using CLI and west
Last updated
Last updated
Only build using the WEST cli method if you have used it before and are comfortable using command line tools.
west
is the Swiss army knife command-line tool for Zephyr. Zephyr provides several west
extension commands for building, flashing, and interacting with Zephyr programs running on a device.
To build an application, navigate to the conexio-firmware-sdk
directory that we installed previously and choose a sample application. Here, we will choose the led_blink
sample.
/opt/nordic/ncs/v2.7.0/conexio_stratus_firmware/samples/conexio_stratus/led_blink
This sample tests two different functionalities of the Stratus device:
The user-programmable LED on the mainboard.
The USB serial communications are working correctly and the log output gets printed on the terminal window.
To compile the application, open the terminal in the sample application directory as illustrated below and issue the following west
command.
This will open the terminal in the installed directory of the nRF Connect SDK as indicated. In our case nordic/ncs/v2.7.0.
Then, in the terminal change the working directory to the sample application you want to compile and flash. For instance, here we will choose the led_blink
sample
cd
conexio_stratus_firmware/samples/conexio_stratus/led_blink
For the latest Gen 2 Stratus Pro nRF9161 device, you can build your application targeting this board by specifying the location of the Stratus Pro board information with the -DBOARD_ROOT
parameter to the CMake build system:
west build -b conexio_stratus_pro/nrf9161/ns -- -DBOARD_ROOT=/opt/nordic/ncs/v2.7.0/conexio-firmware-sdk
or if using a system build
west build -b conexio_stratus_pro/nrf9161/ns -- -DBOARD_ROOT=/opt/nordic/ncs/v2.7.0/conexio-firmware-sdk --sysbuild
For the Gen 1 Stratus device, the build command is:
west build -b conexio_stratus/nrf9160/ns -- -DBOARD_ROOT=/opt/nordic/ncs/v2.7.0/conexio-firmware-sdk
You can update the Stratus application firmware over USB using MCUboot, a secure bootloader that you can use to update applications without an external debugger.
Stratus device comes preprogrammed with the MCUBoot bootloader allowing users to directly update the firmware via the USB interface. Each sample is already configured to enable the Zephyr application to be booted by the MCUBoot after resetting the board.
This is handled internally by the Zephyr configuration system and is wrapped in the CONFIG_BOOTLOADER_MCUBOOT
Kconfig variable, which is enabled in the application’s prj.conf
file as
CONFIG_BOOTLOADER_MCUBOOT=y
More information can be found here.
For Stratus Pro, MCUBoot is enabled by default in the device tree configuration and no extra action is needed by the developer at the application build level.
After the compilation has been completed, you will notice a build
folder being generated, which will contain the following binary:
build/zephyr/app_update.bin
When an application is built with the option CONFIG_BOOTLOADER_MCUBOOT
set, app_update.bin
, a signed variant of the firmware in binary format (as opposed to intelhex) is automatically generated and can be used for firmware over-the-air (FOTA) upgrades.
To program the Stratus via USB, you will need to put the device into DFU mode first. This mode triggers the onboard bootloader that accepts firmware binary files. To enter DFU mode:
Hold down both buttons (MODE/USER + RESET)
Release only the RESET button, while holding down the MODE/USER button
Wait for the white LED to turn on (steady-state)
Release the MODE button
The device is now in the DFU mode. 🚨
Flash the compiled firmware using newtmgr
:
newtmgr -c serial image upload build/zephyr/app_update.bin
Give it a few seconds for the transfer to complete and then, hit the RESET
button. You should now see the LEDs blinking every second. If you have a serial logger such as TeraTerm, Putty, or similar, select the correct COM port and set the baud rate = 115200, hit the RESET
button, and notice the following being printed on the console window:
Now you are all set! Stratus is alive and ready for development 👏