1 /*
2 * SPDX-FileCopyrightText: 2021-2023 Espressif Systems (Shanghai) CO LTD
3 *
4 * SPDX-License-Identifier: Apache-2.0
5 */
6
7 #include <stdlib.h>
8 #include "hal/timer_hal.h"
9 #include "hal/timer_ll.h"
10 #include "soc/soc_caps.h"
11
timer_hal_init(timer_hal_context_t * hal,uint32_t group_num,uint32_t timer_num)12 void timer_hal_init(timer_hal_context_t *hal, uint32_t group_num, uint32_t timer_num)
13 {
14 hal->dev = TIMER_LL_GET_HW(group_num);
15 hal->timer_id = timer_num;
16 // enable peripheral clock
17 timer_ll_enable_clock(hal->dev, timer_num, true);
18 // stop counter, alarm, auto-reload at first place
19 timer_ll_enable_counter(hal->dev, timer_num, false);
20 timer_ll_enable_auto_reload(hal->dev, timer_num, false);
21 timer_ll_enable_alarm(hal->dev, timer_num, false);
22 // enable RTM subsystem if available
23 #if SOC_TIMER_SUPPORT_ETM
24 timer_ll_enable_etm(hal->dev, true);
25 #endif
26 }
27
timer_hal_deinit(timer_hal_context_t * hal)28 void timer_hal_deinit(timer_hal_context_t *hal)
29 {
30 // disable peripheral clock
31 timer_ll_enable_clock(hal->dev, hal->timer_id, false);
32 // ensure counter, alarm, auto-reload are disabled
33 timer_ll_enable_counter(hal->dev, hal->timer_id, false);
34 timer_ll_enable_auto_reload(hal->dev, hal->timer_id, false);
35 timer_ll_enable_alarm(hal->dev, hal->timer_id, false);
36 #if SOC_TIMER_SUPPORT_ETM
37 timer_ll_enable_etm(hal->dev, false);
38 #endif
39 hal->dev = NULL;
40 }
41
timer_hal_set_counter_value(timer_hal_context_t * hal,uint64_t load_val)42 void timer_hal_set_counter_value(timer_hal_context_t *hal, uint64_t load_val)
43 {
44 //////////////////////////////////////////////////////////////////////////////////////////////////////////////////
45 // - `timer_ll_set_reload_value()` will only indicate the `reload_value`
46 // - `timer_ll_set_reload_value()` + ``timer_ll_trigger_soft_reload()` can update the HW counter value by software
47 // Therefore, after updating the HW counter value, we need to restore the previous `reload_value`.
48 // Attention: The following process should be protected by a lock in the driver layer.
49 //////////////////////////////////////////////////////////////////////////////////////////////////////////////////
50 // save current reload value
51 uint64_t old_reload = timer_ll_get_reload_value(hal->dev, hal->timer_id);
52 timer_ll_set_reload_value(hal->dev, hal->timer_id, load_val);
53 timer_ll_trigger_soft_reload(hal->dev, hal->timer_id);
54 // restore the previous reload value
55 timer_ll_set_reload_value(hal->dev, hal->timer_id, old_reload);
56 }
57
timer_hal_capture_and_get_counter_value(timer_hal_context_t * hal)58 uint64_t timer_hal_capture_and_get_counter_value(timer_hal_context_t *hal)
59 {
60 timer_ll_trigger_soft_capture(hal->dev, hal->timer_id);
61 return timer_ll_get_counter_value(hal->dev, hal->timer_id);
62 }
63
