/******************************************************************************
 * @file    app_fan.h
 * @brief   CBR3 风扇档位：0/1/2/3 → 0%/50%/75%/100%
 * @author  cyWu <1917507415@qq.com>
 * @date    2026.08.29
 * @version V1.0.0
 * @history
 * - V1.0.0, 2026.08.29, cyWu, 首次发布
 ******************************************************************************/

#ifndef __APP_FAN_H__
#define __APP_FAN_H__

#include <stdint.h>

/**
 * @brief  初始化风扇（档位 0，PWM 关）
 * @return 无
 */
void app_fan_init(void);

/**
 * @brief  设置档位并立即生效（P0 无软爬坡）
 * @param  gear 0=关，1=50%，2=75%，3=100%；>3 钳位到 3
 * @return 无
 */
void app_fan_set_gear(uint8_t gear);

/**
 * @brief  查询当前真实档位（DP2 必须等于它，通风停段时为 0）
 * @return 0~3
 */
uint8_t app_fan_get_gear(void);

/**
 * @brief  业务节拍（P0 无动作，保留接口供 P1 爬坡）
 * @param  dt 距上次调用的毫秒数
 * @return 无
 */
void app_fan_run(uint16_t dt);

#endif /* __APP_FAN_H__ */