diff --git a/docs/protocol/柜控板固件对接文档.md b/docs/protocol/柜控板固件对接文档.md index 202225b..8ba5bd6 100644 --- a/docs/protocol/柜控板固件对接文档.md +++ b/docs/protocol/柜控板固件对接文档.md @@ -564,6 +564,11 @@ | `temp` | 整数 | 柜体温度。**⚠️ 这是 JSON 数值字段 = 平台单位,由设备换算后上报**:送 **K×100**(即硬件 1K 的读数 ×100,`29800` = `298.00K`)。平台**原样存库、不再 ×100**;管理端按 `temp/100 − 273.15` 显示为 ℃ | | `meter` | 整数 | 电表读数。**⚠️ 这是 JSON 数值字段 = 平台单位,由设备换算后上报**:送 **Wh**(即硬件 0.1kWh 的读数 ×100,`125500` = `125.5 kWh` = 125500 Wh)。平台**原样存库、不再 ×100** | +> ✅ **平台侧落地情况(2026-09-20)**:本字段**已按此要求落库** —— cabinets.meter_wh(最新读数)+ cabinets.meter_at(收到时刻), +> 并在 cabinet_meter_readings 表**只在读数变化时**追加一条留痕(即**抄表记录**,可直接用于按日统计用电量)。 +> 此前平台只把它写进 Redis(TTL 300 秒)⇒ 上报 5 分钟后即被清掉、历史无法回溯,属实现缺口,现已补齐。 +> ⚠️ 与订单电量 nergy **不是一回事**:meter 是**整柜累计电能**(电表读数,天然累加值),nergy 是**单订单充电量**(协议无此字段,见待确认第 13 项的兜底)。 + > ⚠️ **`temp` / `meter` 与 `channels[]` 不是同一套口径,千万别混**(全文统一规则见 **3.1**): > - **`temp` / `meter` 是 JSON 数值字段 → 设备换算**:示例里的 `29800` / `125500` **就是最终值**,**固件不要再乘 100**。 > - **`channels[]` 是 hex 字节流 → 平台换算**:同一条报文里的 `0143` 是**硬件原始值**(323K),平台会 **×100** 得到 32300(K×100)。