Skip to content

Commit 6684a71

Browse files
committed
Quick header changes
1 parent 93ed810 commit 6684a71

File tree

1 file changed

+4
-2
lines changed

1 file changed

+4
-2
lines changed

docs/reference/technology/firmware_update.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -19,6 +19,8 @@ Boot sequences usually have only three stages:
1919
1. **Bootloader**: a device can store multiple versions. The boot selector will attempt to hand control to the newest bootloader. If that bootloader is not stable or does not operate at all, the boot selector will hand control to an older version. This protects the device from being bricked by a faulty bootloader.
2020
1. **Application**: follows the exact same logic as the bootloader.
2121

22+
### Bootloader requirements
23+
2224
To allow remote updates, Mbed OS now has a built-in bootloader that meets the following requirements:
2325

2426
* A minimal feature set, to increase the likelihood of correct operation.
@@ -59,7 +61,7 @@ The bootloader is as generic as possible, and relies on a small subset of CMSIS
5961
"Optionally, each stage of the boot sequence could generate tracing output to record progress. Each trace message should mention the boot stage and system time (if available). Each boot stage should also emit trace messages revealing its build version at startup."
6062
-->
6163
62-
### Using the bootloader to manage updates
64+
#### Using the bootloader to manage updates
6365
6466
Mbed OS uses the bootloader and Update client to manage firmware updates. In short, the update client can point to the location of new firmware version for a stage of the bootloader. When the bootloader next runs, each stage will check for new version information for the subsequent stage; if it finds a version pointer "planted" by the Update client, it will hand control to the planted version.
6567
@@ -78,7 +80,7 @@ The bootloader:
7880
1. Writes the firmware into the storage region on the SD card (or external SPI Flash), as a candidate firmware image.
7981
1. Reboots, handing control back to the bootloader.
8082
81-
### Using the bootloader to recover a device
83+
#### Using the bootloader to recover a device
8284
8385
In an upgradeable, multi-stage boot sequence, each boot component (`n`) can accept a new firmware for its "next-stage" (`n+1`), by incorporating the new firmware into its container for available next-stages. To ensure that a device can roll back from faulty updates, however, incorporating a new next-stage (stage `n+1`) firmware by the stage `n` bootloader has the following properties:
8486

0 commit comments

Comments
 (0)