ra8_rsip_key_injection.h

Go to the documentation of this file.

 
#pragma once
 
#ifdef __cplusplus
extern "C" {
#endif
 
#include <stdint.h>
 
#include "ra8_err.h"
#include "ra8_rsip.h"
#include "ra8_rsip_regs.h"

typedef enum : uint32_t {
  k_ra8_rsip_wrapped_type_bytes      = 4U,   
  k_ra8_rsip_wrapped_mgmt_info_bytes = 16U,  
  k_ra8_rsip_wrapped_mac_bytes       = 16U,  
  k_ra8_rsip_wrapped_max_payload     = 600U, 
  k_ra8_rsip_wrapped_max_total       = 636U, 
} ra8_rsip_wrapped_key_const_t;

typedef enum : uint32_t {
  k_ra8_rsip_wrapped_type_aes      = 0xD1D2D3D4UL, 
  k_ra8_rsip_wrapped_type_rsa_pub  = 0xE1E2E3E4UL, 
  k_ra8_rsip_wrapped_type_rsa_priv = 0xE5E6E7E8UL, 
  k_ra8_rsip_wrapped_type_ecc_pub  = 0xF1F2F3F4UL, 
  k_ra8_rsip_wrapped_type_ecc_priv = 0xF5F6F7F8UL, 
} ra8_rsip_wrapped_key_type_t;

typedef enum : uint16_t {
  k_ra8_rsip_aes_key_bits_128 = 128U, 
  k_ra8_rsip_aes_key_bits_192 = 192U, 
  k_ra8_rsip_aes_key_bits_256 = 256U, 
} ra8_rsip_aes_key_bits_t;

[[nodiscard]] ra8_err_t ra8_rsip_key_inject_aes(uint8_t*                installed_key_buf,
                                                const uint8_t*          raw_key,
                                                ra8_rsip_aes_key_bits_t key_bits);

[[nodiscard]] ra8_err_t ra8_rsip_key_inject_rsa(uint8_t*            installed_key_buf,
                                                const uint8_t*      raw_modulus,
                                                const uint8_t*      raw_exponent,
                                                ra8_rsip_rsa_size_t size);

[[nodiscard]] ra8_err_t ra8_rsip_key_inject_ecc(uint8_t*         installed_key_buf,
                                                ra8_rsip_curve_t curve,
                                                const uint8_t*   raw_priv_or_pub,
                                                bool             is_private);

[[nodiscard]] ra8_err_t ra8_rsip_key_validate(const uint8_t*              installed_key_buf,
                                              ra8_rsip_wrapped_key_type_t expected_type);
 
#ifdef __cplusplus
}
#endif