6.2 XGUS

XGUS 用于主控板读写屏幕变量。本节以“海岸泵站”演示写入设定、读取水温和屏幕主动上传。

核心功能

• 变量读写与连续多字传输。
• 屏幕操作自动上传、写命令应答。
• CRC 校验与画面切换。

1. 参数设置

在 工程 → 设置 → 工程设置 中配置通信参数。

波特率、数据位、校验位、停止位和接收回调统一见 6.1 DCBUS；本章串口联调使用 115200、8N1。

2. 应用

下载本节工程 · 6.8 示例下载

1. 打开 SeasideXGUS.apustai，编译并运行。
2. 模拟器串口副屏选择 工程通信，打开 COM2。
3. 联调助手选择 XGUS，打开 COM3，CRC 保持关闭。
4. 点击“写入设定”，屏上转速变为 70；点击“读取”，返回水温 25。
5. 在屏上切换低速、高速，观察助手收到的上传报文；用助手按钮测试水泵启停。

地址中的数字及下列报文字节均为十六进制；画面显示的 25、40、70 为十进制数值。

3. 报文说明

以下以水温值 9 演示；工程初始值为 25。先写入 9，再核对对应读应答。

3.1 帧格式和长度

XGUS 变量读写报文没有站号字段。

每个字占 2 字节，高字节在前。批量数据按起始地址连续存放，地址每增加 1 表示下一个字。

总帧长均为“长度字段 + 3”字节。CRC 关闭时单次读取 1～125 个字、写入最多 126 个字；开启时单次读取 1～124 个字、写入最多 125 个字。最后一个地址不能超过 0xFFFF。

3.2 单字写入与读取

在串口工具中选择十六进制发送。主板给水温控件写入 9：

主板 → 屏幕：A5 5A 05 82 10 14 00 09
屏幕 → 主板：A5 5A 03 82 4F 4B

第二行仅在工程设置开启“写命令应答”时返回，4F 4B 是字符 OK。屏幕处理写入后，绑定 LW1014 的水温控件显示数值 9。

主板读取 LW1014，假设当前值为 9：

主板 → 屏幕：A5 5A 04 83 10 14 01
屏幕 → 主板：A5 5A 06 83 10 14 01 00 09

请求中的 01 表示读 1 个字，应答中的 01 后面跟随该字的数据 00 09。读取会返回读应答，不要求开启“自动上传”或“写命令应答”。

给转速设定 LW1016 写入 9，只需将地址改为 10 16：

主板 → 屏幕：A5 5A 05 82 10 16 00 09

3.3 连续多字收发

下面一次写入 3 个连续地址：LW1014=9、LW1015=0、LW1016=9。LW1015 是两个控件地址之间的字，也包含在本次写入中。

主板 → 屏幕：A5 5A 09 82 10 14 00 09 00 00 00 09
屏幕 → 主板：A5 5A 03 82 4F 4B

再从 LW1014 起读取 3 个字：

主板 → 屏幕：A5 5A 04 83 10 14 03
屏幕 → 主板：A5 5A 0A 83 10 14 03 00 09 00 00 00 09

写指令没有独立的字数字段，字数由长度计算；读请求的 03 才是读取字数。CRC 关闭时，以上报文到最后一个数据字节结束。

3.4 屏幕操作后的自动上传

在工程设置中开启“自动上传”。用户在屏幕上将转速设定 LW1016 改为 9，屏幕可主动发送：

屏幕 → 主板：A5 5A 06 83 10 16 01 00 09

自动上传使用 83，结构与读应答相同；主板按地址、字数和数据解析。“自动上传”控制屏幕操作后的主动发送，“写命令应答”控制主板写入后的确认，两项分别设置。

3.5 开启 CRC 时的收发

工程与主板同时启用 CRC。使用 CRC16：初值 0xFFFF，右移多项式 0xA001；从功能码开始，计算到最后一个数量或数据字节，不包含帧头、长度字段与 CRC 自身。结果低字节先发、高字节后发。

开启 CRC 后，在原报文末尾增加 2 字节，并将长度字段加 2。例如水温值 9 的报文为：

第一行的 CRC 计算输入为 82 10 14 00 09，结果是 0xDCD8，线上发送 D8 DC。更改功能码、地址、字数或数据后，须重新计算 CRC。

3.6 两种翻页模式

在工程设置中选择对应的 XGUS 模式，按该模式发送翻页指令。下面均切换到画面 2，目标画面须存在于工程中。

模式 1 中，03 表示切页操作，00 02 为画面 ID。模式 2 中，00 84 为翻页入口，5A 01 为切页标记，00 02 为画面 ID；开启“写命令应答”时，该 82 指令处理成功后返回写成功应答。

也可以使用普通变量写指令向画面寄存器 LW0100 写入画面 ID。CRC 关闭时，切到画面 2 的报文为 A5 5A 05 82 01 00 00 02；切换完成后，LW0100 可读回实际主画面 ID。

4. 常见问题

6.8 示例下载 · 6.1 DCBUS