Modules#
GBL Format#
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 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.h
GBL_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.h
GBL_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.h
GBL_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.h
GBL_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.h
GBL_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.h
GBL_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.h
GBL_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.h
GBL_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.h
GBL_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.h
GBL_TAG_ID_END#
#define GBL_TAG_ID_ENDValue:
0xFC0404FCUL
Tag ID for the GBL end tag.
65
of file platform/bootloader/parser/gbl/btl_gbl_format.h
GBL_TAG_ID_SE_UPGRADE#
#define GBL_TAG_ID_SE_UPGRADEValue:
0x5EA617EBUL
Tag ID for the SE upgrade tag.
67
of file platform/bootloader/parser/gbl/btl_gbl_format.h
GBL_TAG_ID_VERSION_DEPENDENCY#
#define GBL_TAG_ID_VERSION_DEPENDENCYValue:
0x76A617EBUL
Tag ID for the version dependency tag.
69
of file platform/bootloader/parser/gbl/btl_gbl_format.h
GBL_TAG_ID_ENC_HEADER#
#define GBL_TAG_ID_ENC_HEADERValue:
0xFB0505FBUL
Tag ID for the GBL encryption header tag.
73
of file platform/bootloader/parser/gbl/btl_gbl_format.h
GBL_TAG_ID_ENC_INIT#
#define GBL_TAG_ID_ENC_INITValue:
0xFA0606FAUL
Tag ID for the GBL encryption init tag.
75
of file platform/bootloader/parser/gbl/btl_gbl_format.h
GBL_TAG_ID_ENC_GBL_DATA#
#define GBL_TAG_ID_ENC_GBL_DATAValue:
0xF90707F9UL
Tag ID for the GBL encryption data tag.
77
of file platform/bootloader/parser/gbl/btl_gbl_format.h
GBL_TAG_ID_SIGNATURE_ECDSA_P256#
#define GBL_TAG_ID_SIGNATURE_ECDSA_P256Value:
0xF70A0AF7UL
Tag ID for the GBL ECDSA secp256r1 signature tag.
81
of file platform/bootloader/parser/gbl/btl_gbl_format.h
GBL_TAG_ID_CERTIFICATE_ECDSA_P256#
#define GBL_TAG_ID_CERTIFICATE_ECDSA_P256Value:
0xF30B0BF3UL
Tag ID for the GBL ECDSA certfificate tag.
83
of file platform/bootloader/parser/gbl/btl_gbl_format.h
GBL_TYPE_NONE#
#define GBL_TYPE_NONEValue:
0x00000000UL
GBL type: Standard GBL.
89
of file platform/bootloader/parser/gbl/btl_gbl_format.h
GBL_TYPE_ENCRYPTION_AESCCM#
#define GBL_TYPE_ENCRYPTION_AESCCMValue:
0x00000001UL
GBL type: AES-CCM encrypted GBL.
91
of file platform/bootloader/parser/gbl/btl_gbl_format.h
GBL_TYPE_SIGNATURE_ECDSA#
#define GBL_TYPE_SIGNATURE_ECDSAValue:
0x00000100UL
GBL type: ECDSA P256-signed GBL.
93
of file platform/bootloader/parser/gbl/btl_gbl_format.h
GBL_VERSION_DEPENDENCY_TYPE_APPLICATION#
#define GBL_VERSION_DEPENDENCY_TYPE_APPLICATIONValue:
0x01U
Image Type : Application Image.
99
of file platform/bootloader/parser/gbl/btl_gbl_format.h
GBL_VERSION_DEPENDENCY_TYPE_BOOTLOADER#
#define GBL_VERSION_DEPENDENCY_TYPE_BOOTLOADERValue:
0x02U
Image Type : Bootloader Image.
101
of file platform/bootloader/parser/gbl/btl_gbl_format.h
GBL_VERSION_DEPENDENCY_TYPE_SE#
#define GBL_VERSION_DEPENDENCY_TYPE_SEValue:
0x03U
Image Type : Secure Engine Image.
103
of file platform/bootloader/parser/gbl/btl_gbl_format.h
GBL_VERSION_DEPENDENCY_OPERATOR_MASK#
#define GBL_VERSION_DEPENDENCY_OPERATOR_MASKValue:
0x0FU
Operator encoding : Operator Mask.
106
of file platform/bootloader/parser/gbl/btl_gbl_format.h
GBL_VERSION_DEPENDENCY_OPERATOR_SHIFT#
#define GBL_VERSION_DEPENDENCY_OPERATOR_SHIFTValue:
0x00U
Operator encoding : Operator Shift.
108
of file platform/bootloader/parser/gbl/btl_gbl_format.h
GBL_VERSION_DEPENDENCY_OPERATOR_TYPE_MASK#
#define GBL_VERSION_DEPENDENCY_OPERATOR_TYPE_MASKValue:
0x0EU
Operator encoding : Operator Type Mask.
110
of file platform/bootloader/parser/gbl/btl_gbl_format.h
GBL_VERSION_DEPENDENCY_OPERATOR_NEGATOR_BIT_MASK#
#define GBL_VERSION_DEPENDENCY_OPERATOR_NEGATOR_BIT_MASKValue:
0x01U
Operator encoding : Negator Bit mask.
112
of file platform/bootloader/parser/gbl/btl_gbl_format.h
GBL_VERSION_DEPENDENCY_OPERATOR_LT#
#define GBL_VERSION_DEPENDENCY_OPERATOR_LTValue:
0x00U
GBL Version Dependency Operator LT.
115
of file platform/bootloader/parser/gbl/btl_gbl_format.h
GBL_VERSION_DEPENDENCY_OPERATOR_LEQ#
#define GBL_VERSION_DEPENDENCY_OPERATOR_LEQValue:
0x02U
GBL Version Dependency Operator LEQ.
117
of file platform/bootloader/parser/gbl/btl_gbl_format.h
GBL_VERSION_DEPENDENCY_OPERATOR_EQ#
#define GBL_VERSION_DEPENDENCY_OPERATOR_EQValue:
0x04U
GBL Version Dependency Operator EQ.
119
of file platform/bootloader/parser/gbl/btl_gbl_format.h
GBL_VERSION_DEPENDENCY_OPERATOR_GEQ#
#define GBL_VERSION_DEPENDENCY_OPERATOR_GEQValue:
0x06U
GBL Version Dependency Operator GEQ.
121
of file platform/bootloader/parser/gbl/btl_gbl_format.h
GBL_VERSION_DEPENDENCY_OPERATOR_GT#
#define GBL_VERSION_DEPENDENCY_OPERATOR_GTValue:
0x08U
GBL Version Dependency Operator GT.
123
of file platform/bootloader/parser/gbl/btl_gbl_format.h
GBL_VERSION_DEPENDENCY_CONNECTIVE_MASK#
#define GBL_VERSION_DEPENDENCY_CONNECTIVE_MASKValue:
0xF0U
Connective encoding : Connective Encoding Mask.
126
of file platform/bootloader/parser/gbl/btl_gbl_format.h
GBL_VERSION_DEPENDENCY_CONNECTIVE_SHIFT#
#define GBL_VERSION_DEPENDENCY_CONNECTIVE_SHIFTValue:
0x04U
Connective encoding : Encoding Shift.
128
of file platform/bootloader/parser/gbl/btl_gbl_format.h
GBL_VERSION_DEPENDENCY_CONNECTIVE_TYPE_MASK#
#define GBL_VERSION_DEPENDENCY_CONNECTIVE_TYPE_MASKValue:
0x0EU
Connective encoding : Encoding Type Mask.
130
of file platform/bootloader/parser/gbl/btl_gbl_format.h
GBL_VERSION_DEPENDENCY_CONNECTIVE_NEGATOR_BIT_MASK#
#define GBL_VERSION_DEPENDENCY_CONNECTIVE_NEGATOR_BIT_MASKValue:
0x01U
Connective encoding : Negator Bit Mask.
132
of file platform/bootloader/parser/gbl/btl_gbl_format.h
GBL_VERSION_DEPENDENCY_CONNECTIVE_AND#
#define GBL_VERSION_DEPENDENCY_CONNECTIVE_ANDValue:
0x00U
Connective AND Mask.
135
of file platform/bootloader/parser/gbl/btl_gbl_format.h
GBL_VERSION_DEPENDENCY_CONNECTIVE_OR#
#define GBL_VERSION_DEPENDENCY_CONNECTIVE_ORValue:
0x02U
Connective OR Mask.
137
of file platform/bootloader/parser/gbl/btl_gbl_format.h
GBL_VERSION_DEPENDENCY_SE_VERSION_MASK#
#define GBL_VERSION_DEPENDENCY_SE_VERSION_MASKValue:
0x00FFFFFFUL
SE version mask for ignoring the compatibility byte when comparing versions.
140
of file platform/bootloader/parser/gbl/btl_gbl_format.h
GBL_TAG_ORDER_INIT#
#define GBL_TAG_ORDER_INITValue:
0U
Tag order.
149
of file platform/bootloader/parser/gbl/btl_gbl_format.h
GBL_TAG_ORDER_HEADER_V3#
#define GBL_TAG_ORDER_HEADER_V3Value:
1U
GBL Tag Order Header.
151
of file platform/bootloader/parser/gbl/btl_gbl_format.h
GBL_TAG_ORDER_VERSION_DEPENDENCY#
#define GBL_TAG_ORDER_VERSION_DEPENDENCYValue:
2U
GBL Tag Order Version Dependency.
153
of file platform/bootloader/parser/gbl/btl_gbl_format.h
GBL_TAG_ORDER_ENC_INIT#
#define GBL_TAG_ORDER_ENC_INITValue:
4U
GBL Tag Order encoding Init.
155
of file platform/bootloader/parser/gbl/btl_gbl_format.h
GBL_TAG_ORDER_APPLICATION#
#define GBL_TAG_ORDER_APPLICATIONValue:
5U
GBL Tag Order Application.
157
of file platform/bootloader/parser/gbl/btl_gbl_format.h
GBL_TAG_ORDER_SE_UPGRADE#
#define GBL_TAG_ORDER_SE_UPGRADEValue:
6U
GBL Tag Order SE Upgarde.
167
of file platform/bootloader/parser/gbl/btl_gbl_format.h
GBL_TAG_ORDER_BOOTLOADER#
#define GBL_TAG_ORDER_BOOTLOADERValue:
7U
GBL Tag Order Bootloader.
171
of file platform/bootloader/parser/gbl/btl_gbl_format.h
GBL_TAG_ORDER_PROG_AND_METADATA#
#define GBL_TAG_ORDER_PROG_AND_METADATAValue:
8U
The Programming and Metadata tags share the same order.
173
of file platform/bootloader/parser/gbl/btl_gbl_format.h
GBL_TAG_ORDER_ENC_GBL_DATA#
#define GBL_TAG_ORDER_ENC_GBL_DATAValue:
9U
GBL Tag Order Enc GBL Data.
175
of file platform/bootloader/parser/gbl/btl_gbl_format.h
GBL_TAG_ORDER_CERTIFICATE#
#define GBL_TAG_ORDER_CERTIFICATEValue:
10U
GBL Tag Order Certificate.
177
of file platform/bootloader/parser/gbl/btl_gbl_format.h
GBL_TAG_ORDER_SIGNATURE#
#define GBL_TAG_ORDER_SIGNATUREValue:
11U
GBL Tag Order Signature.
179
of file platform/bootloader/parser/gbl/btl_gbl_format.h
GBL_TAG_ORDER_END#
#define GBL_TAG_ORDER_ENDValue:
12U
GBL_TAG_ORDER_END must always be strictly greater than any other tag order.
181
of file platform/bootloader/parser/gbl/btl_gbl_format.h
GBL_TAG_FLAG_SINGLE_OCCURRENCE_ONLY#
#define GBL_TAG_FLAG_SINGLE_OCCURRENCE_ONLYValue:
(1UL << 0)
Flags.
184
of file platform/bootloader/parser/gbl/btl_gbl_format.h
GBL_TAG_FLAG_ALWAYS_UNENCRYPTED#
#define GBL_TAG_FLAG_ALWAYS_UNENCRYPTEDValue:
(1UL << 1)
Flags.
186
of file platform/bootloader/parser/gbl/btl_gbl_format.h