refactor(device): 移除备份配置文件并完善ADC模块注释
移除不再需要的 .cproject.yml.bak_dma 和 README.md 备份文件, 同时为 ADC.cpp 添加完整的 Doxygen 风格函数注释,提升代码可读性。
This commit is contained in:
@@ -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 */
|
||||
Reference in New Issue
Block a user