第八章 ApusTAI 常见问题

常见问题先按现象定位，再核对当前工程和目标设备。

常用排查入口

• 掉电保存：通过 RW 掉电保持区保存变化后的设置值。
• 模拟器和串口调试：核对协议、串口参数、地址与收发记录。
• 串口下载工程：确认端口、设备型号和工程编译结果。
• 查看版本：区分 IDE 版本、工程配置和设备固件。

只靠 IDE 预览无法判断实体屏的接线、固件或通信结果；现场问题应同时记录设备型号、固件、工程协议和复现步骤。

串口有 RX，Lua 却收不到

1. 模拟器主口应选择“工程通信”，并打开正确 COM；“手动调试”的数据不会交给工程 Lua。
2. 接收回调必须定义为全局 on_uart_recv(channel, packet, length)。主口判断 channel == 0，独立第二口判断 channel == 3。
3. 第二口需先成功执行 uart_setup(3, ...)；模拟器还需在启动前配置独立的 STT_SIM_UART3。
4. 先打印通道和长度，确认接收到字节，再检查拼帧。一次回调可能是半帧或多帧，length 不一定等于协议帧长。
5. 到串口副屏的“运行日志”查看脚本加载、语法和回调异常。Lua print() 不需要连接 COM，也不会发送到串口。

完整示例见自由协议教程和双串口接口说明。

脚本一直发送，怎样暂停

set_run_cycle(0) 不表示停止；当前按 10 ms 周期执行。具体示例见定时器函数。

主站离线输入的数值，是否已经写入 PLC

没有。新版屏端与模拟器均可先更新 HMI 本地缓存和控件显示，再投递主站写入命令。离线输入只说明本地值已改变；连接设备后仍要检查应答或读回，不能把控件显示当作 PLC 已执行证明。

串口下载出现 BEGIN/STORAGE

它表示屏端在开始传输时无法初始化升级存储。重点核对 /data 挂载、可用空间、升级临时目录创建或清理、以及存储写入错误。记录完整屏端日志和上位机返回内容；单独的 BEGIN/STORAGE 不能按签名密钥错误处理。

SD 升级出现读卡报错

日志中的 drto=1 表示数据读取超时，不能仅凭它断定是文件格式、频率或某个元件损坏。若更换卡后恢复，优先保留该卡作对比测试，生产使用已验证稳定的卡。

升级后花屏、黑屏或误进下载页

1. 核对实际刷入的镜像目录与屏幕型号、分辨率和硬件配置，尤其区分两款 1024×600 镜像。
2. 确认实际生效的固件与 Bootloader 版本；文件名相同不代表内容或型号相同。
3. 记录从上电到异常的完整启动日志，并注明工程是否先显示、是否插卡、是否连接上位机。
4. 新版只有收到合法下载意图的 CONNECT 才应进入串口下载页。没有下载握手却自动进入时，应按异常排查；工程启动错误页与下载页需区分。

各尺寸固件使用固定名称和固定地址，日期记录在仓库提交说明中。下载入口见协议资源与示例。请下载原始 xtt_upg_v2025.img 文件，不要把网页另存成 IMG。

反馈问题时需要哪些信息

请提供屏幕完整型号与触摸类型、IDE/模拟器/固件版本、工程文件、实际镜像路径、复现步骤、完整启动或串口日志。协议问题另附串口参数、站号、地址类型和原始收发字节；日志尽量从异常前开始保留。