dwm_enc_key_set

Sets encryption key. The key is stored in a non-volatile memory. The key that consists of just zeros is considered invalid. If the key is set, the node will automatically enable encryption. Automatic enabling of the encryption is triggered via the UWB network when the node detects encrypted messages and can decrypt the messages with the key. The BLE option is disabled when encryption is enabled automatically. The encryption can be disabled by clearing the key ().

Normally, this call writes to internal flash when setting a new value. Hence, it should not be used frequently and can take hundreds of milliseconds in the worst case! Also, it requires a reset for the new configuration to take effect.

void dwm_enc_key_set(dwm_enc_key_t *key)

Parameters

• key – 16-byte value ? (the encryption key)

• output – Status code

C code example

dwm_enc_key_t key;
key.byte[0] = 0x00;
key.byte[1] = 0x11;
key.byte[2] = 0x22;
/* ... */
key.byte[15] = 0xFF;
dwm_enc_key_set(&key)

SPI/UART example

TLV Request
Type	Length	Value
0x3C	0x10	0x00 0x11 0x22 0x33 0x44 0x55 0x66 0x77 0x88 0x99 0xAA 0xBB 0xCC 0xDD 0xEE 0xFF

Type 0x3C means command dwm_enc_key_set

TLV Response
Type	Length	Value (see error codes)
0x40	0x01	0x00

Type 0x40 means err_code of the previous command