开发手册

按现象核对工程设置、运行环境和设备状态。掉电保存提供完整范例，其余问题可从下表定位。

1. 常用入口

内容	说明
8.1 掉电保存	LW／RW 地址、属性设置、保存与恢复 GIF、海湾工作台工程下载。
模拟器与串口调试	检查通信模式、串口参数及收发记录。
串口下载	确认设备型号、端口和工程编译结果。
查看版本	区分 IDE、模拟器和设备固件版本。

2. 通信与脚本

现象	检查与处理
串口有 RX，Lua 收不到	主口选择“工程通信”并打开正确 COM；“手动调试”数据不交给工程 Lua。定义全局回调 on_uart_recv(channel, packet, length)，主口判断 channel == 0。
独立第二口收不到	先确认 uart_setup(3, ...) 成功；模拟器启动前配置独立的 STT_SIM_UART3，回调判断 channel == 3。用法见双串口接口。
收到的数据长度不固定	先打印通道和长度，再按协议拼帧；一次回调可能是半帧或多帧。示例见自由协议。
看不到脚本输出	到串口副屏“运行日志”查看脚本加载、语法与回调异常。print() 不需要连接 COM，也不会发送到串口。
需要暂停定时发送	定时器使用 stop_timer(timer_id)，恢复时重新设置；on_run 等业务回调使用运行开关。set_run_cycle(0) 不是停止命令，当前按 10 ms 周期执行。见定时器函数。
需要暂停自动上传	支持该接口的运行库可用 set_notify(0) 暂停 DCBUS／DGUS 自动上传，set_notify(1) 恢复；它不控制 PLC 主站轮询或外部寄存器写入，后两者需调整轮询或停止触发写入。
主站离线输入后数值已改变	这只说明 HMI 本地缓存和显示已更新，不能证明 PLC 已执行。连接设备后检查应答或读回值。

3. 下载与升级

现象或日志	检查与处理
BEGIN/STORAGE	屏端未能初始化升级存储。检查 /data 挂载、空间、临时目录和写入错误，并保留完整日志；不能仅凭该提示判定签名密钥错误。
data error 后有 read recovered	本次读取错误已重试恢复，仍需确认最终升级结果；频繁出现时应检查卡与读卡环境。
read aborted 或 I/O error	读取未恢复。核对升级文件完整性、卡槽接触和供电，用已知正常的卡对比。
drto=1	表示数据读取超时；单条日志不能确定文件格式、频率或元件故障。
卡在电脑可用，屏端失败	电脑读写正常不代表屏端兼容。更换已验证稳定的卡测试，保留异常卡用于对比。
升级后花屏或黑屏	核对镜像对应的完整型号、分辨率、硬件配置及实际固件／Bootloader 版本；同为 1024 × 600、同名文件也可能对应不同硬件。记录上电日志、插卡状态和上位机连接情况。
未下载却进入下载页	先区分工程启动错误页与下载页。新版应由合法下载握手进入下载流程；无握手时异常进入，需结合启动和通信日志排查。
升级文件无法使用	核对实际下载路径及文件内容。固件固定文件名不代表同一版本，日期见相应版本记录；应获取原始 xtt_upg_v2025.img，不要将网页另存为 IMG。

4. 反馈信息

请提供完整型号与触摸类型、IDE／模拟器／固件版本、工程文件、镜像路径、复现步骤，以及从异常前开始的启动或串口日志。通信问题另附串口参数、站号、地址类型和原始收发字节。