52 lines
1.9 KiB
ReStructuredText
52 lines
1.9 KiB
ReStructuredText
|
.. _dfu:
|
||
|
|
|
||
|
|
Device Firmware Upgrade Subsystem
|
||
|
|
#################################
|
||
|
|
|
||
|
|
Overview
|
||
|
|
********
|
||
|
|
|
||
|
|
The Device Firmware Upgrade subsystem provides the necessary frameworks to
|
||
|
|
upgrade the image of a Zephyr-based application at run time. It currently
|
||
|
|
consists of two different modules:
|
||
|
|
|
||
|
|
* :file:`boot/`: Interface code to bootloaders
|
||
|
|
* :file:`img_util/`: Image management code
|
||
|
|
|
||
|
|
The DFU subsystem deals with image management, but not with the transport
|
||
|
|
or management protocols themselves required to send the image to the target
|
||
|
|
device. For information on these protocols and frameworks please refer to the
|
||
|
|
:ref:`mgmt` section.
|
||
|
|
|
||
|
|
Bootloaders
|
||
|
|
***********
|
||
|
|
|
||
|
|
.. _mcuboot:
|
||
|
|
|
||
|
|
MCUboot
|
||
|
|
=======
|
||
|
|
|
||
|
|
Zephyr is directly compatible with the open source, cross-RTOS `MCUboot`_ boot
|
||
|
|
loader. It interfaces with MCUboot and is aware of the image format required
|
||
|
|
by it, so that Device Firmware Upgrade is available when MCUboot is the boot
|
||
|
|
loader used with Zephyr. The source code itself is hosted in the
|
||
|
|
`MCUboot GitHub Project`_ page.
|
||
|
|
|
||
|
|
In order to use MCUboot with Zephyr you need to take the following into account:
|
||
|
|
|
||
|
|
1. You will need to define the :ref:`mcuboot_partitions` required by MCUboot in
|
||
|
|
the :ref:`flash_partitions`.
|
||
|
|
2. Your application's :file:`.conf` file needs to enable the
|
||
|
|
:option:`CONFIG_BOOTLOADER_MCUBOOT` Kconfig option in order for Zephyr to
|
||
|
|
be built in an MCUboot-compatible manner
|
||
|
|
3. You need to build and flash MCUboot itself on your device
|
||
|
|
4. You might need to take precautions to avoid mass erasing the flash and also
|
||
|
|
to flash the Zephyr application image at the correct offset (right after the
|
||
|
|
bootloader)
|
||
|
|
|
||
|
|
More detailed information regarding the use of MCUboot with Zephyr can be found
|
||
|
|
in the `MCUboot with Zephyr`_ documentation page on the MCUboot website.
|
||
|
|
|
||
|
|
.. _MCUboot with Zephyr: https://mcuboot.com/mcuboot/readme-zephyr.html
|
||
|
|
.. _MCUboot GitHub Project: https://github.com/runtimeco/mcuboot
|