mirror of
https://github.com/espressif/esp-idf.git
synced 2026-10-01 02:30:52 +03:00
Laukik Hase
52a6ad71ee
- Also add RNG LL-APIs for ESP32-C61 - Add SOC_RNG_CLOCK_IS_INDEPENDENT for ESP32-C61: now that rng_ll_disable() actually clears the RNG clock gate, the application needs the esp_hw_support startup hook to re-enable the RNG after bootloader_random_disable()
123 lines
2.5 KiB
C
123 lines
2.5 KiB
C
/*
|
|
* SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
|
|
*
|
|
* SPDX-License-Identifier: Apache-2.0
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include <stdbool.h>
|
|
#include <stdint.h>
|
|
#include "soc/soc.h"
|
|
#include "soc/lpperi_reg.h"
|
|
#include "soc/lpperi_struct.h"
|
|
|
|
//For ESP32C61, RNG needs to be reset and enabled again when wakeup from sleep
|
|
#define RNG_LL_NEEDS_RESET_WHEN_WAKEUP 1
|
|
//Default value for the RNG timer clock divider
|
|
#define RNG_LL_CFG_PSCALE 255
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/**
|
|
* @brief Read random data from RNG
|
|
*
|
|
* @return 32-bit random data
|
|
*/
|
|
static inline uint32_t rng_ll_read_data(void)
|
|
{
|
|
return REG_READ(LPPERI_RNG_DATA_SYNC_REG);
|
|
}
|
|
|
|
/**
|
|
* @brief Enable or disable RNG sampling.
|
|
*
|
|
* @param enable True to enable, False to disable
|
|
*/
|
|
static inline void rng_ll_enable_sample(bool enable)
|
|
{
|
|
LPPERI.rng_cfg.rng_sample_enable = enable;
|
|
}
|
|
|
|
/**
|
|
* @brief Set RNG timer prescaler
|
|
*
|
|
* @param prescaler Timer prescaler value (0-255)
|
|
*/
|
|
static inline void rng_ll_set_timer_prescaler(uint8_t prescaler)
|
|
{
|
|
LPPERI.rng_cfg.rng_timer_pscale = prescaler;
|
|
}
|
|
|
|
/**
|
|
* @brief Enable or disable rng xor rtc timer.
|
|
*
|
|
* @param enable True to enable, False to disable
|
|
*/
|
|
static inline void rng_ll_enable_rtc_timer(bool enable)
|
|
{
|
|
LPPERI.rng_cfg.rtc_timer_en = enable ? 0x3 : 0x0;
|
|
}
|
|
|
|
/**
|
|
* @brief Enable or disable rng xor async rng timer.
|
|
*
|
|
* @param enable True to enable, False to disable
|
|
*/
|
|
static inline void rng_ll_enable_rng_timer(bool enable)
|
|
{
|
|
LPPERI.rng_cfg.rng_timer_en = enable;
|
|
}
|
|
|
|
/**
|
|
* @brief Reset RNG.
|
|
*/
|
|
static inline void rng_ll_reset(void)
|
|
{
|
|
LPPERI.reset_en.lp_rng_reset_en = 1;
|
|
LPPERI.reset_en.lp_rng_reset_en = 0;
|
|
}
|
|
|
|
/**
|
|
* @brief Enable RNG module
|
|
*
|
|
* TODO: unify in rng_hal.c
|
|
*/
|
|
static inline void rng_ll_enable(void)
|
|
{
|
|
LPPERI.clk_en.rng_ck_en = 1;
|
|
rng_ll_set_timer_prescaler(RNG_LL_CFG_PSCALE);
|
|
rng_ll_enable_sample(true);
|
|
rng_ll_enable_rtc_timer(true);
|
|
rng_ll_enable_rng_timer(true);
|
|
}
|
|
|
|
/**
|
|
* @brief Disable RNG module
|
|
*
|
|
* TODO: unify in rng_hal.c
|
|
*/
|
|
static inline void rng_ll_disable(void)
|
|
{
|
|
rng_ll_enable_sample(false);
|
|
rng_ll_enable_rtc_timer(false);
|
|
rng_ll_enable_rng_timer(false);
|
|
LPPERI.clk_en.rng_ck_en = 0;
|
|
}
|
|
|
|
/**
|
|
* @brief Check that the RNG is live: clocked and out of reset.
|
|
*
|
|
* @return True if the RNG is enabled and operational, false otherwise.
|
|
*/
|
|
static inline bool rng_ll_is_enabled(void)
|
|
{
|
|
return LPPERI.clk_en.rng_ck_en && !LPPERI.reset_en.lp_rng_reset_en;
|
|
}
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|