mirror of
https://github.com/espressif/esp-idf.git
synced 2025-08-09 12:35:28 +00:00
5b54ae76d4
When ESP32-C2 is paired with a 26 MHz XTAL, the systimer tick
frequency becomes equal to 26 / 2.5 = 10.4 MHz. Previously we always
assumed that systimer tick frequency is integer (and 1 MHz * power of
two, above that!).
This commit introduces a new LL macro, SYSTIMER_LL_TICKS_PER_US_DIV.
It should be set in such a way that:
1. SYSTIMER_LL_TICKS_PER_US / SYSTIMER_LL_TICKS_PER_US_DIV equals the
actual systimer tick frequency,
2. and SYSTIMER_LL_TICKS_PER_US is integer.
For ESP32-C2 this means that SYSTIMER_LL_TICKS_PER_US = 52 and
SYSTIMER_LL_TICKS_PER_US_DIV = 5.
This introduced two possible issues:
1. Overflow when multiplying systimer counter by 5
- Should not be an issue, since systimer counter is 52-bit, so
counter * 5 is no more than 55-bit.
2. The code needs to perform:
- divide by 5: when converting from microseconds to ticks
- divide by 52: when converting from ticks to microseconds
The latter potentially introduces a performance issue for the
esp_timer_get_time function.
164 lines
5.6 KiB
C
164 lines
5.6 KiB
C
/*
|
|
* SPDX-FileCopyrightText: 2021-2022 Espressif Systems (Shanghai) CO LTD
|
|
*
|
|
* SPDX-License-Identifier: Apache-2.0
|
|
*/
|
|
#pragma once
|
|
|
|
#include <stdint.h>
|
|
#include <stdbool.h>
|
|
#include "soc/systimer_struct.h"
|
|
#include "hal/assert.h"
|
|
|
|
#define SYSTIMER_LL_COUNTER_CLOCK (0) // Counter used for "wallclock" time
|
|
#define SYSTIMER_LL_COUNTER_OS_TICK (1) // Counter used for OS tick
|
|
#define SYSTIMER_LL_ALARM_OS_TICK_CORE0 (0) // Alarm used for OS tick of CPU core 0
|
|
#define SYSTIMER_LL_ALARM_OS_TICK_CORE1 (1) // Alarm used for OS tick of CPU core 1
|
|
#define SYSTIMER_LL_ALARM_CLOCK (2) // Alarm used for "wallclock" time
|
|
|
|
#define SYSTIMER_LL_TICKS_PER_US (16) // 16 systimer ticks == 1us
|
|
#define SYSTIMER_LL_TICKS_PER_US_DIV (1)
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
// All these functions get invoked either from ISR or HAL that linked to IRAM.
|
|
// Always inline these functions even no gcc optimization is applied.
|
|
|
|
/******************* Clock *************************/
|
|
|
|
__attribute__((always_inline)) static inline void systimer_ll_enable_clock(systimer_dev_t *dev, bool en)
|
|
{
|
|
dev->conf.clk_en = en;
|
|
}
|
|
|
|
/******************* Counter *************************/
|
|
|
|
__attribute__((always_inline)) static inline void systimer_ll_enable_counter(systimer_dev_t *dev, uint32_t counter_id, bool en)
|
|
{
|
|
if (en) {
|
|
dev->conf.val |= 1 << (30 - counter_id);
|
|
} else {
|
|
dev->conf.val &= ~(1 << (30 - counter_id));
|
|
}
|
|
}
|
|
|
|
__attribute__((always_inline)) static inline void systimer_ll_counter_can_stall_by_cpu(systimer_dev_t *dev, uint32_t counter_id, uint32_t cpu_id, bool can)
|
|
{
|
|
if (can) {
|
|
dev->conf.val |= 1 << ((28 - counter_id * 2) - cpu_id);
|
|
} else {
|
|
dev->conf.val &= ~(1 << ((28 - counter_id * 2) - cpu_id));
|
|
}
|
|
}
|
|
|
|
__attribute__((always_inline)) static inline void systimer_ll_counter_snapshot(systimer_dev_t *dev, uint32_t counter_id)
|
|
{
|
|
dev->unit_op[counter_id].timer_unit_update = 1;
|
|
}
|
|
|
|
__attribute__((always_inline)) static inline bool systimer_ll_is_counter_value_valid(systimer_dev_t *dev, uint32_t counter_id)
|
|
{
|
|
return dev->unit_op[counter_id].timer_unit_value_valid;
|
|
}
|
|
|
|
__attribute__((always_inline)) static inline void systimer_ll_set_counter_value(systimer_dev_t *dev, uint32_t counter_id, uint64_t value)
|
|
{
|
|
dev->unit_load_val[counter_id].hi.timer_unit_load_hi = value >> 32;
|
|
dev->unit_load_val[counter_id].lo.timer_unit_load_lo = value & 0xFFFFFFFF;
|
|
}
|
|
|
|
__attribute__((always_inline)) static inline uint32_t systimer_ll_get_counter_value_low(systimer_dev_t *dev, uint32_t counter_id)
|
|
{
|
|
return dev->unit_val[counter_id].lo.timer_unit_value_lo;
|
|
}
|
|
|
|
__attribute__((always_inline)) static inline uint32_t systimer_ll_get_counter_value_high(systimer_dev_t *dev, uint32_t counter_id)
|
|
{
|
|
return dev->unit_val[counter_id].hi.timer_unit_value_hi;
|
|
}
|
|
|
|
__attribute__((always_inline)) static inline void systimer_ll_apply_counter_value(systimer_dev_t *dev, uint32_t counter_id)
|
|
{
|
|
dev->unit_load[counter_id].val = 0x01;
|
|
}
|
|
|
|
/******************* Alarm *************************/
|
|
|
|
__attribute__((always_inline)) static inline void systimer_ll_set_alarm_target(systimer_dev_t *dev, uint32_t alarm_id, uint64_t value)
|
|
{
|
|
dev->target_val[alarm_id].hi.timer_target_hi = value >> 32;
|
|
dev->target_val[alarm_id].lo.timer_target_lo = value & 0xFFFFFFFF;
|
|
}
|
|
|
|
__attribute__((always_inline)) static inline uint64_t systimer_ll_get_alarm_target(systimer_dev_t *dev, uint32_t alarm_id)
|
|
{
|
|
return ((uint64_t)(dev->target_val[alarm_id].hi.timer_target_hi) << 32) | dev->target_val[alarm_id].lo.timer_target_lo;
|
|
}
|
|
|
|
__attribute__((always_inline)) static inline void systimer_ll_connect_alarm_counter(systimer_dev_t *dev, uint32_t alarm_id, uint32_t counter_id)
|
|
{
|
|
dev->target_conf[alarm_id].target_timer_unit_sel = counter_id;
|
|
}
|
|
|
|
__attribute__((always_inline)) static inline void systimer_ll_enable_alarm_oneshot(systimer_dev_t *dev, uint32_t alarm_id)
|
|
{
|
|
dev->target_conf[alarm_id].target_period_mode = 0;
|
|
}
|
|
|
|
__attribute__((always_inline)) static inline void systimer_ll_enable_alarm_period(systimer_dev_t *dev, uint32_t alarm_id)
|
|
{
|
|
dev->target_conf[alarm_id].target_period_mode = 1;
|
|
}
|
|
|
|
__attribute__((always_inline)) static inline void systimer_ll_set_alarm_period(systimer_dev_t *dev, uint32_t alarm_id, uint32_t period)
|
|
{
|
|
HAL_ASSERT(period < (1 << 26));
|
|
dev->target_conf[alarm_id].target_period = period;
|
|
}
|
|
|
|
__attribute__((always_inline)) static inline uint32_t systimer_ll_get_alarm_period(systimer_dev_t *dev, uint32_t alarm_id)
|
|
{
|
|
return dev->target_conf[alarm_id].target_period;
|
|
}
|
|
|
|
__attribute__((always_inline)) static inline void systimer_ll_apply_alarm_value(systimer_dev_t *dev, uint32_t alarm_id)
|
|
{
|
|
dev->comp_load[alarm_id].val = 0x01;
|
|
}
|
|
|
|
__attribute__((always_inline)) static inline void systimer_ll_enable_alarm(systimer_dev_t *dev, uint32_t alarm_id, bool en)
|
|
{
|
|
if (en) {
|
|
dev->conf.val |= 1 << (24 - alarm_id);
|
|
} else {
|
|
dev->conf.val &= ~(1 << (24 - alarm_id));
|
|
}
|
|
}
|
|
|
|
/******************* Interrupt *************************/
|
|
|
|
__attribute__((always_inline)) static inline void systimer_ll_enable_alarm_int(systimer_dev_t *dev, uint32_t alarm_id, bool en)
|
|
{
|
|
if (en) {
|
|
dev->int_ena.val |= 1 << alarm_id;
|
|
} else {
|
|
dev->int_ena.val &= ~(1 << alarm_id);
|
|
}
|
|
}
|
|
|
|
__attribute__((always_inline)) static inline bool systimer_ll_is_alarm_int_fired(systimer_dev_t *dev, uint32_t alarm_id)
|
|
{
|
|
return dev->int_st.val & (1 << alarm_id);
|
|
}
|
|
|
|
__attribute__((always_inline)) static inline void systimer_ll_clear_alarm_int(systimer_dev_t *dev, uint32_t alarm_id)
|
|
{
|
|
dev->int_clr.val |= 1 << alarm_id;
|
|
}
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|