diff --git a/AMI.HMI b/AMI.HMI index 98fc114..dcb991e 100644 Binary files a/AMI.HMI and b/AMI.HMI differ diff --git a/README.md b/README.md index 16a10de..cea076b 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ YMR A11 仪表,使用淘晶驰 TJC4827X543_011 串口屏,分辨率 480 × 272。 -当前通讯协议为 **v1.1(debug 数字状态版)**,工程使用 USART HMI 1.68.1.3037 编辑、编译。 +当前通讯协议为 **v1.2(新增低压电池电压)**,工程使用 USART HMI 1.68.1.3037 编辑、编译。 ## 工程与交接资料 @@ -26,12 +26,22 @@ page debug Debug 共 16 个全局变量 `d0~d15`,状态统一为 `0=未知、1=正常、2=故障`。页面每 250 ms 自动更新文字和颜色,`d1` 同时更新两个对应位置。不要继续直接写入旧接口的 `debug.tN.txt/pco`,它们会被刷新脚本覆盖。 +Dash 车速上方新增低压电池电压,显示两位小数,单位 V: + +```text +dash.lvbat.val=1260 +``` + +每条末尾同样追加 `FF FF FF`。数值单位为 **0.01 V**,示例显示 **12.60 V**;若主控采集值为 mV,先除以 10 换算。该控件为全局,可跨页面更新;上电显示初值 0.00 V,没有自动低压告警。 + 主页面右上角隐藏热区进入 debug;debug 的返回按钮切回主页面。六个任务按钮进入确认页,确认后屏幕向主控发送 `AA 55 01 NN 0D 0A`,`NN=01~06`;取消不发送任务帧。任务帧结束符与主控发给屏幕的文本指令结束符不同。 ## 验证与接手事项 工程编译通过:0 错误、0 警告。模拟器已验证状态转换、跨页更新和 `d1` 双位置同步;任务回传此前已做模拟检查。 +新增低压电压已在模拟器验证 `1260 → 12.60 V`,并验证在 debug 页更新 `1185` 后返回 dash 显示 `11.85 V`。 + 实际屏幕、串口和主控尚未联机验证,C 示例尚未在目标主控工程编译。主页面部分数值的单位和缩放仍需与主控统一。任务执行裁决、VCU 通知、EBS 灯及 ECUBACK 安全输出由主控实现;仪表显示不能作为执行成功或安全回路导通的证明。 许可证沿用仓库中的 [AGPL-3.0](LICENSE)。 diff --git a/docs/AMI仪表通讯交接文档.pdf b/docs/AMI仪表通讯交接文档.pdf index 9b34ee3..c3e4c4a 100644 Binary files a/docs/AMI仪表通讯交接文档.pdf and b/docs/AMI仪表通讯交接文档.pdf differ diff --git a/docs/通讯交接文档.md b/docs/通讯交接文档.md index 558f2f7..7f57e82 100644 --- a/docs/通讯交接文档.md +++ b/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。 diff --git a/docs/验证说明.txt b/docs/验证说明.txt index 8147f88..b93d745 100644 --- a/docs/验证说明.txt +++ b/docs/验证说明.txt @@ -1,4 +1,4 @@ -精简数字接口版:d0-d15,0未知/1正常/2故障;tm0=250ms。 -编译0错误0警告,模拟器通过跨页更新、三态显示、d1双位置同步。 +协议v1.2:新增dash.lvbat.val,0.01V/计数,显示两位小数;d0-d15保持不变,tm0=250ms。 +编译0错误0警告;模拟器验证1260显示12.60V、跨页1185显示11.85V;此前通过debug三态显示及d1双位置同步。 真实屏幕及主控串口未联机验证。 主控C示例尚未在目标工程编译。