P0功能已实现,按键、LED、过零检测、配网、OTA都已正常实现

This commit is contained in:
2026-09-04 18:49:07 +08:00
parent 2fb61a6458
commit 0de88083ba
47 changed files with 5184 additions and 26 deletions
+113
View File
@@ -0,0 +1,113 @@
/******************************************************************************
* @file app_arbiter.c
* @brief 加热占用仲裁:手动 > 定时 > 联动
* @author cyWu <1917507415@qq.com>
* @date 2026.09.04
* @version V1.1.0
* @history
* - V1.1.0, 2026.09.04, cyWu, 精简注释(单标志不包结构体)
* - V1.0.0, 2026.09.04, cyWu, 由风扇仲裁器改为继电器开关
******************************************************************************/
#include "system/includes.h"
#include "app_arbiter.h"
#include "app_linkage.h"
#define LOG_TAG_CONST APP
#define LOG_TAG "[ARB]"
#define LOG_INFO_ENABLE
#include "debug.h"
static uint8_t s_owner;
/**
* @brief 初始化仲裁器
* @return 无
*/
void app_arbiter_init(void)
{
s_owner = ARB_OWNER_NONE;
log_info("arbiter init\n");
}
/**
* @brief 当前加热占用者
* @return ArbOwner_t
*/
uint8_t app_arbiter_get_owner(void)
{
return s_owner;
}
/**
* @brief 短按 / DP0:清占用并作废本轮联动
* @return 无
*/
void app_arbiter_manual_intervene(void)
{
if (s_owner != ARB_OWNER_NONE) {
log_info("manual intervene, owner %d -> none\n", s_owner);
}
s_owner = ARB_OWNER_NONE;
app_linkage_void();
}
/**
* @brief 联动引擎尝试占用
* @return 1=成功;0=定时占用中(12 章:定时窗内联动不插嘴)
*/
uint8_t app_arbiter_linkage_take(void)
{
if (s_owner == ARB_OWNER_TIMER) {
return 0;
}
if (s_owner != ARB_OWNER_LINKAGE) {
log_info("linkage take\n");
}
s_owner = ARB_OWNER_LINKAGE;
return 1;
}
/**
* @brief 联动是否仍在占用
* @return 1=owner==LINKAGE
*/
uint8_t app_arbiter_linkage_active(void)
{
return (s_owner == ARB_OWNER_LINKAGE) ? 1 : 0;
}
/**
* @brief 联动自然失效:让出占用(请求关由调用方发)
* @return 无
*/
void app_arbiter_linkage_release(void)
{
if (s_owner == ARB_OWNER_LINKAGE) {
s_owner = ARB_OWNER_NONE;
}
}
/**
* @brief 定时窗开始占用(优先级高于联动)
* @return 1=成功
*/
uint8_t app_arbiter_timer_take(void)
{
if (s_owner != ARB_OWNER_TIMER) {
log_info("timer take\n");
}
s_owner = ARB_OWNER_TIMER;
return 1;
}
/**
* @brief 定时窗结束释放(调用方负责收口:请求关 + 立刻按 10.3 补判联动)
* @return 无
*/
void app_arbiter_timer_release(void)
{
if (s_owner == ARB_OWNER_TIMER) {
s_owner = ARB_OWNER_NONE;
}
}
+68
View File
@@ -0,0 +1,68 @@
/******************************************************************************
* @file app_arbiter.h
* @brief 加热占用仲裁:手动 > 定时 > 联动(规格书第 12 章)
* @author cyWu <1917507415@qq.com>
* @date 2026.09.04
* @version V1.1.0
******************************************************************************/
#ifndef __APP_ARBITER_H__
#define __APP_ARBITER_H__
#include <stdint.h>
typedef enum {
ARB_OWNER_NONE = 0, /**< 空闲 / 手动接管 */
ARB_OWNER_LINKAGE = 1, /**< 联动占用 */
ARB_OWNER_TIMER = 2 /**< 定时占用 */
} ArbOwner_t;
/**
* @brief 初始化仲裁器
* @return 无
*/
void app_arbiter_init(void);
/**
* @brief 当前加热占用者
* @return ArbOwner_t
*/
uint8_t app_arbiter_get_owner(void);
/**
* @brief 短按 / DP0:清占用并作废本轮联动
* @return 无
*/
void app_arbiter_manual_intervene(void);
/**
* @brief 联动尝试占用
* @return 1=成功;0=定时占用中
*/
uint8_t app_arbiter_linkage_take(void);
/**
* @brief 联动是否仍在占用
* @return 1=是
*/
uint8_t app_arbiter_linkage_active(void);
/**
* @brief 联动自然失效,让出占用
* @return 无
*/
void app_arbiter_linkage_release(void);
/**
* @brief 定时窗开始占用
* @return 1=成功
*/
uint8_t app_arbiter_timer_take(void);
/**
* @brief 定时窗结束释放
* @return 无
*/
void app_arbiter_timer_release(void);
#endif /* __APP_ARBITER_H__ */
+57
View File
@@ -0,0 +1,57 @@
/******************************************************************************
* @file app_defer.c
* @brief ISR→任务上下文的延后执行标志位实现
* @author cyWu <1917507415@qq.com>
* @date 2026.08.31
* @version V1.0.0,首次发布
******************************************************************************/
#include "system/includes.h"
#include "app_defer.h"
/** 位掩码,volatilerequest() 在中断上下文写,take()/is_pending()/cancel()
* 在任务上下文读写,两侧都用 local_irq_disable/enable 包一下读改写,
* 避免"任务侧正在清 A 位时中断侧设 B 位"这种读改写竞态把 B 位冲丢。 */
static volatile uint8_t s_flags;
void app_defer_request(AppDeferBit_t bit)
{
if (bit >= APP_DEFER_MAX) {
return;
}
local_irq_disable();
s_flags |= (uint8_t)(1u << bit);
local_irq_enable();
}
uint8_t app_defer_take(AppDeferBit_t bit)
{
uint8_t was_set;
if (bit >= APP_DEFER_MAX) {
return 0;
}
local_irq_disable();
was_set = (s_flags & (uint8_t)(1u << bit)) ? 1 : 0;
s_flags &= (uint8_t)~(1u << bit);
local_irq_enable();
return was_set;
}
uint8_t app_defer_is_pending(AppDeferBit_t bit)
{
if (bit >= APP_DEFER_MAX) {
return 0;
}
return (s_flags & (uint8_t)(1u << bit)) ? 1 : 0;
}
void app_defer_cancel(AppDeferBit_t bit)
{
if (bit >= APP_DEFER_MAX) {
return;
}
local_irq_disable();
s_flags &= (uint8_t)~(1u << bit);
local_irq_enable();
}
+59
View File
@@ -0,0 +1,59 @@
/******************************************************************************
* @file app_defer.h
* @brief ISR→任务上下文的延后执行标志位(统一收口 2026-08-31 复位事故教训)
* @author cyWu <1917507415@qq.com>
* @date 2026.08.31
* @version V1.0.0,首次发布
*
* @note ⚠ 硬约束:flash 擦写(syscfg_write)、BLE 广播切换、关机收口等"重活"
* 禁止在 usr_timer_add 的中断上下文回调(本产品 20ms usr_timer_tick /
* 按键长按回调)里直接执行,只能在 usr_timer_loopBLE 线程,任务
* 上下文,栈充足)里执行。之前每个模块各自发明一个 pending 标志
* off_pending/pair_pending/ota_pending/nvm 的 s_need_save),
* 容易被后来的功能遗漏这条红线——本模块把"打标志"这一步收成统一
* 接口:ISR 只准调 app_defer_request(),真正执行永远在
* app_function_loop() 里用 app_defer_take() 消费。
******************************************************************************/
#ifndef __APP_DEFER_H__
#define __APP_DEFER_H__
#include <stdint.h>
/** 延后动作位,新增一种"需要写flash/切广播/关机"的动作就加一项 */
typedef enum {
APP_DEFER_NVM_SAVE = 0, /**< VM 防抖到点,需要落盘 */
APP_DEFER_PAIR, /**< 长按 5s 松手,需要清绑定进配对 */
APP_DEFER_OTA, /**< 长按 12s 到点,需要进 OTA */
APP_DEFER_MAX
} AppDeferBit_t;
/**
* @brief 中断上下文调用:只置位,不做任何实际动作
* @param bit 要延后的动作
* @return 无
*/
void app_defer_request(AppDeferBit_t bit);
/**
* @brief 任务上下文调用:查询并清除标志(取出即消费,最多处理一次)
* @param bit 要消费的动作
* @return 1=之前挂起过(现在可以执行真正动作),0=没挂起
*/
uint8_t app_defer_take(AppDeferBit_t bit);
/**
* @brief 任务上下文调用:只查询是否挂起,不清除(多个动作互斥判断用)
* @param bit 要查询的动作
* @return 1=挂起中,0=未挂起
*/
uint8_t app_defer_is_pending(AppDeferBit_t bit);
/**
* @brief 任务上下文调用:撤销挂起(如 OTA 触发时要撤销配对)
* @param bit 要撤销的动作
* @return 无
*/
void app_defer_cancel(AppDeferBit_t bit);
#endif /* __APP_DEFER_H__ */
+160
View File
@@ -0,0 +1,160 @@
/******************************************************************************
* @file app_function.c
* @brief 功能总装:短按切加热、任务上下文落地配对/OTA
* @author cyWu <1917507415@qq.com>
* @date 2026.09.04
* @version V1.1.0
* @history
* - V1.1.0, 2026.09.04, cyWu, 精简注释
* - V1.0.0, 2026.09.04, cyWu, 首次发布
******************************************************************************/
#include "system/includes.h" /* 必须先于 app_main.hu8/u16/u32 等类型由 SDK 定义 */
#include "app_function.h"
#include "app_pair.h"
#include "app_relay.h"
#include "app_zc.h"
#include "app_arbiter.h"
#include "app_nvm.h"
#include "app_linkage.h"
#include "app_timer_task.h"
#include "app_runrec.h"
#include "app_defer.h"
#include "app_led.h"
#include "app_main.h"
#include "usr_le_api.h"
#include "jb_product.h"
#include "board_pin.h"
#include <string.h>
#define LOG_TAG_CONST APP
#define LOG_TAG "[APP_FUNC]"
#define LOG_INFO_ENABLE
#include "debug.h"
/**
* @brief 初始化功能模块
* @return 无
*/
void app_function_init(void)
{
}
/**
* @brief 任务上下文周期处理(配对 / OTA / 写 VM 只准在此落地)
* @return 无
*/
void app_function_loop(void)
{
uint8_t zc_evt = app_zc_consume_timeout();
if (zc_evt == 1) {
log_info("zc timeout 100ms: open request dropped, stay off, fault=2\n");
} else if (zc_evt == 2) {
log_info("zc timeout 100ms: force relay off, fault=2\n");
}
app_nvm_flush();
if (app_defer_take(APP_DEFER_OTA)) {
app_defer_cancel(APP_DEFER_PAIR);
usr_app_ota_init();
app_led_request_ota();
log_info("key hold 12s -> ota\n");
} else if (app_defer_take(APP_DEFER_PAIR)) {
usr_goto_pair_mode();
app_pair_start();
app_led_clear_pair_hint();
log_info("key hold 5s -> pair\n");
}
}
/**
* @brief 同步 DP0 = 继电器实际态
* @return 无
*/
void app_function_poll(void)
{
gDevData.heat_switch = app_relay_get_actual();
}
/**
* @brief 短按切换加热请求(OTA 中忽略)
* @return 无
*/
void usr_on_key_short(void)
{
uint8_t req;
if (app_led_is_ota()) {
return;
}
app_arbiter_manual_intervene();
req = app_relay_get_request() ? 0 : 1;
app_relay_request(req);
log_info("key short heat request=%d\n", req);
}
/**
* @brief 按住满 5s:配对提示灯(ISR 只动 RAM)
* @return 无
*/
void usr_on_key_pair_hint(void)
{
if (app_led_is_ota()) {
return;
}
app_led_hint_pair();
log_info("key hold 5s, pair hint (release to pair, keep to 12s for ota)\n");
}
/**
* @brief 按满 5s 后松手:置配对标志(写 VM 在 loop)
* @return 无
*/
void usr_on_key_pair_start(void)
{
if (app_led_is_ota()) {
return;
}
app_defer_request(APP_DEFER_PAIR);
log_info("key hold 5s released, pair pending\n");
}
/**
* @brief 按住满 12s:置 OTA 标志(BLE 切换在 loop
* @return 无
*/
void usr_on_key_ota_start(void)
{
if (app_led_is_ota()) {
return;
}
app_defer_request(APP_DEFER_OTA);
log_info("key hold 12s, ota pending\n");
}
/**
* @brief 出厂重置:清业务 VM/RAM,保留 BLE 配对
* @return 无
*/
void app_function_factory_reset(void)
{
app_nvm_reset();
app_relay_request(0);
app_arbiter_init();
app_linkage_init();
app_timer_init();
app_runrec_reset();
gDevData.heat_switch = 0;
gDevData.linkage_delete = 0;
gDevData.time_en = 0;
gDevData.fault_en = 0;
gDevData.alarm_en = 0;
gDevData.fault_code = 0;
gDevData.alarm_code = 0;
memset(gDevData.linkage_config, 0, BOARD_LINKAGE_CFG_LEN);
memset(gDevData.run_record, 0, sizeof(gDevData.run_record));
log_info("factory reset: business vm cleared, pairing kept\n");
}
+67
View File
@@ -0,0 +1,67 @@
/******************************************************************************
* @file app_function.h
* @brief 功能总装:按键动作 + DP 同步(配对/OTA 只在任务上下文落地)
* @author cyWu <1917507415@qq.com>
* @date 2026.09.04
* @version V1.1.0
******************************************************************************/
#ifndef __APP_FUNCTION_H__
#define __APP_FUNCTION_H__
#include <stdint.h>
/**
* @brief 初始化功能模块状态
* @return 无
*/
void app_function_init(void);
/**
* @brief 同步 DPDP0=继电器实际态、DP20=fault_code),每个 20ms 业务 tick 调用
* @note DP0 上报**实际吸合状态**(过零完成之后),让 APP 看见过零完成
* @return 无
*/
void app_function_poll(void);
/**
* @brief 任务上下文周期处理(usr_timer_loop 500ms
* @note 写 VM / 配对 / OTA 只准在此落地,禁止放进 20ms ISR
* @return 无
*/
void app_function_loop(void);
/**
* @brief 业务层短按回调(key_manager 触发):切换加热请求(开↔关,手动抢权)
* @return 无
*/
void usr_on_key_short(void);
/**
* @brief 业务层"按住满 5s"回调(key_manager 触发,20ms 中断上下文)
* @note 只切提示灯(绿灯快闪),不清绑定
* @return 无
*/
void usr_on_key_pair_hint(void);
/**
* @brief 业务层"按满 5s 后松手"回调(key_manager 触发,20ms 中断上下文)
* @note 只置标志:清绑定要写 VM,由 app_function_loop 在任务上下文执行
* @return 无
*/
void usr_on_key_pair_start(void);
/**
* @brief 业务层"按住满 12s"回调(key_manager 触发,20ms 中断上下文)
* @note 只置标志:usr_app_ota_init 由 app_function_loop 在任务上下文执行
* @return 无
*/
void usr_on_key_ota_start(void);
/**
* @brief 出厂重置(DP23 写 1):清业务 VM 与 RAM,保留 BLE 配对(规格书 14 章)
* @return 无
*/
void app_function_factory_reset(void);
#endif /* __APP_FUNCTION_H__ */
+190
View File
@@ -0,0 +1,190 @@
/******************************************************************************
* @file app_led.c
* @brief 灯效:跟继电器实际态;OTA / 配对优先(规格书第 6 章)
* @author cyWu <1917507415@qq.com>
* @date 2026.09.04
* @version V1.1.0
* @history
* - V1.1.0, 2026.09.04, cyWu, 精简注释
* - V1.0.0, 2026.09.04, cyWu, 首次发布
******************************************************************************/
#include "app_led.h"
#include "led_manager.h"
#include "bsp_hw.h"
#include "board_pin.h"
#include "app_pair.h"
#include "app_relay.h"
#include "system/includes.h"
#define LOG_TAG_CONST APP
#define LOG_TAG "[APP_LED]"
#define LOG_INFO_ENABLE
#include "debug.h"
typedef struct {
uint8_t inited; /**< 1=已初始化 */
uint8_t ota; /**< 1=OTA 灯效中,app_led_run 只跑交替 */
uint8_t pair_hint; /**< 1=长按已满 5s 但还没松手提交配对,维持配对快闪 */
} AppLedCtx_t;
static AppLedCtx_t s_led;
/**
* @brief 重新播放一次「一次性/限时」灯效,让它从第 0 帧重新开始
* @note 先 Delete 清空槽位再 Add,强制重新计时(见 led.c LED_EventAdd 语义)
* @param evt 要重启的事件
* @return 无
*/
static void led_restart(LED_Event_t evt)
{
LED_EventDelete(evt);
LED_EventAdd(evt);
}
/**
* @brief 灯效初始化
* @return APP_LED_OK=成功
*/
AppLed_Ret_t app_led_init(void)
{
if (s_led.inited) {
return APP_LED_OK;
}
#if BOARD_LED_ENABLE
user_led_init();
s_led.ota = 0;
s_led.pair_hint = 0;
s_led.inited = 1;
#else
log_info("led disabled\n");
#endif
return APP_LED_OK;
}
/**
* @brief 查询模块是否已初始化
* @return APP_LED_OK=已初始化,APP_LED_ERR_NOT_INIT=未初始化
*/
AppLed_Ret_t app_led_get_status(void)
{
return s_led.inited ? APP_LED_OK : APP_LED_ERR_NOT_INIT;
}
/**
* @brief 长按满 5s:绿灯 100ms 快闪提示(红灯灭)
* @return 无
*/
void app_led_hint_pair(void)
{
if (!s_led.inited || s_led.ota) {
return;
}
s_led.pair_hint = 1;
LED_EventAllDelete(); /* 清掉跟继电器灯,避免红绿混色 */
bsp_led_all_off();
LED_EventAdd(LED_EVENT_PAIRING);
}
/**
* @brief 结束"将配网"提示,交回 app_led_run 按 app_pair 状态接管
* @return 无
*/
void app_led_clear_pair_hint(void)
{
s_led.pair_hint = 0;
}
/**
* @brief 进入 OTA:清掉其它灯,挂红绿交替一直闪
* @return 无
*/
void app_led_request_ota(void)
{
if (!s_led.inited) {
return;
}
s_led.ota = 1;
s_led.pair_hint = 0; /* 已改判 OTA,撤销配网提示 */
LED_EventAllDelete();
bsp_led_all_off();
LED_EventAdd(LED_EVENT_OTA);
}
/**
* @brief 查询是否处于 OTA 灯效
* @return 1=OTA 灯效中,0=否
*/
uint8_t app_led_is_ota(void)
{
return s_led.ota;
}
/**
* @brief 按优先级刷新灯(20ms 业务节拍)
* @param dt 距上次调用的毫秒数
* @return 无
*/
void app_led_run(uint16_t dt)
{
AppPairEvt_t pair_evt;
if (!s_led.inited) {
return;
}
#if BOARD_LED_ENABLE
/* OTA 期间只跑红绿交替 */
if (s_led.ota) {
LED_EventAdd(LED_EVENT_OTA);
user_led_handle();
return;
}
/* 配对成功/失败是边沿事件,只在那一拍切灯效(先撤跟继电器灯避免混色) */
pair_evt = app_pair_tick_1ms(dt);
if (pair_evt == APP_PAIR_EVT_OK) {
LED_EventDelete(LED_EVENT_HEAT_ON);
LED_EventDelete(LED_EVENT_HEAT_OFF);
LED_EventDelete(LED_EVENT_PAIRING);
led_restart(LED_EVENT_PAIR_OK);
log_info("led pair ok 3s\n");
} else if (pair_evt == APP_PAIR_EVT_FAIL) {
LED_EventDelete(LED_EVENT_HEAT_ON);
LED_EventDelete(LED_EVENT_HEAT_OFF);
LED_EventDelete(LED_EVENT_PAIRING);
led_restart(LED_EVENT_PAIR_FAIL);
log_info("led pair fail 3s\n");
}
/* 配对提示 / 配对中:维持绿灯快闪(add 幂等,不重置计时) */
if (s_led.pair_hint || app_pair_is_active()) {
if (!LED_IsEventExist(LED_EVENT_PAIR_OK) &&
!LED_IsEventExist(LED_EVENT_PAIR_FAIL)) {
LED_EventAdd(LED_EVENT_PAIRING);
}
} else if (!LED_IsEventExist(LED_EVENT_PAIR_OK) &&
!LED_IsEventExist(LED_EVENT_PAIR_FAIL)) {
/* 无高事件:灯跟继电器实际态(过零完成之后) */
if (app_relay_get_actual()) {
LED_EventAdd(LED_EVENT_HEAT_ON);
} else {
LED_EventAdd(LED_EVENT_HEAT_OFF);
}
}
user_led_handle();
#endif
}
/**
* @brief 清空全部灯事件并灭灯
* @return 无
*/
void app_led_clear(void)
{
#if BOARD_LED_ENABLE
LED_EventAllDelete();
bsp_led_all_off();
#endif
}
+71
View File
@@ -0,0 +1,71 @@
/******************************************************************************
* @file app_led.h
* @brief 灯效:跟继电器实际态;OTA / 配对优先(规格书第 6 章)
* @author cyWu <1917507415@qq.com>
* @date 2026.09.04
* @version V1.1.0
******************************************************************************/
#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;
/**
* @brief 灯效初始化,先全灭(事件表装载)
* @return APP_LED_OK=成功
*/
AppLed_Ret_t app_led_init(void);
/**
* @brief 按优先级刷新灯(每 20ms 业务节拍调用)
* @param dt 距上次调用的毫秒数
* @note 内部读继电器实际态挂 HEAT 事件;同时推进配对会话计时
* app_pair_tick_1ms)并消费配对成功/失败边沿事件。
* @return 无
*/
void app_led_run(uint16_t dt);
/**
* @brief 长按满 5s 的"松手即配网"提示:绿灯 100ms 快闪(红灯灭)
* @note 此时还没清绑定(要等松手),只是给按住的用户反馈
* @return 无
*/
void app_led_hint_pair(void);
/**
* @brief 结束"将配网"提示(配对会话已由 app_pair 接管,或改判为 OTA
* @return 无
*/
void app_led_clear_pair_hint(void);
/**
* @brief 进入 OTA:清掉其它灯,挂红绿交替一直闪(最高优先级)
* @return 无
*/
void app_led_request_ota(void);
/**
* @brief 查询是否处于 OTA 灯效
* @return 1=OTA 灯效中,0=否
*/
uint8_t app_led_is_ota(void);
/**
* @brief 清空全部灯事件并灭灯
* @return 无
*/
void app_led_clear(void);
/**
* @brief 查询是否已初始化
* @return APP_LED_OK=已初始化,APP_LED_ERR_NOT_INIT=未初始化
*/
AppLed_Ret_t app_led_get_status(void);
#endif /* __APP_LED_H__ */
+126
View File
@@ -0,0 +1,126 @@
/******************************************************************************
* @file app_linkage.c
* @brief CBR1 联动引擎骨架(P0BOARD_LINKAGE_ENABLE=0
* @author cyWu <1917507415@qq.com>
* @date 2026.09.04
* @version V1.0.0P2 填充实现(规格书第 10 章)
******************************************************************************/
#include "system/includes.h"
#include "app_linkage.h"
#include "app_relay.h"
#include "board_pin.h"
#define LOG_TAG_CONST APP
#define LOG_TAG "[LINK]"
#define LOG_INFO_ENABLE
#include "debug.h"
static void linkage_disabled_once(void)
{
static uint8_t s_logged;
if (!s_logged) {
s_logged = 1;
log_info("app_linkage disabled (P2)\n");
}
}
/**
* @brief 初始化联动
* @return 无
*/
void app_linkage_init(void)
{
#if BOARD_LINKAGE_ENABLE
/* P2: 清作废标志(配置由 app_nvm_load 灌) */
#else
linkage_disabled_once();
#endif
}
/**
* @brief 500ms 任务上下文跑联动
* @param dt 距上次调用的毫秒数
* @return 无
*/
void app_linkage_run(uint16_t dt)
{
#if BOARD_LINKAGE_ENABLE
(void)dt;
/* P2: 有效配置 + 未作废 + 有温度 → 按 10.3 请求开/关 */
#else
(void)dt;
#endif
}
/**
* @brief 立刻重判(APP 重写 DP8 / 定时收口)
* @return 无
*/
void app_linkage_reeval(void)
{
#if !BOARD_LINKAGE_ENABLE
linkage_disabled_once();
#endif
}
/**
* @brief DP7 联动删除(脉冲)
* @return 无
*/
void app_linkage_delete(void)
{
#if !BOARD_LINKAGE_ENABLE
linkage_disabled_once();
#endif
}
/**
* @brief APP 重写 DP8
* @return 无
*/
void app_linkage_set_config(void)
{
#if !BOARD_LINKAGE_ENABLE
linkage_disabled_once();
#endif
}
/**
* @brief 手动作废本轮联动(仲裁器转调;P0 无联动,空操作)
* @return 无
*/
void app_linkage_void(void)
{
#if !BOARD_LINKAGE_ENABLE
/* P0:无联动引擎,无事可做 */
#endif
}
/**
* @brief 配置是否有效
* @return 1=有效
*/
uint8_t app_linkage_is_valid(void)
{
return 0; /* P0:无有效配置 */
}
/**
* @brief 缸体编号
* @return tank_id
*/
uint16_t app_linkage_get_tank_id(void)
{
return 0;
}
/**
* @brief 配置版本
* @return 版本号
*/
uint8_t app_linkage_get_cfg_ver(void)
{
return 0;
}
+76
View File
@@ -0,0 +1,76 @@
/******************************************************************************
* @file app_linkage.h
* @brief CBR1 联动引擎(第 10 章:1 条 20B DP8 配置,温度回差开/关)
* @author cyWu <1917507415@qq.com>
* @date 2026.09.04
* @version V1.0.0P0 = 骨架(BOARD_LINKAGE_ENABLE=0P2 填充)
*
* @note 开停只看温度(temp_x10,0.1℃ 有符号):
* T < Tmin → 请求开加热
* T > Tmax → 请求关加热
* [Tmin,Tmax] → 保持上一态
* 温度源:已连接=DP6(float×10);断连=扫描风扇 JBao-{tank} 广播。
* 丢广播/无效包 → 当没收到,保持上一态(禁止丢包关加热)。
******************************************************************************/
#ifndef __APP_LINKAGE_H__
#define __APP_LINKAGE_H__
#include <stdint.h>
/**
* @brief 初始化联动(配置有效性由 is_valid 判;作废标志清 0
* @return 无
*/
void app_linkage_init(void);
/**
* @brief 500ms 任务上下文跑联动:有效配置 + 未被手动作废 + 有有效温度才判
* @param dt 距上次调用的毫秒数(=500)
* @return 无
*/
void app_linkage_run(uint16_t dt);
/**
* @brief 立刻按当前温度重判一次(APP 重写 DP8 / 定时窗收口后调用)
* @return 无
*/
void app_linkage_reeval(void);
/**
* @brief DP7 联动删除(脉冲):清 RAM+VM 20B;联动占着则关;delete 清 0
* @return 无
*/
void app_linkage_delete(void);
/**
* @brief APP 重写 DP8memcpy 已完成):存 VM、清手动作废、立刻重判
* @return 无
*/
void app_linkage_set_config(void);
/**
* @brief 手动作废本轮联动(RAM,不写 VM;仲裁器唯一转调点)
* @return 无
*/
void app_linkage_void(void);
/**
* @brief 配置是否有效(缸体号≠0 且 Tmin≤Tmax)
* @return 1=有效
*/
uint8_t app_linkage_is_valid(void);
/**
* @brief 缸体编号(DP8 Byte0-1uint16 大端)
* @return tank_id
*/
uint16_t app_linkage_get_tank_id(void);
/**
* @brief 配置版本(DP8 Byte6,扫描匹配用)
* @return 版本号
*/
uint8_t app_linkage_get_cfg_ver(void);
#endif /* __APP_LINKAGE_H__ */
+123
View File
@@ -0,0 +1,123 @@
/******************************************************************************
* @file app_nvm.c
* @brief CBR1 VM 持久化(P1 起):heat_switch / linkage 20B / time_en /
* time_config1~7 / run_record 31天 / fault_en / alarm_en
* @author cyWu <1917507415@qq.com>
* @date 2026.09.04
* @version V1.0.0P0 = 空骨架(BOARD_NVM_ENABLE=0P1 填充)
*
* @note ⚠ 写 flash 只能在任务上下文(app_nvm_flush / app_nvm_save),
* 20ms 中断上下文只允许 app_nvm_tick 打脏。
******************************************************************************/
#include "system/includes.h"
#include "app_nvm.h"
#include "board_pin.h"
#define LOG_TAG_CONST APP
#define LOG_TAG "[APP_NVM]"
#define LOG_INFO_ENABLE
#include "debug.h"
static void nvm_disabled_once(void)
{
static uint8_t s_logged;
if (!s_logged) {
s_logged = 1;
log_info("app_nvm disabled (P1)\n");
}
}
/**
* @brief 初始化(P1:校验 VM 有效性)
* @return 无
*/
void app_nvm_init(void)
{
#if BOARD_NVM_ENABLE
/* P1: 校验 VM 有效性 */
#else
nvm_disabled_once();
#endif
}
/**
* @brief 立即保存全部业务字段(任务上下文)
* @return 无
*/
void app_nvm_save(void)
{
#if !BOARD_NVM_ENABLE
nvm_disabled_once();
#endif
}
/**
* @brief 立即保存运行记录 item(跨天旋转用)
* @return 无
*/
void app_nvm_save_runrec(void)
{
#if !BOARD_NVM_ENABLE
nvm_disabled_once();
#endif
}
/**
* @brief 从 VM 加载业务字段并应用(开机调用)
* @return 无
*/
void app_nvm_load(void)
{
#if BOARD_NVM_ENABLE
/* P1: heat_switch 恢复 + linkage/timer/run_record 回填 gDevData */
#else
nvm_disabled_once();
#endif
}
/**
* @brief 业务节拍(中断上下文):变化检测 + 防抖计时,不写 flash
* @param dt 距上次调用的毫秒数
* @return 无
*/
void app_nvm_tick(uint16_t dt)
{
#if !BOARD_NVM_ENABLE
(void)dt;
#endif
}
/**
* @brief 任务上下文落盘:防抖满后真正写 VM(500ms loop 调用)
* @return 无
*/
void app_nvm_flush(void)
{
#if !BOARD_NVM_ENABLE
nvm_disabled_once();
#endif
}
/**
* @brief 标记业务字段有变化,防抖计时归零
* @return 无
*/
void app_nvm_mark_dirty(void)
{
#if !BOARD_NVM_ENABLE
nvm_disabled_once();
#endif
}
/**
* @brief 出厂重置:清全部业务 VM(保留 BLE 配对)
* @return 无
*/
void app_nvm_reset(void)
{
#if !BOARD_NVM_ENABLE
nvm_disabled_once();
#endif
}
+83
View File
@@ -0,0 +1,83 @@
/******************************************************************************
* @file app_nvm.h
* @brief CBR1 VM 持久化(P1 起):heat_switch / linkage_config(20B) /
* time_en / time_config1~7 / run_record(31×uint32+日期) /
* fault_en / alarm_en(规格书第 13 章)
* @author cyWu <1917507415@qq.com>
* @date 2026.09.04
* @version V1.0.0P0 = 空骨架(BOARD_NVM_ENABLE=0
*
* @note 存:heat_switch、linkage_config(20B)、time_en、time_config1~7、
* run_record(31×uint32 + slot0 日期)、fault_en、alarm_en。
* 不存:DP1–5、DP6 当前温度、联动作废标志、过零 pending、
* linkage_delete(脉冲)、BLE 三元组(出厂重置不清)。
* 写 VM 时机:APP 改配置后(500ms 防抖);运行记录每累计 600s 一次、
* 跨天旋转立刻写。
*
* ⚠ 写 flash 只能在任务上下文(app_nvm_flush / app_nvm_save /
* app_nvm_save_runrec),20ms 中断上下文只允许 app_nvm_tick 打脏。
******************************************************************************/
#ifndef __APP_NVM_H__
#define __APP_NVM_H__
#include <stdint.h>
/**
* @brief 初始化(校验 VM 有效性,仅日志;数据加载在 app_nvm_load
* @return 无
*/
void app_nvm_init(void);
/**
* @brief 立即保存全部业务字段到 VM
* @note syscfg 写入不能在裸中断里调用;只由 app_nvm_flush()(任务上下文)调用
* @return 无
*/
void app_nvm_save(void);
/**
* @brief 立即保存运行记录 item(跨天旋转时用,任务上下文)
* @note 与 app_nvm_save 的区别:只写 31 天记录这一项,避免跨天时把
* 状态/配置一起无谓擦写一遍
* @return 无
*/
void app_nvm_save_runrec(void);
/**
* @brief 从 VM 加载业务字段并应用(开机调用):
* mode/fan_gear 恢复、联动/定时/运行记录回填 gDevData;mode 从周期头开跑
* @return 无
*/
void app_nvm_load(void);
/**
* @brief 业务节拍(中断上下文):变化检测 + 防抖计时,**不执行写入**
* @param dt 距上次调用的毫秒数
* @note ⚠ 跑在 usr_timer 20ms 回调 = 硬件定时器中断上下文,栈极小,
* 只允许轻量比较计时;禁止在此调 syscfg_write(会栈溢出复位)。
* @return 无
*/
void app_nvm_tick(uint16_t dt);
/**
* @brief 任务上下文落盘:防抖满后真正写 VM(由 usr_timer_loop 500ms 调用)
* @note 必须且只能在非中断上下文调用(VM 擦写 flash 栈用量大)
* @return 无
*/
void app_nvm_flush(void);
/**
* @brief 标记业务字段有变化,防抖计时归零(档位/模式/配置变化时调用)
* @return 无
*/
void app_nvm_mark_dirty(void);
/**
* @brief 出厂重置:清全部业务 VM(保留 BLE 配对,规格书第 14 章)
* @note 由 jb_product DP21 调用;RAM 复位由调用方完成
* @return 无
*/
void app_nvm_reset(void);
#endif /* __APP_NVM_H__ */
+74
View File
@@ -0,0 +1,74 @@
/******************************************************************************
* @file app_pair.c
* @brief 配对会话计时实现
* @author cyWu <1917507415@qq.com>
* @date 2026.08.25
* @version V1.0.0,首次发布,实现配对会话计时与成功/超时判定
******************************************************************************/
#include "app_pair.h"
#include "board_pin.h"
#include "usr_le_api.h"
#include "system/includes.h"
#define LOG_TAG_CONST APP
#define LOG_TAG "[APP_PAIR]"
#define LOG_INFO_ENABLE
#include "debug.h"
/** 配对会话状态,替代原来散落的 s_pairing / s_pair_ms */
typedef struct {
uint8_t active;
uint32_t elapsed_ms;
} AppPairCtx_t;
static AppPairCtx_t s_pair;
/**
* @brief 开始一次配对会话(计时清零)
* @return 无
*/
void app_pair_start(void)
{
s_pair.active = 1;
s_pair.elapsed_ms = 0;
}
/**
* @brief 推进配对计时并检查结果,每个业务 tick 调用一次
* @param dt 距上次调用的毫秒数
* @return APP_PAIR_EVT_OK=配对成功,APP_PAIR_EVT_FAIL=超时,否则 NONE
*/
AppPairEvt_t app_pair_tick_1ms(uint16_t dt)
{
if (!s_pair.active) {
return APP_PAIR_EVT_NONE;
}
/* BLE 侧绑定成功:结束本次配对会话 */
if (usr_get_pair_flag()) {
s_pair.active = 0;
s_pair.elapsed_ms = 0;
log_info("pair ok\n");
return APP_PAIR_EVT_OK;
}
s_pair.elapsed_ms += dt;
if (s_pair.elapsed_ms >= BOARD_PAIR_TIMEOUT_MS) {
s_pair.active = 0;
s_pair.elapsed_ms = 0;
log_info("pair timeout 120s, stay on\n");
return APP_PAIR_EVT_FAIL;
}
return APP_PAIR_EVT_NONE;
}
/**
* @brief 查询是否仍在配对会话中
* @return 1=进行中,0=未在配对
*/
uint8_t app_pair_is_active(void)
{
return s_pair.active;
}
+43
View File
@@ -0,0 +1,43 @@
/******************************************************************************
* @file app_pair.h
* @brief 配对会话计时:开机配对窗口是否成功/超时,与 BLE 配对本身解耦
* @author cyWu <1917507415@qq.com>
* @date 2026.08.25
* @version V1.0.0,首次发布,实现配对会话计时与成功/超时判定
*
* @note 真正的 BLE 广播/绑定逻辑在 usr_le_code;本模块只负责“进入配对后
* 120s 内 usr_get_pair_flag() 是否变 1”这件事,纯状态,不碰灯/按键。
******************************************************************************/
#ifndef __APP_PAIR_H__
#define __APP_PAIR_H__
#include <stdint.h>
/** 配对结果边沿事件,仅在状态变化那一次返回一次 */
typedef enum {
APP_PAIR_EVT_NONE = 0,
APP_PAIR_EVT_OK,
APP_PAIR_EVT_FAIL
} AppPairEvt_t;
/**
* @brief 开始一次配对会话(计时清零)
* @return 无
*/
void app_pair_start(void);
/**
* @brief 推进配对计时并检查结果,每个业务 tick 调用一次
* @param dt 距上次调用的毫秒数
* @return APP_PAIR_EVT_OK=配对成功,APP_PAIR_EVT_FAIL=超时,否则 NONE
*/
AppPairEvt_t app_pair_tick_1ms(uint16_t dt);
/**
* @brief 查询是否仍在配对会话中
* @return 1=进行中,0=未在配对
*/
uint8_t app_pair_is_active(void);
#endif /* __APP_PAIR_H__ */
+154
View File
@@ -0,0 +1,154 @@
/******************************************************************************
* @file app_relay.c
* @brief 继电器:请求等过零执行;超时则关强断、开放弃
* @author cyWu <1917507415@qq.com>
* @date 2026.09.04
* @version V1.1.0
* @history
* - V1.1.0, 2026.09.04, cyWu, 去掉未使用计数,精简注释
* - V1.0.0, 2026.09.04, cyWu, 首次发布
******************************************************************************/
#include "system/includes.h"
#include "app_relay.h"
#include "bsp_hw.h"
#include "board_pin.h"
#include "jb_product.h"
#define LOG_TAG_CONST APP
#define LOG_TAG "[RELAY]"
#define LOG_INFO_ENABLE
#include "debug.h"
typedef struct {
uint8_t request; /**< 上层意图:0=关 1=开 */
uint8_t actual; /**< 过零后的 GPIO 真值 */
} AppRelayCtx_t;
static AppRelayCtx_t s_relay;
/**
* @brief 写继电器 GPIO 并更新 actual(过零 ISR / 超时路径)
* @param on 1=吸合 0=断开
* @return 无
*/
static void relay_apply(uint8_t on)
{
bsp_relay_set(on);
s_relay.actual = on;
}
/**
* @brief 初始化继电器:GPIO 上电默认关;P0 无 VM,请求=实际=关
* @return 无
*/
void app_relay_init(void)
{
s_relay.request = 0;
s_relay.actual = 0;
bsp_relay_set(0);
log_info("relay init, request=off actual=off\n");
}
/**
* @brief 请求加热开/关(手动/APP 写 DP0/定时/联动统一入口)
* @param on 1=开 0=关
* @return 无
*/
void app_relay_request(uint8_t on)
{
on = on ? 1 : 0;
if (on == s_relay.request) {
return; /* 意图没变:不重复发起(避免连续同向请求反复计超时) */
}
s_relay.request = on;
#if BOARD_ZC_ENABLE
if (on == s_relay.actual) {
/* 例如 PC3 已因超时强关(actual=0),收到关请求:无需等沿,直接同步 */
log_info("request %s but actual already %d, sync\n", on ? "ON" : "OFF",
s_relay.actual);
return;
}
log_info("request %s, wait zc edge\n", on ? "ON" : "OFF");
/* 等 app_zc_poll 计数 / bsp_zc 沿回调执行 */
#else
/* 无过零(调试):开不吸合,关立即强断(规格书 7.2 / 4 章) */
if (on) {
gDevData.fault_code = 2;
log_info("zc disabled: open request rejected, stay off\n");
s_relay.request = 0; /* 放弃开请求,回落到实际(不吸合) */
} else {
log_info("zc disabled: force relay off\n");
relay_apply(0);
}
#endif
}
/**
* @brief 过零沿:有 pending 则切 GPIO
* @note FPIN ISR 上下文,禁止 printf / 写 VM / 切 BLE
* @return 无
*/
void app_relay_zc_edge(void)
{
if (s_relay.request == s_relay.actual) {
return; /* 无 pending,仅记录过零(由 app_zc 管超时) */
}
relay_apply(s_relay.request);
}
/**
* @brief 过零超时:关则强断,开则放弃并保持关,fault_code=2
* @note 20ms 节拍调用;与 FPIN ISR 抢状态,关中断后复检
* @return 无
*/
void app_relay_zc_timeout(void)
{
local_irq_disable();
if (s_relay.request == s_relay.actual) {
local_irq_enable();
return;
}
gDevData.fault_code = 2;
if (s_relay.request) {
/* 开请求超时:禁止无过零吸合,放弃本次开请求,保持关 */
s_relay.request = 0;
s_relay.actual = 0;
bsp_relay_set(0);
} else {
/* 关请求超时:强制断开(安全路径,规格书 7.2) */
bsp_relay_set(0);
s_relay.actual = 0;
}
local_irq_enable();
}
/**
* @brief 当前请求态
* @return 1=请求开,0=请求关
*/
uint8_t app_relay_get_request(void)
{
return s_relay.request;
}
/**
* @brief 当前实际吸合态
* @return 1=已吸合,0=已断开
*/
uint8_t app_relay_get_actual(void)
{
return s_relay.actual;
}
/**
* @brief 是否已同步(无 pending
* @return 1=request==actual
*/
uint8_t app_relay_synced(void)
{
return (s_relay.request == s_relay.actual) ? 1 : 0;
}
+57
View File
@@ -0,0 +1,57 @@
/******************************************************************************
* @file app_relay.h
* @brief 继电器:request 等过零落到 actual;灯和 DP0 读 actual
* @author cyWu <1917507415@qq.com>
* @date 2026.09.04
* @version V1.1.0
******************************************************************************/
#ifndef __APP_RELAY_H__
#define __APP_RELAY_H__
#include <stdint.h>
/**
* @brief 初始化继电器(默认关)
* @return 无
*/
void app_relay_init(void);
/**
* @brief 请求开/关(短按 / DP0 / 定时 / 联动统一入口)
* @param on 1=开(等过零)0=关(等过零)
* @return 无
*/
void app_relay_request(uint8_t on);
/**
* @brief 过零沿回调:有 pending 则切 GPIO
* @return 无
*/
void app_relay_zc_edge(void);
/**
* @brief 过零超时:关强断 / 开放弃,fault_code=2
* @return 无
*/
void app_relay_zc_timeout(void);
/**
* @brief 当前请求
* @return 1=开 0=关
*/
uint8_t app_relay_get_request(void);
/**
* @brief 实际吸合态(DP0 / 灯效)
* @return 1=吸合 0=断开
*/
uint8_t app_relay_get_actual(void);
/**
* @brief request 是否已等于 actual
* @return 1=已同步
*/
uint8_t app_relay_synced(void);
#endif /* __APP_RELAY_H__ */
+149
View File
@@ -0,0 +1,149 @@
/******************************************************************************
* @file app_runrec.c
* @brief CBR1 31 天运行记录骨架(P0BOARD_RUNREC_ENABLE=0
* @author cyWu <1917507415@qq.com>
* @date 2026.09.04
* @version V1.0.0P2 填充实现(接口见 app_runrec.h
******************************************************************************/
#include "system/includes.h"
#include "app_runrec.h"
#include "app_relay.h"
#include "board_pin.h"
#define LOG_TAG_CONST APP
#define LOG_TAG "[RUNREC]"
#define LOG_INFO_ENABLE
#include "debug.h"
static void runrec_disabled_once(void)
{
static uint8_t s_logged;
if (!s_logged) {
s_logged = 1;
log_info("app_runrec disabled (P2)\n");
}
}
/**
* @brief 初始化
* @return 无
*/
void app_runrec_init(void)
{
#if BOARD_RUNREC_ENABLE
/* P2: 先灌 VM,未对时只加 slot0 */
#else
runrec_disabled_once();
#endif
}
/**
* @brief 20ms 节拍:实际吸合才累计
* @param dt 距上次调用的毫秒数
* @return 无
*/
void app_runrec_tick(uint16_t dt)
{
#if BOARD_RUNREC_ENABLE
if (app_relay_get_actual()) {
/* P2: s_pend_ms += dt; 满 600s → mark_dirty */
}
#else
(void)dt;
#endif
}
/**
* @brief 500ms 任务上下文:跨天旋转 + 灌 DP17
* @return 无
*/
void app_runrec_rotate_if_needed(void)
{
#if BOARD_RUNREC_ENABLE
/* P2 */
#else
runrec_disabled_once();
#endif
}
/**
* @brief 读某天秒数
* @param day 0~30
* @return 秒(P0 全 0
*/
uint32_t app_runrec_get(uint8_t day)
{
#if BOARD_RUNREC_ENABLE
(void)day;
return 0;
#else
(void)day;
return 0;
#endif
}
/**
* @brief 打包 124B
* @param out 输出缓冲
* @return 无
*/
void app_runrec_pack(uint8_t *out)
{
#if BOARD_RUNREC_ENABLE
(void)out;
#else
(void)out;
#endif
}
/**
* @brief 解包 124B
* @param in 输入缓冲
* @return 无
*/
void app_runrec_unpack(const uint8_t *in)
{
#if BOARD_RUNREC_ENABLE
(void)in;
#else
(void)in;
#endif
}
/**
* @brief slot[0] 日期
* @return 日期
*/
uint32_t app_runrec_get_slot0_date(void)
{
return 0;
}
/**
* @brief 设置 slot[0] 日期
* @param ymd yyyymmdd
* @return 无
*/
void app_runrec_set_slot0_date(uint32_t ymd)
{
#if BOARD_RUNREC_ENABLE
(void)ymd;
#else
(void)ymd;
#endif
}
/**
* @brief 清零(出厂重置)
* @return 无
*/
void app_runrec_reset(void)
{
#if BOARD_RUNREC_ENABLE
/* P2: 全 0 + 日期清 */
#else
runrec_disabled_once();
#endif
}
+80
View File
@@ -0,0 +1,80 @@
/******************************************************************************
* @file app_runrec.h
* @brief CBR1 31 天运行记录(第 13.1 节,DP17 RO,124B):实际吸合计秒
* @author cyWu <1917507415@qq.com>
* @date 2026.09.04
* @version V1.0.0P0 = 骨架(BOARD_RUNREC_ENABLE=0P2 填充)
*
* @note 什么叫在运行:过零后继电器**实际已吸合**app_relay_get_actual()==1)。
* 日期轴:未对时只往 slot[0] 加不旋转;对时后按本地日历左移。
* 落盘:每累计 600s 写一次 VM;跨天立刻写。
******************************************************************************/
#ifndef __APP_RUNREC_H__
#define __APP_RUNREC_H__
#include <stdint.h>
#include "board_pin.h"
#define APP_RUNREC_PACK_LEN (BOARD_RUN_RECORD_DAYS * 4u) /**< 124B */
/**
* @brief 初始化(未对时:只往 slot0 加,不旋转)
* @return 无
*/
void app_runrec_init(void);
/**
* @brief 20ms 节拍:继电器实际吸合则累计秒,满 10 分钟打脏(不写 flash)
* @param dt 距上次调用的毫秒数
* @return 无
*/
void app_runrec_tick(uint16_t dt);
/**
* @brief 500ms 任务上下文:收下 pending 秒并灌 DP17;对时后跨天左移旋转
* @return 无
*/
void app_runrec_rotate_if_needed(void);
/**
* @brief 读某天秒数(0=今天)
* @param day 0~30
* @return 秒
*/
uint32_t app_runrec_get(uint8_t day);
/**
* @brief 打包 124B(每格 uint32 大端),灌 gDevData.run_record
* @param out 输出缓冲(≥124B
* @return 无
*/
void app_runrec_pack(uint8_t *out);
/**
* @brief 从 VM 解包 124Buint32 大端)
* @param in 输入缓冲
* @return 无
*/
void app_runrec_unpack(const uint8_t *in);
/**
* @brief slot[0] 对应本地日期(yyyymmdd 打包)
* @return 日期
*/
uint32_t app_runrec_get_slot0_date(void);
/**
* @brief 设置 slot[0] 日期(对时/旋转后写回)
* @param ymd yyyymmdd
* @return 无
*/
void app_runrec_set_slot0_date(uint32_t ymd);
/**
* @brief 清零 31 天记录与日期(出厂重置)
* @return 无
*/
void app_runrec_reset(void);
#endif /* __APP_RUNREC_H__ */
+52
View File
@@ -0,0 +1,52 @@
/******************************************************************************
* @file app_th_scan.c
* @brief CBR1 断连温湿度扫描骨架(P0BOARD_TH_SCAN_ENABLE=0
* @author cyWu <1917507415@qq.com>
* @date 2026.09.04
* @version V1.0.0P2 填充实现(规格书第 8 章)
******************************************************************************/
#include "system/includes.h"
#include "app_th_scan.h"
#include "board_pin.h"
#define LOG_TAG_CONST APP
#define LOG_TAG "[THSCAN]"
#define LOG_INFO_ENABLE
#include "debug.h"
static void th_scan_disabled_once(void)
{
static uint8_t s_logged;
if (!s_logged) {
s_logged = 1;
log_info("app_th_scan disabled (P2)\n");
}
}
/**
* @brief 初始化扫描模块
* @return 无
*/
void app_th_scan_init(void)
{
#if BOARD_TH_SCAN_ENABLE
/* P2: 无状态(500ms 时隙由 tick 驱动) */
#else
th_scan_disabled_once();
#endif
}
/**
* @brief 500ms 任务上下文:断连已配对时广播/扫描交替
* @return 无
*/
void app_th_scan_tick(void)
{
#if BOARD_TH_SCAN_ENABLE
/* P2: 已连接/配对/OTA → 退交替;断连已配对 → 偶见宝重连广播/奇扫描 */
#else
th_scan_disabled_once();
#endif
}
+28
View File
@@ -0,0 +1,28 @@
/******************************************************************************
* @file app_th_scan.h
* @brief CBR1 断连温湿度扫描(第 8 章,P2):500ms 重连广播 ↔ 500ms 扫描
* @author cyWu <1917507415@qq.com>
* @date 2026.09.04
* @version V1.0.0P0 = 骨架(BOARD_TH_SCAN_ENABLE=0
*
* @note 匹配规则:名字 = "JBao-"+本机缸体号(DP8 uint16 十进制)且配置版本
* 相等 → temp_x10 = int8℃×10;湿度只打日志不参与开停。缸体号 0 不扫。
* 断连丢包:保持上一温度与上一加热态,禁止因丢包关加热。
******************************************************************************/
#ifndef __APP_TH_SCAN_H__
#define __APP_TH_SCAN_H__
/**
* @brief 初始化扫描模块
* @return 无
*/
void app_th_scan_init(void);
/**
* @brief 500ms 任务上下文:断连已配对时 500ms 重连广播 / 500ms 扫描交替
* @return 无
*/
void app_th_scan_tick(void);
#endif /* __APP_TH_SCAN_H__ */
+84
View File
@@ -0,0 +1,84 @@
/******************************************************************************
* @file app_timer_task.c
* @brief CBR1 定时引擎骨架(P0BOARD_TIMER_ENABLE=0
* @author cyWu <1917507415@qq.com>
* @date 2026.09.04
* @version V1.0.0P2 填充实现(规格书第 11 章)
******************************************************************************/
#include "system/includes.h"
#include "app_timer_task.h"
#include "board_pin.h"
#define LOG_TAG_CONST APP
#define LOG_TAG "[TIMER]"
#define LOG_INFO_ENABLE
#include "debug.h"
static void timer_disabled_once(void)
{
static uint8_t s_logged;
if (!s_logged) {
s_logged = 1;
log_info("app_timer_task disabled (P2)\n");
}
}
/**
* @brief 初始化定时引擎
* @return 无
*/
void app_timer_init(void)
{
#if BOARD_TIMER_ENABLE
/* P2: RTC 门闩 + 状态复位 */
#else
timer_disabled_once();
#endif
}
/**
* @brief 500ms 任务上下文跑定时引擎
* @param dt 距上次调用的毫秒数
* @return 无
*/
void app_timer_run(uint16_t dt)
{
#if BOARD_TIMER_ENABLE
(void)dt;
/* P2: 窗判断 → 仲裁 timer_take/release → 请求开/关 */
#else
(void)dt;
#endif
}
/**
* @brief APP 写 DP9 定时总开关
* @param en 0=关 1=开
* @return 无
*/
void app_timer_set_en(uint8_t en)
{
#if BOARD_TIMER_ENABLE
(void)en;
/* P2: time_en=0 → 所有窗立刻结束(关加热)再补判联动 */
#else
(void)en;
#endif
}
/**
* @brief APP 写 DP10~16 定时配置
* @param idx 1~7
* @return 无
*/
void app_timer_set_config(uint8_t idx)
{
#if BOARD_TIMER_ENABLE
(void)idx;
/* P2: 配置入 RAM + mark_dirty */
#else
(void)idx;
#endif
}
+41
View File
@@ -0,0 +1,41 @@
/******************************************************************************
* @file app_timer_task.h
* @brief CBR1 定时引擎(第 11 章,P27 组 8B 配置 + time_en + RTC 门闩)
* @author cyWu <1917507415@qq.com>
* @date 2026.09.04
* @version V1.0.0P0 = 骨架(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 写 DP9 定时总开关
* @param en 0=关(所有窗立刻视为结束,关加热),1=开
* @return 无
*/
void app_timer_set_en(uint8_t en);
/**
* @brief APP 写 DP10~16 定时配置(8 字节,Byte1 模式忽略但原样存 VM)
* @param idx 1~7
* @return 无
*/
void app_timer_set_config(uint8_t idx);
#endif /* __APP_TIMER_TASK_H__ */
+93
View File
@@ -0,0 +1,93 @@
/******************************************************************************
* @file app_zc.c
* @brief 过零业务:20ms 节拍判定 100ms 无沿超时
* @author cyWu <1917507415@qq.com>
* @date 2026.09.04
* @version V1.1.0
* @history
* - V1.1.0, 2026.09.04, cyWu, 精简注释
* - V1.0.0, 2026.09.04, cyWu, 首次发布
******************************************************************************/
#include "system/includes.h"
#include "app_zc.h"
#include "app_relay.h"
#include "bsp_zc.h"
#include "board_pin.h"
#define LOG_TAG_CONST APP
#define LOG_TAG "[APP_ZC]"
#define LOG_INFO_ENABLE
#include "debug.h"
typedef struct {
uint8_t initialized;
uint8_t last_request;
uint8_t timeout_evt; /**< 1=开放弃 2=关强断,任务上下文取走打印 */
uint16_t pending_ms;
} AppZcCtx_t;
static AppZcCtx_t s_zc;
/**
* @brief 初始化过零业务并挂继电器沿回调
* @return 无
*/
void app_zc_init(void)
{
if (s_zc.initialized) {
return;
}
#if BOARD_ZC_ENABLE
bsp_zc_init(app_relay_zc_edge);
s_zc.pending_ms = 0;
s_zc.last_request = app_relay_get_request();
s_zc.initialized = 1;
log_info("zc init ok\n");
#else
log_info("zc disabled\n");
#endif
}
/**
* @brief 20ms 节拍:pending 满 100ms 无沿则超时处理
* @param dt 距上次调用的毫秒数
* @return 无
*/
void app_zc_poll(uint16_t dt)
{
#if !BOARD_ZC_ENABLE
(void)dt;
return;
#endif
if (!s_zc.initialized) {
return;
}
if (app_relay_get_request() != s_zc.last_request) {
s_zc.pending_ms = 0;
s_zc.last_request = app_relay_get_request();
}
if (!app_relay_synced()) {
s_zc.pending_ms = (uint16_t)(s_zc.pending_ms + dt);
if (s_zc.pending_ms >= BOARD_ZC_TIMEOUT_MS) {
s_zc.pending_ms = 0;
s_zc.timeout_evt = app_relay_get_request() ? 1 : 2;
app_relay_zc_timeout();
}
} else {
s_zc.pending_ms = 0;
}
}
/**
* @brief 取走一次超时事件(任务上下文打印)
* @return 0=无 1=开放弃 2=关强断
*/
uint8_t app_zc_consume_timeout(void)
{
uint8_t evt = s_zc.timeout_evt;
s_zc.timeout_evt = 0;
return evt;
}
+33
View File
@@ -0,0 +1,33 @@
/******************************************************************************
* @file app_zc.h
* @brief 过零业务:装配 bsp_zc20ms 节拍判 100ms 超时
* @author cyWu <1917507415@qq.com>
* @date 2026.09.04
* @version V1.1.0
******************************************************************************/
#ifndef __APP_ZC_H__
#define __APP_ZC_H__
#include <stdint.h>
/**
* @brief 初始化过零业务(挂继电器沿回调)
* @return 无
*/
void app_zc_init(void);
/**
* @brief 20ms 节拍,只判超时,不扫沿
* @param dt 距上次调用的毫秒数
* @return 无
*/
void app_zc_poll(uint16_t dt);
/**
* @brief 取走一次超时事件
* @return 0=无 1=开放弃 2=关强断
*/
uint8_t app_zc_consume_timeout(void);
#endif /* __APP_ZC_H__ */
+265
View File
@@ -0,0 +1,265 @@
/******************************************************************************
* @file key.c
* @brief 按键状态机实现
* @author cyWu <1917507415@qq.com>
* @date 2026.08.25
* @version V1.0.0,首次发布,实现按键短按/长按/释放状态机
******************************************************************************/
#include "key.h"
#include <stddef.h>
static uint32_t s_key_count_time;
static uint8_t s_key_num = USR_KEY_COUNT;
keyCategory_t keyTable[USR_KEY_COUNT];
/**
* @brief 读按键电平到 fsm
* @param key 状态机
* @return 1=已读,0=被屏蔽
*/
static uint8_t get_key_level(keyFSM_t *key)
{
if (key->keyShield == KEY_DISABLE) {
return 0;
}
if (key->keyReadValue == NULL) {
return 0;
}
key->keyLevel = (key->keyReadValue() == key->keyDownLevel) ? Bit_SET : Bit_RESET;
return 1;
}
/**
* @brief 单击 / 双击间隔判定
* @param click 状态机
* @return 1=可以出事件
*/
static uint8_t key_click_frequency(keyFSM_t *click)
{
click->keyInterval++;
switch (click->keyFrequency) {
case CLICK:
if (click->keyInterval >= (KEY_INTERVAL / (DEBOUNCE_TIME * KEY_TIMER_MS))) {
click->eventType = SHORT_Event;
return 1;
}
break;
case DbLCLICK:
if (click->keyInterval >= (KEY_INTERVAL / (DEBOUNCE_TIME * KEY_TIMER_MS))) {
click->eventType = DBCL_Event;
return 1;
}
break;
default:
return 1;
}
return 0;
}
/**
* @brief 按键状态机步进
* @param key_buf 状态机
* @return 1=已处理
*/
static uint8_t read_key_status(keyFSM_t *key_buf)
{
if (!get_key_level(key_buf)) {
return 0;
}
switch (key_buf->keyStatus) {
case KEY_ST_NULL:
if (key_buf->keyLevel == Bit_SET) {
key_buf->keyStatus = KEY_ST_SURE;
}
break;
case KEY_ST_SURE:
if (key_buf->keyLevel == Bit_SET) {
key_buf->eventType = DOWN_Event;
key_buf->keyStatus = KEY_ST_DOWN;
key_buf->keyCount = 0;
key_buf->keyLongFlag = 1;
} else {
key_buf->keyStatus = KEY_ST_NULL;
}
break;
case KEY_ST_DOWN:
if (key_buf->keyLevel != Bit_SET) {
if (key_buf->keyShortFlag == 0) {
key_buf->keyShortFlag = 1;
key_buf->keyFrequency++;
key_buf->keyInterval = 0;
}
if (key_click_frequency(key_buf)) {
key_buf->keyFrequency = 0;
key_buf->keyStatus = KEY_ST_NULL;
}
if ((key_buf->keyCount >= key_buf->keyLongTime / DEBOUNCE_TIME)
&& (key_buf->keyCount < key_buf->keyLastTime / DEBOUNCE_TIME)) {
key_buf->keyFrequency = 0;
key_buf->keyStatus = KEY_ST_NULL;
key_buf->eventType = RELEASE_Event;
}
key_buf->keyCount = 0;
key_buf->keyLongFlag = 1;
} else {
if ((++key_buf->keyCount >= key_buf->keyLastTime / DEBOUNCE_TIME)) {
key_buf->keyCount = 0;
key_buf->keyFrequency = 0;
key_buf->keyStatus = KEY_ST_LONG;
key_buf->eventType = LAST_Event;
key_buf->keyLongFlag = 1;
}
if ((key_buf->keyCount >= key_buf->keyLongTime / DEBOUNCE_TIME)
&& (key_buf->keyCount < key_buf->keyLastTime / DEBOUNCE_TIME)) {
key_buf->keyFrequency = 0;
if (key_buf->keyLongFlag == 1) {
key_buf->eventType = LONG_Event;
key_buf->keyLongFlag = 0;
}
}
key_buf->keyShortFlag = 0;
}
break;
case KEY_ST_LONG:
if (key_buf->keyLevel != Bit_SET) {
key_buf->keyStatus = KEY_ST_NULL;
key_buf->eventType = RELEASE_Event;
}
break;
default:
break;
}
return 1;
}
/**
* @brief 扫描全部按键状态机
* @return 无
*/
static void key_event_process(void)
{
size_t i;
for (i = 0; i < s_key_num; i++) {
(void)read_key_status(&keyTable[i].fsm);
}
}
/**
* @brief 1ms 调用一次;满 DEBOUNCE_TIME 才真正采样
* @return 无
*/
void keyCheckProcess(void)
{
s_key_count_time++;
if (s_key_count_time >= (DEBOUNCE_TIME / KEY_TIMER_MS)) {
s_key_count_time = 0;
key_event_process();
}
}
/**
* @brief 拷贝产品按键表
* @param keys 按键数组,长度 USR_KEY_COUNT
* @return 无
*/
void keyParaInit(keyCategory_t *keys)
{
if (keys == NULL) {
return;
}
if (USR_KEY_COUNT >= KEY_MAX_NUMBER) {
s_key_num = KEY_MAX_NUMBER;
}
memcpy(keyTable, keys, sizeof(keyCategory_t) * s_key_num);
}
/**
* @brief 运行中改长按/连按时长并复位状态
* @param key_event 按键索引
* @param key_param 新参数
* @return 无
*/
void setKeyEventParams(uint8_t key_event, keyCategory_t key_param)
{
if (key_event >= s_key_num) {
return;
}
keyTable[key_event].fsm.keyShield = key_param.fsm.keyShield;
keyTable[key_event].fsm.keyLongTime = key_param.fsm.keyLongTime;
keyTable[key_event].fsm.keyLastTime = key_param.fsm.keyLastTime;
keyTable[key_event].fsm.keyStatus = KEY_ST_NULL;
keyTable[key_event].fsm.eventType = NULL_Event;
keyTable[key_event].fsm.keyCount = 0;
}
/**
* @brief 派发按键事件回调
* @return 无
*/
void keyHandle(void)
{
size_t i;
for (i = 0; i < s_key_num; i++) {
if (keyTable[i].fsm.eventType == NULL_Event) {
continue;
}
switch (keyTable[i].fsm.eventType) {
case RELEASE_Event:
if (keyTable[i].func.releasePressCb != NULL) {
keyTable[i].func.releasePressCb();
}
keyTable[i].fsm.eventType = NULL_Event;
break;
case SHORT_Event:
if (keyTable[i].func.ShortPressCb != NULL) {
keyTable[i].func.ShortPressCb();
}
keyTable[i].fsm.eventType = NULL_Event;
break;
case DOWN_Event:
if (keyTable[i].func.downPressCb != NULL) {
keyTable[i].func.downPressCb();
}
keyTable[i].fsm.eventType = NULL_Event;
break;
case LONG_Event:
if (keyTable[i].func.longPressCb != NULL) {
keyTable[i].func.longPressCb();
}
keyTable[i].fsm.eventType = NULL_Event;
break;
case LAST_Event:
if (keyTable[i].func.lastPressCb != NULL) {
keyTable[i].func.lastPressCb();
}
break;
case DBCL_Event:
if (keyTable[i].func.dbclPressCb != NULL) {
keyTable[i].func.dbclPressCb();
}
keyTable[i].fsm.eventType = NULL_Event;
break;
default:
break;
}
}
}
/**
* @brief 复位指定按键状态机
* @param key_index 按键索引
* @return 无
*/
void reset_key_Status(keyList key_index)
{
if (key_index >= USR_KEY_COUNT) {
return;
}
keyTable[key_index].fsm.keyStatus = KEY_ST_NULL;
keyTable[key_index].fsm.eventType = NULL_Event;
keyTable[key_index].fsm.keyCount = 0;
}
+98
View File
@@ -0,0 +1,98 @@
/******************************************************************************
* @file key.h
* @brief 按键状态机:短按 / 长按 / 释放
* @author cyWu <1917507415@qq.com>
* @date 2026.08.25
* @version V1.0.0,首次发布,实现按键短按/长按/释放状态机
******************************************************************************/
#ifndef __KEY_H__
#define __KEY_H__
#include <stdint.h>
#include <string.h>
/*============================================================================*/
/* 宏定义 */
/*============================================================================*/
#define KEY_TIMER_MS 1
#define KEY_MAX_NUMBER 12
#define DEBOUNCE_TIME 30
#define KEY_INTERVAL 30
#define CLICK 1
#define DbLCLICK 2
typedef enum {
USR_KEY_USER = 0,
USR_KEY_COUNT
} keyList;
typedef enum {
Bit_RESET = 0,
Bit_SET
} BitAction_t;
typedef enum {
KEY_ST_NULL = 0,
KEY_ST_RELEASE,
KEY_ST_SURE,
KEY_ST_UP,
KEY_ST_DOWN,
KEY_ST_LONG
} keyStatus_t;
typedef enum {
NULL_Event = 0,
DOWN_Event,
SHORT_Event,
LONG_Event,
LAST_Event,
DBCL_Event,
RELEASE_Event
} keyEvent_t;
typedef enum {
KEY_DISABLE = 0,
KEY_ENABLE = !KEY_DISABLE
} keyEnable_t;
typedef struct {
uint8_t keyShortFlag;
uint8_t keyLongFlag;
uint8_t keyInterval;
uint8_t keyFrequency;
uint16_t keyLongTime;
uint16_t keyLastTime;
uint32_t keyCount;
keyEnable_t keyShield;
BitAction_t keyLevel;
BitAction_t keyDownLevel;
keyStatus_t keyStatus;
keyEvent_t eventType;
uint8_t (*keyReadValue)(void);
} keyFSM_t;
typedef struct {
void (*nullPressCb)(void);
void (*releasePressCb)(void);
void (*downPressCb)(void);
void (*ShortPressCb)(void);
void (*longPressCb)(void);
void (*lastPressCb)(void);
void (*dbclPressCb)(void);
} keyFunc_t;
typedef struct {
keyFSM_t fsm;
keyFunc_t func;
} keyCategory_t;
void keyParaInit(keyCategory_t *keys);
void setKeyEventParams(uint8_t key_event, keyCategory_t key_param);
void keyCheckProcess(void);
void keyHandle(void);
void reset_key_Status(keyList key_index);
#endif /* __KEY_H__ */
+170
View File
@@ -0,0 +1,170 @@
/******************************************************************************
* @file key_manager.c
* @brief 按键:短按切加热;按住 5s 配对 / 12s OTA
* @author cyWu <1917507415@qq.com>
* @date 2026.09.04
* @version V3.1.0
* @history
* - V3.1.0, 2026.09.04, cyWu, 精简注释
* - V3.0.0, 2026.08.31, cyWu, 复用 key.c 长按分级
******************************************************************************/
#include "system/includes.h"
#include "key_manager.h"
#include "bsp_hw.h"
#include "board_pin.h"
#define LOG_TAG_CONST APP
#define LOG_TAG "[KEY]"
#define LOG_INFO_ENABLE
#include "debug.h"
/** 模块状态 */
typedef struct {
uint8_t initialized;
uint8_t boot_key_lock; /**< 1=上电时键还按着,等松开才认短按(不挡长按分级) */
uint8_t ota_fired; /**< 1=已到点触发 OTA,本次按住松手不再提交配对 */
} KeyManagerCtx_t;
static KeyManagerCtx_t s_km;
/**
* @brief 读按键:1=按下
* @return 1=按下,0=松开
*/
static uint8_t key_user_read(void)
{
return bsp_key_is_pressed();
}
/**
* @brief 短按(SHORT_Event,松手时刻 <5s):上电未松手前忽略,否则切加热
* @return 无
*/
static void key_user_short(void)
{
if (s_km.boot_key_lock) {
s_km.boot_key_lock = 0; /* 上电松手当成释放,不当短按切加热 */
log_info("boot key released\n");
return;
}
usr_on_key_short();
}
/**
* @brief 长按到点(LONG_Event,满 5s 仍按住):挂配对提示灯
* @note ⚠ 跑在 usr_timer 20ms(硬件定时器中断上下文):只准打标志 + 切灯效
* 事件(纯 RAM)。清绑定(写 VM)留给 app_function_loop(任务上下文)。
* @return 无
*/
static void key_user_pair_hint(void)
{
usr_on_key_pair_hint();
}
/**
* @brief 连按到点(LAST_Event,满 12s 仍按住,到点即触发不等松手):进 OTA
* @note ⚠ 同上,只置标志;usr_app_ota_init 由 app_function_loop 执行。
* key.c 的 keyHandle 对 LAST_Event 不清 eventType,松手前每 20ms 都会
* 再派发一次,这里用 ota_fired 挡住重复调用。
* @return 无
*/
static void key_user_ota_start(void)
{
if (s_km.ota_fired) {
return;
}
s_km.ota_fired = 1;
usr_on_key_ota_start();
}
/**
* @brief 释放(RELEASE_Event,只有按满 ≥5s 才会触发):未进 OTA 则提交配对
* @note 按满 12s 已触发 OTA 的这次按住,松手不再提交配对(ota_fired 拦住)。
* @return 无
*/
static void key_user_release(void)
{
s_km.boot_key_lock = 0;
if (!s_km.ota_fired) {
usr_on_key_pair_start();
}
s_km.ota_fired = 0;
}
static keyCategory_t s_keys[USR_KEY_COUNT] = {
[USR_KEY_USER] = {
.fsm.keyShield = KEY_ENABLE,
.fsm.keyDownLevel = Bit_SET,
.fsm.eventType = NULL_Event,
.fsm.keyLongTime = BOARD_KEY_PAIR_MS, /* 满 5s 仍按住 -> longPressCb */
.fsm.keyLastTime = BOARD_KEY_OTA_MS, /* 满 12s 仍按住 -> lastPressCb */
.fsm.keyReadValue = key_user_read,
.func.ShortPressCb = key_user_short,
.func.releasePressCb = key_user_release,
.func.longPressCb = key_user_pair_hint,
.func.lastPressCb = key_user_ota_start,
},
};
/**
* @brief 装载按键表
* @return 无
*/
void user_key_init(void)
{
if (s_km.initialized) {
return;
}
keyParaInit(s_keys);
s_km.boot_key_lock = 0;
s_km.ota_fired = 0;
s_km.initialized = 1;
}
/**
* @brief 上电后:键还按着则锁住短按,松开才认短按
* @note 只锁短按,**不锁长按分级**:上电就按住 5s 进配对是受支持的用法。
* @return 无
*/
void user_key_lock_if_held(void)
{
reset_key_Status(USR_KEY_USER);
if (bsp_key_is_pressed()) {
s_km.boot_key_lock = 1; /* 上电手还按着,等松开才认短按,避免一上电就切加热 */
log_info("boot key held, wait release\n");
}
}
/**
* @brief 按真实毫秒推进状态机
* @param dt 距上次调用的毫秒数
* @return 无
*/
void user_key_scan(uint16_t dt)
{
uint16_t i;
if (!s_km.initialized) {
return;
}
if (dt == 0) {
dt = 1;
}
/* 按键库按 1ms 步进,业务节拍是 20ms,这里循环 dt 次对齐真实时间 */
for (i = 0; i < dt; i++) {
keyCheckProcess();
}
}
/**
* @brief 派发按键回调
* @return 无
*/
void user_key_handle(void)
{
if (!s_km.initialized) {
return;
}
keyHandle();
}
+65
View File
@@ -0,0 +1,65 @@
/******************************************************************************
* @file key_manager.h
* @brief 按键:短按切加热;按住 5s 配对 / 12s OTA
* @author cyWu <1917507415@qq.com>
* @date 2026.09.04
* @version V3.1.0
******************************************************************************/
#ifndef __KEY_MANAGER_H__
#define __KEY_MANAGER_H__
#include "key.h"
/**
* @brief 业务层短按回调(app_function 实现)
* @return 无
*/
void usr_on_key_short(void);
/**
* @brief 业务层"按住满 5s"回调(app_function 实现):切配对提示灯,尚未清绑定
* @return 无
*/
void usr_on_key_pair_hint(void);
/**
* @brief 业务层"按满 5s 后松手"回调(app_function 实现):提交配对
* @note 只置标志;清绑定(写 VM)在 app_function_loop(任务上下文)执行
* @return 无
*/
void usr_on_key_pair_start(void);
/**
* @brief 业务层"按住满 12s"回调(app_function 实现):到点即进 OTA
* @note 只置标志;usr_app_ota_init 在 app_function_loop(任务上下文)执行
* @return 无
*/
void usr_on_key_ota_start(void);
/**
* @brief 装载按键表
* @return 无
*/
void user_key_init(void);
/**
* @brief 上电后:若键还按着则锁住短按,松开才认短按(不挡长按分级)
* @return 无
*/
void user_key_lock_if_held(void);
/**
* @brief 按真实毫秒推进状态机(20ms 节拍会循环 dt 次)
* @param dt 距上次调用的毫秒数
* @return 无
*/
void user_key_scan(uint16_t dt);
/**
* @brief 派发按键回调
* @return 无
*/
void user_key_handle(void);
#endif /* __KEY_MANAGER_H__ */
+328
View File
@@ -0,0 +1,328 @@
/******************************************************************************
* @file led.c
* @brief LED 事件框架实现:只改 ledMask 对应通道,红绿互不抢
* @author cyWu <1917507415@qq.com>
* @date 2026.08.25
* @version V1.0.0
* @history
* - V1.0.0, 2026.08.25, cyWu, 首次发布,实现按通道掩码独立开关的 LED 事件框架
******************************************************************************/
#include "led.h"
#include <stddef.h>
static LED_EventTableItem_t s_led_priority_table[PRIORITY_MAX];
static LED_EventTableItem_t s_led_event_table[LED_EVENT_MAX];
static LED_SetState_t s_led_set_state;
static TIME_Get_t s_time_get;
static uint32_t get_tick_diff(uint32_t meiosis);
static uint8_t led_lighting_update(LED_Config_t *led);
#if (BLINK_ENABLE)
static uint8_t led_blinking_update(LED_Config_t *led);
#endif
#if (ALTERNATING_BLINK_ENABLE)
static uint8_t led_alternating_update(LED_Config_t *led);
#endif
/**
* @brief 注册写灯回调,只对掩码里的通道动手
* @param setState 回调,led=通道掩码,state=LED_ON/OFF
* @return 无
*/
void LED_SetStateInit(LED_SetState_t setState)
{
s_led_set_state = setState;
}
/**
* @brief 注册毫秒时间戳回调
* @param getTime 回调
* @return 无
*/
void SET_TimeGetInit(TIME_Get_t getTime)
{
s_time_get = getTime;
}
/**
* @brief 拷贝产品事件表
* @param ledEvent 长度必须为 LED_EVENT_MAX
* @return 无
*/
void LED_EventTableInit(LED_EventTableItem_t ledEvent[])
{
if (ledEvent == NULL) {
return;
}
memset(s_led_priority_table, 0, sizeof(s_led_priority_table));
memset(s_led_event_table, 0, sizeof(s_led_event_table));
memcpy(s_led_event_table, ledEvent, sizeof(s_led_event_table));
}
/**
* @brief 把事件挂到对应优先级槽;同优先级会被覆盖
* @param ledEvent 事件号
* @return 无
*/
void LED_EventAdd(LED_Event_t ledEvent)
{
size_t i;
LED_EventTableItem_t *item;
LED_EventPriority_t prio;
if ((s_time_get == NULL) || (s_led_set_state == NULL)) {
return;
}
if (ledEvent >= LED_EVENT_MAX) {
return;
}
for (i = 0; i < LED_EVENT_MAX; i++) {
item = &s_led_event_table[i];
if (item->event != ledEvent) {
continue;
}
prio = item->priority;
if (prio >= PRIORITY_MAX) {
return;
}
if (s_led_priority_table[prio].event != ledEvent) {
item->config.currentTime = s_time_get();
if (s_led_priority_table[prio].event != LED_EVENT_NONE) {
/* 同优先级换事件:只关掉旧灯里新事件用不到的通道 */
s_led_set_state((uint16_t)(s_led_priority_table[prio].config.ledMask
^ item->config.ledMask),
LED_OFF);
}
}
s_led_priority_table[prio] = *item;
return;
}
}
/**
* @brief 清空优先级表(不改 GPIO,由调用方灭灯)
* @return 无
*/
void LED_EventAllDelete(void)
{
memset(s_led_priority_table, 0, sizeof(s_led_priority_table));
}
/**
* @brief 删除指定事件并关掉它占用的通道
* @param ledEvent 事件号
* @return 无
*/
void LED_EventDelete(LED_Event_t ledEvent)
{
size_t i;
for (i = 0; i < PRIORITY_MAX; i++) {
if (s_led_priority_table[i].event != ledEvent) {
continue;
}
memset(&s_led_priority_table[i], 0, sizeof(LED_EventTableItem_t));
if ((s_led_set_state != NULL) && (ledEvent < LED_EVENT_MAX)) {
s_led_set_state(s_led_event_table[ledEvent].config.ledMask, LED_OFF);
}
return;
}
}
/**
* @brief 从高优先级往下跑事件
* @note handler 返回 1 会拦住更低优先级。红绿要共存时 handler 必须返回 0
* @return 无
*/
void LED_EventHandle(void)
{
int i;
uint8_t ret;
for (i = (int)PRIORITY_MAX - 1; i >= 0; i--) {
if (s_led_priority_table[i].event == LED_EVENT_NONE) {
continue;
}
if (s_led_priority_table[i].ledEventHandler == NULL) {
continue;
}
ret = s_led_priority_table[i].ledEventHandler(&s_led_priority_table[i].config);
if (ret) {
return;
}
}
}
/**
* @brief 是否有事件在跑
* @return 1=有,0=无
*/
uint8_t LED_IsEventActive(void)
{
size_t i;
for (i = 0; i < PRIORITY_MAX; i++) {
if (s_led_priority_table[i].event != LED_EVENT_NONE) {
return 1;
}
}
return 0;
}
/**
* @brief 指定事件是否挂在优先级表里
* @param ledEvent 事件号
* @return 1=在,0=不在
*/
uint8_t LED_IsEventExist(LED_Event_t ledEvent)
{
size_t i;
for (i = 0; i < PRIORITY_MAX; i++) {
if (s_led_priority_table[i].event == ledEvent) {
return 1;
}
}
return 0;
}
/**
* @brief 按配置刷新一次灯效
* @param led 配置,不可为空
* @return 1=还在跑,0=次数用完
*/
uint8_t LED_Update(LED_Config_t *led)
{
if (led == NULL) {
return 0;
}
switch (led->state) {
case LED_LIGHT:
return led_lighting_update(led);
#if (BLINK_ENABLE)
case LED_BLINKING:
return led_blinking_update(led);
#endif
#if (ALTERNATING_BLINK_ENABLE)
case LED_ALTERNATING_BLINK:
return led_alternating_update(led);
#endif
default:
return 0;
}
}
/**
* @brief 毫秒时间差,兼容溢出
* @param meiosis 起点时间戳
* @return 差值 ms
*/
static uint32_t get_tick_diff(uint32_t meiosis)
{
uint32_t now;
if (s_time_get == NULL) {
return 0;
}
now = s_time_get();
if (now >= meiosis) {
return now - meiosis;
}
return (0xFFFFFFFFu - meiosis) + now;
}
/**
* @brief 常亮;runNum 按秒计,0=一直亮
* @param led 配置
* @return 1=还在亮,0=到点灭
*/
static uint8_t led_lighting_update(LED_Config_t *led)
{
uint16_t sec_count;
if (s_led_set_state == NULL) {
return 0;
}
sec_count = (uint16_t)(get_tick_diff(led->currentTime) / 1000u);
if ((led->runNum > 0) && (sec_count >= led->runNum)) {
s_led_set_state(led->ledMask, LED_OFF);
return 0;
}
s_led_set_state(led->ledMask, LED_ON);
return 1;
}
#if (BLINK_ENABLE)
/**
* @brief 闪烁;runNum 按完整周期计,0=一直闪
* @param led 配置
* @return 1=还在闪,0=到点灭
*/
static uint8_t led_blinking_update(LED_Config_t *led)
{
uint32_t run_cycle;
uint16_t blink_count;
uint32_t sec_left;
if (s_led_set_state == NULL) {
return 0;
}
run_cycle = led->blinkParams.onTime + led->blinkParams.offTime;
if (run_cycle == 0) {
return 0;
}
blink_count = (uint16_t)(get_tick_diff(led->currentTime) / run_cycle);
sec_left = get_tick_diff(led->currentTime) % run_cycle;
if ((led->runNum > 0) && (blink_count >= led->runNum)) {
s_led_set_state(led->ledMask, LED_OFF);
return 0;
}
if (sec_left <= led->blinkParams.onTime) {
s_led_set_state(led->ledMask, led->blinkParams.orDer ? LED_OFF : LED_ON);
} else {
s_led_set_state(led->ledMask, led->blinkParams.orDer ? LED_ON : LED_OFF);
}
return 1;
}
#endif
#if (ALTERNATING_BLINK_ENABLE)
/**
* @brief 两组灯按时间片轮流亮
* @param led 配置
* @return 1=还在跑,0=到点灭
*/
static uint8_t led_alternating_update(LED_Config_t *led)
{
uint16_t blink_count;
uint32_t sec_left;
uint32_t time_slice;
size_t i;
if (s_led_set_state == NULL) {
return 0;
}
if (led->alternatingBlinkParams.Cycle == 0) {
return 0;
}
blink_count = (uint16_t)(get_tick_diff(led->currentTime)
/ led->alternatingBlinkParams.Cycle);
sec_left = get_tick_diff(led->currentTime) % led->alternatingBlinkParams.Cycle;
if ((led->runNum > 0) && (blink_count >= led->runNum)) {
s_led_set_state(led->ledMask, LED_OFF);
return 0;
}
time_slice = led->alternatingBlinkParams.Cycle / ALTERNAT_GROUP;
s_led_set_state(led->ledMask, LED_OFF);
for (i = 0; i < ALTERNAT_GROUP; i++) {
if ((sec_left > (time_slice * i)) && (sec_left <= (time_slice * (i + 1)))) {
s_led_set_state(led->alternatingBlinkParams.Group[i], LED_ON);
break;
}
}
return 1;
}
#endif
+123
View File
@@ -0,0 +1,123 @@
/******************************************************************************
* @file led.h
* @brief LED 事件框架:按通道掩码独立开关,红绿可同时亮
* @author cyWu <1917507415@qq.com>
* @date 2026.08.25
* @version V1.1.0
* @history
* - V1.0.0, 2026.08.25, cyWu, 首次发布,实现按通道掩码独立开关的 LED 事件框架
* - V1.1.0, 2026.08.27, cyWu, 新增 LED_EVENT_BOOT_REJECT(拒绝开机低电闪),
* 与运行时 LED_EVENT_EMPTY 参数解耦,各自独立可调
******************************************************************************/
#ifndef __LED_H__
#define __LED_H__
#include <stdint.h>
#include <string.h>
/*============================================================================*/
/* 宏定义 */
/*============================================================================*/
#define BLINK_ENABLE 1
#define ALTERNATING_BLINK_ENABLE 1
#define BREATH_ENABLE 0
#define RUNNING_ENABLE 0
#define MARQUEE_ENABLE 0
#define LED_ON 1
#define LED_OFF 0
#define LED_CHANNEL(user_led) (1u << (user_led))
#define ledPrintf(level, fmt, ...) ((void)0)
/*============================================================================*/
/* 类型 */
/*============================================================================*/
typedef enum {
LED_LIGHT = 0, /**< 常亮 */
LED_BLINKING, /**< 闪烁 */
LED_ALTERNATING_BLINK /**< 红绿交替 */
} LED_State_t;
typedef enum {
LED_EVENT_NONE = 0,
LED_EVENT_HEAT_OFF, /**< 跟继电器-关:绿灯常亮,红灯灭(低优先级) */
LED_EVENT_HEAT_ON, /**< 跟继电器-开:红灯常亮,绿灯灭(低优先级) */
LED_EVENT_PAIRING, /**< 按住满5s提示/配对中:绿灯100ms快闪,红灯灭 */
LED_EVENT_PAIR_OK, /**< 配对成功:绿灯常亮若干秒,再回跟继电器 */
LED_EVENT_PAIR_FAIL, /**< 配对失败:红绿交替若干秒,再回跟继电器 */
LED_EVENT_OTA, /**< OTA:红绿交替,直到升级结束/复位(最高) */
LED_EVENT_MAX
} LED_Event_t;
/**
* 优先级:高者覆盖低者(handler 返回 1 会拦下更低优先级)。
* 加热垫红绿互斥:HEAT 只占最低槽,配对/结果/OTA 事件添加前先全清灯,
* 结束后 app_led_run 按继电器实际态自动重新挂 HEAT(无需显式恢复)。
*/
typedef enum {
PRIORITY_1 = 0, /**< 跟继电器(HEAT_OFF / HEAT_ON */
PRIORITY_2, /**< 配对提示 / 配对结果 */
PRIORITY_3, /**< OTA(最高) */
PRIORITY_MAX
} LED_EventPriority_t;
#if (BLINK_ENABLE)
typedef struct {
uint8_t orDer; /**< 1=先灭后亮,0=先亮后灭 */
uint32_t onTime; /**< 亮时间 ms */
uint32_t offTime; /**< 灭时间 ms */
} LED_BlinkParams_t;
#endif
#if (ALTERNATING_BLINK_ENABLE)
#define ALTERNAT_GROUP 2
typedef struct {
uint16_t Group[ALTERNAT_GROUP]; /**< 交替两组的通道掩码 */
uint32_t Cycle; /**< 一整轮交替周期 ms */
} LED_AlternatingBlinkParams_t;
#endif
typedef struct {
LED_State_t state;
uint16_t ledMask; /**< 本事件只动这些通道,其它灯不受影响 */
uint16_t runNum; /**< 0=无限;常亮按秒计,闪烁按周期计 */
uint32_t currentTime;
#if (BLINK_ENABLE)
LED_BlinkParams_t blinkParams;
#endif
#if (ALTERNATING_BLINK_ENABLE)
LED_AlternatingBlinkParams_t alternatingBlinkParams;
#endif
} LED_Config_t;
typedef struct {
LED_Event_t event;
LED_EventPriority_t priority;
LED_Config_t config;
uint8_t (*ledEventHandler)(LED_Config_t *config);
} LED_EventTableItem_t;
typedef void (*LED_SetState_t)(uint16_t led, uint8_t state);
typedef uint32_t (*TIME_Get_t)(void);
/*============================================================================*/
/* 外部接口 */
/*============================================================================*/
void LED_SetStateInit(LED_SetState_t setState);
void SET_TimeGetInit(TIME_Get_t getTime);
void LED_EventTableInit(LED_EventTableItem_t ledEvent[]);
void LED_EventAdd(LED_Event_t ledEvent);
void LED_EventDelete(LED_Event_t ledEvent);
void LED_EventAllDelete(void);
void LED_EventHandle(void);
uint8_t LED_IsEventActive(void);
uint8_t LED_IsEventExist(LED_Event_t ledEvent);
uint8_t LED_Update(LED_Config_t *led);
#endif /* __LED_H__ */
+188
View File
@@ -0,0 +1,188 @@
/******************************************************************************
* @file led_manager.c
* @brief CBR1 红绿 LED 事件表:跟继电器 / 配对 / OTA(规格书第 6 章)
* @author cyWu <1917507415@qq.com>
* @date 2026.09.04
* @version V1.0.0P0 Bring-up(由门夹双通道事件表裁剪:删电池/充电/模式事件)
*
* @note 加热垫红绿互斥(一次只一种图案),高事件(配对/结果/OTA)添加前
* app_led 层先全清事件+灭灯;事件结束自删后 app_led_run 按继电器
* 实际态自动重新挂 HEAT 事件。
******************************************************************************/
#include "led_manager.h"
#include "system/includes.h"
#include "bsp_hw.h"
#include "board_pin.h"
static uint8_t led_heat_handler(LED_Config_t *led_config);
static uint8_t led_pairing_handler(LED_Config_t *led_config);
static uint8_t led_pair_ok_handler(LED_Config_t *led_config);
static uint8_t led_pair_fail_handler(LED_Config_t *led_config);
static uint8_t led_ota_handler(LED_Config_t *led_config);
/**
* @brief 只改掩码里的通道,其它灯保持原样
* @param led 通道掩码
* @param state LED_ON / LED_OFF
* @return 无
*/
static void set_led_multi(uint16_t led, uint8_t state)
{
if (led & LED_CHANNEL(LED_CH_RED)) {
bsp_led_red_set(state);
}
if (led & LED_CHANNEL(LED_CH_GREEN)) {
bsp_led_green_set(state);
}
}
/**
* @brief 跟继电器常亮:返回 1 占住最低槽
* @param led_config 配置
* @return 1
*/
static uint8_t led_heat_handler(LED_Config_t *led_config)
{
(void)LED_Update(led_config);
return 1;
}
/**
* @brief 配对绿快闪(无限):返回 1 拦下更低优先级,配对期间只此一灯
* @param led_config 配置
* @return 1
*/
static uint8_t led_pairing_handler(LED_Config_t *led_config)
{
(void)LED_Update(led_config);
return 1;
}
/**
* @brief 配对成功常绿若干秒:到点自删,灯交回 app_led_run
* @param led_config 配置
* @return 1=还在亮,0=已自删
*/
static uint8_t led_pair_ok_handler(LED_Config_t *led_config)
{
if (LED_Update(led_config) == 0) {
LED_EventDelete(LED_EVENT_PAIR_OK);
return 0;
}
return 1;
}
/**
* @brief 配对失败红绿交替若干秒:到点自删
* @param led_config 配置
* @return 1=还在跑,0=已自删
*/
static uint8_t led_pair_fail_handler(LED_Config_t *led_config)
{
if (LED_Update(led_config) == 0) {
LED_EventDelete(LED_EVENT_PAIR_FAIL);
return 0;
}
return 1;
}
/**
* @brief OTA 红绿交替(无限):最高优先级,拦下其它一切
* @param led_config 配置
* @return 1
*/
static uint8_t led_ota_handler(LED_Config_t *led_config)
{
(void)LED_Update(led_config);
return 1;
}
/**
* @brief 注册回调并装载 CBR1 事件表(GPIO 已在 bsp_hw_init
* @note 事件枚举数值 = 事件表下标(led.c LED_EventDelete 依赖)
* @return 无
*/
void user_led_init(void)
{
static LED_EventTableItem_t led_event_category[LED_EVENT_MAX] = {
[LED_EVENT_HEAT_OFF] = {
/* 加热关(实际断开):绿灯常亮,红灯灭 */
.event = LED_EVENT_HEAT_OFF,
.priority = PRIORITY_1,
.config.ledMask = LED_CHANNEL(LED_CH_GREEN),
.config.state = LED_LIGHT,
.config.runNum = 0, /* 0=一直亮 */
.ledEventHandler = led_heat_handler,
},
[LED_EVENT_HEAT_ON] = {
/* 加热开(实际吸合):红灯常亮,绿灯灭 */
.event = LED_EVENT_HEAT_ON,
.priority = PRIORITY_1,
.config.ledMask = LED_CHANNEL(LED_CH_RED),
.config.state = LED_LIGHT,
.config.runNum = 0,
.ledEventHandler = led_heat_handler,
},
[LED_EVENT_PAIRING] = {
/* 按住满5s提示 / 配对中:绿灯 100ms 快闪(红灯由 app_led 层保证灭) */
.event = LED_EVENT_PAIRING,
.priority = PRIORITY_2,
.config.ledMask = LED_CHANNEL(LED_CH_GREEN),
.config.state = LED_BLINKING,
.config.blinkParams.orDer = 0,
.config.blinkParams.onTime = BOARD_LED_FAST_ON_MS,
.config.blinkParams.offTime = BOARD_LED_FAST_OFF_MS,
.config.runNum = 0,
.ledEventHandler = led_pairing_handler,
},
[LED_EVENT_PAIR_OK] = {
/* 配对成功:绿灯常亮 3s 后回跟继电器 */
.event = LED_EVENT_PAIR_OK,
.priority = PRIORITY_2,
.config.ledMask = LED_CHANNEL(LED_CH_GREEN),
.config.state = LED_LIGHT,
.config.runNum = (uint16_t)((BOARD_LED_PAIR_OK_MS + 999u) / 1000u),
.ledEventHandler = led_pair_ok_handler,
},
[LED_EVENT_PAIR_FAIL] = {
/* 配对失败:红绿交替 3s 后回跟继电器(半周期 BOARD_LED_ALT_MS */
.event = LED_EVENT_PAIR_FAIL,
.priority = PRIORITY_2,
.config.ledMask = (uint16_t)(LED_CHANNEL(LED_CH_RED) | LED_CHANNEL(LED_CH_GREEN)),
.config.state = LED_ALTERNATING_BLINK,
.config.alternatingBlinkParams.Group[0] = LED_CHANNEL(LED_CH_RED),
.config.alternatingBlinkParams.Group[1] = LED_CHANNEL(LED_CH_GREEN),
.config.alternatingBlinkParams.Cycle = (uint32_t)(BOARD_LED_ALT_MS * 2u),
.config.runNum = (uint16_t)((BOARD_LED_PAIR_FAIL_MS + (BOARD_LED_ALT_MS * 2u) - 1u)
/ (BOARD_LED_ALT_MS * 2u)),
.ledEventHandler = led_pair_fail_handler,
},
[LED_EVENT_OTA] = {
/* OTA:红绿交替一直闪(200ms 半周期),直到升级结束/复位 */
.event = LED_EVENT_OTA,
.priority = PRIORITY_3,
.config.ledMask = (uint16_t)(LED_CHANNEL(LED_CH_RED) | LED_CHANNEL(LED_CH_GREEN)),
.config.state = LED_ALTERNATING_BLINK,
.config.alternatingBlinkParams.Group[0] = LED_CHANNEL(LED_CH_RED),
.config.alternatingBlinkParams.Group[1] = LED_CHANNEL(LED_CH_GREEN),
.config.alternatingBlinkParams.Cycle = (uint32_t)(BOARD_LED_ALT_MS * 2u),
.config.runNum = 0, /* 0=无限 */
.ledEventHandler = led_ota_handler,
},
};
LED_SetStateInit(set_led_multi);
SET_TimeGetInit((TIME_Get_t)timer_get_ms);
LED_EventTableInit(led_event_category);
bsp_led_all_off();
}
/**
* @brief 跑一轮 LED 事件
* @return 无
*/
void user_led_handle(void)
{
LED_EventHandle();
}
+32
View File
@@ -0,0 +1,32 @@
/******************************************************************************
* @file led_manager.h
* @brief CBR1 红绿 LED 通道与事件表(跟继电器/配对/OTA)
* @author cyWu <1917507415@qq.com>
* @date 2026.09.04
* @version V1.0.0P0 Bring-up(门夹双通道框架裁剪:红 PA7 / 绿 PA8)
******************************************************************************/
#ifndef __LED_MANAGER_H__
#define __LED_MANAGER_H__
#include "led.h"
typedef enum {
LED_CH_RED = 0,
LED_CH_GREEN,
LED_CH_MAX
} LedChannel_t;
/**
* @brief 注册 GPIO 回调并装载 CBR1 事件表
* @return 无
*/
void user_led_init(void);
/**
* @brief 跑一轮 LED 事件
* @return 无
*/
void user_led_handle(void);
#endif /* __LED_MANAGER_H__ */