nrf_cc3xx_platform_kmu.h

Go to the documentation of this file.

/*
 * Copyright (c) 2020 Nordic Semiconductor ASA
 *
 * SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
 */
#ifndef NRF_CC3XX_PLATFORM_KMU__
#define NRF_CC3XX_PLATFORM_KMU__
 
#include <stdint.h>
#include <stddef.h>
#include "nrfx.h"
 
#if defined(NRF91_SERIES) || defined(NRF5340_XXAA_APPLICATION)
 
typedef enum {
    NRF_CC3XX_PLATFORM_KEY_TYPE_KDR_AES_128_BIT      = 0, 
    NRF_CC3XX_PLATFORM_KEY_TYPE_CHACHAPOLY_256_BIT   = 1, 
    NRF_CC3XX_PLATFORM_KEY_TYPE_AES_128_BIT          = 2, 
#if defined(NRF5340_XXAA_APPLICATION)
    NRF_CC3XX_PLATFORM_KEY_TYPE_AES_256_BIT          = 3, 
#endif
} nrf_cc3xx_platform_key_type_t;
 
typedef union {
    uint8_t buff_128[16];
    uint8_t buff_256[32];
} nrf_cc3xx_platform_key_buff_t;
 
 
#define NRF_CC3XX_PLATFORM_KMU_DEFAULT_PERMISSIONS          (0xFFFFFFFCUL)
 
 
#define NRF_CC3XX_PLATFORM_KMU_IDENTITY_KEY_PERMISSIONS     (0xFFFFFFFAUL)
 
#if defined(NRF91_SERIES)
 
    #define NRF_CC3XX_PLATFORM_KMU_AES_ADDR                 (0x50841400UL)
 
    #define NRF_CC3XX_PLATFORM_KMU_CHACHAPOLY_ADDR          (0x50841388UL)
 
    #define NRF_CC3XX_PLATFORM_KMU_CHACHAPOLY_ADDR1         (0x50841388UL)
 
    #define NRF_CC3XX_PLATFORM_KMU_CHACHAPOLY_ADDR2         (0x50841398UL)
 
    #define NRF_CC3XX_PLATFORM_NRF9160_KDR_ADDR             (0x50841A50UL)
 
#elif defined(NRF5340_XXAA_APPLICATION)
 
    #define NRF_CC3XX_PLATFORM_KMU_AES_ADDR                 (0x50845400UL)
 
    #define NRF_CC3XX_PLATFORM_KMU_AES_ADDR_1               (0x50845400UL)
 
    #define NRF_CC3XX_PLATFORM_KMU_AES_ADDR_2               (0x50845410UL)
 
    #define NRF_CC3XX_PLATFORM_KMU_CHACHAPOLY_ADDR          (0x50845388UL)
 
    #define NRF_CC3XX_PLATFORM_KMU_CHACHAPOLY_ADDR1         (0x50845388UL)
 
    #define NRF_CC3XX_PLATFORM_KMU_CHACHAPOLY_ADDR2         (0x50845398UL)
#endif
 
int nrf_cc3xx_platform_kmu_write_key(
    uint32_t slot_id,
    nrf_cc3xx_platform_key_type_t key_type,
    nrf_cc3xx_platform_key_buff_t key_buff);
 
 
int nrf_cc3xx_platform_kmu_write_key_slot(
    uint32_t slot_id,
    uint32_t key_addr,
    uint32_t key_perm,
    const uint8_t key[16]);
 
#endif /* defined(NRF91_SERIES) || defined(NRF5340_XXAA_APPLICATION) */
 
#if defined(NRF91_SERIES)
 
int nrf_cc3xx_platform_kmu_write_kdr_slot(uint32_t slot_id, const uint8_t key[16]);
 
 
int nrf_cc3xx_platform_kmu_push_kdr_slot_and_lock(uint32_t slot_id);
 
#endif // defined(NRF91_SERIES)
 
 
#if defined(NRF52840_XXAA)
 
int nrf_cc3xx_platform_kdr_load_key(uint8_t key[16]);
 
#endif // defined(NRF52840_XXAA)
 
int nrf_cc3xx_platform_kmu_shadow_key_derive(
    uint32_t slot_id,
    unsigned int keybits,
    uint8_t const * label,
    size_t label_size,
    uint8_t const * context,
    size_t context_size,
    uint8_t * output,
    size_t output_size);
 
 
 
#endif /* NRF_CC3XX_PLATFORM_KMU__ */