This is an automated email from the ASF dual-hosted git repository. xiaoxiang781216 pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/nuttx.git
commit 7476af8842b97ce1374b83782ea97012ab5903ec Author: dechao_gong <[email protected]> AuthorDate: Wed Oct 14 17:15:04 2026 +0800 Documentation/rtl8730e: document the general-purpose timers Add the Features bullet and the timer config section for the two general-purpose timers on rtl8730e_evb: /dev/timer0 is TIM2 and /dev/timer1 is TIM3, both 32-bit LP basic timers at 32.768 kHz. Record why TIM0 and TIM1 are not exposed (ROM system timer, vendor HAL application and UART-timeout timer). Assisted-by: Claude <[email protected]> Signed-off-by: dechao_gong <[email protected]> --- .../arm/rtl8730e/boards/rtl8730e_evb/index.rst | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/Documentation/platforms/arm/rtl8730e/boards/rtl8730e_evb/index.rst b/Documentation/platforms/arm/rtl8730e/boards/rtl8730e_evb/index.rst index a39e1ca9494..a9d724a47ed 100644 --- a/Documentation/platforms/arm/rtl8730e/boards/rtl8730e_evb/index.rst +++ b/Documentation/platforms/arm/rtl8730e/boards/rtl8730e_evb/index.rst @@ -44,6 +44,8 @@ Supported in this NuttX port: polling mode through the SDK fwlib register layer * PWM output exposed as a ``/dev/pwm0`` character device, driven directly on the SDK fwlib timer layer +* General-purpose timers exposed as ``/dev/timerN`` character devices, with + microsecond timeouts and a periodic expiration callback * littlefs persistent storage mounted at ``/data`` (a dedicated SPI NOR flash partition), backing the Wi-Fi key-value store * Wi-Fi station and SoftAP through the ``wapi`` tool @@ -158,6 +160,21 @@ example:: nsh> pwm -d 25 -f 1000 # 1 kHz, 25% duty on /dev/pwm0 +timer +----- + +Minimal NSH with the timer driver and the ``timer`` example +(``examples/timer``) enabled (no Wi-Fi). The board registers two timers (see +``boards/arm/rtl8730e/rtl8730e_evb/src/rtl8730e_timer.c``): ``/dev/timer0`` +is TIM2 and ``/dev/timer1`` is TIM3, both 32-bit LP basic timers clocked at +32.768 kHz, so a tick is ~30.5 us and a single timeout reaches ~36 hours. +Neither has any board wiring. TIM0 and TIM1 are not exposed: the ROM claims +TIM0 as the system timer behind ``DelayUs()``/``SYSTIMER_*``, and the vendor +HAL claims TIM1 as its application and UART-timeout timer. Exercise a timer +with the example:: + + nsh> timer # 20 samples 0.1 s apart, 1 s timeout, on /dev/timer0 + Wi-Fi =====
