Skip to content

Commit 4deac09

Browse files
committed
[docs][clock_time] Update clock time subsystem documentation
- Update device driver index to use correct page reference - Clarify upper layer responsibilities in architecture overview - Update README to describe POSIX/libc, Soft RTC, and device driver usage - Refine architecture diagram with improved layout and color scheme - Remove obsolete clock_timer.md file
1 parent 0835bca commit 4deac09

File tree

5 files changed

+98
-478
lines changed

5 files changed

+98
-478
lines changed

documentation/6.components/device-driver/INDEX.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@
88
- @subpage page_device_spi
99
- @subpage page_device_pwm
1010
- @subpage page_device_rtc
11-
- @subpage page_device_clock_timer
11+
- @subpage page_device_clock_time
1212
- @subpage page_device_watchdog
1313
- @subpage page_device_wlan
1414
- @subpage page_device_sensor

documentation/6.components/device-driver/clock_time/README.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -13,9 +13,11 @@ hardware counters and timers while the kernel and libc see consistent behavior.
1313

1414
## Layering and Responsibilities
1515

16-
- Upper layers: kernel services (timeouts, delays), POSIX/libc time APIs
17-
(clock_gettime, nanosleep), and RTC/soft-RTC consume the monotonic time base
18-
and timer events exposed by clock_time.
16+
- Upper layers:
17+
- POSIX/libc time APIs (clock_gettime, nanosleep) use boottime and hrtimer APIs.
18+
- Soft RTC uses boottime as its monotonic time base for timekeeping.
19+
- Device drivers (input event timestamps, vDSO, PIC statistics) use boottime
20+
for timestamping.
1921
- clock_time subsystem: core APIs, clock source/event devices, the hrtimer
2022
scheduler, boottime helpers, and the clock_timer adapter.
2123
- Lower layers: BSP drivers provide hardware counters and timers, which are

documentation/6.components/device-driver/clock_time/README_zh.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,8 +10,10 @@ clock_time 子系统为 RT-Thread 提供统一的高精度时间基准与事件
1010

1111
## 分层关系与职责
1212

13-
- 上层:内核超时/延时、POSIX/libc 时间接口(clock_gettime、nanosleep),
14-
以及 RTC/软 RTC,直接使用 clock_time 提供的时间与事件能力。
13+
- 上层:
14+
- POSIX/libc 时间接口(clock_gettime、nanosleep)使用 boottime 和 hrtimer API。
15+
- 软 RTC 使用 boottime 作为单调时间基准进行计时。
16+
- 设备驱动(输入事件时间戳、vDSO、中断控制器统计)使用 boottime 获取时间戳。
1517
- clock_time 子系统:核心 API、时钟源/事件设备、高精度定时器调度器、
1618
boottime 辅助函数、clock_timer 适配层。
1719
- 下层:BSP 驱动提供硬件计数器与定时器,并封装为 clock_time 设备或
Lines changed: 88 additions & 70 deletions
Loading

0 commit comments

Comments
 (0)