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_pwm.c: Add support for all PWM timers and channels.

closedby IhorNehrutsaopened 2021-09-18updated 2021-09-21

port-esp32

This pull request allows using all the available PWM timers (up to 8) and channels(up to 16),
without affecting the PWM API.

If a new frequency is set, first it checks if another timer is using
the same freq.
If yes, then it uses this timer, otherwise, it creates a new one.

If all timers are used, the user should set an already used frequency,
or de-init a channel.

This PR is based on #6276 and #3608.
Thanks, @p1ng0o
Thanks, @dragomirecky
Thanks, @dpgeorge

Tested on ESP WROOM 32
Need to test on ESP32 GENERIC_S2 and GENERIC_C3 boards.

Assessment

Q Qwen · high

The query (Issue #16573) is a documentation request to note that ESP32 C3 and C6 have only 2 timers (0 and 2). The candidate (PR #7817) is a feature implementation that expands PWM support to use all available timers (up to 8) and channels. While both items concern ESP32 timers and affect the same documentation file (docs/esp32/quickref.rst), they address different aspects: the PR implements a feature to utilize more timers, whereas the issue requests documentation about hardware limitations on specific variants. The PR does not resolve the documentation request about C3/C6 having only 2 timers; in fact, the PR's goal of using up to 8 timers might even contradict the limitation mentioned in the issue for those specific chips. They are related by topic (ESP32 timers) but the PR does not fix or implement what the issue asks for.

Suggested action

Keep both items open. The PR should be merged to implement the PWM feature. The issue should be addressed separately by updating the documentation to clarify timer availability per ESP32 variant (C3/C6 vs others).