Files
JBao_Door_Clamp_FW/apps/usr_app/app_led.h
T

70 lines
1.8 KiB
C

/******************************************************************************
* @file app_led.h
* @brief CBC2 灯效优先级:充电 > 配对 > 软关 > 低电 > 切模式闪 > 开机绿灯提示后灭
* @author cyWu <1917507415@qq.com>
* @date 2026.08.25
* @version V1.1.0
* @history
* - V1.0.0, 2026.08.21, cyWu, 首次发布
* - V1.1.0, 2026.08.25, cyWu, 开机绿灯只提示几秒,避免待机常亮耗电
******************************************************************************/
#ifndef __APP_LED_H__
#define __APP_LED_H__
#include <stdint.h>
typedef enum {
APP_LED_OK = 0,
APP_LED_ERR_NOT_INIT
} AppLed_Ret_t;
typedef struct {
uint8_t charge_led; /**< 0=无 1=充电红常亮 2=充满绿常亮 */
uint8_t pairing; /**< 1=配对中绿快闪 */
uint8_t app_power; /**< DP0,为 0 则功能灯灭 */
uint8_t low_bat; /**< 1=低电红闪 */
uint8_t life_on; /**< 1=允许显示开机灯效 */
} AppLedCtx_t;
/**
* @brief 灯效初始化,先全灭
* @return APP_LED_OK=成功
*/
AppLed_Ret_t app_led_init(void);
/**
* @brief 按优先级刷新灯
* @param ctx 充电/配对/开关/低电状态,不可为空
* @param dt 距上次调用的毫秒数
* @return 无
*/
void app_led_tick_1ms(const AppLedCtx_t *ctx, uint16_t dt);
/**
* @brief 请求切模式绿灯闪两下
* @return 无
*/
void app_led_request_mode_blink(void);
/**
* @brief 重新亮几秒开机绿灯
* @return 无
*/
void app_led_hint_power_on(void);
/**
* @brief 播放一次性配对结果灯
* @param ok 1=成功常绿,0=失败红绿交替
* @return 无
*/
void app_led_start_pair_result(uint8_t ok);
/**
* @brief 查询是否已初始化
* @return APP_LED_OK=已初始化,APP_LED_ERR_NOT_INIT=未初始化
*/
AppLed_Ret_t app_led_get_status(void);
#endif /* __APP_LED_H__ */