BR_YKC/Doc/桩和网关通讯协议文档.md

充电桩与网关 UDP JSON 通讯协议

概述

充电桩与网关之间通过 以太网 UDP 通信，使用 JSON 格式进行数据交换。

项目	说明
传输层	UDP
网关端口	6001
桩IP范围	10.12.19.101 ~ 106
数据格式	JSON
编码	UTF-8

---

通讯流程

充电桩上电
    ↓
发送 online（上电）  ──────→ 网关回复 charger_id
    ↓
正常运行时，每 5~10 秒
发送 heartbeat（心跳） ──→ 网关回复
    ↓
             ┌─── 网关下发 start charging（启动充电）
             │
充电桩周期上报实时数据        ←──── 网关可下发 end charging（停止充电）
(realtime data / charge process real / bms info real)
             │
             └─── 充电结束 → 上报 settlement bill（结算账单）

---

指令列表

#	标题	cmd	方向	触发方式
1	桩上电	online	桩 → 网关 → 桩	上电即发
2	心跳	heartbeat	桩 → 网关 → 桩	5~10秒周期
3	启动充电	start charging	网关 → 桩 → 网关	网关主动下发
4	停止充电	end charging	网关 → 桩 → 网关	网关主动下发
5	主动停止充电	proactive end charging	桩 → 网关 → 桩	桩主动上报
6	实时数据上报	realtime data	桩 → 网关 → 桩	周期上送
7	BMS信息上报	bms info	桩 → 网关 → 桩	桩主动上报
8	充电参数配置	charge config	桩 → 网关 → 桩	桩主动上报
9	充电错误报文	charge error	桩 → 网关 → 桩	桩主动上报
10	BMS中止充电	bms stop	桩 → 网关 → 桩	桩主动上报
11	充电机中止充电	charger stop	桩 → 网关 → 桩	桩主动上报
12	充电过程BMS需求与输出	charge process real	桩 → 网关 → 桩	15秒周期
13	充电过程BMS信息	bms info real	桩 → 网关 → 桩	15秒周期
14	结算账单上传	settlement bill	桩 → 网关 → 桩	桩主动上报

---

通用字段说明

所有 JSON 消息均包含以下固定字段：

字段	类型	说明
id	Number	桩编码 (1~6)
cmd	String	指令标识，见指令列表
type	String	"request" 请求帧 / "response" 回复帧

---

1. 桩上电

方向：充电桩 → 网关 → 充电桩

充电桩上电后立即发送，网关回复桩的唯一ID。

Request (充电桩 → 网关)：

{
  "id": 1,
  "cmd": "online",
  "type": "request"
}

字段	类型	必填	说明
id	Number	是	桩编码
cmd	String	是	"online"
type	String	是	"request"

Response (网关 → 充电桩)：

{
  "id": 1,
  "cmd": "online",
  "charger_id": "32010203040506",
  "type": "response"
}

字段	类型	必填	说明
id	Number	是	桩编码
cmd	String	是	"online"
charger_id	String	是	桩唯一ID
type	String	是	"response"

---

2. 心跳

方向：充电桩 → 网关 → 充电桩
周期：5~10 秒

桩定期上报各枪实时状态。

Request (充电桩 → 网关)：

{
  "id": 1,
  "cmd": "heartbeat",
  "gun": [
    { "id": 1, "state": 0 },
    { "id": 2, "state": 0 }
  ],
  "type": "request"
}

字段	类型	必填	说明
id	Number	是	桩编码 (1~6)
cmd	String	是	"heartbeat"
gun	Array	是	枪口列表
gun[].id	Number	是	枪编号 (1~N)
gun[].state	Number	是	枪状态：0 离线；1 故障；2 空闲；3 充电
type	String	是	"request"

Response (网关 → 充电桩)：

{
  "id": 1,
  "cmd": "heartbeat",
  "gun_id": 1,
  "type": "response"
}

字段	类型	必填	说明
id	Number	是	桩编码 (1~6)
cmd	String	是	"heartbeat"
gun_id	Number	是	枪编号 (1~N)
type	String	是	"response"

---

3. 启动充电

方向：网关 → 充电桩 → 网关

网关向充电桩下发启动充电指令，同步下发计费模型。

