refactor(device): 移除备份配置文件并完善ADC模块注释

移除不再需要的 .cproject.yml.bak_dma 和 README.md 备份文件，同时为 ADC.cpp 添加完整的 Doxygen 风格函数注释，提升代码可读性。
2026-05-10 21:27:51 +08:00
parent 4b8b47bc9b
commit 078ea06317
77 changed files with 1326 additions and 6074 deletions
@@ -12,17 +12,17 @@
 * @note 每个枚举值对应任务调度器中的一个任务位，用于驱动主循环中的任务分发。
 */
 enum system_task_t {
-    TASK_ADC_VREF_SAMPLE = 0, /**< @brief 采样 VIN/VREF 原始值任务。 */
-    TASK_ADC_TEMP_SAMPLE,     /**< @brief 采样内部温度通道原始值任务。 */
-    TASK_ADC_PROCESS,         /**< @brief 对 ADC 原始值进行电压与温度计算任务。 */
-    TASK_CAN_RX_POLL,         /**< @brief 兼容保留的 CANFD 接收轮询任务。 */
-    TASK_CAN_RX_PARSE,        /**< @brief 解析并消费已接收 CANFD 帧任务。 */
-    TASK_CAN_TX_PREPARE,      /**< @brief 准备 CANFD 状态发送帧任务。 */
-    TASK_CAN_TX_SEND,         /**< @brief 发送已准备好的 CANFD 帧任务。 */
-    TASK_STATUS_LED,          /**< @brief 状态灯维护任务。 */
-    TASK_HEARTBEAT,           /**< @brief 系统心跳维护任务。 */
-    TASK_DIAGNOSTIC_PRINT,    /**< @brief 诊断信息打印任务。 */
-    TASK_COUNT                /**< @brief 任务总数，用于边界或统计场景。 */
+    TASK_ADC_VREF_SAMPLE = 0, /**< 采样 VIN/VREF 原始值任务。 */
+    TASK_ADC_TEMP_SAMPLE,     /**< 采样内部温度通道原始值任务。 */
+    TASK_ADC_PROCESS,         /**< 对 ADC 原始值进行电压与温度计算任务。 */
+    TASK_CAN_RX_POLL,         /**< 兼容保留的 CANFD 接收轮询任务。 */
+    TASK_CAN_RX_PARSE,        /**< 解析并消费已接收 CANFD 帧任务。 */
+    TASK_CAN_TX_PREPARE,      /**< 预留的 CANFD 发送准备任务，默认不主动置位。 */
+    TASK_CAN_TX_SEND,         /**< 预留的 CANFD 发送执行任务，默认不主动置位。 */
+    TASK_STATUS_LED,          /**< 状态灯维护任务。 */
+    TASK_HEARTBEAT,           /**< 系统心跳维护任务。 */
+    TASK_DIAGNOSTIC_PRINT,    /**< 诊断信息打印任务。 */
+    TASK_COUNT                /**< 任务总数，用于边界或统计场景。 */
 };

 /**
@@ -30,12 +30,23 @@ enum system_task_t {
 * @note 保存各类节拍计数器与待执行任务标志位，由中断与主循环共享访问。
 */
 struct task_scheduler_t {
-    volatile uint32_t task_flags; /**< @brief 待执行任务位图，每一位对应一个任务。 */
-    volatile uint32_t tick_100us; /**< @brief 100us 基准节拍累计计数。 */
-    volatile uint32_t tick_1ms;   /**< @brief 1ms 节拍累计计数。 */
-    volatile uint32_t tick_10ms;  /**< @brief 10ms 节拍累计计数。 */
-    volatile uint32_t tick_100ms; /**< @brief 100ms 节拍累计计数。 */
-    volatile uint32_t tick_1s;    /**< @brief 1s 节拍累计计数。 */
+    volatile uint32_t task_flags; /**< 待执行任务位图，每一位对应一个任务。 */
+    volatile uint32_t tick_100us; /**< 100us 基准节拍累计计数。 */
+    volatile uint32_t tick_1ms;   /**< 1ms 节拍累计计数。 */
+    volatile uint32_t tick_10ms;  /**< 10ms 节拍累计计数。 */
+    volatile uint32_t tick_100ms; /**< 100ms 节拍累计计数。 */
+    /** @brief 1s 节拍累计计数。 */
+    volatile uint32_t tick_1s;
+    /** @brief 调度分频计数：ADC VREF 采样。 */
+    volatile uint16_t div_vref_sample;
+    /** @brief 调度分频计数：ADC 温度采样/处理。 */
+    volatile uint16_t div_temp_sample;
+    /** @brief 调度分频计数：CAN 接收处理。 */
+    volatile uint16_t div_can_rx;
+    /** @brief 调度分频计数：状态灯。 */
+    volatile uint16_t div_can_tx;
+    /** @brief 调度分频计数：心跳与诊断打印。 */
+    volatile uint16_t div_heartbeat;
 };

 /**
@@ -50,10 +61,22 @@ extern task_scheduler_t g_scheduler;
 */
 class App {
 public:
+    /**
+     * @brief 运行应用主循环。
+     * @param[in]  无。
+     * @param[out] 无。
+     * @retval int 固定返回 0；在嵌入式常驻循环场景下通常不会真正返回。
+     */
    int run();

 private:
+    /**
+     * @brief 打印应用启动横幅与系统时钟信息。
+     * @param[in]  无。
+     * @param[out] 无。
+     * @retval    无返回值。
+     */
    void printBanner() const;
 };

-#endif /* MAIN_H */
+#endif /* MAIN_H */