.. zephyr:code-sample:: lorawan-fuota
:name: LoRaWAN FUOTA
:relevant-api: lorawan_api
Perform a LoRaWAN firmware-upgrade over the air (FUOTA) operation.
Overview
********
An application to demonstrate firmware-upgrade over the air (FUOTA) over LoRaWAN.
The following services specified by the LoRa Alliance are used:
- Application Layer Clock Synchronization (`TS003-2.0.0`_)
- Remote Multicast Setup (`TS005-1.0.0`_)
- Fragmented Data Block Transport (`TS004-1.0.0`_)
The FUOTA process is started by the application and afterwards runs in the background in its own
work queue thread. After a firmware upgrade is successfully received, the application is notified
via a callback and can reboot the device into MCUboot to apply the upgrade.
A LoRaWAN Application Server implementing the relevant services is required for this sample to work.
.. _`TS003-2.0.0`: https://resources.lora-alliance.org/technical-specifications/ts003-2-0-0-application-layer-clock-synchronization
.. _`TS005-1.0.0`: https://resources.lora-alliance.org/technical-specifications/lorawan-remote-multicast-setup-specification-v1-0-0
.. _`TS004-1.0.0`: https://resources.lora-alliance.org/technical-specifications/lorawan-fragmented-data-block-transport-specification-v1-0-0
Building and Running
********************
This sample can be found under :zephyr_file:`samples/subsys/lorawan/fuota` in the Zephyr tree.
Before building the sample, make sure to select the correct region in the ``prj.conf`` file.
The following commands build and flash the sample.
.. zephyr-app-commands::
:zephyr-app: samples/subsys/lorawan/fuota
:board: nucleo_wl55jc
:goals: build flash
:compact:
ae0c1b72cf