Files
AMI/docs/TJC8048X370移植说明.md
T

4.6 KiB
Raw Blame History

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。将此 .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/,包含 编译日志、模拟器记录、文件清单与哈希、属性回读和页面截图。

主页面模拟效果

DEBUG 正常状态模拟效果

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 警告。六种状态、未知、跨页恢复、任务确认保留实际状态均通过官方模拟器检查,详情及当前哈希见 无人状态验证报告。实物屏幕尚未下载。

新增无人状态模拟效果