# AMI

YMR A11 仪表，使用淘晶驰 TJC4827X543_011 串口屏，分辨率 480 × 272。

当前通讯协议为 **v1.2（新增低压电池电压）**，工程使用 USART HMI 1.68.1.3037 编辑、编译。

## 工程与交接资料

- [AMI.HMI](AMI.HMI)：最新版屏幕工程，打开后编译并下载到对应型号屏幕。
- [通讯交接文档](docs/通讯交接文档.md)：可编辑协议说明，包含全部状态编号、任务帧、主页面属性及联调步骤。
- [PDF 文档](docs/AMI仪表通讯交接文档.pdf)：适合直接转交接手者的 5 页版本。
- [C 发送示例](examples/ami_debug_send.c)：主控更新 debug 状态的参考函数。
- [验证说明](docs/验证说明.txt)：已完成检查和实物验证范围。

## 最小通讯示例

主控向屏幕发送 ASCII 指令，每条末尾追加三个实际字节 `FF FF FF`，当前波特率为 `9600`：

```text
d0=1
d1=2
page debug
```

这三条分别将配电箱状态设为正常、左急停及行程/惯性状态设为故障、进入 debug 页面。`d0=1` 的完整字节为 `64 30 3D 31 FF FF FF`。

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)。