Build-time selection of the TROPIC01 SH0 pairing key and slot. More...

#include <stdint.h>
#include "libtropic_common.h"

Macros
#define	CDC_PAIRING_KEY_PROD0 0
#define	CDC_PAIRING_KEY_ENG_SAMPLE 1
#define	CDC_PAIRING_KEY_CUSTOM 2
#define	CDC_PAIRING_KEY CDC_PAIRING_KEY_PROD0
#define	PAIRING_KEY_PRIV lt_sh0priv_prod0
#define	PAIRING_KEY_PUB lt_sh0pub_prod0
#define	PAIRING_KEY_SLOT TR01_PAIRING_KEY_SLOT_INDEX_0

Detailed Description

Build-time selection of the TROPIC01 SH0 pairing key and slot.

Every R-Config / maintenance-mode operation needs a secure channel session, which is only possible with a known pairing key. A chip provisioned with a non-default key cannot be reached with the default production key, so the key is selectable at build time.

Select via platformio.ini build_flags (default: PROD0): -DCDC_PAIRING_KEY=CDC_PAIRING_KEY_PROD0 libtropic production key, slot 0 -DCDC_PAIRING_KEY=CDC_PAIRING_KEY_ENG_SAMPLE libtropic engineering-sample key, slot 0 -DCDC_PAIRING_KEY=CDC_PAIRING_KEY_CUSTOM key from pairing_key_custom.h (git-ignored)

The selection resolves to three macros used by the secure-element layer: PAIRING_KEY_PRIV, PAIRING_KEY_PUB, PAIRING_KEY_SLOT.

Definition in file pairing_key_config.h.

Macro Definition Documentation

◆ CDC_PAIRING_KEY

#define CDC_PAIRING_KEY CDC_PAIRING_KEY_PROD0

Definition at line 30 of file pairing_key_config.h.

◆ CDC_PAIRING_KEY_CUSTOM

#define CDC_PAIRING_KEY_CUSTOM 2

Definition at line 27 of file pairing_key_config.h.

◆ CDC_PAIRING_KEY_ENG_SAMPLE

#define CDC_PAIRING_KEY_ENG_SAMPLE 1

Definition at line 26 of file pairing_key_config.h.

◆ CDC_PAIRING_KEY_PROD0

#define CDC_PAIRING_KEY_PROD0 0

Definition at line 25 of file pairing_key_config.h.

◆ PAIRING_KEY_PRIV

#define PAIRING_KEY_PRIV lt_sh0priv_prod0

Definition at line 34 of file pairing_key_config.h.

◆ PAIRING_KEY_PUB

#define PAIRING_KEY_PUB lt_sh0pub_prod0

Definition at line 35 of file pairing_key_config.h.

◆ PAIRING_KEY_SLOT

#define PAIRING_KEY_SLOT TR01_PAIRING_KEY_SLOT_INDEX_0

Definition at line 36 of file pairing_key_config.h.

Macros