refactor(gml670x4): 将函数注释统一迁移到源文件

inc/ads1256.h

@@ -4,52 +4,11 @@
 /* sensor.c 切换通道时需要此寄存器地址 */
 #define ADS1256_REG_MUX 0x01
 
-/**
- * @brief 初始化 ADS1256：配置 GPIO/SPI，复位芯片，写入寄存器，自校准。
- * @return 0 成功，负 errno 失败。
- */
 int ads1256_init(void);
-
-/**
- * @brief 等待 DRDY 拉低（转换结果可读），带超时保护。
- * @param timeout_ms 超时时间（毫秒）。
- * @return 0 成功，-ETIMEDOUT 超时。
- */
 int ads1256_wait_drdy(uint16_t timeout_ms);
-
-/**
- * @brief 向 ADS1256 写单个寄存器。
- * @param reg 目标寄存器地址。
- * @param val 要写入的值。
- */
 void ads1256_write_reg(uint8_t reg, uint8_t val);
-
-/**
- * @brief 从 ADS1256 读单个寄存器。
- * @param reg 目标寄存器地址。
- * @return 寄存器值。
- */
 uint8_t ads1256_read_reg(uint8_t reg);
-
-/**
- * @brief 发送 SYNC + WAKEUP 命令，触发一次同步采样。
- */
 void ads1256_sync_wakeup(void);
-
-/**
- * @brief 硬件复位 ADS1256（通过 RESET 引脚），等待复位后自校准完成。
- * @return 0 成功，-ETIMEDOUT 芯片无响应。
- */
 int ads1256_hwreset(void);
-
-/**
- * @brief 读取当前 24 位转换结果，符号扩展为 int32_t。
- * @return ADC 原始值。
- */
 int32_t ads1256_read_data(void);
-
-/**
- * @brief 发送单字节命令到 ADS1256。
- * @param cmd 命令字。
- */
 void ads1256_write_cmd(uint8_t cmd);

inc/ble_transport.h

@@ -2,27 +2,9 @@
 #include <stdbool.h>
 #include <stdint.h>
 
-/**
- * @brief 初始化 BLE 协议栈、NUS 服务和内部状态。
- * @return 0 成功，负 errno 失败。
- */
 int ble_transport_init(void);
-
-/**
- * @brief 启动 BLE 广播。
- */
 void ble_transport_adv_start(void);
-
-/**
- * @brief 通过 NUS 发送二进制帧，自动重试最多 3 次。未连接或通知未开启时静默丢弃。
- * @param data 待发送字节缓冲区。
- * @param len  字节数。
- */
 void ble_transport_send(const uint8_t *data, uint16_t len);
-
-/**
- * @brief 检查是否已连接且通知已使能。
- */
 bool ble_transport_is_ready(void);
 
 /* --- 下行参数 getter --- */

inc/button.h

@@ -1,7 +1,3 @@
 #pragma once
 
-/**
- * @brief 初始化按键模块：Button1 按下触发去皮 + LED1 闪烁反馈。
- * @return 0 成功，负 errno 失败。
- */
 int button_init(void);

inc/sensor.h

@@ -1,14 +1,4 @@
 #pragma once
 
-/**
- * @brief 初始化压力传感器模块：ADS1256 硬件 + 初始去皮 + 创建采集线程。
- *
- * 调用后采集线程自动启动，以 50 Hz 循环采集 → CoP → BLE 发送。
- * @return 0 成功，负 errno 失败。
- */
 int sensor_init(void);
-
-/**
- * @brief 执行四路去皮（零点校准），可从任意线程调用。
- */
 void sensor_perform_tare(void);