ra8_rsip_core.h

Go to the documentation of this file.

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

typedef struct {
  bool run_bist; 
} ra8_rsip_config_t;

typedef void (*ra8_rsip_event_fn_t)(void* ctx, uint32_t isr);
 
/* =============================================================================
 * Lifecycle
 * =============================================================================
 */

[[nodiscard]] ra8_err_t ra8_rsip_init(const ra8_rsip_config_t* cfg);

[[nodiscard]] ra8_err_t ra8_rsip_deinit(void);
 
/* =============================================================================
 * Status / IRQ
 * =============================================================================
 */

[[nodiscard]] ra8_err_t ra8_rsip_get_status(uint32_t* out);

[[nodiscard]] ra8_err_t ra8_rsip_clear_status(uint32_t mask);

[[nodiscard]] ra8_err_t ra8_rsip_attach_handler(ra8_rsip_event_fn_t fn, void* ctx);

void ra8_rsip_dispatch(void);
 
/* =============================================================================
 * TRNG
 * =============================================================================
 */

[[nodiscard]] ra8_err_t ra8_rsip_trng_read(uint8_t* buf, uint32_t len);
 
/* =============================================================================
 * SHA-256
 * =============================================================================
 */

[[nodiscard]] ra8_err_t ra8_rsip_sha256(const uint8_t* msg, uint32_t msg_len, uint8_t* digest);
 
/* =============================================================================
 * SHA-256 incremental (init / update / final)
 * =============================================================================
 */

typedef enum : uint16_t {
  k_ra8_rsip_sha256_state_words = 8U,    
  k_ra8_rsip_sha256_block       = 64U,   
  k_ra8_rsip_hmac_inner_pad     = 0x36U, 
  k_ra8_rsip_hmac_outer_pad     = 0x5CU, 
} ra8_rsip_sha_buf_t;

typedef struct {
  uint32_t state[k_ra8_rsip_sha256_state_words]; 
  uint8_t  block[k_ra8_rsip_sha256_block];       
  uint64_t total_bytes;                          
  uint32_t used;                                 
  uint8_t  initialized;                          
} ra8_rsip_sha256_ctx_t;

[[nodiscard]] ra8_err_t ra8_rsip_sha256_init(ra8_rsip_sha256_ctx_t* ctx);

[[nodiscard]] ra8_err_t
ra8_rsip_sha256_update(ra8_rsip_sha256_ctx_t* ctx, const uint8_t* data, uint32_t len);

[[nodiscard]] ra8_err_t ra8_rsip_sha256_final(ra8_rsip_sha256_ctx_t* ctx, uint8_t* digest_out);
 
/* =============================================================================
 * HMAC-SHA-256 incremental (init / update / final)
 * =============================================================================
 */

typedef struct {
  ra8_rsip_sha256_ctx_t inner;                              
  uint8_t               key_block[k_ra8_rsip_sha256_block]; 
  uint8_t               initialized;                        
} ra8_rsip_hmac_sha256_ctx_t;

[[nodiscard]] ra8_err_t
ra8_rsip_hmac_sha256_init(ra8_rsip_hmac_sha256_ctx_t* ctx, const uint8_t* key, uint32_t key_len);

[[nodiscard]] ra8_err_t
ra8_rsip_hmac_sha256_update(ra8_rsip_hmac_sha256_ctx_t* ctx, const uint8_t* data, uint32_t len);

[[nodiscard]] ra8_err_t ra8_rsip_hmac_sha256_final(ra8_rsip_hmac_sha256_ctx_t* ctx,
                                                   uint8_t*                    mac_out);
 
/* =============================================================================
 * Power transition
 * =============================================================================
 */

[[nodiscard]] ra8_err_t ra8_rsip_enter_stop(void);

[[nodiscard]] ra8_err_t ra8_rsip_exit_stop(void);
 
#ifdef __cplusplus
}
#endif