Bootloader GPIO definitions.

Enumerations

enum  blState_e {
  BL_ST_UP,
  BL_ST_DOWN,
  BL_ST_POLLING_LOOP,
  BL_ST_DOWNLOAD_LOOP,
  BL_ST_DOWNLOAD_FAILURE,
  BL_ST_DOWNLOAD_SUCCESS
}
 Defines various bootloader states. Use in LED code to signal bootload activity.

Functions

void bootloadGpioInit (void)
 Initialize GPIO.
 
void bootloadStateIndicator (enum blState_e state)
 Helper function used for displaying bootloader state (for example: with LEDs).
 
bool bootloadForceActivation (void)
 Force activation of bootloader.

State Indicator Macros

The bootloader indicates which state it is in by calling these // macros. Map them to the ::halBootloadStateIndicator function // (in bootloder-gpio.c) if you want to display that bootloader state. // Used to blink the LED's or otherwise signal bootloader activity.

#define BL_STATE_UP()   do { bootloadStateIndicator(BL_ST_UP); } while (0)
 Finished init sequence, ready for bootload.
 
#define BL_STATE_DOWN()   do { bootloadStateIndicator(BL_ST_DOWN); } while (0)
 Called right before bootloader resets to application. Use to cleanup and reset GPIO's to leave node in known state for app start, if necessary.
 
#define BL_STATE_POLLING_LOOP()   do { bootloadStateIndicator(BL_ST_POLLING_LOOP); } while (0)
 Standalone bootloader polling serial/radio interface.
 
#define BL_STATE_DOWNLOAD_LOOP()   do { bootloadStateIndicator(BL_ST_DOWNLOAD_LOOP); } while (0)
 Processing download image.
 
#define BL_STATE_DOWNLOAD_SUCCESS()   do { bootloadStateIndicator(BL_ST_DOWNLOAD_SUCCESS); } while (0)
 Download process was a success.
 
#define BL_STATE_DOWNLOAD_FAILURE()   do { bootloadStateIndicator(BL_ST_DOWNLOAD_FAILURE); } while (0)
 Download process failed.

Detailed Description

See bootloader-gpio.h for source code.

Macro Definition Documentation

#define BL_STATE_DOWN ( )    do { bootloadStateIndicator(BL_ST_DOWN); } while (0)
#define BL_STATE_DOWNLOAD_FAILURE ( )    do { bootloadStateIndicator(BL_ST_DOWNLOAD_FAILURE); } while (0)
#define BL_STATE_DOWNLOAD_LOOP ( )    do { bootloadStateIndicator(BL_ST_DOWNLOAD_LOOP); } while (0)
#define BL_STATE_DOWNLOAD_SUCCESS ( )    do { bootloadStateIndicator(BL_ST_DOWNLOAD_SUCCESS); } while (0)
#define BL_STATE_POLLING_LOOP ( )    do { bootloadStateIndicator(BL_ST_POLLING_LOOP); } while (0)
#define BL_STATE_UP ( )    do { bootloadStateIndicator(BL_ST_UP); } while (0)

Enumeration Type Documentation

enum blState_e
Enumerator
BL_ST_UP 

bootloader up

BL_ST_DOWN 

bootloader going down

BL_ST_POLLING_LOOP 

polling interfaces

BL_ST_DOWNLOAD_LOOP 

downloading

BL_ST_DOWNLOAD_FAILURE 

download failure

BL_ST_DOWNLOAD_SUCCESS 

download success

Function Documentation

bool bootloadForceActivation ( void  )
void bootloadGpioInit ( void  )
void bootloadStateIndicator ( enum blState_e  state)