# TJC8048X370_011 移植说明

日期：2026-10-07。

本版本将 AMI 的 480×272 界面适配至 TJC8048X370_011（X3 系列、7 寸、800×480）。原工程 `AMI.HMI` 保留，新工程为根目录的 `AMI_TJC8048X370_011.HMI`。

## 工程与资源

- 编辑器：USART HMI 1.68.1.3037。
- 页面：`dash`、`debug`、`CONFIRM`。
- 字库 ID 2：32 像素、GB2312 中文；用于任务按钮、状态与参数。
- 字库 ID 3：96 像素、ASCII；用于车速数字。
- 字库 ID 4：24 像素、GB2312 中文；用于 DEBUG 回路框中的长标签。
- 绘图脚本另存于 `scripts/hmi/TJC8048X370_011/`，原 480×272 脚本保留。

主页面保留左侧六个任务按钮、中间车速及 VCU 实际任务/锁定状态、右侧车辆参数及 EBS 状态。DEBUG 保留原回路顺序和十五路映射，坐标与文字区域按新分辨率调整。确认页按钮和触摸范围同步放大。

## MCU 接口

保留现有控件名称、ID、作用域、数值缩放及定时器参数。换屏本身不要求修改 MCU 固件。

- 串口：9600、8N1，`recmod=0`。
- MCU → 屏幕：原 ASCII 属性指令，末尾三个真实字节 `FF FF FF`。
- 屏幕 → MCU：确认任务后输出 `AA 55 01 NN 0D 0A`，`NN=01..06`；取消不发送任务帧。
- `dash.lvbat.val=1260` 仍表示 12.60 V。
- DEBUG `d0..d15` 仍使用 0=未知、1=正常、2=故障。
- 确认发送只提出任务请求，实际任务仍由 VCU 状态反馈更新。

CAN 协议和信号单位继续以当前 DBC 与 `通讯交接文档.md` 为准。

## 下载与实物验收

下载文件为 [`AMI_TJC8048X370_011.tft`](../output/hmi/AMI_TJC8048X370_011.tft)。将此 `.tft` 下载至对应屏幕。先按屏幕完整型号及规格书确认供电、触摸版本和 UART 电平/接口模式，再连接 MCU；工程型号选择不证明实际接线正确。

实物验收应检查：上电页面、六个任务按钮确认/取消、DEBUG 入口/返回、跨页数值更新、正常/故障/未知转换、低压电压小数、车速与状态反馈、重连恢复。模拟器结果只证明模拟界面和脚本行为，不能代替实物 UART、触摸及时延验证。

## 初始移植验证结果

- 编译通过：0 错误、0 警告，TFT 大小 8,862,596 字节。
- 属性回读通过：控件 ID、名称、作用域、数值缩放、定时器参数和确认事件保持原接口，控件均在 800×480 范围内。
- 模拟器触摸验证通过：六个任务分别回传 `AA 55 01 01..06 0D 0A`，取消无任务帧，确认请求不改变 VCU 实际任务。
- 模拟器跨页验证通过：在 DEBUG 页更新 `dash.lvbat.val=1185` 和 `current_task=6`，触摸返回后显示 11.85 V、手动驾驶；数值查询与页 ID 回传正确。
- DEBUG 的未知/正常/故障三种状态均完成截图及各状态控件像素颜色检查；长标签与底部状态完整可见。主页面数值、任务/锁定/EBS 状态和确认页完成视觉检查。
- 原始 `AMI.HMI` 的 SHA-256 与移植前一致。新 HMI 和 TFT 哈希见下方清单。
- 尚未下载至实物屏幕，实物 UART、触摸及时延待验收。

证据目录：[`docs/evidence/2026-10-07/tjc8048-migration/`](evidence/2026-10-07/tjc8048-migration/)，包含 [编译日志](evidence/2026-10-07/tjc8048-migration/compile-final.log)、[模拟器记录](evidence/2026-10-07/tjc8048-migration/simulator-results.json)、[文件清单与哈希](evidence/2026-10-07/tjc8048-migration/manifest.json)、属性回读和页面截图。

![主页面模拟效果](evidence/2026-10-07/tjc8048-migration/dash-sample.png)

![DEBUG 正常状态模拟效果](evidence/2026-10-07/tjc8048-migration/debug-normal.png)

## 2026-10-07 无人状态扩展

当前 800×480 工程的屏幕接口升级为 1.5。在锁定状态右侧增加无人状态；`sd` 调整为宽 115、24 像素字库 ID 4，新增状态由 `xstr` 在 x=330、y=379、w=174、h=53 区域绘制，不改变原控件 ID。全局变量 `as_state` 上电为 6（未知），0..5 分别为 AS OFF、AS Ready、AS Driving、AS Finished、AS Emergency、Manual Driving。后初始化与 100 ms 定时器按变化更新，切页后重绘。

新增状态需要配套 v2.7 MCU 的 `0x183` 版本 2 解码；初始移植的“换屏不要求修改 MCU”仅适用于未增加状态的原接口。最新版 HMI/TFT 与初始移植哈希不同；当前 TFT 为 8,863,680 字节，编译 0 错误、0 警告。六种状态、未知、跨页恢复、任务确认保留实际状态均通过官方模拟器检查，详情及当前哈希见 [无人状态验证报告](无人状态显示验证报告.md)。实物屏幕尚未下载。

![新增无人状态模拟效果](evidence/2026-10-07/as-status/dash-as-ready-sample.png)