esp32: add implementation of esp_timer based on TG0 LAC timer

Closes: IDF-979
2025-08-16 06:54:22 +00:00 · 2020-02-06 14:00:18 +08:00
parent 67b0a79167
commit 739eb05bb9
63 changed files with 1261 additions and 504 deletions
--- a/components/esp_timer/src/ets_timer_legacy.c
+++ b/components/esp_timer/src/ets_timer_legacy.c
@@ -0,0 +1,129 @@
+// Copyright 2010-2017 Espressif Systems (Shanghai) PTE LTD
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/*
+ * ets_timer module implements a set of legacy timer APIs which are
+ * used by the WiFi driver. This is done on top of the newer esp_timer APIs.
+ * Applications should not use ets_timer functions, as they may change without
+ * notice.
+ */
+
+#include <string.h>
+#include "esp_types.h"
+#include "esp_log.h"
+#include "esp_attr.h"
+#include "esp_intr_alloc.h"
+#include "soc/frc_timer_reg.h"
+#include "freertos/FreeRTOS.h"
+#include "freertos/task.h"
+#include "freertos/semphr.h"
+#include "freertos/xtensa_api.h"
+#include "sdkconfig.h"
+#include "esp_timer.h"
+#if CONFIG_IDF_TARGET_ESP32
+#include "esp32/rom/ets_sys.h"
+#elif CONFIG_IDF_TARGET_ESP32S2
+#include "esp32s2/rom/ets_sys.h"
+#endif
+
+/* We abuse 'timer_arg' field of ETSTimer structure to hold a pointer to esp_timer */
+#define ESP_TIMER(p_ets_timer) ((esp_timer_handle_t) (p_ets_timer)->timer_arg)
+
+/* We abuse 'timer_expire' field of ETSTimer structure to hold a magic value
+ * signifying that the contents of the timer was zeroed out.
+ */
+#define TIMER_INITIALIZED_FIELD(p_ets_timer) ((p_ets_timer)->timer_expire)
+#define TIMER_INITIALIZED_VAL 0x12121212
+
+static IRAM_ATTR bool timer_initialized(ETSTimer *ptimer)
+{
+    return TIMER_INITIALIZED_FIELD(ptimer) == TIMER_INITIALIZED_VAL;
+}
+
+void ets_timer_setfn(ETSTimer *ptimer, ETSTimerFunc *pfunction, void *parg)
+{
+    if (!timer_initialized(ptimer)) {
+        memset(ptimer, 0, sizeof(*ptimer));
+        TIMER_INITIALIZED_FIELD(ptimer) = TIMER_INITIALIZED_VAL;
+    }
+
+    if (ESP_TIMER(ptimer) == NULL) {
+        const esp_timer_create_args_t create_args = {
+                .callback = pfunction,
+                .arg = parg,
+                .name = "ETSTimer",
+                .dispatch_method = ESP_TIMER_TASK
+        };
+
+        ESP_ERROR_CHECK( esp_timer_create(&create_args, (esp_timer_handle_t*)&(ptimer->timer_arg)) );
+    }
+}
+
+
+void IRAM_ATTR ets_timer_arm_us(ETSTimer *ptimer, uint32_t time_us, bool repeat_flag)
+{
+    assert(timer_initialized(ptimer));
+    esp_timer_stop(ESP_TIMER(ptimer));  // no error check
+    if (!repeat_flag) {
+        ESP_ERROR_CHECK( esp_timer_start_once(ESP_TIMER(ptimer), time_us) );
+    } else {
+        ESP_ERROR_CHECK( esp_timer_start_periodic(ESP_TIMER(ptimer), time_us) );
+    }
+}
+
+void IRAM_ATTR ets_timer_arm(ETSTimer *ptimer, uint32_t time_ms, bool repeat_flag)
+{
+    uint64_t time_us = 1000LL * (uint64_t) time_ms;
+    assert(timer_initialized(ptimer));
+    esp_timer_stop(ESP_TIMER(ptimer));  // no error check
+    if (!repeat_flag) {
+        ESP_ERROR_CHECK( esp_timer_start_once(ESP_TIMER(ptimer), time_us) );
+    } else {
+        ESP_ERROR_CHECK( esp_timer_start_periodic(ESP_TIMER(ptimer), time_us) );
+    }
+}
+
+void ets_timer_done(ETSTimer *ptimer)
+{
+    if (timer_initialized(ptimer)) {
+        esp_timer_delete(ESP_TIMER(ptimer));
+        ptimer->timer_arg = NULL;
+        TIMER_INITIALIZED_FIELD(ptimer) = 0;
+    }
+}
+
+void IRAM_ATTR ets_timer_disarm(ETSTimer *ptimer)
+{
+    if (timer_initialized(ptimer)) {
+        esp_timer_stop(ESP_TIMER(ptimer));
+    }
+}
+
+
+void ets_timer_init(void)
+{
+
+}
+
+void ets_timer_deinit(void)
+{
+
+}
+
+void os_timer_setfn(ETSTimer *ptimer, ETSTimerFunc *pfunction, void *parg) __attribute__((alias("ets_timer_setfn")));
+void os_timer_disarm(ETSTimer *ptimer) __attribute__((alias("ets_timer_disarm")));
+void os_timer_arm_us(ETSTimer *ptimer,uint32_t u_seconds,bool repeat_flag) __attribute__((alias("ets_timer_arm_us")));
+void os_timer_arm(ETSTimer *ptimer,uint32_t milliseconds,bool repeat_flag) __attribute__((alias("ets_timer_arm")));
+void os_timer_done(ETSTimer *ptimer) __attribute__((alias("ets_timer_done")));
+