Request (网关 → 充电桩)：

{
  "id": 1,
  "cmd": "start charging",
  "transaction_id": "32010200000000111511161555350260",
  "gun_id": 1,
  "fee": [
    [1, 0, 6, 0.3, 0.5],
    [2, 6, 10, 0.8, 0.8],
    [3, 10, 15, 1.2, 0.8],
    [4, 15, 24, 0.6, 0.6]
  ],
  "limit_amount": 0,
  "type": "request"
}

字段	类型	必填	说明
id	Number	是	桩编码 (1~6)
cmd	String	是	"start charging"
transaction_id	String	是	订单编码 32位
gun_id	Number	是	枪编码 (1~N)
fee	Array	是	计费模型数组，每行：[计费段, 开始时间, 结束时间, 电费, 服务费]
limit_amount	Float	是	停止金额（元）。0 为不限制
type	String	是	"request"

fee 数组格式：

每行固定5个元素：

[计费段, 开始时间(小时), 结束时间(小时), 电费单价, 服务费单价]

计费段	含义
1	尖
2	峰
3	平
4	谷

Response (充电桩 → 网关)：

{
  "id": 1,
  "cmd": "start charging",
  "transaction_id": "32010200000000111511161555350260",
  "gun_id": 1,
  "result": 0,
  "error_code": 0,
  "type": "response"
}

字段	类型	必填	说明
id	Number	是	桩编码 (1~6)
cmd	String	是	"start charging"
transaction_id	String	是	订单编码 32位
gun_id	Number	是	枪编码 (1~N)
result	Number	是	启动结果：0=失败；1=成功
error_code	Number	是	错误码：0=无；1=设备编号不匹配；2=枪已在充电；3=设备故障；4=设备离线；5=未插枪
type	String	是	"response"

---

4. 停止充电

方向：网关 → 充电桩 → 网关

Request (网关 → 充电桩)：

{
  "id": 1,
  "cmd": "end charging",
  "transaction_id": "32010200000000111511161555350260",
  "gun_id": 1,
  "type": "request"
}

字段	类型	必填	说明
id	Number	是	桩编码 (1~6)
cmd	String	是	"end charging"
transaction_id	String	是	订单编码 32位
gun_id	Number	是	枪编码 (1~N)
type	String	是	"request"

Response (充电桩 → 网关)：

{
  "id": 1,
  "cmd": "end charging",
  "transaction_id": "32010200000000111511161555350260",
  "gun_id": 1,
  "result": 0,
  "error_code": 0,
  "type": "response"
}

字段	类型	必填	说明
id	Number	是	桩编码 (1~6)
cmd	String	是	"end charging"
transaction_id	String	是	订单编码 32位
gun_id	Number	是	枪编码 (1~N)
result	Number	是	停止结果：0 失败；1 成功
error_code	Number	是	错误码：0 无；1 枪未在充电；2 其他故障
type	String	是	"response"

---

5. 主动停止充电

方向：充电桩 → 网关 → 充电桩

充电桩主动上报停止充电（如用户刷卡停止、车辆BMS中止等）。

Request (充电桩 → 网关)：

{
  "id": 1,
  "cmd": "proactive end charging",
  "transaction_id": "32010200000000111511161555350260",
  "gun_id": 1,
  "type": "request"
}

字段	类型	必填	说明
id	Number	是	桩编码 (1~6)
cmd	String	是	"proactive end charging"
transaction_id	String	是	订单编码 32位
gun_id	Number	是	枪编码 (1~N)
type	String	是	"request"

Response (网关 → 充电桩)：

{
  "id": 1,
  "cmd": "proactive end charging",
  "transaction_id": "32010200000000111511161555350260",
  "gun_id": 1,
  "type": "response"
}

字段	类型	必填	说明
id	Number	是	桩编码 (1~6)
cmd	String	是	"end charging"
transaction_id	String	是	订单编码 32位
gun_id	Number	是	枪编码 (1~N)
type	String	是	"response"

---

6. 充电桩实时数据上报

方向：充电桩 → 网关 → 充电桩
周期：待机 5 分钟、充电 15 秒

Request (充电桩 → 网关)：

