生成代码包

This commit is contained in:
2026-08-29 11:06:52 +08:00
commit 4cb7418a02
914 changed files with 218983 additions and 0 deletions
+388
View File
@@ -0,0 +1,388 @@
/* ================================================================
* jb_product.c — 用户层实现(请填补空白处)
* 设备: 温湿度风扇 | 生成时间: 2026-08-29 10:31:50
*
* ══ 开发流程 ══
* 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.mode = 0; /* MODE_0 (关闭模式) */
gDevData.fan_gear = 0; /* FAN_GEAR_0 (关闭风扇) */
gDevData.current_temp = 0.0f; /* DP3 当前温度 (float) */
gDevData.current_humi = 0; /* DP4 当前湿度 */
gDevData.cond_en = 0; /* DP5 条件使能 0=关 1=开 */
memset(gDevData.cond_config1, 0, 6); /* DP6 条件配置1 */
memset(gDevData.cond_config2, 0, 6); /* DP7 条件配置2 */
memset(gDevData.cond_config3, 0, 6); /* DP8 条件配置3 */
memset(gDevData.cond_config4, 0, 6); /* DP9 条件配置4 */
memset(gDevData.cond_config5, 0, 6); /* DP10 条件配置5 */
memset(gDevData.cond_config6, 0, 6); /* DP11 条件配置6 */
memset(gDevData.cond_config7, 0, 6); /* DP12 条件配置7 */
gDevData.time_en = 0; /* DP13 定时使能 0=关 1=开 */
memset(gDevData.time_config1, 0, 8); /* DP14 定时配置1 */
memset(gDevData.time_config2, 0, 8); /* DP15 定时配置2 */
memset(gDevData.time_config3, 0, 8); /* DP16 定时配置3 */
memset(gDevData.time_config4, 0, 8); /* DP17 定时配置4 */
memset(gDevData.time_config5, 0, 8); /* DP18 定时配置5 */
memset(gDevData.time_config6, 0, 8); /* DP19 定时配置6 */
memset(gDevData.time_config7, 0, 8); /* DP20 定时配置7 */
gDevData.fault_en = 0; /* DP21 设备故障使能 */
gDevData.fault_code = 0; /* DP22 设备故障 */
gDevData.alarm_en = 0; /* DP23 设备告警使能 */
gDevData.alarm_code = 0; /* DP24 设备告警 */
gDevData.factory_reset = 0; /* DP25 恢复出厂设置 0=关 1=开 */
gDevData.reserva_dp1 = 0; /* DP26 预留DP1 */
gDevData.reserva_dp2 = 0; /* DP27 预留DP2 */
gDevData.reserva_dp3 = 0; /* DP28 预留DP3 */
}
/* ════════════════════════════════════════════════════════════════
* userHandle — 用户数据采集
* 协议层自动检测变化并上报(注意:此处是上报,不是下发控制)
* ════════════════════════════════════════════════════════════════ */
void userHandle(void)
{
/* ── 可上报 DP (RO / RW): 用户数据采集 ── */
// gDevData.power = read_sensor(); /* DP0 开关 */
// gDevData.mode = read_sensor(); /* DP1 模式 */
// gDevData.fan_gear = read_sensor(); /* DP2 风速挡位 */
// gDevData.current_temp = 23.5f; /* DP3 当前温度 (float, scale=0.1), 直接填物理量 */
// gDevData.current_humi = read_sensor(); /* DP4 当前湿度 */
// gDevData.cond_en = read_sensor(); /* DP5 条件使能 */
// memcpy(gDevData.cond_config1, sensor_read(), 6); /* DP6 条件配置1 */
// memcpy(gDevData.cond_config2, sensor_read(), 6); /* DP7 条件配置2 */
// memcpy(gDevData.cond_config3, sensor_read(), 6); /* DP8 条件配置3 */
// memcpy(gDevData.cond_config4, sensor_read(), 6); /* DP9 条件配置4 */
// memcpy(gDevData.cond_config5, sensor_read(), 6); /* DP10 条件配置5 */
// memcpy(gDevData.cond_config6, sensor_read(), 6); /* DP11 条件配置6 */
// memcpy(gDevData.cond_config7, sensor_read(), 6); /* DP12 条件配置7 */
// gDevData.time_en = read_sensor(); /* DP13 定时使能 */
// memcpy(gDevData.time_config1, sensor_read(), 8); /* DP14 定时配置1 */
// memcpy(gDevData.time_config2, sensor_read(), 8); /* DP15 定时配置2 */
// memcpy(gDevData.time_config3, sensor_read(), 8); /* DP16 定时配置3 */
// memcpy(gDevData.time_config4, sensor_read(), 8); /* DP17 定时配置4 */
// memcpy(gDevData.time_config5, sensor_read(), 8); /* DP18 定时配置5 */
// memcpy(gDevData.time_config6, sensor_read(), 8); /* DP19 定时配置6 */
// memcpy(gDevData.time_config7, sensor_read(), 8); /* DP20 定时配置7 */
// gDevData.fault_en = read_sensor(); /* DP21 设备故障使能 */
// gDevData.fault_code = read_sensor(); /* DP22 设备故障 */
// gDevData.alarm_en = read_sensor(); /* DP23 设备告警使能 */
// gDevData.alarm_code = read_sensor(); /* DP24 设备告警 */
// gDevData.reserva_dp1 = read_sensor(); /* DP26 预留DP1 */
// gDevData.reserva_dp2 = read_sensor(); /* DP27 预留DP2 */
// gDevData.reserva_dp3 = read_sensor(); /* DP28 预留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 模式 (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;
/* ── DP2 风速挡位 (enum) ── */
case DP_ID_FAN_GEAR:
gDevData.fan_gear = ctrl->fan_gear;
switch (ctrl->fan_gear)
{
case FAN_GEAR_0: /* 关闭风扇 */
// TODO: 处理 关闭风扇
break;
case FAN_GEAR_1: /* 1档风速 */
// TODO: 处理 1档风速
break;
case FAN_GEAR_2: /* 2档风速 */
// TODO: 处理 2档风速
break;
case FAN_GEAR_3: /* 3档风速 */
// TODO: 处理 3档风速
break;
default:
break;
}
break;
/* ── DP5 条件使能 (bool) ── */
case DP_ID_COND_EN:
if (ctrl->cond_en)
{
gDevData.cond_en = 1;
// TODO: 开 — 执行动作
}
else
{
gDevData.cond_en = 0;
// TODO: 关 — 执行动作
}
break;
/* ── DP6 条件配置1 (raw) ── */
case DP_ID_COND_CONFIG1:
memcpy(gDevData.cond_config1, ctrl->cond_config1, 6);
// TODO: 根据 gDevData.cond_config1 执行动作 (长度 6 字节)
break;
/* ── DP7 条件配置2 (raw) ── */
case DP_ID_COND_CONFIG2:
memcpy(gDevData.cond_config2, ctrl->cond_config2, 6);
// TODO: 根据 gDevData.cond_config2 执行动作 (长度 6 字节)
break;
/* ── DP8 条件配置3 (raw) ── */
case DP_ID_COND_CONFIG3:
memcpy(gDevData.cond_config3, ctrl->cond_config3, 6);
// TODO: 根据 gDevData.cond_config3 执行动作 (长度 6 字节)
break;
/* ── DP9 条件配置4 (raw) ── */
case DP_ID_COND_CONFIG4:
memcpy(gDevData.cond_config4, ctrl->cond_config4, 6);
// TODO: 根据 gDevData.cond_config4 执行动作 (长度 6 字节)
break;
/* ── DP10 条件配置5 (raw) ── */
case DP_ID_COND_CONFIG5:
memcpy(gDevData.cond_config5, ctrl->cond_config5, 6);
// TODO: 根据 gDevData.cond_config5 执行动作 (长度 6 字节)
break;
/* ── DP11 条件配置6 (raw) ── */
case DP_ID_COND_CONFIG6:
memcpy(gDevData.cond_config6, ctrl->cond_config6, 6);
// TODO: 根据 gDevData.cond_config6 执行动作 (长度 6 字节)
break;
/* ── DP12 条件配置7 (raw) ── */
case DP_ID_COND_CONFIG7:
memcpy(gDevData.cond_config7, ctrl->cond_config7, 6);
// TODO: 根据 gDevData.cond_config7 执行动作 (长度 6 字节)
break;
/* ── DP13 定时使能 (bool) ── */
case DP_ID_TIME_EN:
if (ctrl->time_en)
{
gDevData.time_en = 1;
// TODO: 开 — 执行动作
}
else
{
gDevData.time_en = 0;
// TODO: 关 — 执行动作
}
break;
/* ── DP14 定时配置1 (raw) ── */
case DP_ID_TIME_CONFIG1:
memcpy(gDevData.time_config1, ctrl->time_config1, 8);
// TODO: 根据 gDevData.time_config1 执行动作 (长度 8 字节)
break;
/* ── DP15 定时配置2 (raw) ── */
case DP_ID_TIME_CONFIG2:
memcpy(gDevData.time_config2, ctrl->time_config2, 8);
// TODO: 根据 gDevData.time_config2 执行动作 (长度 8 字节)
break;
/* ── DP16 定时配置3 (raw) ── */
case DP_ID_TIME_CONFIG3:
memcpy(gDevData.time_config3, ctrl->time_config3, 8);
// TODO: 根据 gDevData.time_config3 执行动作 (长度 8 字节)
break;
/* ── DP17 定时配置4 (raw) ── */
case DP_ID_TIME_CONFIG4:
memcpy(gDevData.time_config4, ctrl->time_config4, 8);
// TODO: 根据 gDevData.time_config4 执行动作 (长度 8 字节)
break;
/* ── DP18 定时配置5 (raw) ── */
case DP_ID_TIME_CONFIG5:
memcpy(gDevData.time_config5, ctrl->time_config5, 8);
// TODO: 根据 gDevData.time_config5 执行动作 (长度 8 字节)
break;
/* ── DP19 定时配置6 (raw) ── */
case DP_ID_TIME_CONFIG6:
memcpy(gDevData.time_config6, ctrl->time_config6, 8);
// TODO: 根据 gDevData.time_config6 执行动作 (长度 8 字节)
break;
/* ── DP20 定时配置7 (raw) ── */
case DP_ID_TIME_CONFIG7:
memcpy(gDevData.time_config7, ctrl->time_config7, 8);
// TODO: 根据 gDevData.time_config7 执行动作 (长度 8 字节)
break;
/* ── DP21 设备故障使能 (uint8) ── */
case DP_ID_FAULT_EN:
gDevData.fault_en = ctrl->fault_en;
// TODO: 根据 ctrl->fault_en 执行动作
break;
/* ── DP23 设备告警使能 (uint8) ── */
case DP_ID_ALARM_EN:
gDevData.alarm_en = ctrl->alarm_en;
// TODO: 根据 ctrl->alarm_en 执行动作
break;
/* ── DP25 恢复出厂设置 (bool) ── */
case DP_ID_FACTORY_RESET:
if (ctrl->factory_reset)
{
gDevData.factory_reset = 1;
// TODO: 开 — 执行动作
}
else
{
gDevData.factory_reset = 0;
// TODO: 关 — 执行动作
}
break;
/* ── DP26 预留DP1 (uint32) ── */
case DP_ID_RESERVA_DP1:
gDevData.reserva_dp1 = ctrl->reserva_dp1;
// TODO: 根据 ctrl->reserva_dp1 执行动作
break;
/* ── DP27 预留DP2 (uint32) ── */
case DP_ID_RESERVA_DP2:
gDevData.reserva_dp2 = ctrl->reserva_dp2;
// TODO: 根据 ctrl->reserva_dp2 执行动作
break;
/* ── DP28 预留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;
}
+55
View File
@@ -0,0 +1,55 @@
/* ================================================================
* jb_product.h — 用户层头文件(自动生成)
* 设备: 温湿度风扇 | 生成时间: 2026-08-29 10:31:50
*
* 声明用户需实现的函数。数据结构定义见 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
+320
View File
@@ -0,0 +1,320 @@
/* ================================================================
* jb_protocol.h — 见宝 IOT 协议层(自动生成)
* 设备: 温湿度风扇 | DP 数: 29 | Bitmap: 4B
* 协议版本: V1.0 | 生成时间: 2026-08-29 10:31:50
*
* 帧格式: [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 bitbit 序号 = DP ID0 起始)
* 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 29
#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 "CBR3"
#define JB_PRODUCT_CODE "PRCBR3"
#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_MODE = 1, /* 模式 (enum, RW) */
DP_ID_FAN_GEAR = 2, /* 风速挡位 (enum, RW) */
DP_ID_CURRENT_TEMP = 3, /* 当前温度 (float, RO) */
DP_ID_CURRENT_HUMI = 4, /* 当前湿度 (uint8, RO) */
DP_ID_COND_EN = 5, /* 条件使能 (bool, RW) */
DP_ID_COND_CONFIG1 = 6, /* 条件配置1 (raw, RW) */
DP_ID_COND_CONFIG2 = 7, /* 条件配置2 (raw, RW) */
DP_ID_COND_CONFIG3 = 8, /* 条件配置3 (raw, RW) */
DP_ID_COND_CONFIG4 = 9, /* 条件配置4 (raw, RW) */
DP_ID_COND_CONFIG5 = 10, /* 条件配置5 (raw, RW) */
DP_ID_COND_CONFIG6 = 11, /* 条件配置6 (raw, RW) */
DP_ID_COND_CONFIG7 = 12, /* 条件配置7 (raw, RW) */
DP_ID_TIME_EN = 13, /* 定时使能 (bool, RW) */
DP_ID_TIME_CONFIG1 = 14, /* 定时配置1 (raw, RW) */
DP_ID_TIME_CONFIG2 = 15, /* 定时配置2 (raw, RW) */
DP_ID_TIME_CONFIG3 = 16, /* 定时配置3 (raw, RW) */
DP_ID_TIME_CONFIG4 = 17, /* 定时配置4 (raw, RW) */
DP_ID_TIME_CONFIG5 = 18, /* 定时配置5 (raw, RW) */
DP_ID_TIME_CONFIG6 = 19, /* 定时配置6 (raw, RW) */
DP_ID_TIME_CONFIG7 = 20, /* 定时配置7 (raw, RW) */
DP_ID_FAULT_EN = 21, /* 设备故障使能 (uint8, RW) */
DP_ID_FAULT_CODE = 22, /* 设备故障 (uint8, RO) */
DP_ID_ALARM_EN = 23, /* 设备告警使能 (uint8, RW) */
DP_ID_ALARM_CODE = 24, /* 设备告警 (uint8, RO) */
DP_ID_FACTORY_RESET = 25, /* 恢复出厂设置 (bool, WO) */
DP_ID_RESERVA_DP1 = 26, /* 预留DP1 (uint32, RW) */
DP_ID_RESERVA_DP2 = 27, /* 预留DP2 (uint32, RW) */
DP_ID_RESERVA_DP3 = 28, /* 预留DP3 (uint32, RW) */
DP_ID_MAX
} dp_id_t;
/* DP 数据长度(字节) */
#define DP_LEN_POWER 1
#define DP_LEN_MODE 1
#define DP_LEN_FAN_GEAR 1
#define DP_LEN_CURRENT_TEMP 2
#define DP_LEN_CURRENT_HUMI 1
#define DP_LEN_COND_EN 1
#define DP_LEN_COND_CONFIG1 6
#define DP_LEN_COND_CONFIG2 6
#define DP_LEN_COND_CONFIG3 6
#define DP_LEN_COND_CONFIG4 6
#define DP_LEN_COND_CONFIG5 6
#define DP_LEN_COND_CONFIG6 6
#define DP_LEN_COND_CONFIG7 6
#define DP_LEN_TIME_EN 1
#define DP_LEN_TIME_CONFIG1 8
#define DP_LEN_TIME_CONFIG2 8
#define DP_LEN_TIME_CONFIG3 8
#define DP_LEN_TIME_CONFIG4 8
#define DP_LEN_TIME_CONFIG5 8
#define DP_LEN_TIME_CONFIG6 8
#define DP_LEN_TIME_CONFIG7 8
#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;
/* 风速挡位 */
typedef enum
{
FAN_GEAR_0 = 0, /* 关闭风扇 */
FAN_GEAR_1 = 1, /* 1档风速 */
FAN_GEAR_2 = 2, /* 2档风速 */
FAN_GEAR_3 = 3, /* 3档风速 */
} FAN_GEAR_t;
/* ════════════════════════════════════════════════════════════════
* 数据结构
* ════════════════════════════════════════════════════════════════ */
/* 数据点 — 所有 DP 的当前值 */
typedef struct
{
uint8_t power; /* DP0 开关 */
uint8_t mode; /* DP1 模式 */
uint8_t fan_gear; /* DP2 风速挡位 */
float current_temp; /* DP3 当前温度 (float, scale=0.1) */
uint8_t current_humi; /* DP4 当前湿度 */
uint8_t cond_en; /* DP5 条件使能 */
uint8_t cond_config1[6];/* DP6 条件配置1 */
uint8_t cond_config2[6];/* DP7 条件配置2 */
uint8_t cond_config3[6];/* DP8 条件配置3 */
uint8_t cond_config4[6];/* DP9 条件配置4 */
uint8_t cond_config5[6];/* DP10 条件配置5 */
uint8_t cond_config6[6];/* DP11 条件配置6 */
uint8_t cond_config7[6];/* DP12 条件配置7 */
uint8_t time_en; /* DP13 定时使能 */
uint8_t time_config1[8];/* DP14 定时配置1 */
uint8_t time_config2[8];/* DP15 定时配置2 */
uint8_t time_config3[8];/* DP16 定时配置3 */
uint8_t time_config4[8];/* DP17 定时配置4 */
uint8_t time_config5[8];/* DP18 定时配置5 */
uint8_t time_config6[8];/* DP19 定时配置6 */
uint8_t time_config7[8];/* DP20 定时配置7 */
uint8_t fault_en; /* DP21 设备故障使能 */
uint8_t fault_code; /* DP22 设备故障 */
uint8_t alarm_en; /* DP23 设备告警使能 */
uint8_t alarm_code; /* DP24 设备告警 */
uint8_t factory_reset;/* DP25 恢复出厂设置 */
uint32_t reserva_dp1; /* DP26 预留DP1 */
uint32_t reserva_dp2; /* DP27 预留DP2 */
uint32_t reserva_dp3; /* DP28 预留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 */