#ifndef DEVICE_TIMER_H
#define DEVICE_TIMER_H

/**
 * @brief 用户调度定时器模块。
 * @note 负责建立 100us 基准节拍，并通过中断驱动任务调度器。
 */
class SchedulerTimer {
public:
    /** init 故障码（0=成功；经 0xA3 INIT_STATUS fault_codes[] 上报） */
    enum InitFault : uint8_t {
        kFaultOk          = 0U, /**< 成功 */
        kFaultNotEnabled  = 1U, /**< CTL0.CEN 未置位（定时器未使能） */
        kFaultPscMismatch = 2U, /**< PSC 回读与配置不一致 */
        kFaultCarMismatch = 3U, /**< CAR 回读与配置不一致 */
        kFaultNoTick      = 4U, /**< 100us 中断节拍未前进（NVIC/向量/优先级异常） */
    };

    /**
     * @brief 初始化用户调度定时器及其中断，并验证节拍真实运行。
     * @param[in]  无。
     * @param[out] 无。
     * @retval uint8_t InitFault 故障码（0=寄存器回读一致且 tick_100us 中断节拍已前进）。
     * @note      当前用于建立 100us 基准节拍，驱动 TaskManager::tick100us()。
     */
    static uint8_t init();

    /**
     * @brief TIMER2 中断处理入口。
     * @param[in]  无。
     * @param[out] 无。
     * @retval    无返回值。
     * @note      每次计数溢出时清除标志并调用 TaskManager::tick100us()。
     */
    static void onInterrupt();

private:
    /**
     * @brief 配置 TIMER2 基本时序参数。
     * @param[in]  无。
     * @param[out] 无。
     * @retval    无返回值。
     */
    static void configureTimer();

    /**
     * @brief 配置 TIMER2 的 NVIC 优先级。
     * @param[in]  无。
     * @param[out] 无。
     * @retval    无返回值。
     */
    static void configureNvic();
};

#endif /* DEVICE_TIMER_H */