ra8_tz_secure_boot.h

Go to the documentation of this file.

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

typedef enum : uint8_t {
  k_ra8_tz_sau_region_code_nsc  = 0U, 
  k_ra8_tz_sau_region_ns_mram   = 1U, 
  k_ra8_tz_sau_region_sram_nsc  = 2U, 
  k_ra8_tz_sau_region_ns_sram   = 3U, 
  k_ra8_tz_sau_region_ns_periph = 4U, 
  k_ra8_tz_sau_region_count     = 5U, 
} ra8_tz_sau_region_t;

typedef enum : uint8_t {
  k_ra8_tz_secure_boot_step_idle           = 0U, 
  k_ra8_tz_secure_boot_step_sau_done       = 1U, 
  k_ra8_tz_secure_boot_step_prcr_unlocked  = 2U, 
  k_ra8_tz_secure_boot_step_ipcsar_written = 3U, 
  k_ra8_tz_secure_boot_step_prcr_relocked  = 4U, 
  k_ra8_tz_secure_boot_step_blxns_armed    = 5U, 
  k_ra8_tz_secure_boot_step_branched       = 6U, 
} ra8_tz_secure_boot_step_t;

typedef enum : uint32_t {
  k_ra8_tz_ns_rot_header_magic = 0x3152534EU, 
} ra8_tz_ns_rot_header_magic_t;

typedef enum : uint8_t {
  k_ra8_tz_ns_rot_header_offset = 0x40U, 
} ra8_tz_ns_rot_header_offset_t;

typedef struct {
  uint32_t magic;    
  uint32_t body_len; 
} ra8_ns_rot_header_t;

[[nodiscard]] uint32_t ra8_tz_ns_signed_body_len(const uint32_t* ns_vector_table);

[[nodiscard]] ra8_err_t ra8_tz_secure_boot_sau_init(void);

[[nodiscard]] ra8_err_t ra8_tz_secure_boot_security_init(uint32_t ipcsar_value,
                                                         uint32_t ipcpar_value);

[[nodiscard]] ra8_err_t ra8_tz_secure_boot_jump_ns(const uint32_t* ns_vector_table);

[[nodiscard]] ra8_err_t ra8_tz_secure_boot_run(uint32_t        ipcsar_value,
                                               uint32_t        ipcpar_value,
                                               const uint32_t* ns_vector_table);

RA8_TEST_HELPER void ra8_tz_secure_boot_host_reset(void);

ra8_tz_secure_boot_step_t ra8_tz_secure_boot_get_step(void);

RA8_TEST_HELPER uint32_t ra8_tz_secure_boot_host_blxns_target(void);
 
#ifdef __cplusplus
}
#endif