Add AMI CAN DBC and verified SDC/BMS firmware handoff

docs/通讯交接文档.md

@@ -1,9 +1,11 @@
 # AMI 仪表通讯交接文档
 
-协议版本 1.2（新增低压电池电压）  |  2026-10-01
+屏幕接口 1.2；MCU CAN 协议 2.0（SDC / BMS）  |  2026-10-03
 
 适用工程：AMI.HMI；屏幕 TJC4827X543_011，480 × 272；编辑器 USART HMI 1.68.1.3037。本文以随附的精简指令版工程为准。
 
+2026-10-03 补充：dash 增加全局虚拟浮点控件 `lvbat`，两位小数，`dash.lvbat.val=1230` 显示 12.30 V，来源为 SDC ADC。当前 MCU CAN 输入见 [SDC_BMS协议.md](SDC_BMS协议.md)；原整数高压电压/电流控件四舍五入为 1 V / 1 A。灰色数值表示未知或失效。SDC GPIO 尚无具名安全状态映射，当前 MCU 不生成正常/故障判断。
+
 ## 1. 接手先看这三点
 
 主控 → 屏幕：发送文本指令，末尾必须追加三个实际字节 FF FF FF。屏幕 → 主控：用户确认任务后发送固定 6 字节帧 AA 55 01 NN 0D 0A。这两种帧的结束方式不同。
@@ -117,16 +119,16 @@ Program.s 上电通过 printh 发出 00 00 00 FF FF FF 88 FF FF FF。该启动
 | --- | --- | --- |
 | 低压电池电压 | dash.lvbat.val=1260 | 0.01 V/计数；显示 12.60 V |
 | 当前车速 | dash.speed.val=30 | 界面标注 km/h；示例显示 30 |
-| 高压电压 | dash.ts.val=300 | 示例为显示值；电气单位需与主控统一 |
+| 高压电压 | dash.ts.val=300 | 整数 V；BMS 原始 0.1 V 四舍五入 |
 | 扭矩千分 | dash.mct.val=500 | 保留界面“扭矩千分”定义 |
-| 高压电流 | dash.dl.val=20 | 示例为显示值 |
-| 电机温度 | dash.djwd.val=45 | 示例为显示值 |
-| MCU 温度 | dash.mcuwd.val=40 | 示例为显示值 |
-| 最高单体 | dash.dtwd.val=50 | 含义/单位待主控确认，不能仅按控件名猜测 |
+| 高压电流 | dash.dl.val=20 | 整数 A；BMS 原始偏置 uint16 换算后四舍五入 |
+| 电机温度 | dash.djwd.val=45 | 控件支持整数 ℃；当前 MCU 无来源，保持无效 |
+| MCU 温度 | dash.mcuwd.val=40 | 控件支持整数 ℃；当前 MCU 无来源，保持无效 |
+| 最高单体 | dash.dtwd.val=50 | BMS 最高有效实际温度，整数 ℃ |
 
 低压电池电压放在车速上方，保留两位小数。主控若采集为 mV，应先换算为 0.01 V 整数（例如 12600 mV → 1260）。指令 dash.lvbat.val=1260 后仍追加 FF FF FF。该值为全局，切页保留，上电设计初值 0.00 V；初值和断线后的旧值不代表有效测量，也没有自动低压告警。
 
-数值 val 按有符号 32 位整数使用。除新增低压电池电压外，高压电压、电流、温度及“最高单体”的单位、有效范围、无效值和缩放未形成主控协议，接手者应与主控统一。
+数值 val 按有符号 32 位整数使用。当前 CAN 来源、单位、缩放、独立超时和有效颜色已在 [AMI_CAN_DBC说明.md](AMI_CAN_DBC说明.md) 定义。车速、扭矩、电机/逆变器温度尚缺来源或标定，不能把示例值当作测量结果。
 
 ## 页面指令
 
@@ -183,13 +185,13 @@ int ami_set_debug(unsigned id, unsigned state)
 
 ## 已完成与待验证
 
-已完成：USART HMI 编译 0 错误、0 警告；模拟器验证跨页数值更新、正常/故障/未知转换，以及 d1 双位置同步；新增 lvbat 已验证 1260 显示 12.60 V、跨页更新 1185 显示 11.85 V。六个任务回传此前已做模拟检查。待完成：实际屏幕下载、UART 收发、触摸行为、数据时序和车辆安全动作。C 示例仅为驱动接入参考，本次未在目标主控工程中编译。
+已完成：USART HMI 编译 0 错误、0 警告；模拟器验证跨页数值更新、正常/故障/未知转换，以及 d1 双位置同步；新增 lvbat 已验证 1260 显示 12.60 V、跨页更新 1185 显示 11.85 V。六个任务回传此前已做模拟检查。2026-10-03 已通过实物 CAN1 / MCU / USART2 / COM4 到官方 HMI 调试器联调，含六个任务确认/取消、失效和恢复。待完成：物理屏幕下载、实物触摸与完整时延、CAN2 接线和车辆安全动作。C 示例仅为驱动接入参考，本次未在目标主控工程中编译。
 
 ## 8. 工程版本与资料
 
 配套 AMI.HMI 的 SHA-256：
-c667e115e3a7c8c1fd08e9c135d101c4d5bb1d3fe4b3f46ca80a85e860a06d1f
+8a37e4961f90671f04e55ba94c173ae8fbfc5e30c2a3e74a2c37148157c3d16d
 
-旧版工程不能与本版 dN 接口混用。配套文件包括 AMI.HMI、PDF、通讯交接文档.md 和 ami_debug_send.c；其中 Markdown 为可编辑文字源，C 文件为参考发送函数。仓库中的实际位置见 README。
+旧版工程不能与本版 dN 接口混用。配套文件包括 AMI.HMI、AMI.dbc、DBC 说明、通讯交接文档.md 和 ami_debug_send.c；旧 PDF 保留为 v1.2 历史资料，其中 Markdown 为可编辑文字源，C 文件为参考发送函数。仓库中的实际位置见 README。
 
 官方协议依据：wiki.tjc1688.com/commands/index.html；wiki.tjc1688.com/return/index.html；wiki.tjc1688.com/variables/bkcmd.html。项目自定义任务帧和 dN 编号以本文及配套工程为准。