{
  "id": 1,
  "cmd": "realtime data",
  "transaction_id": "32010200000000111511161555350260",
  "gun_id": 1,
  "state": 0,
  "gun_back": 0,
  "gun_insert": 1,
  "voltage": 2222,
  "current": 2222,
  "cable_temp": 85,
  "cable_code": "1234567890123456",
  "soc": 85,
  "battery_temp": 95,
  "charge_time": 45,
  "remain_time": 30,
  "charge_kwh": 12.3456,
  "loss_kwh": 12.4567,
  "charge_amount": 18.6851,
  "fault": 0,
  "type": "request"
}

字段	类型	必填	说明
id	Number	是	桩编码 (1~6)
cmd	String	是	"realtime data"
transaction_id	String	是	交易流水号 32位，待机时填充0
gun_id	Number	是	枪编号 (1~N)
state	Number	是	枪状态：0 离线；1 故障；2 空闲；3 充电
gun_back	Number	是	枪是否归位：0 否；1 是；2 未知
gun_insert	Number	是	是否插枪：0 否；1 是
voltage	Float	是	输出电压，单位0.1V。待机时为0
current	Float	是	输出电流，单位0.1A。待机时为0
cable_temp	Number	是	枪线温度，单位℃，偏移量-50。待机时为0
cable_code	String	是	枪线编码 16位，没有时填充0
soc	Number	是	电池SOC百分比 0~100，待机/交流桩为0
battery_temp	Number	是	电池组最高温度，单位℃，偏移量-50。待机/交流桩为0
charge_time	Number	是	累计充电时间，单位分钟。待机时为0
remain_time	Number	是	剩余时间，单位分钟。待机/交流桩为0
charge_kwh	Float	是	充电度数(kWh)，精确到小数点后4位。待机时为0
loss_kwh	Float	是	计损充电度数(kWh)。未设置计损比例时等于charge_kwh
charge_amount	Float	是	已充金额(元)，精确到小数点后4位
fault	Number	是	硬件故障位图（16bit），见下方说明
type	String	是	"request"

fault 故障位图：

Bit	故障
1	急停
2	无模块
3	温度高
4	防雷故障
5	DC20中断
6	FC08中断
7	电表中断
8	读卡器中断
9	RC10中断
10	风扇故障
11	熔断器故障
12	接触器故障
13	门打开

Response (网关 → 充电桩)：

{
  "id": 1,
  "cmd": "realtime data",
  "transaction_id": "32010200000000111511161555350260",
  "gun_id": 1,
  "type": "response"
}

字段	类型	必填	说明
id	Number	是	桩编码 (1~6)
cmd	String	是	"realtime data"
transaction_id	String	是	交易流水号 32位
gun_id	Number	是	枪编号 (1~N)
type	String	是	"response"

---

7. BMS信息上报

方向：充电桩 → 网关 → 充电桩

Request (充电桩 → 网关)：

{
  "id": 1,
  "cmd": "bms info",
  "transaction_id": "32010200000000111511161555350260",
  "gun_id": 1,
  "protocol_version": "0001.01",
  "battery_type": 3,
  "rated_capacity": 600.0,
  "rated_voltage": 3600.0,
  "manufacturer": "CATL",
  "battery_sn": "BT123456",
  "production_year": 2023,
  "production_month": 6,
  "production_day": 15,
  "charge_count": 1250,
  "ownership": 1,
  "reserved": 0,
  "vin": "LSVAA4182E2123456",
  "software_version": "FFFFFF.07DF.0B.0A.10",
  "type": "request"
}

