尧图网站建设 
EMQX GBT32960 网关正式支持 GBT32960-2025 协议版本自动识别、新信息类型与激活命令深度解析【免费下载链接】emqxThe most scalable and reliable MQTT broker for AI, IoT, IIoT and connected vehicles项目地址: https://gitcode.com/gh_mirrors/em/emqxGBT32960 是面向新能源汽车的国家标准数据交换协议国内车联网平台接入时普遍需要同时面对 2016 版与 2025 版终端设备。EMQX 的 GBT32960 网关在本仓库变更 changes/ee/feat-17013.en.md 中正式加入了GBT32960-2025 协议支持网关可以通过帧头自动识别协议版本并针对两个版本分别完成解析与序列化。阅读本文后你将掌握 EMQX GBT32960 网关的版本探测原理、2025 版新增信息类型的字段级定义、激活命令0x09/0x0A的处理流程、版本感知的参数编解码差异以及相应的配置与测试验证方法。1. 为什么需要 GBT32960-2025 支持GBT32960 网关应用位于 apps/emqx_gateway_gbt32960基于 GBT32960 规范实现负责将车载终端上报的二进制帧接入 EMQX并转换为 JSON 载荷发布到 MQTT 主题。随着标准演进2025 版协议在信息类型、命令集和字段宽度上都有调整若网关只能解析 2016 版帧混合部署场景下会出现解析失败或数据错乱。本次变更的关键设计是在解析器中引入协议版本状态解析器的初始状态emqx_gbt32960_frame.erl默认proto_ver 2016帧记录emqx_gbt32960.hrl增加proto_ver字段取值为2016或2025解析出的每条消息都会携带proto_ver后续所有字段解析与序列化都依据该版本分支进行。2. 协议版本自动检测##与$$帧头2025 版协议最直观的差异在帧起始标识。网关在search_heading/1中逐字节扫描帧头emqx_gbt32960_frame.erlsearch_heading(16#23, 16#23, Rest/binary) - {ok, Rest, ?PROTO_VER_2016}; search_heading(16#24, 16#24, Rest/binary) - {ok, Rest, ?PROTO_VER_2025}; search_heading(_, Rest/binary) - search_heading(Rest); search_heading() - {error, invalid_frame}.其中16#23即字符#16#24即字符$。因此帧头协议版本说明##GBT32960-2016旧版终端设备$$GBT32960-2025新版终端设备同一 TCP 连接上可以同时接收两种版本的数据流——由于版本信息保存在解析器状态中粘包/半包情况下也会保留当前帧的版本继续解析{more, State#{phase parse, proto_ver Version}}解析完成后再重置回默认版本。序列化方向同样按版本选择帧头emqx_gbt32960_frame.erl下行应答会携带与上行帧一致的帧头。3. 帧结构与校验不变的基础除帧头与版本分支外帧的总体结构两个版本保持一致起始标识(2B) 命令字(1B) 应答标志(1B) VIN(17B) 加密方式(1B) 数据长度(2B, WORD) 数据单元 校验码(1B)头部固定 22 字节?HEADER_SIZE见 emqx_gbt32960_frame.erl。校验码通过逐字节异或bxor累加计算cal_check/3解析时校验失败返回frame_check_error。加密方式字段定义在 emqx_gbt32960.hrl取值含义0x01不加密ENCRYPT_NONE0x02RSA0x03AES1280x04SM20x05SM40xFE/0xFF异常 / 无效当前仓库中decipher/2与encipher/2仍是透传占位实现TODO 状态实际加密业务需在应用层另行处理。4. GBT32960-2025 新增信息类型详解2025 版在实时信息上报0x02与补发信息上报0x03中新增了多类信息单元。信息类型编号定义在 emqx_gbt32960.hrl解析逻辑位于 emqx_gbt32960_frame.erl。4.1 信息类型编号对照类型2016 编号2025 编号备注Vehicle整车数据0x010x012025 版字段缩减DriveMotor驱动电机0x020x02单电机长度 12B → 10BFuelCell燃料电池0x030x032025 版固定 12BEngine发动机0x040x042025 版字段缩减Location定位0x050x052025 版新增坐标系Extreme极值0x06—2016 专用Alarm报警0x070x062025 版编号前移并扩展ChargeableBatVoltage0x08—2016 专用ChargeableBatTemp0x09—2016 专用PowerBatteryVoltage—0x072025 新增PowerBatteryTemp—0x082025 新增FuelCellStack—0x302025 新增SuperCapacitor—0x312025 新增SuperCapacitorExtreme—0x322025 新增Signature数字签名—0xFF2025 新增4.2 字段级差异Vehicle整车数据2016 版为 20 字节包含油门踏板AcceleratorPedal与制动踏板BrakePedal2025 版缩减为 18 字节移除了这两个字段emqx_gbt32960_frame.erl。共同字段为车辆状态、充电状态、运行模式、车速(WORD)、累计里程(DWORD)、总电压(WORD)、总电流(WORD)、SOC(BYTE)、DC-DC 状态(BYTE)、档位(BYTE)、绝缘电阻(WORD)。DriveMotor驱动电机2016 版每个电机 12 字节含输入电压与直流母线电流2025 版每个电机 10 字节转矩字段由 WORD 扩为 DWORD去掉了输入电压与母线电流emqx_gbt32960_frame.erl。FuelCell燃料电池2016 版长度可变先给探测点数量再跟随探测温度序列并含单体电压、电流、燃料消耗率2025 版固定 12 字节新增剩余氢气量RemainingH2与 DCDC 温度DCDCTempemqx_gbt32960_frame.erl。Engine发动机2016 版含发动机状态与燃料消耗率2025 版仅保留曲轴转速CrankshaftSpeed。Location定位2025 版在定位状态后新增 1 字节坐标系字段CoordinateSystem后续才是经度、纬度各 DWORD。Alarm报警2025 版新增“通用报警”列表FaultGeneralNum / FaultGeneralList每一项由报警代号(BYTE)与报警等级(BYTE)组成tune_fault_level/1同时 2025 版故障码输出为 8 位十六进制、2016 版为 4 位十六进制tune_fault_codelist/2emqx_gbt32960_frame.erl。PowerBatteryVoltage / PowerBatteryTemp动力蓄电池电压/温度2025 版新增按电池包组织电压单元含电池包序号、包电压、包电流、最小并联单体总数及逐单体电压WORD 序列温度单元含电池包序号、探测点数量及逐点温度。FuelCellStack燃料电池堆2025 版新增含堆序号、电压、电流、氢气入口压力、空气入口压力、空气入口温度、探测点数量及逐点温度。SuperCapacitor / SuperCapacitorExtreme超级电容2025 版新增。SuperCapacitor 含管理子系统号、总电压、总电流、单体总数、逐单体电压与探测温度SuperCapacitorExtreme 给出最高/最低单体电压与温度及其所属管理子系统号、单体编号CellCode 在 2025 版为 WORD。Signature数字签名2025 版新增0xFF结构为签名类型(BYTE) R 值长度(WORD) R 值 S 值长度(WORD) S 值R/S 值以十六进制字符串输出parse_signature/1emqx_gbt32960_frame.erl。注意帧内未识别或非标准的信息类型不会被丢弃而是包装为CustomData类型将剩余数据做 Base64 编码后输出emqx_gbt32960_frame.erl保证自定义扩展数据不丢失。5. 新增命令激活0x09 / 0x0A2025 版协议新增了终端激活流程命令定义于 emqx_gbt32960.hrl命令十六进制方向说明CMD_ACTIVATION0x09终端 → 平台激活请求CMD_ACTIVATION_RES0x0A平台 → 终端激活应答激活请求的解析emqx_gbt32960_frame.erl包含时间戳年/月/日/时/分/秒、芯片 ID16 字节、公钥长度WORD、公钥十六进制字符串、VIN17 字节以及末尾的数字签名复用parse_signature/1格式。应答方向0x0A由下行消息触发序列化serialize_data/5中?CMD_ACTIVATION_RES分支emqx_gbt32960_frame.erl载荷仅两个字节激活状态ActivationStatus, BYTE与信息Info, BYTE。在通道层handle_in对 0x09 激活帧会先走upstreaming/2将帧转为 JSON 上报见第 7 节随后返回{ok, Channel}等待应用侧下发激活应答。源码注释表明激活流程的证书校验与完整业务闭环TODO: implement activation flow with proper certificate validation仍待实现接入方需要结合自身的证书体系完成端到端验证。6. 版本感知的参数查询与设置0x02/0x03参数查询0x80与参数设置0x81在 2016 与 2025 版本之间存在参数取值宽度差异这是最容易导致对接出错的地方参数标识2016 版2025 版0x02WORD2 字节BYTE1 字节0x03WORD2 字节BYTE1 字节解析侧parse_params_/3按版本选择模式匹配分支emqx_gbt32960_frame.erl序列化侧tune_params_/3同样按版本输出对应宽度emqx_gbt32960_frame.erl。其余参数标识0x01、0x04~0x10两个版本宽度一致其中 0x05软件版本长度跟随其前导的 0x040x0E 长度跟随 0x0D解析器会校验这种“前置标识”约束缺失时记录错误日志并提前结束。下行构造参数查询/设置帧时JSON 载荷中参数键使用0x01形式的十六进制字符串通道层通过hexstring_to_byte/1转为字节标识emqx_gbt32960_channel.erl。7. 2025 车辆登入BMS 电池包编码字段2016 版车辆登入0x01数据为时间戳、登入流水号Seq, WORD、ICCID20 字节、可充电储能子系统数Num, BYTE、编码长度Length, BYTE及编码数据Id。2025 版车辆登入结构变化显著emqx_gbt32960_frame.erl去掉编码长度字段新增BMS 电池管理系统数量BmsNum, BYTE其后跟随两部分编码数据BatteryPackCounts每个 BMS 对应的电池包数量列表BatteryPackEncodings逐 BMS、逐电池包的编码字段每个电池包编码固定 24 字节?BAT_PACK_CODE_LENemqx_gbt32960_frame.erl。解析器会按BmsNum严格消费字节流parse_bat_packs/2parse_bat_encodings/2若编码数据不足或多余将记录invalid_bat_pack_encoding错误并终止解析避免错位。测试用例 emqx_gbt32960_parser_SUITE.erl 验证了 2025 登入帧可正确解析出BatteryPackEncodings如[[PACK12345678901234567890]]。无论哪个版本车辆登入后 VIN 都会被用作客户端标识maybe_assign_clientid/2将clientid与username均设置为 VINemqx_gbt32960_channel.erl后续订阅、发布授权与认证都围绕 VIN 展开。8. 数据接入上行主题映射与 JSON 载荷通道层将每个帧转换为 MQTT 消息发布upstreaming/2transform/1emqx_gbt32960_channel.erl主题规则为mountpoint 命令后缀命令主题后缀车辆登入 0x01upstream/vlogin实时信息上报 0x02upstream/info补发信息上报 0x03upstream/reinfo车辆登出 0x04upstream/vlogout平台登入 0x05upstream/plogin平台登出 0x06upstream/plogout激活 0x09upstream/activation参数查询/设置/终端控制应答 0x80/0x81/0x82upstream/response其他命令upstream/transparent载荷为统一 JSON 结构{Cmd, Vin, Encrypt, Data}to_json/1其中Data即第 4、5、6 节解析出的各字段 map如Infos列表。2025 版的proto_ver同时体现在连接信息enrich_conninfo/2中proto_ver ProtoVer与帧序列化帧头中业务侧可据此区分数据版本。下行方向网关在登入成功后自动订阅默认下行主题dnstream?DEFAULT_DOWNLINK_TOPICemqx_gbt32960.hrl应用向该主题发布 JSON 消息即可驱动参数查询/设置、终端控制等下行帧消息经msgs2frame/3转换为帧后进入 inflight 队列并按retry_interval重发直至max_retry_times用尽emqx_gbt32960_channel.erl。队列达到message_queue_len上限时新的下行消息将被丢弃并计入delivery.dropped指标。9. 网关配置与启用GBT32960 网关的配置 schema 位于 emqx_gbt32960_schema.erl可通过 Dashboard、HTTP API 或 emqx.conf 启用。示例配置README.mdgateway.gbt32960 { mountpoint gbt32960/${clientid} listeners.tcp.default { bind 7325 } }关键配置项配置项默认值说明mountpointgbt32960/${clientid}/上行主题挂载前缀${clientid}运行时替换为 VINretry_interval8s下行帧重发间隔duration_msmax_retry_times3下行帧最大重发次数message_queue_len10下行消息队列长度上限listeners.tcp.*—TCP 监听器配置默认端口 7325注意通过 emqx.conf 配置网关需要逐节点生效通过 Dashboard 或 HTTP API 配置则集群内统一生效。网关模块通过-gateway(#{}...)声明式注册emqx_gateway_gbt32960.erl并在加载/更新/卸载回调中分别启动、热更新、停止监听器。10. 测试验证2025 协议覆盖仓库测试对 2025 支持做了系统化覆盖可直接作为协议实现的行为基准emqx_gbt32960_parser_SUITE.erl包含case_2025_login、case_2025_report_vehicle、case_2025_report_drive_motor、case_2025_report_fuel_cell、case_2025_report_engine、case_2025_report_location、case_2025_report_alarm、case_2025_report_power_battery_voltage、case_2025_report_power_battery_temp、case_2025_report_fuel_cell_stack、case_2025_report_super_capacitor、case_2025_report_super_capacitor_extreme、case_2025_report_signature、case_2025_activation、case_2025_serialize_activation_res、case_2025_key_exchange、case_2025_serialize_key_exchange、case_2025_param_query_byte_params、case_2025_serialize_setting等 19 个用例覆盖全部新信息类型、激活/密钥交换序列化以及 2025 参数 BYTE 宽度emqx_gbt32960_SUITE.erl通道级测试如t_case22_login_2025$$帧头登入并校验BatteryPackEncodings、t_case23_reportinfo_2025_0x012025 整车 18 字节、t_case24_reportinfo_2025_0x072025 动力电池电压、t_case25_param_query_20250x02/0x03 按 BYTE 解析与应答其中测试编码器encode_2025/5使用$$起始标识。这些用例同时验证了同一通道内两种协议版本共存的能力——2016 与 2025 帧可被同一解析器正确分派为存量终端与新增终端的平滑过渡提供了保障。11. 总结通过 changes/ee/feat-17013.en.md 引入的变更EMQX GBT32960 网关形成了完整的双版本协议栈自动识别##/$$帧头 解析器proto_ver状态机一条连接可混跑 2016/2025 终端全量新类型Vehicle、DriveMotor、FuelCell、Engine、Location、Alarm 的 2025 版定义加上 PowerBatteryVoltage/Temp、FuelCellStack、SuperCapacitor、SuperCapacitorExtreme、Signature 五个全新信息类型新命令集激活 0x09/0x0A 与密钥交换 0x0B 的解析与序列化版本感知编码参数查询/设置中 0x02/0x03 由 WORD 收窄为 BYTE避免跨版本误读登入扩展2025 车辆登入新增 BMS 电池包数量与 24 字节电池包编码字段。接入方在迁移到 2025 协议时应重点核对第 4、5、6 节列出的字段宽度与编号差异并结合第 10 节的测试用例做对拍验证激活与加密链路当前在仓库中仍有 TODO 占位生产落地前需要由业务侧补齐证书校验与加解密实现。【免费下载链接】emqxThe most scalable and reliable MQTT broker for AI, IoT, IIoT and connected vehicles项目地址: https://gitcode.com/gh_mirrors/em/emqx创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 EMQX GBT32960 网关正式支持 GBT32960-2025 协议：版本自动识别、新信息类型与激活命令深度解析
EMQX GBT32960 网关正式支持 GBT32960-2025 协议版本自动识别、新信息类型与激活命令深度解析【免费下载链接】emqxThe most scalable and reliable MQTT broker for AI, IoT, IIoT and connected vehicles项目地址: https://gitcode.com/gh_mirrors/em/emqxGBT32960 是面向新能源汽车的国家标准数据交换协议国内车联网平台接入时普遍需要同时面对 2016 版与 2025 版终端设备。EMQX 的 GBT32960 网关在本仓库变更 changes/ee/feat-17013.en.md 中正式加入了GBT32960-2025 协议支持网关可以通过帧头自动识别协议版本并针对两个版本分别完成解析与序列化。阅读本文后你将掌握 EMQX GBT32960 网关的版本探测原理、2025 版新增信息类型的字段级定义、激活命令0x09/0x0A的处理流程、版本感知的参数编解码差异以及相应的配置与测试验证方法。1. 为什么需要 GBT32960-2025 支持GBT32960 网关应用位于 apps/emqx_gateway_gbt32960基于 GBT32960 规范实现负责将车载终端上报的二进制帧接入 EMQX并转换为 JSON 载荷发布到 MQTT 主题。随着标准演进2025 版协议在信息类型、命令集和字段宽度上都有调整若网关只能解析 2016 版帧混合部署场景下会出现解析失败或数据错乱。本次变更的关键设计是在解析器中引入协议版本状态解析器的初始状态emqx_gbt32960_frame.erl默认proto_ver 2016帧记录emqx_gbt32960.hrl增加proto_ver字段取值为2016或2025解析出的每条消息都会携带proto_ver后续所有字段解析与序列化都依据该版本分支进行。2. 协议版本自动检测##与$$帧头2025 版协议最直观的差异在帧起始标识。网关在search_heading/1中逐字节扫描帧头emqx_gbt32960_frame.erlsearch_heading(16#23, 16#23, Rest/binary) - {ok, Rest, ?PROTO_VER_2016}; search_heading(16#24, 16#24, Rest/binary) - {ok, Rest, ?PROTO_VER_2025}; search_heading(_, Rest/binary) - search_heading(Rest); search_heading() - {error, invalid_frame}.其中16#23即字符#16#24即字符$。因此帧头协议版本说明##GBT32960-2016旧版终端设备$$GBT32960-2025新版终端设备同一 TCP 连接上可以同时接收两种版本的数据流——由于版本信息保存在解析器状态中粘包/半包情况下也会保留当前帧的版本继续解析{more, State#{phase parse, proto_ver Version}}解析完成后再重置回默认版本。序列化方向同样按版本选择帧头emqx_gbt32960_frame.erl下行应答会携带与上行帧一致的帧头。3. 帧结构与校验不变的基础除帧头与版本分支外帧的总体结构两个版本保持一致起始标识(2B) 命令字(1B) 应答标志(1B) VIN(17B) 加密方式(1B) 数据长度(2B, WORD) 数据单元 校验码(1B)头部固定 22 字节?HEADER_SIZE见 emqx_gbt32960_frame.erl。校验码通过逐字节异或bxor累加计算cal_check/3解析时校验失败返回frame_check_error。加密方式字段定义在 emqx_gbt32960.hrl取值含义0x01不加密ENCRYPT_NONE0x02RSA0x03AES1280x04SM20x05SM40xFE/0xFF异常 / 无效当前仓库中decipher/2与encipher/2仍是透传占位实现TODO 状态实际加密业务需在应用层另行处理。4. GBT32960-2025 新增信息类型详解2025 版在实时信息上报0x02与补发信息上报0x03中新增了多类信息单元。信息类型编号定义在 emqx_gbt32960.hrl解析逻辑位于 emqx_gbt32960_frame.erl。4.1 信息类型编号对照类型2016 编号2025 编号备注Vehicle整车数据0x010x012025 版字段缩减DriveMotor驱动电机0x020x02单电机长度 12B → 10BFuelCell燃料电池0x030x032025 版固定 12BEngine发动机0x040x042025 版字段缩减Location定位0x050x052025 版新增坐标系Extreme极值0x06—2016 专用Alarm报警0x070x062025 版编号前移并扩展ChargeableBatVoltage0x08—2016 专用ChargeableBatTemp0x09—2016 专用PowerBatteryVoltage—0x072025 新增PowerBatteryTemp—0x082025 新增FuelCellStack—0x302025 新增SuperCapacitor—0x312025 新增SuperCapacitorExtreme—0x322025 新增Signature数字签名—0xFF2025 新增4.2 字段级差异Vehicle整车数据2016 版为 20 字节包含油门踏板AcceleratorPedal与制动踏板BrakePedal2025 版缩减为 18 字节移除了这两个字段emqx_gbt32960_frame.erl。共同字段为车辆状态、充电状态、运行模式、车速(WORD)、累计里程(DWORD)、总电压(WORD)、总电流(WORD)、SOC(BYTE)、DC-DC 状态(BYTE)、档位(BYTE)、绝缘电阻(WORD)。DriveMotor驱动电机2016 版每个电机 12 字节含输入电压与直流母线电流2025 版每个电机 10 字节转矩字段由 WORD 扩为 DWORD去掉了输入电压与母线电流emqx_gbt32960_frame.erl。FuelCell燃料电池2016 版长度可变先给探测点数量再跟随探测温度序列并含单体电压、电流、燃料消耗率2025 版固定 12 字节新增剩余氢气量RemainingH2与 DCDC 温度DCDCTempemqx_gbt32960_frame.erl。Engine发动机2016 版含发动机状态与燃料消耗率2025 版仅保留曲轴转速CrankshaftSpeed。Location定位2025 版在定位状态后新增 1 字节坐标系字段CoordinateSystem后续才是经度、纬度各 DWORD。Alarm报警2025 版新增“通用报警”列表FaultGeneralNum / FaultGeneralList每一项由报警代号(BYTE)与报警等级(BYTE)组成tune_fault_level/1同时 2025 版故障码输出为 8 位十六进制、2016 版为 4 位十六进制tune_fault_codelist/2emqx_gbt32960_frame.erl。PowerBatteryVoltage / PowerBatteryTemp动力蓄电池电压/温度2025 版新增按电池包组织电压单元含电池包序号、包电压、包电流、最小并联单体总数及逐单体电压WORD 序列温度单元含电池包序号、探测点数量及逐点温度。FuelCellStack燃料电池堆2025 版新增含堆序号、电压、电流、氢气入口压力、空气入口压力、空气入口温度、探测点数量及逐点温度。SuperCapacitor / SuperCapacitorExtreme超级电容2025 版新增。SuperCapacitor 含管理子系统号、总电压、总电流、单体总数、逐单体电压与探测温度SuperCapacitorExtreme 给出最高/最低单体电压与温度及其所属管理子系统号、单体编号CellCode 在 2025 版为 WORD。Signature数字签名2025 版新增0xFF结构为签名类型(BYTE) R 值长度(WORD) R 值 S 值长度(WORD) S 值R/S 值以十六进制字符串输出parse_signature/1emqx_gbt32960_frame.erl。注意帧内未识别或非标准的信息类型不会被丢弃而是包装为CustomData类型将剩余数据做 Base64 编码后输出emqx_gbt32960_frame.erl保证自定义扩展数据不丢失。5. 新增命令激活0x09 / 0x0A2025 版协议新增了终端激活流程命令定义于 emqx_gbt32960.hrl命令十六进制方向说明CMD_ACTIVATION0x09终端 → 平台激活请求CMD_ACTIVATION_RES0x0A平台 → 终端激活应答激活请求的解析emqx_gbt32960_frame.erl包含时间戳年/月/日/时/分/秒、芯片 ID16 字节、公钥长度WORD、公钥十六进制字符串、VIN17 字节以及末尾的数字签名复用parse_signature/1格式。应答方向0x0A由下行消息触发序列化serialize_data/5中?CMD_ACTIVATION_RES分支emqx_gbt32960_frame.erl载荷仅两个字节激活状态ActivationStatus, BYTE与信息Info, BYTE。在通道层handle_in对 0x09 激活帧会先走upstreaming/2将帧转为 JSON 上报见第 7 节随后返回{ok, Channel}等待应用侧下发激活应答。源码注释表明激活流程的证书校验与完整业务闭环TODO: implement activation flow with proper certificate validation仍待实现接入方需要结合自身的证书体系完成端到端验证。6. 版本感知的参数查询与设置0x02/0x03参数查询0x80与参数设置0x81在 2016 与 2025 版本之间存在参数取值宽度差异这是最容易导致对接出错的地方参数标识2016 版2025 版0x02WORD2 字节BYTE1 字节0x03WORD2 字节BYTE1 字节解析侧parse_params_/3按版本选择模式匹配分支emqx_gbt32960_frame.erl序列化侧tune_params_/3同样按版本输出对应宽度emqx_gbt32960_frame.erl。其余参数标识0x01、0x04~0x10两个版本宽度一致其中 0x05软件版本长度跟随其前导的 0x040x0E 长度跟随 0x0D解析器会校验这种“前置标识”约束缺失时记录错误日志并提前结束。下行构造参数查询/设置帧时JSON 载荷中参数键使用0x01形式的十六进制字符串通道层通过hexstring_to_byte/1转为字节标识emqx_gbt32960_channel.erl。7. 2025 车辆登入BMS 电池包编码字段2016 版车辆登入0x01数据为时间戳、登入流水号Seq, WORD、ICCID20 字节、可充电储能子系统数Num, BYTE、编码长度Length, BYTE及编码数据Id。2025 版车辆登入结构变化显著emqx_gbt32960_frame.erl去掉编码长度字段新增BMS 电池管理系统数量BmsNum, BYTE其后跟随两部分编码数据BatteryPackCounts每个 BMS 对应的电池包数量列表BatteryPackEncodings逐 BMS、逐电池包的编码字段每个电池包编码固定 24 字节?BAT_PACK_CODE_LENemqx_gbt32960_frame.erl。解析器会按BmsNum严格消费字节流parse_bat_packs/2parse_bat_encodings/2若编码数据不足或多余将记录invalid_bat_pack_encoding错误并终止解析避免错位。测试用例 emqx_gbt32960_parser_SUITE.erl 验证了 2025 登入帧可正确解析出BatteryPackEncodings如[[PACK12345678901234567890]]。无论哪个版本车辆登入后 VIN 都会被用作客户端标识maybe_assign_clientid/2将clientid与username均设置为 VINemqx_gbt32960_channel.erl后续订阅、发布授权与认证都围绕 VIN 展开。8. 数据接入上行主题映射与 JSON 载荷通道层将每个帧转换为 MQTT 消息发布upstreaming/2transform/1emqx_gbt32960_channel.erl主题规则为mountpoint 命令后缀命令主题后缀车辆登入 0x01upstream/vlogin实时信息上报 0x02upstream/info补发信息上报 0x03upstream/reinfo车辆登出 0x04upstream/vlogout平台登入 0x05upstream/plogin平台登出 0x06upstream/plogout激活 0x09upstream/activation参数查询/设置/终端控制应答 0x80/0x81/0x82upstream/response其他命令upstream/transparent载荷为统一 JSON 结构{Cmd, Vin, Encrypt, Data}to_json/1其中Data即第 4、5、6 节解析出的各字段 map如Infos列表。2025 版的proto_ver同时体现在连接信息enrich_conninfo/2中proto_ver ProtoVer与帧序列化帧头中业务侧可据此区分数据版本。下行方向网关在登入成功后自动订阅默认下行主题dnstream?DEFAULT_DOWNLINK_TOPICemqx_gbt32960.hrl应用向该主题发布 JSON 消息即可驱动参数查询/设置、终端控制等下行帧消息经msgs2frame/3转换为帧后进入 inflight 队列并按retry_interval重发直至max_retry_times用尽emqx_gbt32960_channel.erl。队列达到message_queue_len上限时新的下行消息将被丢弃并计入delivery.dropped指标。9. 网关配置与启用GBT32960 网关的配置 schema 位于 emqx_gbt32960_schema.erl可通过 Dashboard、HTTP API 或 emqx.conf 启用。示例配置README.mdgateway.gbt32960 { mountpoint gbt32960/${clientid} listeners.tcp.default { bind 7325 } }关键配置项配置项默认值说明mountpointgbt32960/${clientid}/上行主题挂载前缀${clientid}运行时替换为 VINretry_interval8s下行帧重发间隔duration_msmax_retry_times3下行帧最大重发次数message_queue_len10下行消息队列长度上限listeners.tcp.*—TCP 监听器配置默认端口 7325注意通过 emqx.conf 配置网关需要逐节点生效通过 Dashboard 或 HTTP API 配置则集群内统一生效。网关模块通过-gateway(#{}...)声明式注册emqx_gateway_gbt32960.erl并在加载/更新/卸载回调中分别启动、热更新、停止监听器。10. 测试验证2025 协议覆盖仓库测试对 2025 支持做了系统化覆盖可直接作为协议实现的行为基准emqx_gbt32960_parser_SUITE.erl包含case_2025_login、case_2025_report_vehicle、case_2025_report_drive_motor、case_2025_report_fuel_cell、case_2025_report_engine、case_2025_report_location、case_2025_report_alarm、case_2025_report_power_battery_voltage、case_2025_report_power_battery_temp、case_2025_report_fuel_cell_stack、case_2025_report_super_capacitor、case_2025_report_super_capacitor_extreme、case_2025_report_signature、case_2025_activation、case_2025_serialize_activation_res、case_2025_key_exchange、case_2025_serialize_key_exchange、case_2025_param_query_byte_params、case_2025_serialize_setting等 19 个用例覆盖全部新信息类型、激活/密钥交换序列化以及 2025 参数 BYTE 宽度emqx_gbt32960_SUITE.erl通道级测试如t_case22_login_2025$$帧头登入并校验BatteryPackEncodings、t_case23_reportinfo_2025_0x012025 整车 18 字节、t_case24_reportinfo_2025_0x072025 动力电池电压、t_case25_param_query_20250x02/0x03 按 BYTE 解析与应答其中测试编码器encode_2025/5使用$$起始标识。这些用例同时验证了同一通道内两种协议版本共存的能力——2016 与 2025 帧可被同一解析器正确分派为存量终端与新增终端的平滑过渡提供了保障。11. 总结通过 changes/ee/feat-17013.en.md 引入的变更EMQX GBT32960 网关形成了完整的双版本协议栈自动识别##/$$帧头 解析器proto_ver状态机一条连接可混跑 2016/2025 终端全量新类型Vehicle、DriveMotor、FuelCell、Engine、Location、Alarm 的 2025 版定义加上 PowerBatteryVoltage/Temp、FuelCellStack、SuperCapacitor、SuperCapacitorExtreme、Signature 五个全新信息类型新命令集激活 0x09/0x0A 与密钥交换 0x0B 的解析与序列化版本感知编码参数查询/设置中 0x02/0x03 由 WORD 收窄为 BYTE避免跨版本误读登入扩展2025 车辆登入新增 BMS 电池包数量与 24 字节电池包编码字段。接入方在迁移到 2025 协议时应重点核对第 4、5、6 节列出的字段宽度与编号差异并结合第 10 节的测试用例做对拍验证激活与加密链路当前在仓库中仍有 TODO 占位生产落地前需要由业务侧补齐证书校验与加解密实现。【免费下载链接】emqxThe most scalable and reliable MQTT broker for AI, IoT, IIoT and connected vehicles项目地址: https://gitcode.com/gh_mirrors/em/emqx创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考