news 2026/8/21 17:13:18

互联互通不再是难题:HUIZHI-ChargeOS-cloud中电联T/CEC 102协议对接实战指南

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
互联互通不再是难题:HUIZHI-ChargeOS-cloud中电联T/CEC 102协议对接实战指南

互联互通不再是难题:HUIZHI-ChargeOS-cloud中电联T/CEC 102协议对接实战指南

【免费下载链接】HUIZHI-ChargeOS-cloud⚡️慧知开源充电平台全套源码⚡️;⚡️完整业务流程⚡️; ①SpringCloud、MySQL、Netty、uniapp、云快充协议1.5 云快充协议1.6、互联互通协议、多租户、分时计费。 ②小程序、管理后台、多商户、模拟桩。 ③充电平台技术解决方案。项目地址: https://gitcode.com/gh_mirrors/hu/HUIZHI-ChargeOS-cloud

慧知开源充电平台(HUIZHI-ChargeOS-cloud)是一套基于 SpringCloud 微服务架构的完整充电业务解决方案,内置了云快充协议 1.5/1.6、中电联互联互通协议(T/CEC 102)、多租户与分时计费等能力。本文将以实战视角,带你一步步完成中电联T/CEC 102协议对接,让自家充电平台轻松实现跨平台互联互通,摆脱"信息孤岛"的困境。

一、为什么要对接中电联T/CEC 102协议?

很多运营商会遇到这样的痛点:自己的充电桩无法被其他平台发现,用户必须下载多个 App 才能找到充电站。中电联互联互通协议(T/CEC 102)正是解决这一问题的"通用语言"——它规定了充电平台之间数据交互的标准格式,涵盖站点、设备、订单、计费等全链路信息。

HUIZHI-ChargeOS-cloud 在 V3.0.8 版本中全面支持了中电联互联互通协议,并在运营管理后台中提供了完整的"互联互通"菜单,开箱即用。

二、HUIZHI-ChargeOS-cloud 互联互通能力一览

该项目的互联互通功能集中在hcp-modules/hcp-operator运营模块中,通过 6 张核心数据表支撑完整对接流程:

模块数据表对应实体作用
平台信息hlht_platform_infoHlhtPlatformInfo配置对接方密钥、签名、互联互通地址
运营商信息hlht_operator_infoHlhtOperatorInfo登记运营商组织机构代码
站点信息hlht_station_infoHlhtStationInfo同步充电站位置、计费、营业信息
设备信息hlht_equipment_infoHlhtEquipmentInfo同步充电桩设备参数
接口信息hlht_connector_infoHlhtConnectorInfo同步充电枪(接口)信息
订单信息hlht_charge_order_infoHlhtChargeOrderInfo上报充电订单、电量、SOC 数据

对应控制器位于hcp-operator/controller目录,例如HlhtPlatformInfoController提供/platformInfo接口,HlhtChargeOrderInfoController提供/orderInfo接口,建表 SQL 可在sql/hcp_cloud.sql中查看。

三、快速上手:对接前的准备工作清单

在开始对接前,请先完成以下准备:

  1. 获取源码:克隆项目到本地
    git clone https://gitcode.com/gh_mirrors/hu/HUIZHI-ChargeOS-cloud
  2. 准备环境:JDK、MySQL、Redis、Nacos,并按sql/目录初始化数据库。
  3. 拿到对接凭证:向对接平台申请平台 ID、签名密钥、数据加密密钥与初始化向量(IV)。
  4. 确认对接环境:区分测试环境与生产环境,填写互联互通接口地址。

四、中电联T/CEC 102协议对接的6个核心步骤

步骤1:配置互联互通平台信息(最关键的一步)

进入运营管理后台的"互联互通 → 平台信息"菜单,新增一条对接平台记录。核心字段包括:对接编码、对接平台名称、对接方秘钥、签名秘钥、数据加密秘钥、初始化向量,以及互联互通地址和对接环境。这里还支持配置我方平台 ID 与密钥,以及"是否推送"开关,用于控制数据推送方向。

