GBL Format#
Modules#
Macros#
Magic word indicating GBL image.
Major version of the GBL spec.
Tag ID for the GBL header tag.
Tag ID for the GBL bootloader tag.
Tag ID for the GBL application info tag.
Tag ID for the GBL metadata tag.
Tag ID for the GBL flash program tag.
Tag ID for the GBL flash program tag (LZ4)
Tag ID for the GBL flash program tag (LZMA)
Tag ID for the GBL flash erase&program tag.
Tag ID for the GBL delta dfu tag.
Tag ID for the GBL delta dfu tag (LZ4)
Tag ID for the GBL delta dfu tag (LZMA)
Tag ID for the GBL end tag.
Tag ID for the SE upgrade tag.
Tag ID for the version dependency tag.
Tag ID for the GBL encryption header tag.
Tag ID for the GBL encryption init tag.
Tag ID for the GBL encryption data tag.
Tag ID for the GBL ECDSA secp256r1 signature tag.
Tag ID for the GBL ECDSA certfificate tag.
GBL type: Standard GBL.
GBL type: AES-CCM encrypted GBL.
GBL type: ECDSA P256-signed GBL.
Image Type : Application Image.
Image Type : Bootloader Image.
Image Type : Secure Engine Image.
Operator encoding : Operator Mask.
Operator encoding : Operator Shift.
Operator encoding : Operator Type Mask.
Operator encoding : Negator Bit mask.
GBL Version Dependency Operator LT.
GBL Version Dependency Operator LEQ.
GBL Version Dependency Operator EQ.
GBL Version Dependency Operator GEQ.
GBL Version Dependency Operator GT.
Connective encoding : Connective Encoding Mask.
Connective encoding : Encoding Shift.
Connective encoding : Encoding Type Mask.
Connective encoding : Negator Bit Mask.
Connective AND Mask.
Connective OR Mask.
SE version mask for ignoring the compatibility byte when comparing versions.
Tag order.
GBL Tag Order Header.
GBL Tag Order Version Dependency.
GBL Tag Order encoding Init.
GBL Tag Order Application.
GBL Tag Order SE Upgarde.
GBL Tag Order Bootloader.
The Programming and Metadata tags share the same order.
GBL Tag Order Enc GBL Data.
GBL Tag Order Certificate.
GBL Tag Order Signature.
GBL_TAG_ORDER_END must always be strictly greater than any other tag order.
Flags.
Flags.
Macro Definition Documentation#
GBL_IMAGE_MAGIC_WORD#
#define GBL_IMAGE_MAGIC_WORDValue:
0xE35050E3UL
Magic word indicating GBL image.
41 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_COMPATIBILITY_MAJOR_VERSION#
#define GBL_COMPATIBILITY_MAJOR_VERSIONValue:
0x03000000UL
Major version of the GBL spec.
43 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_TAG_ID_HEADER_V3#
#define GBL_TAG_ID_HEADER_V3Value:
0x03A617EBUL
Tag ID for the GBL header tag.
49 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_TAG_ID_BOOTLOADER#
#define GBL_TAG_ID_BOOTLOADERValue:
0xF50909F5UL
Tag ID for the GBL bootloader tag.
51 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_TAG_ID_APPLICATION#
#define GBL_TAG_ID_APPLICATIONValue:
0xF40A0AF4UL
Tag ID for the GBL application info tag.
53 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_TAG_ID_METADATA#
#define GBL_TAG_ID_METADATAValue:
0xF60808F6UL
Tag ID for the GBL metadata tag.
55 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_TAG_ID_PROG#
#define GBL_TAG_ID_PROGValue:
0xFE0101FEUL
Tag ID for the GBL flash program tag.
57 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_TAG_ID_PROG_LZ4#
#define GBL_TAG_ID_PROG_LZ4Value:
0xFD0505FDUL
Tag ID for the GBL flash program tag (LZ4)
59 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_TAG_ID_PROG_LZMA#
#define GBL_TAG_ID_PROG_LZMAValue:
0xFD0707FDUL
Tag ID for the GBL flash program tag (LZMA)
61 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_TAG_ID_ERASEPROG#
#define GBL_TAG_ID_ERASEPROGValue:
0xFD0303FDUL
Tag ID for the GBL flash erase&program tag.
63 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_TAG_ID_DELTA#
#define GBL_TAG_ID_DELTAValue:
0xF80A0AF8UL
Tag ID for the GBL delta dfu tag.
65 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_TAG_ID_DELTA_LZ4#
#define GBL_TAG_ID_DELTA_LZ4Value:
0xF80B0BF8UL
Tag ID for the GBL delta dfu tag (LZ4)
67 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_TAG_ID_DELTA_LZMA#
#define GBL_TAG_ID_DELTA_LZMAValue:
0xF80C0CF8UL
Tag ID for the GBL delta dfu tag (LZMA)
69 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_TAG_ID_END#
#define GBL_TAG_ID_ENDValue:
0xFC0404FCUL
Tag ID for the GBL end tag.
71 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_TAG_ID_SE_UPGRADE#
#define GBL_TAG_ID_SE_UPGRADEValue:
0x5EA617EBUL
Tag ID for the SE upgrade tag.
73 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_TAG_ID_VERSION_DEPENDENCY#
#define GBL_TAG_ID_VERSION_DEPENDENCYValue:
0x76A617EBUL
Tag ID for the version dependency tag.
75 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_TAG_ID_ENC_HEADER#
#define GBL_TAG_ID_ENC_HEADERValue:
0xFB0505FBUL
Tag ID for the GBL encryption header tag.
79 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_TAG_ID_ENC_INIT#
#define GBL_TAG_ID_ENC_INITValue:
0xFA0606FAUL
Tag ID for the GBL encryption init tag.
81 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_TAG_ID_ENC_GBL_DATA#
#define GBL_TAG_ID_ENC_GBL_DATAValue:
0xF90707F9UL
Tag ID for the GBL encryption data tag.
83 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_TAG_ID_SIGNATURE_ECDSA_P256#
#define GBL_TAG_ID_SIGNATURE_ECDSA_P256Value:
0xF70A0AF7UL
Tag ID for the GBL ECDSA secp256r1 signature tag.
87 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_TAG_ID_CERTIFICATE_ECDSA_P256#
#define GBL_TAG_ID_CERTIFICATE_ECDSA_P256Value:
0xF30B0BF3UL
Tag ID for the GBL ECDSA certfificate tag.
89 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_TYPE_NONE#
#define GBL_TYPE_NONEValue:
0x00000000UL
GBL type: Standard GBL.
95 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_TYPE_ENCRYPTION_AESCCM#
#define GBL_TYPE_ENCRYPTION_AESCCMValue:
0x00000001UL
GBL type: AES-CCM encrypted GBL.
97 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_TYPE_SIGNATURE_ECDSA#
#define GBL_TYPE_SIGNATURE_ECDSAValue:
0x00000100UL
GBL type: ECDSA P256-signed GBL.
99 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_VERSION_DEPENDENCY_TYPE_APPLICATION#
#define GBL_VERSION_DEPENDENCY_TYPE_APPLICATIONValue:
0x01U
Image Type : Application Image.
105 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_VERSION_DEPENDENCY_TYPE_BOOTLOADER#
#define GBL_VERSION_DEPENDENCY_TYPE_BOOTLOADERValue:
0x02U
Image Type : Bootloader Image.
107 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_VERSION_DEPENDENCY_TYPE_SE#
#define GBL_VERSION_DEPENDENCY_TYPE_SEValue:
0x03U
Image Type : Secure Engine Image.
109 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_VERSION_DEPENDENCY_OPERATOR_MASK#
#define GBL_VERSION_DEPENDENCY_OPERATOR_MASKValue:
0x0FU
Operator encoding : Operator Mask.
112 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_VERSION_DEPENDENCY_OPERATOR_SHIFT#
#define GBL_VERSION_DEPENDENCY_OPERATOR_SHIFTValue:
0x00U
Operator encoding : Operator Shift.
114 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_VERSION_DEPENDENCY_OPERATOR_TYPE_MASK#
#define GBL_VERSION_DEPENDENCY_OPERATOR_TYPE_MASKValue:
0x0EU
Operator encoding : Operator Type Mask.
116 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_VERSION_DEPENDENCY_OPERATOR_NEGATOR_BIT_MASK#
#define GBL_VERSION_DEPENDENCY_OPERATOR_NEGATOR_BIT_MASKValue:
0x01U
Operator encoding : Negator Bit mask.
118 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_VERSION_DEPENDENCY_OPERATOR_LT#
#define GBL_VERSION_DEPENDENCY_OPERATOR_LTValue:
0x00U
GBL Version Dependency Operator LT.
121 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_VERSION_DEPENDENCY_OPERATOR_LEQ#
#define GBL_VERSION_DEPENDENCY_OPERATOR_LEQValue:
0x02U
GBL Version Dependency Operator LEQ.
123 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_VERSION_DEPENDENCY_OPERATOR_EQ#
#define GBL_VERSION_DEPENDENCY_OPERATOR_EQValue:
0x04U
GBL Version Dependency Operator EQ.
125 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_VERSION_DEPENDENCY_OPERATOR_GEQ#
#define GBL_VERSION_DEPENDENCY_OPERATOR_GEQValue:
0x06U
GBL Version Dependency Operator GEQ.
127 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_VERSION_DEPENDENCY_OPERATOR_GT#
#define GBL_VERSION_DEPENDENCY_OPERATOR_GTValue:
0x08U
GBL Version Dependency Operator GT.
129 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_VERSION_DEPENDENCY_CONNECTIVE_MASK#
#define GBL_VERSION_DEPENDENCY_CONNECTIVE_MASKValue:
0xF0U
Connective encoding : Connective Encoding Mask.
132 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_VERSION_DEPENDENCY_CONNECTIVE_SHIFT#
#define GBL_VERSION_DEPENDENCY_CONNECTIVE_SHIFTValue:
0x04U
Connective encoding : Encoding Shift.
134 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_VERSION_DEPENDENCY_CONNECTIVE_TYPE_MASK#
#define GBL_VERSION_DEPENDENCY_CONNECTIVE_TYPE_MASKValue:
0x0EU
Connective encoding : Encoding Type Mask.
136 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_VERSION_DEPENDENCY_CONNECTIVE_NEGATOR_BIT_MASK#
#define GBL_VERSION_DEPENDENCY_CONNECTIVE_NEGATOR_BIT_MASKValue:
0x01U
Connective encoding : Negator Bit Mask.
138 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_VERSION_DEPENDENCY_CONNECTIVE_AND#
#define GBL_VERSION_DEPENDENCY_CONNECTIVE_ANDValue:
0x00U
Connective AND Mask.
141 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_VERSION_DEPENDENCY_CONNECTIVE_OR#
#define GBL_VERSION_DEPENDENCY_CONNECTIVE_ORValue:
0x02U
Connective OR Mask.
143 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_VERSION_DEPENDENCY_SE_VERSION_MASK#
#define GBL_VERSION_DEPENDENCY_SE_VERSION_MASKValue:
0x00FFFFFFUL
SE version mask for ignoring the compatibility byte when comparing versions.
146 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_TAG_ORDER_INIT#
#define GBL_TAG_ORDER_INITValue:
0U
Tag order.
155 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_TAG_ORDER_HEADER_V3#
#define GBL_TAG_ORDER_HEADER_V3Value:
1U
GBL Tag Order Header.
157 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_TAG_ORDER_VERSION_DEPENDENCY#
#define GBL_TAG_ORDER_VERSION_DEPENDENCYValue:
2U
GBL Tag Order Version Dependency.
159 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_TAG_ORDER_ENC_INIT#
#define GBL_TAG_ORDER_ENC_INITValue:
4U
GBL Tag Order encoding Init.
161 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_TAG_ORDER_APPLICATION#
#define GBL_TAG_ORDER_APPLICATIONValue:
5U
GBL Tag Order Application.
163 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_TAG_ORDER_SE_UPGRADE#
#define GBL_TAG_ORDER_SE_UPGRADEValue:
6U
GBL Tag Order SE Upgarde.
173 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_TAG_ORDER_BOOTLOADER#
#define GBL_TAG_ORDER_BOOTLOADERValue:
7U
GBL Tag Order Bootloader.
177 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_TAG_ORDER_PROG_AND_METADATA#
#define GBL_TAG_ORDER_PROG_AND_METADATAValue:
8U
The Programming and Metadata tags share the same order.
179 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_TAG_ORDER_ENC_GBL_DATA#
#define GBL_TAG_ORDER_ENC_GBL_DATAValue:
9U
GBL Tag Order Enc GBL Data.
181 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_TAG_ORDER_CERTIFICATE#
#define GBL_TAG_ORDER_CERTIFICATEValue:
10U
GBL Tag Order Certificate.
183 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_TAG_ORDER_SIGNATURE#
#define GBL_TAG_ORDER_SIGNATUREValue:
11U
GBL Tag Order Signature.
185 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_TAG_ORDER_END#
#define GBL_TAG_ORDER_ENDValue:
12U
GBL_TAG_ORDER_END must always be strictly greater than any other tag order.
187 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_TAG_FLAG_SINGLE_OCCURRENCE_ONLY#
#define GBL_TAG_FLAG_SINGLE_OCCURRENCE_ONLYValue:
(1UL << 0)
Flags.
190 of file platform/bootloader/parser/gbl/btl_gbl_format.hGBL_TAG_FLAG_ALWAYS_UNENCRYPTED#
#define GBL_TAG_FLAG_ALWAYS_UNENCRYPTEDValue:
(1UL << 1)
Flags.
192 of file platform/bootloader/parser/gbl/btl_gbl_format.h