工业串口屏开发指南：迪文DGUS变量驱动架构与串口指令实战

结论先行：工业串口屏真正的价值不在"显示"，而在于把界面从 MCU 代码里剥离出去——屏幕自己管 GUI，单片机只负责改数据。凡是把按钮位置、页面切换、数值格式都写进固件的项目，改一次界面就要重新编译、烧录、送检，代价极高。本文以迪文 DGUS 屏（基于 K600+ 内核）为样本，把变量驱动模型的三个文件、五条串口指令、两种存储空间、CRC16 帧校验与 Modbus RTU 主机模式一次讲透，并给出 MCU 侧可编译的驱动代码，适用于工业数据采集、RTU 远程终端与各类 物联网设备的人机界面开发。

一、变量驱动到底省掉了什么

先看两种做法的差别。传统做法是 MCU 直接驱动液晶，工程师要在固件里维护字库、坐标、页面状态机和触摸判定；变量驱动则把"怎么显示"下沉到屏幕内部的组态配置，MCU 与屏幕之间只剩一条数据通道。这两条路线的工程代价差别很大：

要理解这套模型，记住一句话就够了：屏幕内部把 GUI 拆成一个个"控件"，每个控件绑定一个变量地址，串口改写这个地址，控件显示就跟着变。举例来说，要在某个页面显示两位小数的温度值 25.00，只需两步：先用组态软件在页面上放一个"数据变量显示"控件，设好字体、颜色、单位、小数位数和数据源地址，通过 SD 卡把生成的 14.BIN 下载进屏；运行时 MCU 只需把温度值周期性地写到那个数据源地址即可，屏幕会自动按预设格式渲染。触摸录入同理，反向操作：MCU 定时读回录入变量的值。

二、屏幕端的三个文件：CONFIG.TXT、13.BIN、14.BIN

DGUS 屏的"配置"全部通过 SD/SDHC 卡完成，卡里放三类文件：

• 图片文件：页面背景图，按页面 ID 命名，屏内以页面为单位组织；
• 字库文件：显示用字库，屏内按字库 ID 划分空间（第 64～127 号字库可由串口指令读取）；
• CONFIG.TXT：唯一的文本配置文件，负责写 R0～RC 等系统寄存器，同时指定下载 13.BIN、14.BIN 等控件文件；
• 13.BIN：触控/键控配置文件，定义每个页面上"哪里可以按、按下后干什么"；
• 14.BIN：显示变量配置文件，定义每个页面上"哪个地址的数据以什么形式显示"。

把这两个 BIN 文件的分工记牢，开发流程就顺了：13.BIN 管输入，14.BIN 管输出。13.BIN 覆盖录入类交互，包括变量数据录入（0x00）、弹出菜单（0x01）、增量调节（0x02）、拖动调节（0x03）、RTC 设置（0x04）、按键值返回（0x05）、文本录入（0x06，分 ASCII 与 GBK 汉字）与硬件参数配置（0x07）；14.BIN 覆盖显示类控件，分图标类（0x00～0x06，含动画图标、滑块刻度、位变量图标等）、文本类（数据变量 0x10、文本 0x11、RTC 0x12、HEX 变量 0x13）与图形类（实时曲线 0x20、基本图形 0x21、列表 0x22）。

工程上最容易踩的坑是：14.BIN 里变量的高字节写 0xFF 可以临时取消本条显示指令，这是做"显示开关"的官方手段，比改地址更省事。

三、串口数据帧：5 个数据块，5 条指令

DGUS 的串口协议非常克制——一共只有 5 条指令，因为屏幕的工作模式和 GUI 状态完全由数据变量控制，串口只需对变量和寄存器做读、写。数据帧固定由 5 个数据块组成：

五条指令的功能与寻址方式如下。注意两种存储空间寻址单位不同，这是写代码时最容易出错的地方：

以几个真实帧为例，方便直接对照调试。切换显示页面到第 5 页，是往寄存器 0x03（PIC_ID）写 0x0005；把背光调到 100%，是往寄存器 0x01（LED_NOW，范围 0x00～0x40）写 0x40：

切换页面到第5页   5A A5 06 80 03 00 05 19 E7
背光调至100%      5A A5 05 80 01 40 70 48
写VP 0x1000=2500  5A A5 07 82 10 00 09 C4 5F 1D
读VP 0x2000起4字  5A A5 06 83 20 00 04 29 A9
读寄存器0x00起16B 5A A5 05 81 00 10 20 24   <-- 数据手册原例

其中 5A A5 05 81 00 10 20 24 是数据手册中给出的原始示例，最后两字节 20 24 就是 CRC 校验值，本文后面用同一套算法复算过，结果一致——这一点很重要，说明校验范围确实只覆盖"指令+数据"，不含帧头与长度字节。

四、两种存储空间：256 字节寄存器 vs 28K 字变量存储器

新手最容易混淆的就是"寄存器"和"变量存储器"这两个词。它们在 DGUS 里是两块完全不同的空间：

常用的运行态寄存器值得单独列一下：0x01 是 LED 亮度（0x00～0x40）；0x03 读为当前页面 ID、写为切换页面；0x05 是触摸标志，0x5A 表示触摸坐标有更新，用户读取后必须清零，否则触摸数据不再刷新；0x06 是触摸状态（0x01 第一次按下、0x03 一直按压、0x02 抬起）；0x07 是 4 字节按压坐标；0x20 起 16 字节是 RTC（年月日星期时分秒 + 农历 + 天干地支 + 生肖）；0xEE 写 0x5AA5 会让屏复位一次。

