This is the chip specific include file for T32CZ20 True Random Number Generator (TRNG). Note that there is a common include file for this HAL module that contains the APIs that should be used by the application. More...

#include "tr_hal_platform.h"

Include dependency graph for T32CZ20_trng.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures
struct	SECURITY_CTRL_REGISTERS_T

struct	TRNG_REGISTERS_T

Macros
#define	CHIP_MEMORY_MAP_SECURITY_CTRL_BASE 0x50003000

#define	SECURITY_CTRL_CHIP_REGISTERS ((SECURITY_CTRL_REGISTERS_T *) CHIP_MEMORY_MAP_SECURITY_CTRL_BASE)

#define	OTP_WRITE_ENABLE_KEY (0x28514260)

#define	OTP_WRITE_DISABLE_KEY (0x00000000)

#define	CHIP_MEMORY_MAP_TRNG_BASE (0x40044A00UL)
	chip register addresses section 2.2 of the data sheet explains the Memory map. this gives the base address for how to write the chip registers the chip registers are how the software interacts configures GPIOs, reads GPIOs, and gets/sets information on the chip We create a struct below that addresses the individual registers. This makes it so we can use this base address and a struct field to read or write a chip register

#define	REG_TRNG_EXPECTED_VERSION 0x39304200

#define	REG_TRNG_STATUS_BUSY 0x01

#define	REG_TRNG_STATUS_FIFO_CLEARED 0x02

#define	REG_TRNG_STATUS_ENTROPY_SRC_AVAIL 0x04

#define	REG_TRNG_STATUS_NOT_ENABLED 0x100

#define	REG_TRNG_STATUS_HEALTH_TEST_ACTIVE 0x200

#define	REG_TRNG_STATUS_DATA_READY 0x400

#define	REG_TRNG_STATUS_HALTED_ERROR 0x800

#define	REG_CONTROL_ENABLE_TRNG_FUNCTION 0x01

#define	REG_CONTROL_ENABLE_TRNG_CLOCK 0x02

#define	TRNG_CHIP_REGISTERS ((TRNG_REGISTERS_T *) CHIP_MEMORY_MAP_TRNG_BASE)

#define	TRNG_TIMEOUT_COUNT 20000

Functions
tr_hal_status_t	tr_hal_trng_read_internal (uint32_t result, uint32_t busy_cycles)

tr_hal_status_t	tr_hal_trng_debug (uint32_t version, uint32_t status, uint32_t data, uint32_t control)

Detailed Description

This is the chip specific include file for T32CZ20 True Random Number Generator (TRNG). Note that there is a common include file for this HAL module that contains the APIs that should be used by the application.

SPDX-License-Identifier: LicenseRef-TridentMSLA SPDX-FileCopyrightText: 2025 Trident IoT, LLC https://www.tridentiot.com

Trident IoT SDK

Data Structures

Macros

Functions

Detailed Description