字段	类型	必填	说明
id	Number	是	桩编码 (1~6)
cmd	String	是	"bms info"
transaction_id	String	是	交易流水号 32位
gun_id	Number	是	枪编号 (1~N)
protocol_version	String	是	BMS通信协议版本号。格式：byte3.byte2-byte1，例："0001.01"=V1.1
battery_type	Number	是	电池类型：1铅酸；2氢电池；3磷酸铁锂；4锰酸锂；5钴酸锂；6三元材料；7聚合物锂离子；8钛酸锂；255其他
rated_capacity	Float	是	额定容量，单位0.1Ah。例：600.0=60.0Ah
rated_voltage	Float	是	额定总电压，单位0.1V。例：3600.0=360.0V
manufacturer	String	是	电池生产厂商名称，最长4字节
battery_sn	String	是	电池组序号，最长4字节
production_year	Number	是	生产年份，1985偏移量。例：2023=1985+38
production_month	Number	是	生产月份，1~12
production_day	Number	是	生产日，1~31
charge_count	Number	是	电池组充电次数，0次偏移量
ownership	Number	是	电池产权标识：0租赁；1车自有
reserved	Number	是	预留位
vin	String	是	车辆识别码VIN，17位字符
software_version	String	是	BMS软件版本号。格式：byte8.byte7-byte5.byte4-byte3-byte2-byte1
type	String	是	"request"

Response (网关 → 充电桩)：

{
  "id": 1,
  "cmd": "bms info",
  "gun_id": 1,
  "type": "response"
}

---

8. 充电参数配置

方向：充电桩 → 网关 → 充电桩
依据：GBT-27930 充电桩与BMS参数配置阶段报文

Request (充电桩 → 网关)：

{
  "id": 1,
  "cmd": "charge config",
  "transaction_id": "32010200000000111511161555350260",
  "gun_id": 1,
  "bms_max_cell_voltage": 4.20,
  "bms_max_current": 250.0,
  "bms_rated_energy": 60.0,
  "bms_max_voltage": 750.0,
  "bms_max_temp": 95,
  "bms_soc": 85.0,
  "bms_current_voltage": 680.0,
  "pile_max_voltage": 750.0,
  "pile_min_voltage": 200.0,
  "pile_max_current": 250.0,
  "pile_min_current": 10.0,
  "type": "request"
}

字段	类型	必填	说明
id	Number	是	桩编码 (1~6)
cmd	String	是	"charge config"
transaction_id	String	是	交易流水号 32位
gun_id	Number	是	枪编号 (1~N)
bms_max_cell_voltage	Float	是	BMS单体最高允许充电电压，单位0.01V，范围0~24V
bms_max_current	Float	是	BMS最高允许充电电流，单位0.1A，-400A偏移量
bms_rated_energy	Float	是	BMS标称总能量，单位0.1kWh，范围0~1000kWh
bms_max_voltage	Float	是	BMS最高允许充电总电压，单位0.1V
bms_max_temp	Number	是	BMS最高允许温度，单位℃，-50℃偏移量，范围-50~200℃
bms_soc	Float	是	BMS荷电状态SOC，单位0.1%，范围0~100%
bms_current_voltage	Float	是	BMS当前电池电压，单位0.1V
pile_max_voltage	Float	是	电桩最高输出电压，单位0.1V
pile_min_voltage	Float	是	电桩最低输出电压，单位0.1V
pile_max_current	Float	是	电桩最大输出电流，单位0.1A，-400A偏移量
pile_min_current	Float	是	电桩最小输出电流，单位0.1A，-400A偏移量
type	String	是	"request"

Response (网关 → 充电桩)：

{
  "id": 1,
  "cmd": "charge config",
  "gun_id": 1,
  "type": "response"
}

---

9. 充电错误报文

方向：充电桩 → 网关 → 充电桩
依据：GBT-27930 充电桩与BMS充电错误报文

Request (充电桩 → 网关)：

{
  "id": 1,
  "cmd": "charge error",
  "transaction_id": "32010200000000111511161555350260",
  "gun_id": 1,
  "charger_spn2560_00_timeout": 0,
  "charger_spn2560_aa_timeout": 0,
  "charger_time_sync_timeout": 0,
  "charger_ready_timeout": 0,
  "charger_status_timeout": 0,
  "charger_stop_timeout": 0,
  "charger_statistics_timeout": 0,
  "bms_identify_timeout": 0,
  "battery_param_timeout": 0,
  "bms_ready_timeout": 0,
  "battery_status_timeout": 0,
  "battery_demand_timeout": 0,
  "bms_stop_timeout": 0,
  "bms_statistics_timeout": 0,
  "type": "request"
}

所有超时字段取值：0=正常；1=超时；2=不可信状态

