QUERY · ISSUE

docs: ESP32 C3 and C6 has only 2 Timers (0 and 2)

openby dmoibmopened 2025-01-12updated 2025-02-20

port-esp32

Documentation URL

https://docs.micropython.org/en/latest/esp32/quickref.html#timers

Description

A note for ESP32 C3 and C6 would be helpful. These only have two timers, Timer(0) and Timer(2)

Code of Conduct

Yes, I agree

CANDIDATE · PULL REQUEST

esp32/machine_timer.c: Restrict timer numbers for ESP32C3 to 0 and 1.

mergedby robert-hhopened 2024-04-03updated 2024-07-23

port-esp32

The ESP32C3 has only two timers in one group. Previously trying to use timer 3 caused a core dump.

Addresses the issue uncovered in discussion #14235.

Assessment

S Sonnet · high

Both concern the same hardware limitation: ESP32C3 has fewer timers than a full ESP32. The PR (#14245) adds a code-level guard to prevent crashes when invalid timer numbers are used on ESP32C3, addressing the root cause from a safety perspective. However, the query is a documentation request for the quickref page, which the PR does not touch. Additionally, there are discrepancies: the PR covers only ESP32C3 (not C6), and restricts to timers 0 and 1 (not 0 and 2 as the query states), suggesting the timer numbering/indexing may differ between what the user observes and what the code enforces. The doc request remains open regardless of this PR's merge status.

Suggested action

Keep the issue open as a documentation task. Reference PR #14245 for context on the hardware constraint. Clarify the correct valid timer numbers for C3 and C6 respectively (the PR says 0–1, the issue says 0 and 2), then add a variant-specific note to docs/esp32/quickref.rst covering both C3 and C6.