Opaque wrapped-key handle. More...

#include <ra8_rsip_keys.h>

Data Fields
uint32_t	alg
	OEM-cmd algorithm selector.
uint32_t	body_words
	Number of body words (1..261).
uint32_t	body [k_ra8_rsip_handle_words_rsa4096_priv]
	Wrapped body.

Detailed Description

Opaque wrapped-key handle.

The HAL never exposes raw key bytes; every key the engine touches lives behind a wrapped blob. The handle carries the algorithm selector + the body word count so the engine can route the body through the correct command FIFO (FSP rsip_wrapped_key_t).

The blob storage is sized to the largest wrapped key the engine accepts (RSA-4096 private = 260 body words + 1 alg word).

Invariant: alg is one of ra8_rsip_oem_cmd_t.; body_words <= k_ra8_rsip_handle_words_rsa4096_priv.

Note: Handles are populated by ra8_rsip_aes_*_install_*, ra8_rsip_rsa_*_install_* etc. and consumed by every cipher / signing / KDF API.

Since: 0.1.0

Definition at line 66 of file ra8_rsip_keys.h.

Field Documentation

◆ alg

uint32_t ra8_rsip_key_handle_t::alg

OEM-cmd algorithm selector.

Definition at line 67 of file ra8_rsip_keys.h.

Referenced by priv_load_handle(), and ra8_rsip_protected_ecdsa_sign().

◆ body

uint32_t ra8_rsip_key_handle_t::body[k_ra8_rsip_handle_words_rsa4096_priv]

Wrapped body.

Definition at line 69 of file ra8_rsip_keys.h.

Referenced by priv_push_handle_body(), and ra8_rsip_protected_ecdsa_sign().

◆ body_words

uint32_t ra8_rsip_key_handle_t::body_words

Number of body words (1..261).

Definition at line 68 of file ra8_rsip_keys.h.