五、CRC16 校验与 MCU 侧完整代码

DGUS 的帧校验采用 ANSI CRC-16（生成多项式 X16+X15+X2+1，即 0x8005 反射形式 0xA001），初值 0xFFFF，低字节在前。是否启用由 R2.4（FCRC）决定，是否自动应答校验结果由 RC.3（CRC_ACK_EN）决定——启用应答后，屏幕会在校验完成时回一帧"帧头+02+原指令与数据+（0xFF 表示校验正确 / 0x00 表示错误）+CRC"。

下面这段代码把 CRC 计算和变量写入封装在一起，已在 8 位/32 位 MCU 上通用（不含串口收发底层）：

#include <stdint.h>

/* ANSI CRC-16：多项式 0xA001(反射)，初值 0xFFFF */
static uint16_t dgus_crc16(const uint8_t *p, uint16_t n)
{
    uint16_t crc = 0xFFFF;
    while (n--) {
        crc ^= *p++;
        for (uint8_t i = 0; i < 8; i++)
            crc = (crc & 1) ? (crc >> 1) ^ 0xA001 : (crc >> 1);
    }
    return crc;
}

/* 向变量地址 vp 写入 len 个字（字按高字节在前排列） */
void dgus_write_vp(uint16_t vp, const uint16_t *w, uint8_t len)
{
    uint8_t buf[8 + 128];
    uint8_t n = 0;
    uint16_t c;

    buf[n++] = 0x5A;  buf[n++] = 0xA5;      /* 帧头 R3:RA */
    buf[n++] = 3 + len * 2 + 2;             /* 长度 = 指令+VP+数据+CRC */
    buf[n++] = 0x82;                        /* 写变量存储器 */
    buf[n++] = vp >> 8;  buf[n++] = vp & 0xFF;
    for (uint8_t i = 0; i < len; i++) {
        buf[n++] = w[i] >> 8;
        buf[n++] = w[i] & 0xFF;
    }
    c = dgus_crc16(&buf[3], 1 + 2 + len * 2);  /* 校验不含帧头与长度 */
    buf[n++] = c & 0xFF;                    /* 低字节在前 */
    buf[n++] = c >> 8;
    uart_send(buf, n);
}

用这段代码验证数据手册原例：对 81 00 10 三个字节求 CRC，得到 0x2420，低字节在前即 20 24，与手册完全一致。调试阶段建议先把 CRC 关掉（R2.4=0）跑通通信，再打开校验，否则一个字节顺序搞反就会表现为"屏幕毫无反应"，很难定位。

六、配置寄存器速查（R0～RC）

这些参数全部写在 CONFIG.TXT 里，由 SD 卡一次性烧入，运行时不建议改动。它们是项目量产前必须确认的项：

波特率那一项值得多看一眼：出厂 115200bps 在多数场合够用，若要频繁刷趋势图或传长文本，可按 R5:R9 = 6250000 / 目标波特率 自算。比如 10000bps 对应 R5:R9 = 625 = 0x0271，即 R5=0x02、R9=0x71。反过来，若屏幕偶发丢帧，先怀疑波特率误差而不是线材。

七、把屏幕当网关：Modbus RTU 主机模式

当系统里已有 Modbus 设备（PLC、仪表、变频器）时，可以让 DGUS 屏直接当 Modbus 主机，省掉一颗 MCU。迪文提供专用升级程序 DGUS_V63_MODBUS.BIN（对应 DGUS V6.3，支持 K600+ 内核），刷入后用户接口指令集变为 Modbus RTU 主机模式，不再支持标准 DGUS 指令集。其配置存放在 22.BIN 字库的 20KW～28KW 区间，最多支持 1023 条 Modbus 指令，每条指令的字段如下：

支持的功能码与数据长度换算关系见下表。这里有一个必须记住的坑：Modbus 的位（线圈）变量按 LSB 定义，而 DGUS 按 MSB 定义，做位变量映射时要逐位翻转，否则读回来的状态整片错位。

八、现场踩过的几个坑

最后把工程上反复出现的问题归拢一下，都是文档里写得不显眼、但现场一定会遇到的：

• 触摸标志读后不清零：0x05 寄存器读出 0x5A 后必须由用户软件清零，否则触摸坐标从此不再更新，表现为"屏幕卡死"，实际只是标志没清。
• 变量地址没规划：28K 字空间看似很大，趋势图、列表、多语言文本一起吃很容易撞车。建议按"系统保留 / 页面显示 / 录入回读 / 历史缓存"分段，组态阶段就写成表。
• 多屏并联没改帧头：同一路 485 上挂多块屏，必须用 R3:RA 把帧头设成不同值当设备地址，否则会同时响应。
• SD 卡没锁、字库越界：量产后应在 CONFIG.TXT 里禁止 SD 接口（注意锁定后不先解锁就无法校准触摸屏）；用寄存器 0x40～0x49 读字库时须满足 Lib_Address + OP_Length ≤ 0x020000，越界不报错、只出错数据。

九、小结

变量驱动架构的本质是把"界面"从固件里搬进了屏幕，MCU 与屏之间只剩一条极简的数据通道——5 条指令、两种空间、一套 CRC16。掌握这套模型后，改界面不再需要动 MCU 代码，多语言、多页面、趋势图都变成组态工作。

落地时记住三句话：界面归屏幕，数据归 MCU；寄存器管硬件，变量存储器管显示；通信先跑通再开 CRC。本文基于《迪文 DGUS 屏用户开发指南》（Ver4.1）等资料整理优化。