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 · ISSUE

esp32: Virtual timers not currently supported in doc

closedby jejopened 2021-02-26updated 2021-03-04

According to this page: http://docs.micropython.org/en/latest/esp32/quickref.html#timers virtual timers are not supported.
But it seems to work in real life with a -1 timer.
Is it a problem of documentation update?

from machine import Timer

t = Timer(-1)
t.init(period=1000, mode=Timer.PERIODIC, callback=lambda t:print("Working"))

while True:
    pass

Working
Working
Working
...

Assessment

Q Qwen · high

Both issues concern ESP32 timer documentation in the quickref. Issue #16573 requests documenting that ESP32 C3/C6 have only 2 hardware timers (0 and 2). Issue #6967 discusses virtual timers (Timer(-1)) appearing to work despite documentation saying they're unsupported. While both relate to ESP32 timer documentation, they address different aspects: #16573 is about variant-specific hardware limitations (C3/C6 having only 2 timers), while #6967 is about virtual timer support. The candidate does not resolve the query about C3/C6 timer count documentation.

Suggested action

Keep both issues open as they address different documentation needs. #16573 should be addressed to document C3/C6 hardware limitations, while #6967 needs investigation into whether virtual timers are actually supported or if the documentation is incorrect.