# 充电桩与网关 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 (充电桩 → 网关)：**

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

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

**Response (网关 → 充电桩)：**

```json
{
  "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 (充电桩 → 网关)：**

```json
{
  "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 (网关 → 充电桩)：**

```json
{
  "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 (网关 → 充电桩)：**

```json
{
  "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 (充电桩 → 网关)：**

```json
{
  "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 (网关 → 充电桩)：**

```json
{
  "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 (充电桩 → 网关)：**

```json
{
  "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 (充电桩 → 网关)：**

```json
{
  "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 (网关 → 充电桩)：**

```json
{
  "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 (充电桩 → 网关)：**

```json
{
  "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 (网关 → 充电桩)：**

```json
{
  "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 (充电桩 → 网关)：**

```json
{
  "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 (网关 → 充电桩)：**

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

---

## 8. 充电参数配置

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

**Request (充电桩 → 网关)：**

```json
{
  "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 (网关 → 充电桩)：**

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

---

## 9. 充电错误报文

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

**Request (充电桩 → 网关)：**

```json
{
  "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 (网关 → 充电桩)：**

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

---

## 10. BMS中止充电

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

**Request (充电桩 → 网关)：**

```json
{
  "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 (网关 → 充电桩)：**

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

---

## 11. 充电机中止充电

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

**Request (充电桩 → 网关)：**

```json
{
  "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 (网关 → 充电桩)：**

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

---

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

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

**Request (充电桩 → 网关)：**

```json
{
  "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 (网关 → 充电桩)：**

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

---

## 13. 充电过程BMS信息

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

**Request (充电桩 → 网关)：**

```json
{
  "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 (网关 → 充电桩)：**

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

---

## 14. 结算账单上传

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

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

**Request (充电桩 → 网关)：**

```json
{
  "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 (网关 → 充电桩)：**

```json
{
  "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 | 充电桩 | 网关 | 充电结束 |