Common bootloader definitions.
Modules | |
GPIO | |
Bootloader GPIO definitions. | |
Serial | |
Common bootloader serial definitions. |
Typedefs | |
typedef uint8_t | BL_Status |
Define the bootloader status type. |
Enumerations | |
enum | { COMM_SERIAL = 0x01, COMM_RADIO = 0x02 } |
Bootloader Status Definitions | |
These are numerical definitions for the possible bootloader status codes. | |
#define | BL_SUCCESS 0U |
Numerical definition for a bootloader status code: Success. | |
#define | BL_CRC_MATCH 2U |
Numerical definition for a bootloader status code: CRC match. | |
#define | BL_IMG_FLASHED 3U |
Numerical definition for a bootloader status code: Image flashed. | |
#define | BL_ERR 1U |
Numerical definition for a bootloader status code: serial error. | |
#define | BL_ERR_MASK 0x40U |
Numerical definition for a bootloader status code: Error mask. | |
#define | BL_ERR_HEADER_EXP 0x41U |
Numerical definition for a bootloader status code: Failed in header state. Header expected. | |
#define | BL_ERR_HEADER_WRITE_CRC 0x42U |
Numerical definition for a bootloader status code: Failed write/CRC of header. | |
#define | BL_ERR_CRC 0x43U |
Numerical definition for a bootloader status code: Failed file CRC. | |
#define | BL_ERR_UNKNOWN_TAG 0x44U |
Numerical definition for a bootloader status code: Unknown tag. | |
#define | BL_ERR_SIG 0x45U |
Numerical definition for a bootloader status code: EBL header error. | |
#define | BL_ERR_ODD_LEN 0x46U |
Numerical definition for a bootloader status code: Trying to flash odd length bytes. | |
#define | BL_ERR_BLOCK_INDEX 0x47U |
Numerical definition for a bootloader status code: Indexed past end of block buffer. | |
#define | BL_ERR_OVWR_BL 0x48U |
Numerical definition for a bootloader status code: Attempt to overwrite bootloader flash. | |
#define | BL_ERR_OVWR_SIMEE 0x49U |
Numerical definition for a bootloader status code: Attempt to overwrite Simulated EEPROM flash. | |
#define | BL_ERR_ERASE_FAIL 0x4AU |
Numerical definition for a bootloader status code: Flash erase failed. | |
#define | BL_ERR_WRITE_FAIL 0x4BU |
Numerical definition for a bootloader status code: Flash write failed. | |
#define | BL_ERR_CRC_LEN 0x4CU |
Numerical definition for a bootloader status code: END tag CRC wrong length. | |
#define | BL_ERR_NO_QUERY 0X4DU |
Numerical definition for a bootloader status code: Received data before query request/response. | |
#define | BL_ERR_BAD_LEN 0x4EU |
Numerical definition for a bootloader status code: Invalid length detected. | |
#define | BL_ERR_TAGBUF 0x4FU |
Numerical definition for a bootloader status code: Problem with tagBuf detected. | |
#define | BL_EBL_CONTINUE 0x50U |
Numerical definition for a bootloader status code: processEbl deferred, call again to continue. | |
#define | BL_ERR_UNEXPECTED_TAG 0x51U |
Numerical definition for a bootloader status code: A known tag was found in an unexpected location (eg. header tag found after data) | |
#define | BL_ERR_UNK_ENC 0x52U |
Numerical definition for a bootloader status code: The specified encryption type is unknown to this bootloader. | |
#define | BL_ERR_INV_KEY 0x53U |
Numerical definition for a bootloader status code: No valid encryption key found on the device (ie. It's all 0xFF's). Bootloader will not function until this key is set. | |
#define | BL_ERR_ENC 0x54U |
Numerical definition for a bootloader status code: Generic error indicating that there was a problem with the encrypted file when decrypting. | |
#define | BL_IBR_ERR_CRC 0x55U |
Numerical definition for a bootloader status code: Failed IBR crc. | |
#define | BL_IBR_ERR_VERS 0x56U |
Numerical definition for a bootloader status code: Incorrect IBR version. | |
#define | BL_IBR_ERR_ADDR 0x57U |
Numerical definition for a bootloader status code: Invalid ebl address in IBR. | |
#define | BL_IBR_ERR_HDR 0x58U |
Numerical definition for a bootloader status code: Incorrect IBR header. |
Bootloader State Flags | |
These are numerical flags for the possible bootloader states. These values are used in the bootloader code for making the current state more verbose.
| |
#define | TIMEOUT 0x16 |
Bootloader state flag. | |
#define | FILEDONE 0x17 |
Bootloader state flag. | |
#define | FILEABORT 0x18 |
Bootloader state flag. | |
#define | BLOCKOK 0x19 |
Bootloader state flag. | |
#define | QUERYFOUND 0x1A |
Bootloader state flag. | |
#define | START_TIMEOUT 0x1B |
Bootloader state flag. | |
#define | BLOCK_TIMEOUT 0x1C |
Bootloader state flag. | |
#define | BLOCKERR_MASK 0x20 |
Bootloader state flag. | |
#define | BLOCKERR_SOH 0x21 |
Bootloader state flag: Start Of Header not received. | |
#define | BLOCKERR_CHK 0x22 |
Bootloader state flag: Sequence of bytes don't match. | |
#define | BLOCKERR_CRCH 0x23 |
Bootloader state flag: CRC High byte failure. | |
#define | BLOCKERR_CRCL 0x24 |
Bootloader state flag: CRC Low byte failure. | |
#define | BLOCKERR_SEQUENCE 0x25 |
Bootloader state flag: Block received out of sequence. | |
#define | BLOCKERR_PARTIAL 0x26 |
Bootloader state flag: Partial block received. | |
#define | BLOCKERR_DUPLICATE 0x27 |
Bootloader state flag: Duplicate of previous block. |
Detailed Description
Common bootloader definitions.
See bootloader-common.h
for source code.
Macro Definition Documentation
#define BL_CRC_MATCH 2U |
Numerical definition for a bootloader status code: CRC match.
#define BL_EBL_CONTINUE 0x50U |
Numerical definition for a bootloader status code: processEbl deferred, call again to continue.
#define BL_ERR 1U |
Numerical definition for a bootloader status code: serial error.
#define BL_ERR_BAD_LEN 0x4EU |
Numerical definition for a bootloader status code: Invalid length detected.
#define BL_ERR_BLOCK_INDEX 0x47U |
Numerical definition for a bootloader status code: Indexed past end of block buffer.
#define BL_ERR_CRC 0x43U |
Numerical definition for a bootloader status code: Failed file CRC.
#define BL_ERR_CRC_LEN 0x4CU |
Numerical definition for a bootloader status code: END tag CRC wrong length.
#define BL_ERR_ENC 0x54U |
Numerical definition for a bootloader status code: Generic error indicating that there was a problem with the encrypted file when decrypting.
#define BL_ERR_ERASE_FAIL 0x4AU |
Numerical definition for a bootloader status code: Flash erase failed.
#define BL_ERR_HEADER_EXP 0x41U |
Numerical definition for a bootloader status code: Failed in header state. Header expected.
#define BL_ERR_HEADER_WRITE_CRC 0x42U |
Numerical definition for a bootloader status code: Failed write/CRC of header.
#define BL_ERR_INV_KEY 0x53U |
Numerical definition for a bootloader status code: No valid encryption key found on the device (ie. It's all 0xFF's). Bootloader will not function until this key is set.
#define BL_ERR_MASK 0x40U |
Numerical definition for a bootloader status code: Error mask.
#define BL_ERR_NO_QUERY 0X4DU |
Numerical definition for a bootloader status code: Received data before query request/response.
#define BL_ERR_ODD_LEN 0x46U |
Numerical definition for a bootloader status code: Trying to flash odd length bytes.
#define BL_ERR_OVWR_BL 0x48U |
Numerical definition for a bootloader status code: Attempt to overwrite bootloader flash.
#define BL_ERR_OVWR_SIMEE 0x49U |
Numerical definition for a bootloader status code: Attempt to overwrite Simulated EEPROM flash.
#define BL_ERR_SIG 0x45U |
Numerical definition for a bootloader status code: EBL header error.
#define BL_ERR_TAGBUF 0x4FU |
Numerical definition for a bootloader status code: Problem with tagBuf detected.
#define BL_ERR_UNEXPECTED_TAG 0x51U |
Numerical definition for a bootloader status code: A known tag was found in an unexpected location (eg. header tag found after data)
#define BL_ERR_UNK_ENC 0x52U |
Numerical definition for a bootloader status code: The specified encryption type is unknown to this bootloader.
#define BL_ERR_UNKNOWN_TAG 0x44U |
Numerical definition for a bootloader status code: Unknown tag.
#define BL_ERR_WRITE_FAIL 0x4BU |
Numerical definition for a bootloader status code: Flash write failed.
#define BL_IBR_ERR_ADDR 0x57U |
Numerical definition for a bootloader status code: Invalid ebl address in IBR.
#define BL_IBR_ERR_CRC 0x55U |
Numerical definition for a bootloader status code: Failed IBR crc.
#define BL_IBR_ERR_HDR 0x58U |
Numerical definition for a bootloader status code: Incorrect IBR header.
#define BL_IBR_ERR_VERS 0x56U |
Numerical definition for a bootloader status code: Incorrect IBR version.
#define BL_IMG_FLASHED 3U |
Numerical definition for a bootloader status code: Image flashed.
#define BL_SUCCESS 0U |
Numerical definition for a bootloader status code: Success.
#define BLOCK_TIMEOUT 0x1C |
Bootloader state flag.
#define BLOCKERR_CHK 0x22 |
Bootloader state flag: Sequence of bytes don't match.
#define BLOCKERR_CRCH 0x23 |
Bootloader state flag: CRC High byte failure.
#define BLOCKERR_CRCL 0x24 |
Bootloader state flag: CRC Low byte failure.
#define BLOCKERR_DUPLICATE 0x27 |
Bootloader state flag: Duplicate of previous block.
#define BLOCKERR_MASK 0x20 |
Bootloader state flag.
#define BLOCKERR_PARTIAL 0x26 |
Bootloader state flag: Partial block received.
#define BLOCKERR_SEQUENCE 0x25 |
Bootloader state flag: Block received out of sequence.
#define BLOCKERR_SOH 0x21 |
Bootloader state flag: Start Of Header not received.
#define BLOCKOK 0x19 |
Bootloader state flag.
#define FILEABORT 0x18 |
Bootloader state flag.
#define FILEDONE 0x17 |
Bootloader state flag.
#define QUERYFOUND 0x1A |
Bootloader state flag.
#define START_TIMEOUT 0x1B |
Bootloader state flag.
#define TIMEOUT 0x16 |
Bootloader state flag.
Typedef Documentation
typedef uint8_t BL_Status |
Define the bootloader status type.