1 of 1

(7/30/26 Draft Version) Certificate Store

Secured

File

Type

File Type

Version

File

Subtype

File

Index

Remark

Get: N/A

Set: No

0xD811 (Secured)
0xD812 (Unsecured)

Host App may send the following files to the device:

0xD821

Host App may fetch the following files from the device:

0xD831

Host App may delete the following files from the device:

Example #1

The subtype 0x00 VICAL certificates will be loaded into the unit, starts from entry #00 to #29.

Example #2

The subtype 0x01 individual certificates will be loaded into the unit, starts from entry #30 to #44.

The size of an entry (CERT_REC_T) is 32 bytes, so the entire store (CERT_STORE_T) has 32x45 = 1440 bytes.

Host Application may fetch the file of “Certificate Store Table” with File ID:0A-00-02-00. Then, decode and display the contents of the file as follows: (4 certificates in this case)

Scanning input file: cert_table.bin.

The input file size = 1440 bytes.
Data Structure & File Size match.

(7/30/26 Draft Version) Certificate Store

Secured

File

Type

File Type

Version

File

Subtype

File

Index

Remark

Get: N/A

Set: No

0xD811 (Secured)
0xD812 (Unsecured)

Host App may send the following files to the device:

0xD821

Host App may fetch the following files from the device:

0xD831

Host App may delete the following files from the device:

Example #1

The subtype 0x00 VICAL certificates will be loaded into the unit, starts from entry #00 to #29.

Example #2

The subtype 0x01 individual certificates will be loaded into the unit, starts from entry #30 to #44.

The size of an entry (CERT_REC_T) is 32 bytes, so the entire store (CERT_STORE_T) has 32x45 = 1440 bytes.

Host Application may fetch the file of “Certificate Store Table” with File ID:0A-00-02-00. Then, decode and display the contents of the file as follows: (4 certificates in this case)

Scanning input file: cert_table.bin.

The input file size = 1440 bytes.
Data Structure & File Size match.

typedef struct
{
    uint16_t year;
    uint16_t mon;
    uint8_t  day;
    uint8_t  hour;
    uint8_t  min;
    uint8_t  sec;
} MDL_CERT_TIME;

typedef struct                  // 32 bytes total
{
    uint8_t  status[2];          // ACTIVE or empty
    uint8_t  ski[8];             // subject key identifier
    uint8_t  region[6];          // example: US-CA
    MDL_CERT_TIME from_time;     // not before time in RTC format
    MDL_CERT_TIME to_time;       // not after time in RTC format
} CERT_REC_T;

#define CERT_STORE_MAX_CNT       45      // the max number of entries in CERT Store

typedef struct
{
    CERT_REC_T entry[CERT_STORE_MAX_CNT];
} CERT_STORE_T;

NOTE 1: If users delete the VICAL file (0A-00-00-00), then FW will delete all the VICAL certificates.

NOTE 2: If users delete the CERT Store Table file (0A-00-02-00), then FW will delete all the certificates.

Example: 0xD831 command string to delete CERT Store Table

For AB4.10 & older images: Use File ID: 0A-00-01-00

For AB4.11 & newer images: Use File ID: 0A-00-02-00

AA0081040105D8318408D83181040A000100 // for AB4.10 & older images

AA 00 // Header

81 04 01 05 D8 31 // P1, 0xD831 Command, Msg ID 05

84 08 D8 31 // P4, Len=8

81 04 0A 00 01 00 // P4->P1, File ID=0x0A000100

typedef struct
{
    uint16_t year;
    uint16_t mon;
    uint8_t  day;
    uint8_t  hour;
    uint8_t  min;
    uint8_t  sec;
} MDL_CERT_TIME;

typedef struct                  // 32 bytes total
{
    uint8_t  status[2];          // ACTIVE or empty
    uint8_t  ski[8];             // subject key identifier
    uint8_t  region[6];          // example: US-CA
    MDL_CERT_TIME from_time;     // not before time in RTC format
    MDL_CERT_TIME to_time;       // not after time in RTC format
} CERT_REC_T;

#define CERT_STORE_MAX_CNT       45      // the max number of entries in CERT Store

typedef struct
{
    CERT_REC_T entry[CERT_STORE_MAX_CNT];
} CERT_STORE_T;

(7/30/26 Draft Version) Certificate Store

(7/30/26 Draft Version) Certificate Store

Send File

Fetch File

Delete File

Script file to load certificate to unit

The data structures of CERT_STORE_T

CERT Store Operation Table[45] =