Standalone Bootloader#
Definition of the standalone bootloader interface.
Some functions in this file return an ::EmberStatus value. See error-def.h for definitions of all ::EmberStatus return values.
See bootloader-interface-standalone.h for source code.
Functions#
Detects if the standalone bootloader is installed, and if so returns the installed version.
Quits the current application and launches the standalone bootloader (if installed).
Macros#
Define a numerical value for NO BOOTLOADER mode.
Define a numerical value for the normal bootloader mode.
Define a numerical value for the recovery bootloader mode.
Function Documentation#
halGetStandaloneBootloaderVersion#
uint16_t halGetStandaloneBootloaderVersion (void )
Detects if the standalone bootloader is installed, and if so returns the installed version.
Type | Direction | Argument Name | Description |
---|---|---|---|
void | N/A |
A returned version of 0x1234 would indicate version 1.2 build 34
Returns
BOOTLOADER_INVALID_VERSION if the standalone bootloader is not present, or the version of the installed standalone bootloader.
halLaunchStandaloneBootloader#
EmberStatus halLaunchStandaloneBootloader (uint8_t mode)
Quits the current application and launches the standalone bootloader (if installed).
Type | Direction | Argument Name | Description |
---|---|---|---|
uint8_t | N/A | mode | Controls the mode in which the standalone bootloader will run. See the bootloader Application Note for full details. Options are:
Both modes also allow an image transfer to begin via serial xmodem. |
The function returns an error if the standalone bootloader is not present.
Returns
An ::EmberStatus error if the standalone bootloader is not present, or ::EMBER_SUCCESS.