68 lines
2.5 KiB
C
68 lines
2.5 KiB
C
/******************************************************************************
|
||
* @file app_disp.h
|
||
* @brief CBR3 数码管显示：温度/湿度整数、负号、-- 故障、告警闪烁
|
||
* @author cyWu <1917507415@qq.com>
|
||
* @date 2026.09.02
|
||
* @version V2.0.0（规格书 V3.0.0）：闪烁改第 8.2 节——有有效联动配置时按
|
||
* 「是否落在 [min,max]」闪，出范围就闪、与被作废/是否吹风无关；
|
||
* 喂入方是 app_linkage（也可用 BOARD_DISP_ALARM_TEST 宏强制验证）
|
||
*
|
||
* @note 两块 2 位 7 段数码管：温度管整数 ℃、湿度管整数 %。DP 恒灭。
|
||
* 0~99 显示绝对值；<0 显示 -9~-1（G 段负号）；<-9 钳位 -9；>99 钳位 99。
|
||
* 连续失败 3 次双管 "--"（优先于闪烁）。告警闪烁（规格书 8.2）
|
||
* 与吹风解耦：超范围侧 500ms 亮/500ms 灭，带内侧常亮数值。
|
||
******************************************************************************/
|
||
|
||
#ifndef __APP_DISP_H__
|
||
#define __APP_DISP_H__
|
||
|
||
#include <stdint.h>
|
||
|
||
/**
|
||
* @brief 初始化显示模块
|
||
* @return 无
|
||
*/
|
||
void app_disp_init(void);
|
||
|
||
/**
|
||
* @brief 业务节拍：计算 4 位要显示什么，写入段码缓冲（不直接打管）
|
||
* @param dt 距上次调用的毫秒数（闪烁相位累加）
|
||
* @note 软关机由 app_disp_scan 处理；本函数只算数据。
|
||
* @return 无
|
||
*/
|
||
void app_disp_run(uint16_t dt);
|
||
|
||
/**
|
||
* @brief 显示动态扫描（快节拍定时器回调）：每次点亮 1 位，4 位轮询刷新
|
||
* @note 由 app_disp_init 注册的 BOARD_DISP_SCAN_MS 定时器调用；
|
||
* 必须短、不可阻塞；软关机时 4 位全灭。
|
||
* CT1642 无内部扫描 RAM，靠本函数持续轮询维持 4 位同亮不闪。
|
||
* @return 无
|
||
*/
|
||
void app_disp_scan(void);
|
||
|
||
/**
|
||
* @brief 设置温度超范围标志：超范围时温度管 500ms 闪烁（app_linkage 喂，
|
||
* 规格书 8.2：T>Tmax 或 T<Tmin；含等于不算超）
|
||
* @param en 1=超范围（闪），0=带内（常亮数值）
|
||
* @return 无
|
||
*/
|
||
void app_disp_set_temp_alarm(uint8_t en);
|
||
|
||
/**
|
||
* @brief 设置湿度超范围标志：超范围时湿度管 500ms 闪烁（app_linkage 喂，
|
||
* 规格书 8.2：H>Hmax 或 H<Hmin）
|
||
* @param en 1=超范围（闪），0=带内（常亮数值）
|
||
* @return 无
|
||
*/
|
||
void app_disp_set_humi_alarm(uint8_t en);
|
||
|
||
/**
|
||
* @brief 温度或湿度管是否处于告警闪烁
|
||
* @return 1=任一侧告警，0=无
|
||
*/
|
||
uint8_t app_disp_is_alarm(void);
|
||
|
||
#endif /* __APP_DISP_H__ */
|
||
|