生成代码包
This commit is contained in:
@@ -0,0 +1,383 @@
|
||||
/* ================================================================
|
||||
* jb_product.c — 用户层实现(请填补空白处)
|
||||
* 设备: 喷淋器 | 生成时间: 2026-09-09 10:22:58
|
||||
*
|
||||
* ══ 开发流程 ══
|
||||
* 1. 实现硬件抽象: jbGetTimerCount(定时器由 SOC SDK 提供)
|
||||
* 发送由 SOC SDK 的 ble_send_data 承担,协议层已直接调用,无需 uartWrite
|
||||
* 2. userInit() 设置 DP 默认值与外设初始化
|
||||
* 3. userHandle() 用户数据采集
|
||||
* 4. jbEventProcess() 处理 APP 下发的控制命令
|
||||
* 5. 主动上报 / OTA 的网关应答在收到 REPORTCMD_V2 后调用 jbReportAckCheck 清除等待
|
||||
* ================================================================
|
||||
*/
|
||||
|
||||
#include "jb_product.h"
|
||||
|
||||
/* ════════════════════════════════════════════════════════════════
|
||||
* 全局变量
|
||||
* ════════════════════════════════════════════════════════════════ */
|
||||
|
||||
jb_data_point_t gDevData;
|
||||
static volatile uint32_t timerMs;
|
||||
|
||||
/* ════════════════════════════════════════════════════════════════
|
||||
* userInit — DP 默认值
|
||||
* ════════════════════════════════════════════════════════════════ */
|
||||
void userInit(void)
|
||||
{
|
||||
memset(&gDevData, 0, sizeof(jb_data_point_t));
|
||||
|
||||
gDevData.power = 0; /* DP0 总开关 0=关 1=开 */
|
||||
gDevData.spray_switch = 0; /* DP1 喷淋开关 0=关 1=开 */
|
||||
gDevData.mode = 0; /* MODE_0 (关闭模式) */
|
||||
gDevData.once_spray_time = 0; /* DP3 单次喷淋时长 */
|
||||
gDevData.continuous_spray_time = 0; /* DP4 连续喷淋时长 */
|
||||
gDevData.current_temp = 0.0f; /* DP5 当前温度 (float) */
|
||||
gDevData.current_humi = 0; /* DP6 当前湿度 */
|
||||
memset(gDevData.spray_config, 0, 8); /* DP7 喷淋配置 */
|
||||
gDevData.linkage_delete = 0; /* DP8 联动删除 0=关 1=开 */
|
||||
memset(gDevData.linkage_config, 0, 20); /* DP9 联动配置 */
|
||||
gDevData.spray_plan_en = 0; /* DP10 喷淋计划总开关 0=关 1=开 */
|
||||
memset(gDevData.spray_plan1, 0, 15); /* DP11 喷淋计划1 */
|
||||
memset(gDevData.time_config2, 0, 15); /* DP12 喷淋计划2 */
|
||||
memset(gDevData.time_config3, 0, 15); /* DP13 喷淋计划3 */
|
||||
memset(gDevData.time_config4, 0, 15); /* DP14 喷淋计划4 */
|
||||
memset(gDevData.time_config5, 0, 15); /* DP15 喷淋计划5 */
|
||||
memset(gDevData.time_config6, 0, 15); /* DP16 喷淋计划6 */
|
||||
memset(gDevData.time_config7, 0, 15); /* DP17 喷淋计划7 */
|
||||
memset(gDevData.run_record, 0, 124); /* DP18 运行记录 */
|
||||
gDevData.heartbeat = 0; /* DP19 心跳 0=关 1=开 */
|
||||
gDevData.fault_en = 0; /* DP20 设备故障使能 */
|
||||
gDevData.fault_code = 0; /* DP21 设备故障 */
|
||||
gDevData.alarm_en = 0; /* DP22 设备告警使能 */
|
||||
gDevData.alarm_code = 0; /* DP23 设备告警 */
|
||||
gDevData.factory_reset = 0; /* DP24 恢复出厂设置 0=关 1=开 */
|
||||
gDevData.reserva_dp1 = 0; /* DP25 预留DP1 */
|
||||
gDevData.reserva_dp2 = 0; /* DP26 预留DP2 */
|
||||
gDevData.reserva_dp3 = 0; /* DP27 预留DP3 */
|
||||
}
|
||||
|
||||
/* ════════════════════════════════════════════════════════════════
|
||||
* userHandle — 用户数据采集
|
||||
* 协议层自动检测变化并上报(注意:此处是上报,不是下发控制)
|
||||
* ════════════════════════════════════════════════════════════════ */
|
||||
void userHandle(void)
|
||||
{
|
||||
/* ── 可上报 DP (RO / RW): 用户数据采集 ── */
|
||||
// gDevData.power = read_sensor(); /* DP0 总开关 */
|
||||
// gDevData.spray_switch = read_sensor(); /* DP1 喷淋开关 */
|
||||
// gDevData.mode = read_sensor(); /* DP2 模式 */
|
||||
// gDevData.once_spray_time = read_sensor(); /* DP3 单次喷淋时长 */
|
||||
// gDevData.continuous_spray_time = read_sensor(); /* DP4 连续喷淋时长 */
|
||||
// memcpy(gDevData.spray_config, sensor_read(), 8); /* DP7 喷淋配置 */
|
||||
// gDevData.linkage_delete = read_sensor(); /* DP8 联动删除 */
|
||||
// memcpy(gDevData.linkage_config, sensor_read(), 20); /* DP9 联动配置 */
|
||||
// gDevData.spray_plan_en = read_sensor(); /* DP10 喷淋计划总开关 */
|
||||
// memcpy(gDevData.spray_plan1, sensor_read(), 15); /* DP11 喷淋计划1 */
|
||||
// memcpy(gDevData.time_config2, sensor_read(), 15); /* DP12 喷淋计划2 */
|
||||
// memcpy(gDevData.time_config3, sensor_read(), 15); /* DP13 喷淋计划3 */
|
||||
// memcpy(gDevData.time_config4, sensor_read(), 15); /* DP14 喷淋计划4 */
|
||||
// memcpy(gDevData.time_config5, sensor_read(), 15); /* DP15 喷淋计划5 */
|
||||
// memcpy(gDevData.time_config6, sensor_read(), 15); /* DP16 喷淋计划6 */
|
||||
// memcpy(gDevData.time_config7, sensor_read(), 15); /* DP17 喷淋计划7 */
|
||||
// memcpy(gDevData.run_record, sensor_read(), 124); /* DP18 运行记录 */
|
||||
// gDevData.fault_en = read_sensor(); /* DP20 设备故障使能 */
|
||||
// gDevData.fault_code = read_sensor(); /* DP21 设备故障 */
|
||||
// gDevData.alarm_en = read_sensor(); /* DP22 设备告警使能 */
|
||||
// gDevData.alarm_code = read_sensor(); /* DP23 设备告警 */
|
||||
// gDevData.reserva_dp1 = read_sensor(); /* DP25 预留DP1 */
|
||||
// gDevData.reserva_dp2 = read_sensor(); /* DP26 预留DP2 */
|
||||
// gDevData.reserva_dp3 = read_sensor(); /* DP27 预留DP3 */
|
||||
}
|
||||
|
||||
/* ════════════════════════════════════════════════════════════════
|
||||
* jbEventProcess — 0x03 APP 控制事件处理(下行 / DP 赋值方向)
|
||||
*
|
||||
* 协议层自动解包 0x03 帧后调用本函数。
|
||||
* info->dp_ids[] = 被控制的 DP ID 列表
|
||||
* ctrl 已填入下发的值;复制到 gDevData 并执行动作
|
||||
* ════════════════════════════════════════════════════════════════ */
|
||||
int8_t jbEventProcess(jb_event_info_t *info, jb_data_point_t *ctrl)
|
||||
{
|
||||
if (!info || !ctrl)
|
||||
{
|
||||
return -1;
|
||||
}
|
||||
|
||||
for (uint8_t i = 0; i < info->count; i++)
|
||||
{
|
||||
switch (info->dp_ids[i])
|
||||
{
|
||||
|
||||
/* ── DP0 总开关 (bool) ── */
|
||||
case DP_ID_POWER:
|
||||
if (ctrl->power)
|
||||
{
|
||||
gDevData.power = 1;
|
||||
// TODO: 开 — 执行动作
|
||||
}
|
||||
else
|
||||
{
|
||||
gDevData.power = 0;
|
||||
// TODO: 关 — 执行动作
|
||||
}
|
||||
break;
|
||||
|
||||
/* ── DP1 喷淋开关 (bool) ── */
|
||||
case DP_ID_SPRAY_SWITCH:
|
||||
if (ctrl->spray_switch)
|
||||
{
|
||||
gDevData.spray_switch = 1;
|
||||
// TODO: 开 — 执行动作
|
||||
}
|
||||
else
|
||||
{
|
||||
gDevData.spray_switch = 0;
|
||||
// TODO: 关 — 执行动作
|
||||
}
|
||||
break;
|
||||
|
||||
/* ── DP2 模式 (enum) ── */
|
||||
case DP_ID_MODE:
|
||||
gDevData.mode = ctrl->mode;
|
||||
switch (ctrl->mode)
|
||||
{
|
||||
case MODE_0: /* 关闭模式 */
|
||||
// TODO: 处理 关闭模式
|
||||
break;
|
||||
case MODE_1: /* 单次喷淋 */
|
||||
// TODO: 处理 单次喷淋
|
||||
break;
|
||||
case MODE_2: /* 连续喷淋 */
|
||||
// TODO: 处理 连续喷淋
|
||||
break;
|
||||
default:
|
||||
break;
|
||||
}
|
||||
break;
|
||||
|
||||
/* ── DP3 单次喷淋时长 (uint8) ── */
|
||||
case DP_ID_ONCE_SPRAY_TIME:
|
||||
gDevData.once_spray_time = ctrl->once_spray_time;
|
||||
// TODO: 根据 ctrl->once_spray_time 执行动作
|
||||
break;
|
||||
|
||||
/* ── DP4 连续喷淋时长 (uint8) ── */
|
||||
case DP_ID_CONTINUOUS_SPRAY_TIME:
|
||||
gDevData.continuous_spray_time = ctrl->continuous_spray_time;
|
||||
// TODO: 根据 ctrl->continuous_spray_time 执行动作
|
||||
break;
|
||||
|
||||
/* ── DP5 当前温度 (float, scale=0.1) ── */
|
||||
case DP_ID_CURRENT_TEMP:
|
||||
gDevData.current_temp = ctrl->current_temp;
|
||||
// TODO: 根据 ctrl->current_temp 执行动作 (已是浮点物理量)
|
||||
break;
|
||||
|
||||
/* ── DP6 当前湿度 (uint8) ── */
|
||||
case DP_ID_CURRENT_HUMI:
|
||||
gDevData.current_humi = ctrl->current_humi;
|
||||
// TODO: 根据 ctrl->current_humi 执行动作
|
||||
break;
|
||||
|
||||
/* ── DP7 喷淋配置 (raw) ── */
|
||||
case DP_ID_SPRAY_CONFIG:
|
||||
memcpy(gDevData.spray_config, ctrl->spray_config, 8);
|
||||
// TODO: 根据 gDevData.spray_config 执行动作 (长度 8 字节)
|
||||
break;
|
||||
|
||||
/* ── DP8 联动删除 (bool) ── */
|
||||
case DP_ID_LINKAGE_DELETE:
|
||||
if (ctrl->linkage_delete)
|
||||
{
|
||||
gDevData.linkage_delete = 1;
|
||||
// TODO: 开 — 执行动作
|
||||
}
|
||||
else
|
||||
{
|
||||
gDevData.linkage_delete = 0;
|
||||
// TODO: 关 — 执行动作
|
||||
}
|
||||
break;
|
||||
|
||||
/* ── DP9 联动配置 (raw) ── */
|
||||
case DP_ID_LINKAGE_CONFIG:
|
||||
memcpy(gDevData.linkage_config, ctrl->linkage_config, 20);
|
||||
// TODO: 根据 gDevData.linkage_config 执行动作 (长度 20 字节)
|
||||
break;
|
||||
|
||||
/* ── DP10 喷淋计划总开关 (bool) ── */
|
||||
case DP_ID_SPRAY_PLAN_EN:
|
||||
if (ctrl->spray_plan_en)
|
||||
{
|
||||
gDevData.spray_plan_en = 1;
|
||||
// TODO: 开 — 执行动作
|
||||
}
|
||||
else
|
||||
{
|
||||
gDevData.spray_plan_en = 0;
|
||||
// TODO: 关 — 执行动作
|
||||
}
|
||||
break;
|
||||
|
||||
/* ── DP11 喷淋计划1 (raw) ── */
|
||||
case DP_ID_SPRAY_PLAN1:
|
||||
memcpy(gDevData.spray_plan1, ctrl->spray_plan1, 15);
|
||||
// TODO: 根据 gDevData.spray_plan1 执行动作 (长度 15 字节)
|
||||
break;
|
||||
|
||||
/* ── DP12 喷淋计划2 (raw) ── */
|
||||
case DP_ID_TIME_CONFIG2:
|
||||
memcpy(gDevData.time_config2, ctrl->time_config2, 15);
|
||||
// TODO: 根据 gDevData.time_config2 执行动作 (长度 15 字节)
|
||||
break;
|
||||
|
||||
/* ── DP13 喷淋计划3 (raw) ── */
|
||||
case DP_ID_TIME_CONFIG3:
|
||||
memcpy(gDevData.time_config3, ctrl->time_config3, 15);
|
||||
// TODO: 根据 gDevData.time_config3 执行动作 (长度 15 字节)
|
||||
break;
|
||||
|
||||
/* ── DP14 喷淋计划4 (raw) ── */
|
||||
case DP_ID_TIME_CONFIG4:
|
||||
memcpy(gDevData.time_config4, ctrl->time_config4, 15);
|
||||
// TODO: 根据 gDevData.time_config4 执行动作 (长度 15 字节)
|
||||
break;
|
||||
|
||||
/* ── DP15 喷淋计划5 (raw) ── */
|
||||
case DP_ID_TIME_CONFIG5:
|
||||
memcpy(gDevData.time_config5, ctrl->time_config5, 15);
|
||||
// TODO: 根据 gDevData.time_config5 执行动作 (长度 15 字节)
|
||||
break;
|
||||
|
||||
/* ── DP16 喷淋计划6 (raw) ── */
|
||||
case DP_ID_TIME_CONFIG6:
|
||||
memcpy(gDevData.time_config6, ctrl->time_config6, 15);
|
||||
// TODO: 根据 gDevData.time_config6 执行动作 (长度 15 字节)
|
||||
break;
|
||||
|
||||
/* ── DP17 喷淋计划7 (raw) ── */
|
||||
case DP_ID_TIME_CONFIG7:
|
||||
memcpy(gDevData.time_config7, ctrl->time_config7, 15);
|
||||
// TODO: 根据 gDevData.time_config7 执行动作 (长度 15 字节)
|
||||
break;
|
||||
|
||||
/* ── DP19 心跳 (bool) ── */
|
||||
case DP_ID_HEARTBEAT:
|
||||
if (ctrl->heartbeat)
|
||||
{
|
||||
gDevData.heartbeat = 1;
|
||||
// TODO: 开 — 执行动作
|
||||
}
|
||||
else
|
||||
{
|
||||
gDevData.heartbeat = 0;
|
||||
// TODO: 关 — 执行动作
|
||||
}
|
||||
break;
|
||||
|
||||
/* ── DP20 设备故障使能 (uint8) ── */
|
||||
case DP_ID_FAULT_EN:
|
||||
gDevData.fault_en = ctrl->fault_en;
|
||||
// TODO: 根据 ctrl->fault_en 执行动作
|
||||
break;
|
||||
|
||||
/* ── DP22 设备告警使能 (uint8) ── */
|
||||
case DP_ID_ALARM_EN:
|
||||
gDevData.alarm_en = ctrl->alarm_en;
|
||||
// TODO: 根据 ctrl->alarm_en 执行动作
|
||||
break;
|
||||
|
||||
/* ── DP24 恢复出厂设置 (bool) ── */
|
||||
case DP_ID_FACTORY_RESET:
|
||||
if (ctrl->factory_reset)
|
||||
{
|
||||
gDevData.factory_reset = 1;
|
||||
// TODO: 开 — 执行动作
|
||||
}
|
||||
else
|
||||
{
|
||||
gDevData.factory_reset = 0;
|
||||
// TODO: 关 — 执行动作
|
||||
}
|
||||
break;
|
||||
|
||||
/* ── DP25 预留DP1 (uint32) ── */
|
||||
case DP_ID_RESERVA_DP1:
|
||||
gDevData.reserva_dp1 = ctrl->reserva_dp1;
|
||||
// TODO: 根据 ctrl->reserva_dp1 执行动作
|
||||
break;
|
||||
|
||||
/* ── DP26 预留DP2 (uint32) ── */
|
||||
case DP_ID_RESERVA_DP2:
|
||||
gDevData.reserva_dp2 = ctrl->reserva_dp2;
|
||||
// TODO: 根据 ctrl->reserva_dp2 执行动作
|
||||
break;
|
||||
|
||||
/* ── DP27 预留DP3 (uint32) ── */
|
||||
case DP_ID_RESERVA_DP3:
|
||||
gDevData.reserva_dp3 = ctrl->reserva_dp3;
|
||||
// TODO: 根据 ctrl->reserva_dp3 执行动作
|
||||
break;
|
||||
|
||||
default:
|
||||
break;
|
||||
}
|
||||
}
|
||||
return 0;
|
||||
}
|
||||
|
||||
/* 0x30 OTA 升级请求
|
||||
* 返回 0=接受升级(协议层应答 JB_OK + MaxDataLen)
|
||||
* 非 0=拒绝,返回值即错误码(JB_OTA_*)
|
||||
*
|
||||
* ⚠ SOC 侧 OTA 尚未实现:当前仅应答,不执行任何升级动作。 */
|
||||
int8_t jbOnOtaNotify(uint32_t fwVersion, uint32_t fwLength, uint32_t fwCrc32)
|
||||
{
|
||||
(void)fwVersion; (void)fwLength; (void)fwCrc32;
|
||||
// TODO: 检查 Flash 空间与版本,决定是否接收升级
|
||||
// 允许: 返回 JB_OK(协议层应答 JB_OK + MaxDataLen)
|
||||
// 拒绝: 返回对应 JB_OTA_* 错误码(如 JB_OTA_VER_LOW / JB_OTA_SPACE_ERR)
|
||||
return JB_OK;
|
||||
}
|
||||
|
||||
/* 0x32 OTA 数据(含分片序号)*/
|
||||
void jbOnOtaData(const uint8_t *data, uint16_t len,
|
||||
uint16_t shardIdx, uint16_t totalShards)
|
||||
{
|
||||
(void)data; (void)len; (void)shardIdx; (void)totalShards;
|
||||
// TODO: 写入 Flash,累计 CRC32
|
||||
// 全部数据接收完成后调用 jbSendOtaResult(JB_OK, mcuVersion)
|
||||
}
|
||||
|
||||
/* 0x36 / 0x38 停止 OTA */
|
||||
void jbOnOtaStop(void)
|
||||
{
|
||||
// TODO: 终止 OTA,释放资源
|
||||
}
|
||||
|
||||
/* 任意 MCU→BLE 请求的 ACK 回调(cmd 标识是哪条请求的应答,result 为结果码)
|
||||
- SOC 仅保留 OTA 主动请求应答: OTA完成 0x35 / 停止 0x39
|
||||
- 可在本回调中设置"XX 完成/失败"标志,供主循环判断"确认成功才继续" */
|
||||
void jbOnAck(uint8_t cmd, uint8_t result)
|
||||
{
|
||||
(void)cmd;
|
||||
(void)result;
|
||||
// TODO: switch(cmd){ case CMD_OTA_COMPLETE_ACK: gOtaDone = (result==JB_OK); break; case CMD_OTA_STOP_MCU_ACK: ... }
|
||||
}
|
||||
|
||||
/* ════════════════════════════════════════════════════════════════
|
||||
* 硬件抽象(按实际平台实现)
|
||||
* ════════════════════════════════════════════════════════════════ */
|
||||
|
||||
/* ── 定时器 ── */
|
||||
void jbTimerIrq(void)
|
||||
{
|
||||
timerMs++;
|
||||
} /* 在 1ms 中断中调用本函数 */
|
||||
|
||||
uint32_t jbGetTimerCount(void)
|
||||
{
|
||||
return timerMs;
|
||||
}
|
||||
@@ -0,0 +1,55 @@
|
||||
/* ================================================================
|
||||
* jb_product.h — 用户层头文件(自动生成)
|
||||
* 设备: 喷淋器 | 生成时间: 2026-09-09 10:22:58
|
||||
*
|
||||
* 声明用户需实现的函数。数据结构定义见 jb_protocol.h
|
||||
* ================================================================
|
||||
*/
|
||||
|
||||
#ifndef _JB_PRODUCT_H
|
||||
#define _JB_PRODUCT_H
|
||||
|
||||
#include "jb_protocol.h"
|
||||
|
||||
/* ════════════════════════════════════════════════════════════════
|
||||
* 硬件配置(SOC SDK 已提供定时器,无需 UART 波特率配置)
|
||||
* ════════════════════════════════════════════════════════════════ */
|
||||
#define TIMER_PERIOD_MS 1
|
||||
|
||||
/* ════════════════════════════════════════════════════════════════
|
||||
* 版本管理
|
||||
* ════════════════════════════════════════════════════════════════ */
|
||||
/* MCU software version: Vmajor.minor.patch */
|
||||
#define JB_MCU_SW_VERSION_MAJOR 1
|
||||
#define JB_MCU_SW_VERSION_MINOR 0
|
||||
#define JB_MCU_SW_VERSION_PATCH 0
|
||||
|
||||
/* MCU hardware version: Vmajor.minor.patch */
|
||||
#define JB_MCU_HW_VERSION_MAJOR 1
|
||||
#define JB_MCU_HW_VERSION_MINOR 0
|
||||
#define JB_MCU_HW_VERSION_PATCH 0
|
||||
|
||||
/* ════════════════════════════════════════════════════════════════
|
||||
* 用户 API
|
||||
* ════════════════════════════════════════════════════════════════ */
|
||||
|
||||
/* 全局设备数据 — 协议层直接读写该变量 */
|
||||
extern jb_data_point_t gDevData;
|
||||
|
||||
/* ==================== 用户必须实现 ============================== */
|
||||
void userInit(void); /* DP 默认值与外设初始化 */
|
||||
void userHandle(void); /* 用户数据采集 */
|
||||
void jbTimerIrq(void); /* Call from 1ms timer ISR */
|
||||
|
||||
/* =========== 协议回调(声明见 jb_protocol.h)================== */
|
||||
/* int8_t jbEventProcess(...); // 0x03 控制事件 */
|
||||
/* int8_t jbOnOtaNotify(...); // 0x30 OTA 请求 */
|
||||
/* void jbOnOtaData(...); // 0x32 OTA 数据 */
|
||||
/* void jbOnOtaStop(); // 0x36/0x38 停止 OTA */
|
||||
/* void jbOnAck(...); // 任意请求 ACK(结果) */
|
||||
|
||||
/* ============= 主动请求(声明见 jb_protocol.h)================ */
|
||||
/* int32_t jbNotifyOtaStop(); // 0x38 通知 BLE 停止 OTA */
|
||||
/* int32_t jbSendOtaResult(...); // 0x34 OTA 结果 */
|
||||
|
||||
#endif /* _JB_PRODUCT_H */
|
||||
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,308 @@
|
||||
/* ================================================================
|
||||
* jb_protocol.h — 见宝 IOT 协议层(自动生成)
|
||||
* 设备: 喷淋器 | DP 数: 28 | Bitmap: 4B
|
||||
* 协议版本: V1.0 | 生成时间: 2026-09-09 10:22:58
|
||||
*
|
||||
* 帧格式: [55 AA] [LEN_H LEN_L] [CMD] [SN] [payload...] [CKSUM]
|
||||
* LEN = CMD(1) + SN(1) + payload + CKSUM(1) = payload + 3
|
||||
* CKSUM = sum(LEN_H .. payload_last) & 0xFF
|
||||
* Bitmap = 每个 DP 占 1 bit,bit 序号 = DP ID(0 起始)
|
||||
* Values = 按 bitmap 置位顺序排列,每个 DP 占完整 byte_length
|
||||
* ================================================================
|
||||
*/
|
||||
|
||||
#ifndef _JB_PROTOCOL_H
|
||||
#define _JB_PROTOCOL_H
|
||||
|
||||
#include <stdint.h>
|
||||
#include <stddef.h>
|
||||
#include <string.h>
|
||||
|
||||
/* ════════════════════════════════════════════════════════════════
|
||||
* 协议常量
|
||||
* ════════════════════════════════════════════════════════════════ */
|
||||
#define PKT_HEAD_0 0x55
|
||||
#define PKT_HEAD_1 0xAA
|
||||
#define MAX_PACKAGE_LEN 128
|
||||
#define JB_OTA_MAX_PAYLOAD 96 /* OTA 单包 Payload 上限(Byte); 须 <= MAX_PACKAGE_LEN - 11(0x32 帧开销) */
|
||||
|
||||
#define DP_COUNT 28
|
||||
#define DP_BITMAP_SIZE 4
|
||||
|
||||
#define SEND_MAX_TIME 2500 /* ACK 重传超时(ms);BLE Indication往返常需数百ms~1s,过短会误重传导致双应答 */
|
||||
#define SEND_MAX_NUM 3 /* 最大重传次数 */
|
||||
#define REPORT_DEBOUNCE 2000 /* 变化上报防抖时间(ms) */
|
||||
#define REPORT_PERIOD 600000 /* 定时全量上报周期(ms) */
|
||||
|
||||
/* Device identity: 取自 Excel 设备信息表的 ProdtCode / productCode。
|
||||
* JB_CATEGORY_CODE: 必须 4 字符 ASCII,供 BLE 广播 prodcode 使用
|
||||
* JB_PRODUCT_CODE : 必须 6 字符 ASCII,供 BLE 广播 pcode 使用
|
||||
* 模板未填时回退占位 XXXX / XXXXXX(仍需用户修改)。
|
||||
*/
|
||||
#define JB_PROTOCOL_VERSION 0x0100 /* V1.0 */
|
||||
#define JB_CATEGORY_CODE "CBR2"
|
||||
#define JB_PRODUCT_CODE "PRCBR2"
|
||||
#define JB_DEVICE_SN 0x00
|
||||
#define JB_DEVICE_CAPABILITY 0ULL
|
||||
|
||||
/* ════════════════════════════════════════════════════════════════
|
||||
* 命令码(见《SOC方案接入协议通讯文档》)
|
||||
* ════════════════════════════════════════════════════════════════ */
|
||||
typedef enum
|
||||
{
|
||||
/* ── APP-BLE 数据(6) ── */
|
||||
CMD_CONTROL = 0x03, /* APP/BLE → MCU: 下发控制 */
|
||||
CMD_CONTROL_ACK = 0x04, /* MCU → APP/BLE: 控制应答 */
|
||||
CMD_READ = 0x05, /* APP/BLE → MCU: 读取请求 */
|
||||
CMD_READ_ACK = 0x06, /* MCU → APP/BLE: 读取应答 */
|
||||
CMD_REPORT = 0x07, /* MCU → APP/BLE: 主动上报 */
|
||||
CMD_REPORT_ACK = 0x08, /* APP/BLE → MCU: 上报应答 */
|
||||
/* ── OTA(10) ── */
|
||||
CMD_OTA_NOTIFY = 0x30, /* BLE → MCU: OTA 升级请求 */
|
||||
CMD_OTA_NOTIFY_ACK = 0x31, /* MCU → BLE: OTA 应答(含MaxLen) */
|
||||
CMD_OTA_DATA = 0x32, /* BLE → MCU: OTA 数据 */
|
||||
CMD_OTA_DATA_ACK = 0x33, /* MCU → BLE: OTA 数据应答 */
|
||||
CMD_OTA_COMPLETE = 0x34, /* MCU → BLE: OTA 完成 */
|
||||
CMD_OTA_COMPLETE_ACK = 0x35, /* BLE → MCU: OTA 完成应答 */
|
||||
CMD_OTA_STOP_BLE = 0x36, /* BLE → MCU: 停止 OTA */
|
||||
CMD_OTA_STOP_BLE_ACK = 0x37, /* MCU → BLE: 停止应答 */
|
||||
CMD_OTA_STOP_MCU = 0x38, /* MCU → BLE: 通知停止 OTA */
|
||||
CMD_OTA_STOP_MCU_ACK = 0x39, /* BLE → MCU: 停止应答 */
|
||||
} jb_cmd_t;
|
||||
|
||||
/* ════════════════════════════════════════════════════════════════
|
||||
* 结果码
|
||||
* ════════════════════════════════════════════════════════════════ */
|
||||
typedef enum
|
||||
{
|
||||
JB_OK = 0x00,
|
||||
JB_PARAM_ERR = 0x01,
|
||||
JB_BUSY = 0x02,
|
||||
JB_NOT_SUPPORT = 0x03,
|
||||
JB_CRC_ERR = 0x04,
|
||||
JB_FAIL = 0x05,
|
||||
/* ── OTA 专用错误码 ── */
|
||||
JB_OTA_NO_NEED = 0x20, /* 无需升级(版本一致) */
|
||||
JB_OTA_VER_LOW = 0x21, /* OTA 版本低于当前版本 */
|
||||
JB_OTA_SPACE_ERR = 0x22, /* Flash 空间不足 */
|
||||
JB_OTA_STATE_ERR = 0x23, /* OTA 状态错误 */
|
||||
JB_OTA_FILE_ERR = 0x24, /* OTA 文件检验失败 */
|
||||
JB_OTA_FAIL = 0x25, /* 升级失败 */
|
||||
} jb_result_t;
|
||||
|
||||
/* ════════════════════════════════════════════════════════════════
|
||||
* BLE 工作状态位 (0x14)
|
||||
* ════════════════════════════════════════════════════════════════ */
|
||||
#define WS_CONNECTING (1 << 0) /* 配网中 */
|
||||
#define WS_CONFIGURED (1 << 1) /* 已配网 */
|
||||
#define WS_RECONNECTING (1 << 2) /* 断线重连中 */
|
||||
#define WS_CLOUD_CONNECTED (1 << 3) /* 已连接到云 */
|
||||
#define WS_APP_ONLINE (1 << 4) /* App 在线 */
|
||||
#define WS_APP_DIRECT (1 << 5) /* App 直连 */
|
||||
#define WS_OTA_UPGRADING (1 << 6) /* 模组 OTA 升级中 */
|
||||
#define WS_RESERVED (1 << 7) /* 保留 */
|
||||
|
||||
/* ════════════════════════════════════════════════════════════════
|
||||
* 设备能力位图 (0x02 Capability Bitmap, 8B 大端)
|
||||
* ════════════════════════════════════════════════════════════════ */
|
||||
#define CAP_BLE_OTA (1ULL << 0) /* BLE OTA */
|
||||
#define CAP_MCU_OTA (1ULL << 1) /* MCU OTA */
|
||||
#define CAP_APP_DIRECT (1ULL << 2) /* APP 直连 BLE */
|
||||
#define CAP_IPC_GATEWAY (1ULL << 3) /* IPC 网关连接 */
|
||||
#define CAP_PRODUCTION (1ULL << 4) /* 产测模式 */
|
||||
#define CAP_PARAM_CFG (1ULL << 5) /* 参数配置 */
|
||||
#define CAP_LOG (1ULL << 6) /* 日志功能 */
|
||||
|
||||
/* ════════════════════════════════════════════════════════════════
|
||||
* DP ID 枚举(从 Excel 自动生成)
|
||||
* ════════════════════════════════════════════════════════════════ */
|
||||
typedef enum
|
||||
{
|
||||
DP_ID_POWER = 0, /* 总开关 (bool, RW) */
|
||||
DP_ID_SPRAY_SWITCH = 1, /* 喷淋开关 (bool, RW) */
|
||||
DP_ID_MODE = 2, /* 模式 (enum, RW) */
|
||||
DP_ID_ONCE_SPRAY_TIME = 3, /* 单次喷淋时长 (uint8, RW) */
|
||||
DP_ID_CONTINUOUS_SPRAY_TIME = 4, /* 连续喷淋时长 (uint8, RW) */
|
||||
DP_ID_CURRENT_TEMP = 5, /* 当前温度 (float, WO) */
|
||||
DP_ID_CURRENT_HUMI = 6, /* 当前湿度 (uint8, WO) */
|
||||
DP_ID_SPRAY_CONFIG = 7, /* 喷淋配置 (raw, RW) */
|
||||
DP_ID_LINKAGE_DELETE = 8, /* 联动删除 (bool, RW) */
|
||||
DP_ID_LINKAGE_CONFIG = 9, /* 联动配置 (raw, RW) */
|
||||
DP_ID_SPRAY_PLAN_EN = 10, /* 喷淋计划总开关 (bool, RW) */
|
||||
DP_ID_SPRAY_PLAN1 = 11, /* 喷淋计划1 (raw, RW) */
|
||||
DP_ID_TIME_CONFIG2 = 12, /* 喷淋计划2 (raw, RW) */
|
||||
DP_ID_TIME_CONFIG3 = 13, /* 喷淋计划3 (raw, RW) */
|
||||
DP_ID_TIME_CONFIG4 = 14, /* 喷淋计划4 (raw, RW) */
|
||||
DP_ID_TIME_CONFIG5 = 15, /* 喷淋计划5 (raw, RW) */
|
||||
DP_ID_TIME_CONFIG6 = 16, /* 喷淋计划6 (raw, RW) */
|
||||
DP_ID_TIME_CONFIG7 = 17, /* 喷淋计划7 (raw, RW) */
|
||||
DP_ID_RUN_RECORD = 18, /* 运行记录 (raw, RO) */
|
||||
DP_ID_HEARTBEAT = 19, /* 心跳 (bool, WO) */
|
||||
DP_ID_FAULT_EN = 20, /* 设备故障使能 (uint8, RW) */
|
||||
DP_ID_FAULT_CODE = 21, /* 设备故障 (uint8, RO) */
|
||||
DP_ID_ALARM_EN = 22, /* 设备告警使能 (uint8, RW) */
|
||||
DP_ID_ALARM_CODE = 23, /* 设备告警 (uint8, RO) */
|
||||
DP_ID_FACTORY_RESET = 24, /* 恢复出厂设置 (bool, WO) */
|
||||
DP_ID_RESERVA_DP1 = 25, /* 预留DP1 (uint32, RW) */
|
||||
DP_ID_RESERVA_DP2 = 26, /* 预留DP2 (uint32, RW) */
|
||||
DP_ID_RESERVA_DP3 = 27, /* 预留DP3 (uint32, RW) */
|
||||
DP_ID_MAX
|
||||
} dp_id_t;
|
||||
|
||||
/* DP 数据长度(字节) */
|
||||
#define DP_LEN_POWER 1
|
||||
#define DP_LEN_SPRAY_SWITCH 1
|
||||
#define DP_LEN_MODE 1
|
||||
#define DP_LEN_ONCE_SPRAY_TIME 1
|
||||
#define DP_LEN_CONTINUOUS_SPRAY_TIME 1
|
||||
#define DP_LEN_CURRENT_TEMP 2
|
||||
#define DP_LEN_CURRENT_HUMI 1
|
||||
#define DP_LEN_SPRAY_CONFIG 8
|
||||
#define DP_LEN_LINKAGE_DELETE 1
|
||||
#define DP_LEN_LINKAGE_CONFIG 20
|
||||
#define DP_LEN_SPRAY_PLAN_EN 1
|
||||
#define DP_LEN_SPRAY_PLAN1 15
|
||||
#define DP_LEN_TIME_CONFIG2 15
|
||||
#define DP_LEN_TIME_CONFIG3 15
|
||||
#define DP_LEN_TIME_CONFIG4 15
|
||||
#define DP_LEN_TIME_CONFIG5 15
|
||||
#define DP_LEN_TIME_CONFIG6 15
|
||||
#define DP_LEN_TIME_CONFIG7 15
|
||||
#define DP_LEN_RUN_RECORD 124
|
||||
#define DP_LEN_HEARTBEAT 1
|
||||
#define DP_LEN_FAULT_EN 1
|
||||
#define DP_LEN_FAULT_CODE 1
|
||||
#define DP_LEN_ALARM_EN 1
|
||||
#define DP_LEN_ALARM_CODE 1
|
||||
#define DP_LEN_FACTORY_RESET 1
|
||||
#define DP_LEN_RESERVA_DP1 4
|
||||
#define DP_LEN_RESERVA_DP2 4
|
||||
#define DP_LEN_RESERVA_DP3 4
|
||||
|
||||
/* ════════════════════════════════════════════════════════════════
|
||||
* DP 枚举值定义
|
||||
* ════════════════════════════════════════════════════════════════ */
|
||||
/* 模式 */
|
||||
typedef enum
|
||||
{
|
||||
MODE_0 = 0, /* 关闭模式 */
|
||||
MODE_1 = 1, /* 单次喷淋 */
|
||||
MODE_2 = 2, /* 连续喷淋 */
|
||||
} MODE_t;
|
||||
|
||||
/* ════════════════════════════════════════════════════════════════
|
||||
* 数据结构
|
||||
* ════════════════════════════════════════════════════════════════ */
|
||||
|
||||
/* 数据点 — 所有 DP 的当前值 */
|
||||
typedef struct
|
||||
{
|
||||
uint8_t power; /* DP0 总开关 */
|
||||
uint8_t spray_switch; /* DP1 喷淋开关 */
|
||||
uint8_t mode; /* DP2 模式 */
|
||||
uint8_t once_spray_time;/* DP3 单次喷淋时长 */
|
||||
uint8_t continuous_spray_time;/* DP4 连续喷淋时长 */
|
||||
float current_temp; /* DP5 当前温度 (float, scale=0.1) */
|
||||
uint8_t current_humi; /* DP6 当前湿度 */
|
||||
uint8_t spray_config[8];/* DP7 喷淋配置 */
|
||||
uint8_t linkage_delete;/* DP8 联动删除 */
|
||||
uint8_t linkage_config[20];/* DP9 联动配置 */
|
||||
uint8_t spray_plan_en;/* DP10 喷淋计划总开关 */
|
||||
uint8_t spray_plan1[15];/* DP11 喷淋计划1 */
|
||||
uint8_t time_config2[15];/* DP12 喷淋计划2 */
|
||||
uint8_t time_config3[15];/* DP13 喷淋计划3 */
|
||||
uint8_t time_config4[15];/* DP14 喷淋计划4 */
|
||||
uint8_t time_config5[15];/* DP15 喷淋计划5 */
|
||||
uint8_t time_config6[15];/* DP16 喷淋计划6 */
|
||||
uint8_t time_config7[15];/* DP17 喷淋计划7 */
|
||||
uint8_t run_record[124];/* DP18 运行记录 */
|
||||
uint8_t heartbeat; /* DP19 心跳 */
|
||||
uint8_t fault_en; /* DP20 设备故障使能 */
|
||||
uint8_t fault_code; /* DP21 设备故障 */
|
||||
uint8_t alarm_en; /* DP22 设备告警使能 */
|
||||
uint8_t alarm_code; /* DP23 设备告警 */
|
||||
uint8_t factory_reset;/* DP24 恢复出厂设置 */
|
||||
uint32_t reserva_dp1; /* DP25 预留DP1 */
|
||||
uint32_t reserva_dp2; /* DP26 预留DP2 */
|
||||
uint32_t reserva_dp3; /* DP27 预留DP3 */
|
||||
} jb_data_point_t;
|
||||
|
||||
/* 控制事件信息 */
|
||||
typedef struct
|
||||
{
|
||||
uint8_t count;
|
||||
uint8_t dp_ids[DP_ID_MAX];
|
||||
} jb_event_info_t;
|
||||
|
||||
/* ACK 等待 / 重传管理器 */
|
||||
typedef struct
|
||||
{
|
||||
uint8_t active; /* 是否有等待中的请求 */
|
||||
uint8_t sn; /* 帧序列号 */
|
||||
uint8_t retry;
|
||||
uint8_t buf[MAX_PACKAGE_LEN];
|
||||
uint16_t len;
|
||||
uint32_t sendTime;
|
||||
} jb_wait_ack_t;
|
||||
|
||||
/* 协议全局状态 */
|
||||
typedef struct
|
||||
{
|
||||
uint8_t sn; /* 设备 SN 计数器 */
|
||||
uint8_t rxBuf[MAX_PACKAGE_LEN];
|
||||
jb_wait_ack_t waitAck; /* ACK 重传管理器 */
|
||||
jb_data_point_t lastData; /* 上次上报快照 */
|
||||
uint32_t lastReportTime; /* 上次上报时刻 */
|
||||
uint32_t lastChangeTime; /* 上次变化上报时刻 */
|
||||
} jb_protocol_t;
|
||||
|
||||
/* ════════════════════════════════════════════════════════════════
|
||||
* 全局实例
|
||||
* ════════════════════════════════════════════════════════════════ */
|
||||
extern jb_protocol_t jbProtocol;
|
||||
|
||||
/* ════════════════════════════════════════════════════════════════
|
||||
* 协议层 API(自动生成)
|
||||
* ════════════════════════════════════════════════════════════════ */
|
||||
void jbInit(void);
|
||||
int32_t jbPutData(uint8_t *buf, uint32_t len);
|
||||
|
||||
int32_t jbNotifyOtaStop(void);
|
||||
int32_t jbSendOtaResult(uint8_t result, const uint8_t *mcuVersion);
|
||||
|
||||
int32_t jbProtocolHandle(jb_data_point_t *data);
|
||||
|
||||
/*
|
||||
* 网关应答确认(主动上报 / OTA 共用,REPORTCMD_V2,非 55AA)
|
||||
* cmd: ble_proto 包 cmd
|
||||
* gateway_int_cnt: gateway int 个数
|
||||
* gateway_int0: gateway_int[0]
|
||||
* 成功条件: cmd==0 && gateway_int_cnt==1 && gateway_int0==0
|
||||
* 返回: 1=成功并清除等待; 0=未命中/条件不符
|
||||
*/
|
||||
int8_t jbReportAckCheck(uint16_t cmd, uint8_t gateway_int_cnt, int32_t gateway_int0);
|
||||
|
||||
/* ════════════════════════════════════════════════════════════════
|
||||
* 硬件抽象(用户实现)
|
||||
* ════════════════════════════════════════════════════════════════ */
|
||||
uint32_t jbGetTimerCount(void); /* ms 计数器(定时器由 SOC SDK 提供) */
|
||||
|
||||
/* 发送接口:经 SOC SDK 提供的 BLE 发送封装(由用户/SDK 实现,非本生成代码范围)*/
|
||||
extern void ble_send_data(uint8_t *data, uint16_t len);
|
||||
|
||||
/* ════════════════════════════════════════════════════════════════
|
||||
* 用户回调(用户实现)
|
||||
* ════════════════════════════════════════════════════════════════ */
|
||||
/* 0x03 APP 下发控制事件 */
|
||||
int8_t jbEventProcess(jb_event_info_t *info, jb_data_point_t *data);
|
||||
|
||||
/* BLE → MCU 事件回调 */
|
||||
int8_t jbOnOtaNotify(uint32_t fwVersion, uint32_t fwLength, uint32_t fwCrc32); /* 0x30, 返回0=接受,非0=拒绝码 */
|
||||
void jbOnOtaData(const uint8_t *data, uint16_t len,
|
||||
uint16_t shardIdx, uint16_t totalShards); /* 0x32 */
|
||||
void jbOnOtaStop(void); /* 0x36 / 0x38 停止 */
|
||||
|
||||
/* MCU → BLE 应答回调(收到 BLE 应答时触发)*/
|
||||
void jbOnAck(uint8_t cmd, uint8_t result); /* 任意请求 ACK(结果) */
|
||||
|
||||
#endif /* _JB_PROTOCOL_H */
|
||||
Reference in New Issue
Block a user