docs: 补充核心分层中文注释

2026-09-29 18:18:44 +08:00
parent a77471a7b1
commit 9fd01bb61b
81 changed files with 1189 additions and 112 deletions
@@ -10,13 +10,16 @@
 #include "esp_err.h"
 #include "platform.h"

+/* platform facade 以下的板级驱动入口，不允许被上层组件直接包含。 */
 esp_err_t platform_stepper_driver_init(void);
+/* 旋转调用同步占有运动互斥锁，返回时不会残留后台运动。 */
 esp_err_t platform_stepper_driver_rotate_angle_with_accel(float angle,
                                                          int target_delay_us,
                                                          int timeout_ms);
 esp_err_t platform_stepper_driver_release_hold(int timeout_ms);
 void platform_stepper_driver_power_off(void);
 void platform_power_hold_init(void);
+/* 初始化板级灯带和脉冲输出任务；重复调用由实现保证幂等。 */
 esp_err_t platform_io_effects_init(void);
 esp_err_t platform_digital_input_driver_configure(const platform_digital_input_config_t *config);
 bool platform_digital_input_driver_is_active(const platform_digital_input_config_t *config);