Show low-voltage battery voltage on dash and document centivolt input

docs/通讯交接文档.md

@@ -1,6 +1,6 @@
 # AMI 仪表通讯交接文档
 
-协议版本 1.1（debug 数字状态版）  |  2026-09-30
+协议版本 1.2（新增低压电池电压）  |  2026-10-01
 
 适用工程：AMI.HMI；屏幕 TJC4827X543_011，480 × 272；编辑器 USART HMI 1.68.1.3037。本文以随附的精简指令版工程为准。
 
@@ -111,10 +111,11 @@ Program.s 上电通过 printh 发出 00 00 00 FF FF FF 88 FF FF FF。该启动
 
 # 6. 主页面与页面切换
 
-主页面数字控件已设为全局，可通过带页面名的属性指令跨页更新。它们是整数显示控件，没有约定浮点缩放。不要直接发送小数值。
+主页面数字控件已设为全局，可通过带页面名的属性指令跨页更新。新增 lvbat 是两位小数的虚拟浮点控件，val 单位固定为 0.01 V；其他原有数值仍为整数显示。所有 val 指令都发送整数。
 
 | 显示项 | 赋值命令示例 | 说明 |
 | --- | --- | --- |
+| 低压电池电压 | dash.lvbat.val=1260 | 0.01 V/计数；显示 12.60 V |
 | 当前车速 | dash.speed.val=30 | 界面标注 km/h；示例显示 30 |
 | 高压电压 | dash.ts.val=300 | 示例为显示值；电气单位需与主控统一 |
 | 扭矩千分 | dash.mct.val=500 | 保留界面“扭矩千分”定义 |
@@ -123,7 +124,9 @@ Program.s 上电通过 printh 发出 00 00 00 FF FF FF 88 FF FF FF。该启动
 | MCU 温度 | dash.mcuwd.val=40 | 示例为显示值 |
 | 最高单体 | dash.dtwd.val=50 | 含义/单位待主控确认，不能仅按控件名猜测 |
 
-数值 val 按有符号 32 位整数使用。电压、电流、温度及“最高单体”的单位、有效范围、无效值和缩放未形成主控协议；本版只确认控件名及整数赋值方式。联调前应由接手者补齐这些定义。
+低压电池电压放在车速上方，保留两位小数。主控若采集为 mV，应先换算为 0.01 V 整数（例如 12600 mV → 1260）。指令 dash.lvbat.val=1260 后仍追加 FF FF FF。该值为全局，切页保留，上电设计初值 0.00 V；初值和断线后的旧值不代表有效测量，也没有自动低压告警。
+
+数值 val 按有符号 32 位整数使用。除新增低压电池电压外，高压电压、电流、温度及“最高单体”的单位、有效范围、无效值和缩放未形成主控协议，接手者应与主控统一。
 
 ## 页面指令
 
@@ -180,12 +183,12 @@ int ami_set_debug(unsigned id, unsigned state)
 
 ## 已完成与待验证
 
-已完成：USART HMI 编译 0 错误、0 警告；模拟器验证跨页数值更新、正常/故障/未知转换，以及 d1 双位置同步。六个任务回传此前已做模拟检查。待完成：实际屏幕下载、UART 收发、触摸行为、数据时序和车辆安全动作。C 示例仅为驱动接入参考，本次未在目标主控工程中编译。
+已完成：USART HMI 编译 0 错误、0 警告；模拟器验证跨页数值更新、正常/故障/未知转换，以及 d1 双位置同步；新增 lvbat 已验证 1260 显示 12.60 V、跨页更新 1185 显示 11.85 V。六个任务回传此前已做模拟检查。待完成：实际屏幕下载、UART 收发、触摸行为、数据时序和车辆安全动作。C 示例仅为驱动接入参考，本次未在目标主控工程中编译。
 
 ## 8. 工程版本与资料
 
 配套 AMI.HMI 的 SHA-256：
-4b7986154d6f0a7a4226ee4591373f39f9ed70af5a6c81ee9380c6e9f72c0ada
+c667e115e3a7c8c1fd08e9c135d101c4d5bb1d3fe4b3f46ca80a85e860a06d1f
 
 旧版工程不能与本版 dN 接口混用。配套文件包括 AMI.HMI、PDF、通讯交接文档.md 和 ami_debug_send.c；其中 Markdown 为可编辑文字源，C 文件为参考发送函数。仓库中的实际位置见 README。