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

移除不再需要的 .cproject.yml.bak_dma 和 README.md 备份文件,
同时为 ADC.cpp 添加完整的 Doxygen 风格函数注释,提升代码可读性。
This commit is contained in:
cbb
2026-05-10 21:27:51 +08:00
parent 4b8b47bc9b
commit 078ea06317
77 changed files with 1326 additions and 6074 deletions
+40 -2
View File
@@ -6,15 +6,53 @@
/**
* @brief 任务调度管理器。
* @note 负责维护节拍计数器与待执行任务位图。
* @note 负责维护各类节拍计数器与待执行任务位图,由定时器中断与主循环共享访问。
*/
class TaskManager {
public:
/**
* @brief 初始化调度器内部状态。
* @param[in] 无。
* @param[out] 无。
* @retval 无返回值。
* @note 将所有节拍计数器和任务标志位清零。
*/
static void init();
/**
* @brief 推进一次 100us 调度节拍。
* @param[in] 无。
* @param[out] 无。
* @retval 无返回值。
* @note 由 TIMER2 ISR 调用;按周期分档置位 ADC/CAN/LED/心跳/诊断等任务标志。
*/
static void tick100us();
/**
* @brief 原子地取出当前所有待执行任务位图并清零。
* @param[in] 无。
* @param[out] 无。
* @retval uint32_t 返回当前待执行任务位图。
* @note 内部通过关中断保证原子性,供 TaskRunner 消费。
*/
static uint32_t takePending();
/**
* @brief 置位一个或多个待执行任务标志。
* @param[in] taskMask 待置位的任务位图掩码。
* @param[out] 无。
* @retval 无返回值。
*/
static void set(uint32_t taskMask);
/**
* @brief 获取全局调度器状态对象引用。
* @param[in] 无。
* @param[out] 无。
* @retval task_scheduler_t& 全局调度器状态对象的引用。
* @note 提供外部模块对调度状态的可观型访问。
*/
static task_scheduler_t &state();
};
#endif /* SYS_TASK_MANAGER_H */
#endif /* SYS_TASK_MANAGER_H */