对应实体见hcp-operator/domain/HlhtPlatformInfo.java

步骤2:登记运营商信息

在"运营商信息"中录入运营商全称、统一社会信用代码、客服电话等资料。运营商 ID(组织机构代码)是互联互通报文中的重要标识,务必与对方平台保持一致。

对应实体见hcp-operator/domain/HlhtOperatorInfo.java

步骤3:同步站点信息

站点信息字段非常丰富,包括站点唯一编码(由行政区划代码 6 位 + 运营商 ID 9 位 + 场站 ID 组成)、站点类型、状态、经纬度、车位数量、充电电费描述、服务费、营业时间等。填写时可参考"站点信息"管理页面。

对应实体见hcp-operator/domain/HlhtStationInfo.java

步骤4:同步设备与接口(充电枪)信息

  • 设备信息(hlht_equipment_info):登记设备唯一编码、设备类型、额定电压上下限、额定电流、功率、生产商信息等;
  • 接口信息(hlht_connector_info):登记充电枪编码、接口类型、恒功率电压/电流范围、运营状态等。

这两个环节决定了对方平台能否正确展示你的充电桩状态。

步骤5:上报充电订单数据

订单信息表(hlht_charge_order_info)记录了充电订单号、充电桩/接口唯一标识、车牌号、VIN 码、起始/结束 SOC、尖峰平谷各时段电量等数据,是中电联互联互通协议中交易结算与对账的基础。

步骤6:用模拟充电桩联调测试

对接完成前,建议先使用内置的"模拟充电桩"模块进行联调。该模块可以模拟真实充电桩的实时状态(电流、电压、功率),帮助你验证互联互通数据是否正确上报,避免直接在生产环境踩坑。

五、核心字段速查:一次看懂对接参数

参数类别常见字段说明
平台鉴权platformId / platformSecret / signSecret对接方平台 ID、秘钥、签名秘钥
数据加密dataSecret / dataSecretIv报文数据加密密钥与初始化向量
我方身份jingliPlatformId / jingliPlatformSecret我方在对方平台的注册身份
站点信息stationUniqueNumber / areaCode站点唯一编码与行政区划代码
设备信息equipmentId / power / equipmentModel设备编码、功率与型号
订单信息orderNo / startSoc / endSoc订单号与充电起止 SOC

六、常见问题排查(FAQ)

Q1:平台信息已配置,但对方平台收不到数据?检查"是否推送"开关是否为 1,并确认互联互通地址在测试/生产环境中正确填写。

Q2:签名校验总是失败?优先核对签名密钥与数据加密密钥是否与对方一致,注意加密密钥与初始化向量(IV)需要配套使用,可参考HlhtPlatformInfo中的字段设计。

Q3:站点/设备状态展示异常?确认站点唯一编码、运营商 ID 是否符合协议规定的位数与拼接规则,并检查设备与接口信息的上下级关联是否正确。

Q4:想快速验证协议流程?使用"模拟充电桩"模块发起模拟充电,观察订单与实时监控数据是否正常流转,这是成本最低的联调方式。

七、结语

中电联T/CEC 102协议对接并没有想象中复杂。借助 HUIZHI-ChargeOS-cloud 完整的互联互通模块,你只需要完成平台信息、站点、设备、订单等几个环节的配置与联调,就能让充电平台真正"连起来"。如果对接过程中遇到问题,多对照sql/hcp_cloud.sql中的表结构与hcp-operator模块的源码进行排查,效率会高很多。

希望这篇中电联T/CEC 102协议对接实战指南能帮你少走弯路,早日实现充电业务的互联互通!

【免费下载链接】HUIZHI-ChargeOS-cloud⚡️慧知开源充电平台全套源码⚡️;⚡️完整业务流程⚡️; ①SpringCloud、MySQL、Netty、uniapp、云快充协议1.5 云快充协议1.6、互联互通协议、多租户、分时计费。 ②小程序、管理后台、多商户、模拟桩。 ③充电平台技术解决方案。项目地址: https://gitcode.com/gh_mirrors/hu/HUIZHI-ChargeOS-cloud

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!