字段	说明
charger_spn2560_00_timeout	接收SPN2560=0x00的充电机辨识报文超时
charger_spn2560_aa_timeout	接收SPN2560=0xAA的充电机辨识报文超时
charger_time_sync_timeout	接收时间同步和充电机最大输出能力报文超时
charger_ready_timeout	接收充电机完成充电准备报文超时
charger_status_timeout	接收充电机充电状态报文超时
charger_stop_timeout	接收充电机中止充电报文超时
charger_statistics_timeout	接收充电机充电统计报文超时
bms_identify_timeout	接收BMS和车辆的辨识报文超时
battery_param_timeout	接收电池充电参数报文超时
bms_ready_timeout	接收BMS完成充电准备报文超时
battery_status_timeout	接收电池充电总状态报文超时
battery_demand_timeout	接收电池充电要求报文超时
bms_stop_timeout	接收BMS中止充电报文超时
bms_statistics_timeout	接收BMS充电统计报文超时

Response (网关 → 充电桩)：

{
  "id": 1,
  "cmd": "charge error",
  "gun_id": 1,
  "type": "response"
}

---

10. BMS中止充电

方向：充电桩 → 网关 → 充电桩
依据：GBT-27930 充电桩与BMS充电阶段BMS中止报文

Request (充电桩 → 网关)：

{
  "id": 1,
  "cmd": "bms stop",
  "transaction_id": "32010200000000111511161555350260",
  "gun_id": 1,
  "stop_reason_soc": 0,
  "stop_reason_total_voltage": 0,
  "stop_reason_cell_voltage": 0,
  "stop_reason_charger": 0,
  "fault_insulation": 0,
  "fault_connector_temp": 0,
  "fault_bms_temp": 0,
  "fault_connector": 0,
  "fault_battery_temp": 0,
  "fault_relay": 0,
  "fault_voltage_detect": 0,
  "fault_other": 0,
  "error_current": 0,
  "error_voltage": 0,
  "type": "request"
}

所有字段取值：0=正常；1=中止/异常

字段	说明
stop_reason_soc	达到SOC目标值中止
stop_reason_total_voltage	达到总电压设定值中止
stop_reason_cell_voltage	达到单体电压设定值中止
stop_reason_charger	充电机主动中止
fault_insulation	绝缘故障
fault_connector_temp	输出连接器过温
fault_bms_temp	BMS元件过温
fault_connector	充电连接器故障
fault_battery_temp	电池组温度过高
fault_relay	高压继电器故障
fault_voltage_detect	检测点2电压检测故障
fault_other	其他故障
error_current	电流过大
error_voltage	电压异常

Response (网关 → 充电桩)：

{
  "id": 1,
  "cmd": "bms stop",
  "gun_id": 1,
  "type": "response"
}

---

11. 充电机中止充电

方向：充电桩 → 网关 → 充电桩
依据：GBT-27930 充电桩与BMS充电阶段充电机中止报文

Request (充电桩 → 网关)：

{
  "id": 1,
  "cmd": "charger stop",
  "transaction_id": "32010200000000111511161555350260",
  "gun_id": 1,
  "stop_reason_condition": 0,
  "stop_reason_manual": 0,
  "stop_reason_abnormal": 0,
  "stop_reason_bms": 0,
  "fault_charger_temp": 0,
  "fault_connector": 0,
  "fault_internal_temp": 0,
  "fault_power_transfer": 0,
  "fault_emergency": 0,
  "fault_other": 0,
  "error_current": 0,
  "error_voltage": 0,
  "type": "request"
}

所有字段取值：0=正常；1=中止/异常

字段	说明
stop_reason_condition	达到充电机设定的条件
stop_reason_manual	人工中止
stop_reason_abnormal	异常中止
stop_reason_bms	BMS主动中止
fault_charger_temp	充电机过温
fault_connector	充电连接器故障
fault_internal_temp	充电机内部过温
fault_power_transfer	所需电量不能传送
fault_emergency	充电机急停
fault_other	其他故障
error_current	电流不匹配
error_voltage	电压异常

Response (网关 → 充电桩)：

{
  "id": 1,
  "cmd": "charger stop",
  "gun_id": 1,
  "type": "response"
}

---

12. 充电过程BMS需求与充电机输出

