Definition of the standalone bootloader interface.
Macros | |
#define | NO_BOOTLOADER_MODE 0xFF |
Define a numerical value for NO BOOTLOADER mode. In other words, the bootloader should not be run. | |
#define | STANDALONE_BOOTLOADER_NORMAL_MODE 1 |
Define a numerical value for the normal bootloader mode. | |
#define | STANDALONE_BOOTLOADER_RECOVERY_MODE 0 |
Define a numerical value for the recovery bootloader mode. |
Functions | |
uint16_t | halGetStandaloneBootloaderVersion (void) |
Detects if the standalone bootloader is installed, and if so returns the installed version. | |
EmberStatus | halLaunchStandaloneBootloader (uint8_t mode) |
Quits the current application and launches the standalone bootloader (if installed). The function returns an error if the standalone bootloader is not present. |
Detailed Description
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.
Macro Definition Documentation
#define NO_BOOTLOADER_MODE 0xFF |
#define STANDALONE_BOOTLOADER_NORMAL_MODE 1 |
#define STANDALONE_BOOTLOADER_RECOVERY_MODE 0 |
Function Documentation
uint16_t halGetStandaloneBootloaderVersion | ( | void |
| ) |
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.
EmberStatus halLaunchStandaloneBootloader | ( | uint8_t | mode | ) |
- Parameters
-
mode
Controls the mode in which the standalone bootloader will run. See the bootloader Application Note for full details. Options are: - STANDALONE_BOOTLOADER_NORMAL_MODE Will listen for an over-the-air image transfer on the current channel with current power settings.
- STANDALONE_BOOTLOADER_RECOVERY_MODE Will listen for an over-the-air image transfer on the default channel with default power settings.
- Returns
- An EmberStatus error if the standalone bootloader is not present, or EMBER_SUCCESS.