Standalone#
EM35x standalone bootloader public definitions.
See standalone-bootloader.h for source code.
Required Custom Functions#
This function must be implemented, providing a bootloader menu.
Available Bootloader Library Functions#
Functions implemented by the bootloader library that may be used by custom functions.
Puts the bootloader into a mode where it will receive an image. commState indicates whether the image is received via serial (COMM_SERIAL) or over the air (COMM_RADIO)
A hook to the bootloader library for it to check for extra menu options. Only used for ember internal debug builds, not normally needed.
Initialize OTA Bootloader state.
Check to see if the bootloader has detected an OTA upload start.
Puts the bootloader into a mode where it will receive an image over the air. The function checkOtaStart() should have been called first and it should have returned with a status of BL_SUCCESS before calling this function.
Uses the information in the PHY_CONFIG token to determine if a power amplifier is present in the node design.
Validate application integrity by running AES-MMO hash and comparing to AAT.
Required Custom Functions Documentation#
bootloaderMenu
void bootloaderMenu (void )
This function must be implemented, providing a bootloader menu.
N/A |
35
of file /Users/vihuszar/Git/EmbeddedSoftware/super/platform/base/hal/micro/cortexm3/common/standalone-bootloader.h
Available Bootloader Library Functions Documentation#
receiveImage#
BL_Status receiveImage (uint8_t commState)
Puts the bootloader into a mode where it will receive an image. commState indicates whether the image is received via serial (COMM_SERIAL) or over the air (COMM_RADIO)
N/A | commState |
51
of file /Users/vihuszar/Git/EmbeddedSoftware/super/platform/base/hal/micro/cortexm3/common/standalone-bootloader.h
checkDebugMenuOption
bool checkDebugMenuOption (uint8_t ch)
A hook to the bootloader library for it to check for extra menu options. Only used for ember internal debug builds, not normally needed.
N/A | ch |
Returns
true if the option was handled, false if not.
58
of file /Users/vihuszar/Git/EmbeddedSoftware/super/platform/base/hal/micro/cortexm3/common/standalone-bootloader.h
initOtaState#
BL_Status initOtaState (void )
Initialize OTA Bootloader state.
N/A |
Note
OTA support hooks are subject to change!
Returns
BL_Status of the success of the function.
65
of file /Users/vihuszar/Git/EmbeddedSoftware/super/platform/base/hal/micro/cortexm3/common/standalone-bootloader.h
checkOtaStart#
BL_Status checkOtaStart (void )
Check to see if the bootloader has detected an OTA upload start.
N/A |
Note
OTA support hooks are subject to change!
Returns
BL_Status of the success of the function.
72
of file /Users/vihuszar/Git/EmbeddedSoftware/super/platform/base/hal/micro/cortexm3/common/standalone-bootloader.h
receiveOtaImage#
BL_Status receiveOtaImage (void )
Puts the bootloader into a mode where it will receive an image over the air. The function checkOtaStart() should have been called first and it should have returned with a status of BL_SUCCESS before calling this function.
N/A |
Note
OTA support hooks are subject to change!
Returns
BL_Status of the success of the function.
82
of file /Users/vihuszar/Git/EmbeddedSoftware/super/platform/base/hal/micro/cortexm3/common/standalone-bootloader.h
paIsPresent#
bool paIsPresent (void )
Uses the information in the PHY_CONFIG token to determine if a power amplifier is present in the node design.
N/A |
Note
This function must not be called before emBootloaderRadioBoot().
Returns
true if a power amplifier is present, false otherwise.
91
of file /Users/vihuszar/Git/EmbeddedSoftware/super/platform/base/hal/micro/cortexm3/common/standalone-bootloader.h
halCheckIntegrity#
bool halCheckIntegrity (void )
Validate application integrity by running AES-MMO hash and comparing to AAT.
N/A |
Returns
false if fails integrity check, true if pass
98
of file /Users/vihuszar/Git/EmbeddedSoftware/super/platform/base/hal/micro/cortexm3/common/standalone-bootloader.h