方向：充电桩 → 网关 → 充电桩
周期：15 秒
依据：GBT-27930 充电过程BMS需求、充电机输出报文

Request (充电桩 → 网关)：

{
  "id": 1,
  "cmd": "charge process real",
  "transaction_id": "32010200000000111511161555350260",
  "gun_id": 1,
  "bms_voltage_demand": 680.0,
  "bms_current_demand": 250.0,
  "bms_charge_mode": 2,
  "bms_voltage_measure": 678.5,
  "bms_current_measure": 248.0,
  "bms_max_cell_voltage": 4.15,
  "bms_max_cell_group": 3,
  "bms_soc": 85,
  "bms_remain_time": 30,
  "pile_voltage_output": 680.0,
  "pile_current_output": 250.0,
  "charge_time": 45,
  "type": "request"
}

字段	类型	必填	说明
id	Number	是	桩编码 (1~6)
cmd	String	是	"charge process real"
transaction_id	String	是	交易流水号 32位
gun_id	Number	是	枪编号 (1~N)
bms_voltage_demand	Float	是	BMS电压需求，单位0.1V
bms_current_demand	Float	是	BMS电流需求，单位0.1A，-400A偏移量
bms_charge_mode	Number	是	充电模式：1恒压；2恒流
bms_voltage_measure	Float	是	BMS充电电压测量值，单位0.1V
bms_current_measure	Float	是	BMS充电电流测量值，单位0.1A，-400A偏移量
bms_max_cell_voltage	Float	是	最高单体蓄电池电压，单位0.01V，范围0~24V
bms_max_cell_group	Number	是	最高单体电压所在组号，范围0~15
bms_soc	Number	是	当前SOC，单位%，范围0~100
bms_remain_time	Number	是	估算剩余充电时间，单位分钟，范围0~600
pile_voltage_output	Float	是	电桩电压输出值，单位0.1V
pile_current_output	Float	是	电桩电流输出值，单位0.1A，-400A偏移量
charge_time	Number	是	累计充电时间，单位分钟，范围0~600
type	String	是	"request"

Response (网关 → 充电桩)：

{
  "id": 1,
  "cmd": "charge process real",
  "gun_id": 1,
  "type": "response"
}

---

13. 充电过程BMS信息

方向：充电桩 → 网关 → 充电桩
周期：15 秒
依据：GBT-27930 充电过程BMS信息报文

Request (充电桩 → 网关)：

{
  "id": 1,
  "cmd": "bms info real",
  "transaction_id": "32010200000000111511161555350260",
  "gun_id": 1,
  "max_cell_voltage_no": 128,
  "max_battery_temp": 45,
  "max_temp_point_no": 8,
  "min_battery_temp": 25,
  "min_temp_point_no": 3,
  "cell_voltage_status": 0,
  "soc_status": 0,
  "charge_current_status": 0,
  "battery_temp_status": 0,
  "insulation_status": 0,
  "connector_status": 0,
  "charge_enable": 1,
  "type": "request"
}

字段	类型	必填	说明
id	Number	是	桩编码 (1~6)
cmd	String	是	"bms info real"
transaction_id	String	是	交易流水号 32位
gun_id	Number	是	枪编号 (1~N)
max_cell_voltage_no	Number	是	最高单体电压所在编号，1偏移量，范围1~256
max_battery_temp	Number	是	最高电池温度，单位℃，-50℃偏移量，范围-50~200℃
max_temp_point_no	Number	是	最高温度检测点编号，1偏移量，范围1~128
min_battery_temp	Number	是	最低电池温度，单位℃，-50℃偏移量
min_temp_point_no	Number	是	最低温度检测点编号，1偏移量
cell_voltage_status	Number	是	单体电压过高/过低：0正常；1过高；2过低
soc_status	Number	是	SOC过高/过低：0正常；1过高；2过低
charge_current_status	Number	是	充电过电流：0正常；1过流；2不可信
battery_temp_status	Number	是	电池温度过高：0正常；1过高；2不可信
insulation_status	Number	是	绝缘状态：0正常；1异常；2不可信
connector_status	Number	是	输出连接器连接状态：0正常；1异常；2不可信
charge_enable	Number	是	充电禁止：0禁止；1允许
type	String	是	"request"

