69 lines
1.8 KiB
C
69 lines
1.8 KiB
C
/******************************************************************************
|
||
* @file app_th.h
|
||
* @brief CBR3 温湿度采集：2s 周期、失败计数、最近有效值
|
||
* @author cyWu <1917507415@qq.com>
|
||
* @date 2026.08.31
|
||
* @version V1.1.0，发令阶段 nack 也计入连续失败
|
||
*
|
||
* @note 规格书 8.4：联动只在本次采样成功时用新值比较；采样失败保持
|
||
* 上一有效值继续判（与显示一致），直到连续 3 次失败显示 "--"
|
||
* （DP24 fault_code=1）。fault_code=2 预留，本模块只给出
|
||
* is_fault，由 app_function 映射。
|
||
******************************************************************************/
|
||
|
||
#ifndef __APP_TH_H__
|
||
#define __APP_TH_H__
|
||
|
||
#include <stdint.h>
|
||
|
||
/**
|
||
* @brief 初始化温湿度模块
|
||
* @return 无
|
||
*/
|
||
void app_th_init(void);
|
||
|
||
/**
|
||
* @brief 业务节拍：内部 2s 才真正采一次；采的时候走总线互斥
|
||
* @param dt 距上次调用的毫秒数
|
||
* @return 无
|
||
*/
|
||
void app_th_poll(uint16_t dt);
|
||
|
||
/**
|
||
* @brief 是否已有有效采样
|
||
* @return 1=有效，0=从未成功
|
||
*/
|
||
uint8_t app_th_get_valid(void);
|
||
|
||
/**
|
||
* @brief 最近一次有效温度
|
||
* @return 温度 ×10（如 25.3℃ → 253）
|
||
*/
|
||
int16_t app_th_get_temp_x10(void);
|
||
|
||
/**
|
||
* @brief 最近一次有效湿度
|
||
* @return 湿度 0~100 整数 %
|
||
*/
|
||
uint8_t app_th_get_humi(void);
|
||
|
||
/**
|
||
* @brief 连续失败次数
|
||
* @return 连续失败次数
|
||
*/
|
||
uint8_t app_th_get_fail_cnt(void);
|
||
|
||
/**
|
||
* @brief 传感器故障（连续失败 ≥ BOARD_TH_FAIL_MAX）
|
||
* @return 1=故障（显示 --、fault_code=1），0=正常
|
||
*/
|
||
uint8_t app_th_is_fault(void);
|
||
|
||
/**
|
||
* @brief 最近一次采样是否成功（app_linkage / app_disp 用，规格书 8.4）
|
||
* @return 1=成功，0=失败/未采样过
|
||
*/
|
||
uint8_t app_th_last_sample_ok(void);
|
||
|
||
#endif /* __APP_TH_H__ */
|