/******************************************************************************
 * @file    app_timer_task.h
 * @brief   CBR0 定时引擎（规格书第 11 章，P2：7 组 11B 配置 + time_en + RTC 门闩）
 * @author  cyWu <1917507415@qq.com>
 * @date    2026.09.04
 * @version V1.1.0，P0 = 骨架（BOARD_TIMER_ENABLE=0）
 ******************************************************************************/

#ifndef __APP_TIMER_TASK_H__
#define __APP_TIMER_TASK_H__

#include <stdint.h>

/**
 * @brief  初始化定时引擎（RTC 门闩：usr_rtc_get_time 失败等同 time_en=0）
 * @return 无
 */
void app_timer_init(void);

/**
 * @brief  500ms 任务上下文跑定时引擎（窗开始开 / 窗结束关 + 联动立刻重判）
 * @param  dt 距上次调用的毫秒数（=500）
 * @return 无
 */
void app_timer_run(uint16_t dt);

/**
 * @brief  APP 写 DP12 定时总开关
 * @param  en 0=关（所有窗立刻视为结束，关灯），1=开
 * @return 无
 */
void app_timer_set_en(uint8_t en);

/**
 * @brief  APP 写 DP13~19 定时配置（11 字节，规格书 11.1）
 * @param  idx 1~7
 * @return 无
 */
void app_timer_set_config(uint8_t idx);

#endif /* __APP_TIMER_TASK_H__ */