Response (网关 → 充电桩)：

{
  "id": 1,
  "cmd": "bms info real",
  "gun_id": 1,
  "type": "response"
}

---

14. 结算账单上传

方向：充电桩 → 网关 → 充电桩

充电结束生成结算账单上传。若未收到响应，间隔30秒重试一次，最多重试3次。收到成功响应后，充电桩本地删除该账单。

Request (充电桩 → 网关)：

{
  "id": 1,
  "cmd": "settlement bill",
  "transaction_id": "55031412782305012018061910262392",
  "gun_id": 1,
  "start_time": 1584349487,
  "end_time": 1584349487,
  "billing": [
    [1.30000, 0.0000, 0.0000, 0.0000],
    [1.30000, 0.0000, 0.0000, 0.0000],
    [1.30000, 0.0000, 0.0000, 0.0000],
    [1.30000, 0.0000, 0.0000, 0.0000]
  ],
  "meter_start": 0.0000,
  "meter_end": 0.0000,
  "total_energy": 0.0000,
  "total_energy_loss": 0.0000,
  "total_amount": 0.0000,
  "vin": "",
  "trade_type": 2,
  "trade_time": 1584349487,
  "stop_reason": 0,
  "card_physical_id": "D14B0A54",
  "type": "request"
}

字段	类型	必填	说明
id	Number	是	桩编码 (1~6)
cmd	String	是	"settlement bill"
transaction_id	String	是	交易流水号 32位
gun_id	Number	是	枪编号 (1~N)
start_time	Number	是	充电开始时间，Unix时间戳（秒）
end_time	Number	是	充电结束时间，Unix时间戳（秒）
billing	Array	是	尖峰平谷计费数组，4行，顺序：[尖,峰,平,谷]，每行：[单价(.5f), 电量(.4f), 计损电量(.4f), 金额(.4f)]
meter_start	Float	是	电表总起值(kWh)，四位小数
meter_end	Float	是	电表总止值(kWh)，四位小数
total_energy	Float	是	总电量(kWh)，四位小数
total_energy_loss	Float	是	计损总电量(kWh)，四位小数
total_amount	Float	是	消费金额(元)，含电费和服务费，四位小数
vin	String	是	电动汽车VIN码，17位ASCII
trade_type	Number	是	交易标识：1=app启动；2=卡启动；4=离线卡启动；5=VIN码启动
trade_time	Number	是	交易时间，Unix时间戳（秒）
stop_reason	Number	是	停止原因，见云快充附录13.1
card_physical_id	String	是	物理卡号，默认为空
type	String	是	"request"

billing 数组格式：

[尖, 峰, 平, 谷]   ← 4行，固定顺序
  │
  └─ [单价(.5f), 电量(.4f), 计损电量(.4f), 金额(.4f)]

Response (网关 → 充电桩)：

{
  "id": 1,
  "cmd": "settlement bill",
  "transaction_id": "55031412782305012018061910262392",
  "gun_id": 1,
  "result": 1,
  "type": "response"
}

字段	类型	必填	说明
id	Number	是	桩编码 (1~6)
cmd	String	是	"settlement bill"
transaction_id	String	是	交易流水号 32位
gun_id	Number	是	枪编号 (1~N)
result	Number	是	账单上传结果：1=成功；0=失败
type	String	是	"response"

重试机制：若未收到响应，间隔30秒重试一次，最多重试3次。收到成功响应后，本账单在充电桩本地删除。

---

附录：协议汇总表

编号	cmd	请求方	响应方	触发方式
1	online	充电桩	网关	上电
2	heartbeat	充电桩	网关	5~10s周期
3	start charging	网关	充电桩	网关下发
4	end charging	网关	充电桩	网关下发
5	proactive end charging	充电桩	网关	桩主动
6	realtime data	充电桩	网关	周期上送
7	bms info	充电桩	网关	桩主动
8	charge config	充电桩	网关	桩主动
9	charge error	充电桩	网关	桩主动
10	bms stop	充电桩	网关	桩主动
11	charger stop	充电桩	网关	桩主动
12	charge process real	充电桩	网关	15s周期
13	bms info real	充电桩	网关	15s周期
14	settlement bill	充电桩	网关	充电结束