Show low-voltage battery voltage on dash and document centivolt input
This commit is contained in:
@@ -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)。
|
||||
|
||||
Binary file not shown.
+8
-5
@@ -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。
|
||||
|
||||
|
||||
+2
-2
@@ -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示例尚未在目标工程编译。
|
||||
|
||||
Reference in New Issue
Block a user