Wrapped-key handle handed to DOTF by ra8_rsip. More...

#include <ra8_dotf.h>

Data Fields
ra8_dotf_key_size_t	size
	128 / 192 / 256 selector for REG00.
uint8_t	key_index
	RSIP key slot this handle came from.
uint8_t	valid
	Non-zero if the wrapped key is real.
uint32_t	words [8]
	Wrapped-key payload (up to 256 bits).

Detailed Description

Wrapped-key handle handed to DOTF by ra8_rsip.

The HAL never sees raw key bits. ra8_rsip's key-injection layer (HUM Ch 52 p 3302..3307) wraps a plaintext or OEM-protected key into a vendor-defined "wrapped key" envelope and produces this handle. The DOTF driver consumes the handle, stages the wrapped payload into REG03 in big-endian word order, and arms the AES core. Clearing words[0] to zero indicates an empty / cleared handle – the driver treats that as "no key staged" and refuses to enable the channel.

cppcheck cannot see tests/ so it flags every field as unused; all fields are read in the driver.

Definition at line 201 of file ra8_dotf.h.

Field Documentation

◆ key_index

uint8_t ra8_dotf_key_handle_t::key_index

RSIP key slot this handle came from.

Definition at line 203 of file ra8_dotf.h.

Referenced by internal_state_reset().

◆ size

ra8_dotf_key_size_t ra8_dotf_key_handle_t::size

128 / 192 / 256 selector for REG00.

Definition at line 202 of file ra8_dotf.h.

Referenced by internal_stage_key(), internal_state_reset(), internal_validate_rotate_inputs(), ra8_dotf_install_key(), and ra8_dotf_rotate_key().

◆ valid

uint8_t ra8_dotf_key_handle_t::valid

Non-zero if the wrapped key is real.

Definition at line 204 of file ra8_dotf.h.

Referenced by internal_state_reset(), internal_validate_rotate_inputs(), and ra8_dotf_install_key().

◆ words

uint32_t ra8_dotf_key_handle_t::words[8]

Wrapped-key payload (up to 256 bits).

Definition at line 205 of file ra8_dotf.h.

Referenced by internal_stage_key(), and internal_state_reset().

The documentation for this struct was generated from the following file:

libs/ra8_hal/inc/ra8_dotf.h