mirror of
https://github.com/espressif/esp-idf.git
synced 2025-10-16 00:49:16 +00:00
18091976ec
- Standardize all LL macros using atomic env variables with `do { ... } while (0)`
- Prevent potential macro misuse in control flow constructs (e.g., if/else)
- Affected targets: esp32, esp32c2, esp32c5, esp32s3, esp32p4, etc.
- Affected modules include: LCD, I2S, TIMER, and others
135 lines
3.4 KiB
C
135 lines
3.4 KiB
C
/*
|
|
* SPDX-FileCopyrightText: 2023-2025 Espressif Systems (Shanghai) CO LTD
|
|
*
|
|
* SPDX-License-Identifier: Apache-2.0
|
|
*/
|
|
|
|
// Note that most of the register operations in this layer are non-atomic operations.
|
|
|
|
#pragma once
|
|
|
|
#include <stdbool.h>
|
|
#include "hal/assert.h"
|
|
#include "hal/misc.h"
|
|
#include "soc/soc_etm_struct.h"
|
|
#include "soc/hp_sys_clkrst_struct.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#define ETM_LL_SUPPORT_STATUS 1 // Support to get and clear the status of the ETM event and task
|
|
|
|
/**
|
|
* @brief Enable the bus clock for ETM module
|
|
*
|
|
* @param group_id Group ID
|
|
* @param enable true to enable, false to disable
|
|
*/
|
|
static inline void _etm_ll_enable_bus_clock(int group_id, bool enable)
|
|
{
|
|
(void)group_id;
|
|
HP_SYS_CLKRST.soc_clk_ctrl3.reg_etm_apb_clk_en = enable;
|
|
HP_SYS_CLKRST.soc_clk_ctrl1.reg_etm_sys_clk_en = enable;
|
|
}
|
|
|
|
/// use a macro to wrap the function, force the caller to use it in a critical section
|
|
/// the critical section needs to declare the __DECLARE_RCC_ATOMIC_ENV variable in advance
|
|
#define etm_ll_enable_bus_clock(...) do { \
|
|
(void)__DECLARE_RCC_ATOMIC_ENV; \
|
|
_etm_ll_enable_bus_clock(__VA_ARGS__); \
|
|
} while(0)
|
|
|
|
/**
|
|
* @brief Reset the ETM module
|
|
*
|
|
* @param group_id Group ID
|
|
*/
|
|
static inline void etm_ll_reset_register(int group_id)
|
|
{
|
|
(void)group_id;
|
|
HP_SYS_CLKRST.hp_rst_en1.reg_rst_en_etm = 1;
|
|
HP_SYS_CLKRST.hp_rst_en1.reg_rst_en_etm = 0;
|
|
}
|
|
|
|
/// use a macro to wrap the function, force the caller to use it in a critical section
|
|
/// the critical section needs to declare the __DECLARE_RCC_ATOMIC_ENV variable in advance
|
|
#define etm_ll_reset_register(...) do { \
|
|
(void)__DECLARE_RCC_ATOMIC_ENV; \
|
|
etm_ll_reset_register(__VA_ARGS__); \
|
|
} while(0)
|
|
|
|
/**
|
|
* @brief Enable ETM channel
|
|
*
|
|
* @param hw ETM register base address
|
|
* @param chan Channel ID
|
|
*/
|
|
static inline void etm_ll_enable_channel(soc_etm_dev_t *hw, uint32_t chan)
|
|
{
|
|
if (chan < 32) {
|
|
hw->ch_ena_ad0_set.val = 1 << chan;
|
|
} else {
|
|
hw->ch_ena_ad1_set.val = 1 << (chan - 32);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @brief Disable ETM channel
|
|
*
|
|
* @param hw ETM register base address
|
|
* @param chan Channel ID
|
|
*/
|
|
static inline void etm_ll_disable_channel(soc_etm_dev_t *hw, uint32_t chan)
|
|
{
|
|
if (chan < 32) {
|
|
hw->ch_ena_ad0_clr.val = 1 << chan;
|
|
} else {
|
|
hw->ch_ena_ad1_clr.val = 1 << (chan - 32);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @brief Check whether the ETM channel is enabled or not
|
|
*
|
|
* @param hw ETM register base address
|
|
* @param chan Channel ID
|
|
* @return true if the channel is enabled, false otherwise
|
|
*/
|
|
static inline bool etm_ll_is_channel_enabled(soc_etm_dev_t *hw, uint32_t chan)
|
|
{
|
|
if (chan < 32) {
|
|
return hw->ch_ena_ad0.val & (1 << chan);
|
|
} else {
|
|
return hw->ch_ena_ad1.val & (1 << (chan - 32));
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @brief Set the input event for the ETM channel
|
|
*
|
|
* @param hw ETM register base address
|
|
* @param chan Channel ID
|
|
* @param event Event ID
|
|
*/
|
|
static inline void etm_ll_channel_set_event(soc_etm_dev_t *hw, uint32_t chan, uint32_t event)
|
|
{
|
|
HAL_FORCE_MODIFY_U32_REG_FIELD(hw->channel[chan].eid, evt_id, event);
|
|
}
|
|
|
|
/**
|
|
* @brief Set the output task for the ETM channel
|
|
*
|
|
* @param hw ETM register base address
|
|
* @param chan Channel ID
|
|
* @param task Task ID
|
|
*/
|
|
static inline void etm_ll_channel_set_task(soc_etm_dev_t *hw, uint32_t chan, uint32_t task)
|
|
{
|
|
HAL_FORCE_MODIFY_U32_REG_FIELD(hw->channel[chan].tid, task_id, task);
|
|
}
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|