1menu "High resolution timer (esp_timer)"
2
3    config ESP_TIMER_PROFILING
4        bool "Enable esp_timer profiling features"
5        default n
6        help
7            If enabled, esp_timer_dump will dump information such as number of times the timer was started,
8            number of times the timer has triggered, and the total time it took for the callback to run.
9            This option has some effect on timer performance and the amount of memory used for timer
10            storage, and should only be used for debugging/testing purposes.
11
12    config ESP_TIME_FUNCS_USE_RTC_TIMER  # [refactor-todo] remove when timekeeping and persistence are separate
13        bool
14
15    config ESP_TIME_FUNCS_USE_ESP_TIMER  # [refactor-todo] remove when timekeeping and persistence are separate
16        bool
17
18    config ESP_TIME_FUNCS_USE_NONE  # [refactor-todo] remove when timekeeping and persistence are separate
19        bool
20
21    config ESP_TIMER_TASK_STACK_SIZE
22        int "High-resolution timer task stack size"
23        default 3584
24        range 2048 65536
25        help
26            Configure the stack size of "timer_task" task. This task is used
27            to dispatch callbacks of timers created using ets_timer and esp_timer
28            APIs. If you are seing stack overflow errors in timer task, increase
29            this value.
30
31            Note that this is not the same as FreeRTOS timer task. To configure
32            FreeRTOS timer task size, see "FreeRTOS timer task stack size" option
33            in "FreeRTOS" menu.
34
35    config ESP_TIMER_INTERRUPT_LEVEL
36        int "Interrupt level"
37        default 1
38        range 1 3 if IDF_TARGET_ESP32
39        range 1 1 if !IDF_TARGET_ESP32
40        help
41            It sets the interrupt level for esp_timer ISR in range 1..3.
42            A higher level (3) helps to decrease the ISR esp_timer latency.
43
44    config ESP_TIMER_SUPPORTS_ISR_DISPATCH_METHOD
45        bool "Support ISR dispatch method"
46        default n
47        help
48            Allows using ESP_TIMER_ISR dispatch method (ESP_TIMER_TASK dispatch method is also avalible).
49            - ESP_TIMER_TASK - Timer callbacks are dispatched from a high-priority esp_timer task.
50            - ESP_TIMER_ISR - Timer callbacks are dispatched directly from the timer interrupt handler.
51            The ISR dispatch can be used, in some cases, when a callback is very simple
52            or need a lower-latency.
53
54    choice ESP_TIMER_IMPL
55        prompt "Hardware timer to use for esp_timer"
56        default ESP_TIMER_IMPL_TG0_LAC if IDF_TARGET_ESP32
57        default ESP_TIMER_IMPL_SYSTIMER
58        help
59            esp_timer APIs can be implemented using different hardware timers.
60
61            - "FRC2 (legacy)" implementation has been used in ESP-IDF v2.x - v4.1.
62
63            - "LAC timer of Timer Group 0" implementation is simpler, and has smaller
64              run time overhead because software handling of timer overflow is not needed.
65
66            - "SYSTIMER" implementation is similar to "LAC timer of Timer Group 0" but for non ESP32 chips.
67
68        config ESP_TIMER_IMPL_FRC2
69            bool "FRC2 (legacy) timer"
70            depends on IDF_TARGET_ESP32
71
72        config ESP_TIMER_IMPL_TG0_LAC
73            bool "LAC timer of Timer Group 0"
74            depends on IDF_TARGET_ESP32
75
76        config ESP_TIMER_IMPL_SYSTIMER
77            bool "SYSTIMER"
78            depends on !IDF_TARGET_ESP32
79
80    endchoice
81
82endmenu # esp_timer
83