大彩讲堂：VisualHMI软件如何使用二维码控件

发布人：大彩科技发布日期：2026-03-13

一、概述

本文档适合于 M 系列（固件版本 >= V10.0.7.0）串口屏，在VisualHMI平台上开发。

二维码可以通过【二维码控件】来显示。用户可以通过串口指令来更新二维码显示的内容，常用于商品支付、或者用户售后服务的入口链接等等。

二、开发环境

2.1 VisualHMI 软件版本
需安装V1.0.270.0及以上的版本进行开发。打开VisualHMI软件，在工程→帮助→关于，可查看到当前安装的软件版本，如图2-1所示；

图2-1 VisualHMI软件版本

2.2 串口屏固件版本

版本查看，可通过屏幕背面的贴纸查看。

三、仪表指针

3.1 属性说明

选中菜单栏→控件→【二维码控件】，如图3-1所示。

图3-1 二维码控件

3.1.1基本属性

二维码控件的功能属性如图3-2所示。

图3-2 基本属性

1. 读取地址：控件所绑定的变量地址；

2. 文本长度：显示内容的字符串最大长度，默认为“16”；如，显示二维码内容为“https://www.baidu.com/”，寄存器地址为 0x1001。即0x1001~0x1010，共16个寄存器分配给二维码内容显示，一个地址显示2个字符，最多显示32个字符。如下所示：

3.1.2 外观属性

二维码控件外观属性如图3-3所示。

图3-3 二维码控件外观属性

1. 错误纠正：最高（30%）；较高（25%）；中等（15%）；最低（7%）

二维码的容错能力，具有纠错功能。若二维码因屏幕污损等引起局部遮掩时，仍可以被扫码识别。

四、应用案例

4.1 工程配置

在画面中添加一个【二维码控件】，用于读写控制，控件配置如图4-1所示：

1. 读取地址：LW1001；

2. 文本长度：32；

图4-1 设置属性

4.2 运行预览

假设创建的虚拟串口对为COM1和COM2。运行虚拟屏，VisualHMI软件和虚拟屏用“虚拟串口”建立联机。如图4-2所示

图4-2 联机

打开指令助手，读写 LW1001 地址的操作，如图4-3所示：

1. 协议配置：和工程通讯协议对应。DCBUS；帧头：AA55；启用CRC：是；站号：0；

2. 指令配置：

· 写变量：如地址为 LW1001，地址栏填入1001，对地址 https://www.baidu.com/的16进制assic“68 74 74 70 73 3A 2F 2F 77 77 77 2E 62 61 69 64 75 2E 63 6F 6D 2F 00”。点击发送，屏幕实时显示状态；

PS： MUC 设置二维码控件时候，要以 0x00 结尾

· 读变量：如地址为 LW1001，地址栏填入1001。点击发送，屏幕会返回 LW1001地址状态的指令；

图4-3 模拟运行