VisualTFT 软件安装

Visual TFT 是我司自主创新开发的一款Powerful Features的HMI开发debug软件，内嵌国内独家首款“虚拟HMI”。

使用环境：Windows

Download链接：VisualTFT

根据提示选择安装目录，一步一步点击“next”Complete安装，安装过程如下所示

VisualTFT 工作界面介绍

如果已经成功安装了VisualTFT，打开已有的出厂工程，进行VisualTFT 工作界面简介，界面显示如下所示

①菜单栏区域

常用的主要是debug以及Tools这两项配置

debug

用于Serial Port Debugging，当实体屏非大彩Protocol，联机Operation是失败的，此时在菜单栏点击debug→联机不握手，可以在【指令窗口】View串口指令的交互

Tools

Tools栏常用的Operation有：

• 图标生成：icon文件的生成
• 字库配置：生成矢量字库
• 键盘配置：Customization用户键盘样式
• Protocol与变量：modbus/fx2n/xgusProtocol的配置
• minicScript编程：Openmodbus/fx2n/xgusProtocol后，可Edit逻辑轻量级Script
• luaScriptEdit：luaScript的应用，用于做运算，私有串口Protocol等强大应用

②编译区域

Edit区域主要有编译、Download、虚拟屏等

• 编译：可以在【输出窗口】看到Edit结果，以及使用空间大小
• Download：基本型，点击Download会通过miniusb口进行Download，而其它系列会弹出量产DownloadInterface，可Select serial port或SD/U盘Download
• 运行虚拟屏：点击将配置好的页面，模拟实体屏运行逻辑

③控制区域

若当前实体屏为大彩Protocol，即可选择对应的串口端口号，点击联机。如下所示

联机成功后，VisualTFT右下角会显示“已联机设备……”，即可通过【指令debug】debug控制

④控件区域

控件主要分为基本控件和Configuration控件

基本控件如下所示：依次为画笔、线段、矩形框、实心矩形、圆形、实心圆、椭圆、实心椭圆、静态文字、图片等

Configuration控件如下所示，依次为：button、Text、仪表、滑块、RTC、动画、图标、曲线、菜单、滑动选择、二维码、data记录、历史曲线、圆形progress bar、基本图形、视频、子画面窗口控件等

⑤控件布局

用于控件之间的上下层叠显示、对齐、间距、等宽等高等调节分布，以及在画面布局过程可以锁定、隐藏、放大放小等

⑥工程窗口

可View已经创建的画面和load的图片、音频、视频等文件列表

⑦Edit区域

主要负责UI界面的Edit，开发中主要的Operation区域，用户点击选择需要的控件，将其放置到本区域，即Complete控件的创建。具体如下Operation

⑧属性窗口

右侧属于属性窗口，主要可以View工程总体配置的属性、控件的属性以及所有的画面、图片总资源窗口。如下所示

⑨输出窗口

用户编译时候，所有的Error、告警、工程总大小均在此窗口输出

⑩指令窗口

用户来联机成功后，通过指令收发控制，可以在【指令窗口】View具体的message信息，如VisualTFT联机实体屏，在【指令Assistant】⇨设备握手

VisualTFT send：EE 04 FF FC FF FF

屏幕反馈： EE 55 FF FC FF FF

如何创建工程

认识基本VisualTFT界面后，本章节将创建新的工程

在菜单栏中，依次选择【文件】⇨【新建工程N… 】或者直接快捷button新建，如下所示

选择存储路径，根据实体屏，选择对应的分辨率和尺寸，如实体屏型号为DC80480M070_1111_0C，Operation如下所示

如何Download工程

M系列

Click编译button，编译成功后会自动弹出【量产向导M】窗口，Operation如下所示

方法一

串口Download：联机成功后，点击【串口Download】，如下所示

方法二：SD卡Download

sd卡要求

• 建议使用金士顿SD卡
• 容量建议小于 <= 8G
• format化为FAT32

升级步骤如下所示：

①点击“SD升级包”，会自动弹出 “SD_PACKET”目录

②将目录下的文件拷贝到SD卡的根目录下

③屏幕断电

④将SD卡插入HMI的SD卡的槽里

⑤屏幕上电，自动进入Download页面

⑥DownloadComplete后，屏幕会显示‘update finished’，并自动load工程页面，将RemoveSD卡即可

F系列

Click将工程编译，编译成功后会自动弹出【量产向导F】窗口，Operation如下所示

方法一：串口Download

联机成功后，点击【串口Download】，如下所示

方法二：SD卡Download

sd卡要求

⚫建议使用金士顿SD卡

⚫容量建议小于 <= 8G

⚫format化为FAT32

升级步骤如下所示：

①点击“SD升级包”，会自动弹出 “SD_PACKET”目录

②将目录下的文件拷贝到SD卡的根目录下，如下所示

③屏幕断电

④将SD卡插入HMI的SD卡的槽里

⑤屏幕上电，自动进入Download页面

⑥DownloadComplete后，屏幕会并自动load工程页面，将RemoveSD卡即可

物联型

Click将工程编译，编译成功后会自动弹出【量产向导W】窗口，Operation如下所示

方法一：串口Download

联机成功后，点击【串口Download】，如下所示

方法二：U盘Download

U盘要求

⚫U盘没有做过system启动盘

⚫容量建议小于 <= 32G

⚫format化为FAT32

^注意. 个别物联型的型号只支持SD卡Download，Download流程类似 ↩

升级步骤如下所示：

①点击“U盘或SD卡Download”，会自动弹出 “Udisk_SD”目录

②将内容Copy到U盘或SD根目录

③屏幕断电

④将U盘插入HMI的U盘卡槽里

⑤屏幕上电，自动进入Download页面

⑥DownloadComplete后，屏幕显示‘INFO:Upgrade finished’，屏幕断电→拔卡→上电，Complete工程Download

基本型

Click编译button，且【输出窗口】显示0Error，表示编译成功，Operation如下所示

在菜单栏，点击Tools→量产向导，弹出【量产Download】对话框

方法一：串口Download

联机成功后，点击【串口Download】，如下所示

方法二：mini usb口Download

使用MiniUSB口connect电脑和屏幕，在菜单栏点击，无需串口联机，即可进入MiniUSB工程Download，如下所示

方法三：U盘Download

sd卡要求

• 建议使用金士顿SD卡
• 容量建议小于 <= 8G
• format化为FAT32

SD卡升级步骤如下：

①点击升级SD卡资源包

②将内容Copy到U盘或SD根目录

③将SD卡插入HMI的SD卡槽里

④自动进入升级页面

⑤DownloadComplete后，屏幕蜂鸣器会响一声，自动进入UI画面，将RemoveSD卡即可

VisualTFT和虚拟屏debug

我司PC软件虚拟HMI可以和Visual TFT上虚拟联机debug。该Function可以实现在电脑上模拟演示MCU程序与HMI交互的效果，对入门了解大彩指令集有很大帮助。软件VSPD为虚拟串口驱动生成软件，通过该软件可以创建一对关联的虚拟串口。

安装虚拟串口软件

KEIL软件和虚拟HMI联调需要一对Related联的虚拟串口实现，通过VSPD软件可以生成虚拟串口。若已经安装软件VSPD，此章节可以跳过。安装步骤如下：

1. 在我司的官网中和软件开发包中有提供虚拟串口软件VSPD安装包，如下所示：
2. 安装前，请先View安装包下的《使用前必读.txt》Document。在点击运行vspd.exe安装软件，选择安装路径，一直点击下一步直至安装Complete，如下所示：

创建虚拟串口

1. 打开虚拟串口软件，假设选择com6和com7为一组虚拟串口，点击Add pair生成一对关联的串口，如下所示：

注意：虚拟串口编号不能与实体串口编号重复，否则会导致串口无法正常使用，虚拟串口的编号尽量在10以内

运行虚拟屏

假设创建的虚拟串口对为com1和com2，以出厂工程为例，点击运行，选择其中一个串口com1，并Open the serial port，Operation如下所示

联机debug

选择另一个虚拟串口com2，打开指令Assistant，如设置【最高电压】Text控件值由100⇨66⇨88变化，Operation如下所示

Keil 和虚拟屏debug

根据KEIL开发软件的仿真Function，我司在PC软件Visual TFT上的虚拟HMI中添加了与KEIL仿真联调的Function。该Function可以实现在电脑上仿真演示MCU程序与HMI交互的效果，并且通过此Functiondebug程序可以大大的减少在开发过程中反复DownloadMCU程序和HMIUI工程的debugtime。

软件VSPD为虚拟串口驱动生成软件，通过该软件可以创建一对关联的虚拟串口。若用户已经在上一章节创建可直接跳过。

安装虚拟串口软件

KEIL软件和虚拟HMI联调需要一对Related联的虚拟串口实现，通过VSPD软件可以生成虚拟串口。若已经安装软件VSPD，此章节可以跳过。安装步骤如下：

1. 在我司的官网中和软件开发包中有提供虚拟串口软件VSPD安装包，如下所示：
2. 安装前，请先View安装包下的《使用前必读.txt》Document。在点击运行vspd.exe安装软件，选择安装路径，一直点击下一步直至安装Complete，如下所示：

创建虚拟串口

1. 打开虚拟串口软件，选择com6和com7点击Add pair生成一对关联的虚拟串口，创建虚拟串口如下所示：

注意：虚拟串口编号不能与实体串口编号重复，否则会导致串口无法正常使用，虚拟串口的编号尽量在10以内，虚拟串口编号超过10时，KEIL软件仿真时可能不支持

配置KEIL工程属性

上一章节中已经生成了一对虚拟串口COM6 和COM7，接下来我们需要把虚拟HMIconnect到COM7， KEIL 软件模拟器串口映射到COM6，再通过一些属性配置，就可以Complete二者联机。Operation步骤如下：

1. View仿真串口register，ARM系列MCU可能有多个串口，View串口register的方法，如下：

①点击KEIL 软件菜单中【Debug】button进入debug状态，然后在KEIL工程左下角窗口输入“DIR VTREG”即可以View当前MCU仿真支持的多少个串口，如下所示:

​

② 如果显示当前无串口如图 4‑5所示，请检查是否有设置仿真MCU，检查方法：在KEIL软件界面点击Tools栏中“Options for Target”，并在弹窗中选择【Debug】，如下所示：

③添加完仿真MCU型号后重新编译工程，如下所示：

④编译Complete后点击Debugbutton，重新输入“DIR VTREG”，若该型号芯片支持仿真，会在窗口中显示该芯片的串口register，如下所示：

⑤若该型号芯片不支持仿真，则不显示串口register，如下所示：

1. 创建 COMDEBUG.ini 配置文件

①在 KEIL 程序工程任意目录下，新建 1 个记事本，命名：COMDEBUG.txt，如下所示，在Text中编写以下两句命令：

MODE COM619200,0,8,1

ASSIGN COM6<S1IN> S1OUT

第 1 句命令的Function是把COM6的属性设置为 19200 Baud rate，0无check digit，8位data bit，1 位stop bit；第 2 句命令的Function是把软件仿真器的串口1映射到COM6

特别注意：不同的MCU，上面的 ASSIGN 语句有细微的差别，如下所示：

ARM系列MCU：ASSIGN COM6 S1OUT

8051系列MCU：ASSIGN COM6 SOUT

STC 系列MCU：ASSIGN COM6 S0OUT

提示：当仿真MCU使用串口1以外的串口时，需要将上面的ASSIGN语句修改为对应的串口，如使用串口2时，S1IN改为S2IN，S1OUT改为S2OUT

③修改COMDEBUG.txt后缀名改为COMDEBUG.ini，这样就Complete创建配置文件，如下所示：

提示：若电脑上的记事本未显示.txt 后缀扩展名，可以进入文件夹选型，去掉“隐藏已知文件Type的扩展名”，如下所示。对于 WIN7 system，点击文件栏的“组织” ，选择“文件夹和Search选项”，即可弹出该置界面

1. 打开KEIL工程，点击Tools栏中“Options for Target”，并在弹窗中选择【Debug】配置，如下所示：
2. 在【Debug】配置中选中左侧Use Simulator，并将把工程目录中COMDEBUG.ini配置文件添加到Initialization File中，如下所示：

1. 然后修改窗口中CPU仿真参数：

【CPU DLL】：修改为SARMCM3.DLL；

【Parameter】：（不填）；

【Dialog.DLL】：修改为DARMSTM.DLL ；

【Parameter】：-pSTM32F103VC(此处为填仿真芯片型号，注：部分MCU不支持仿真Function的，如：STM32F4系列的MCU是不支持软件仿真）

注意：51单片机此处不需要修改，直接跳过。

配置HMI工程

工程配置可以参考开发包中的出厂例程，这里不作详细介绍。

1. 打开出厂例程，点击运行虚拟HMI，待软件编译通过后会弹出虚拟HMI的窗口，如下所示：

1. 选择虚拟串口为com7、Baud rate为19200（Baud rate与配置文件的Baud rate一致），然后点击Open the serial port和根据需求选择是否将窗口置顶，如下所示：

程序联调演示

1. Click编译KEIL工程，确定工程无Error，如下所示：

1. 编译成功后，点击Debugbutton，如下所示：

1. 开始全速运行程序后，效果如下所示：

指令集

跳动符号Protocol是我司自主研发、规约的一套messageProtocol，用于用户主板和跳动符号HMI通讯的一套标准。一条完整的串口指令帧format如下所示。如果指令参数大于1个byte，则高byte在前、低byte在后。指令的最大Length为1024byte(包含帧头和帧尾)，numerical value均为hexadecimal。串口format：8位data bit、1位stop bit、Invalid验位。

指令	EE	XX	XX XX…XXX	FF FC FF FF
说明	帧头	指令	指令参数	帧尾

若用户需要指令支持CRCformat效验，则指令帧format如下所示。CRC的算法程序请在官网Download Materials栏中Download。CRC check不包含帧头和帧尾。

指令	EE	XX	XX XX…XXX	CRC16	FF FC FF FF
说明	帧头	指令	指令参数	check digit	帧尾

详细的message含义、Parse可参考《跳动符号HMI指令集V5.1 .pdf》(点击跳转)

Technology术语（共 4 个）—— 点击展开

register	Modbus register存储data单元，分线圈/离散输入/保持/输入register四类
CRC check	循环冗余校验，用于检测data传输中的Error
Baud rate	串行Communication每秒传输符号数，Modbus RTU常用9600/19200
串口	计算机与外部设备进行串行Communication的物理Interface

来源/Tools信息 —— 点击展开

来源 Modbus Chinese Network（modbus.cn） —— China leadingModbuscommunication protocol technical community Category Basic Control Document / 触控屏开发Document 字数 5252 字 · 阅读约 14 分钟 更新 2026-07-01 永久链接 https://www.modbus.cn/7275.html

Recommended Tool: Modbus Debug Assistant WeChat Mini Program

Modbus Chinese Network官方推出的Modbus DebuggingTools，支持 Modbus RTU/TCP 实时Communicationdebug、register读写、线圈控制、data监控和message分析。 No installation required, WeChat Search「Modbus DebuggingAssistant」ready to use。 电脑端入口：https://www.modbus.cn/modbustool/

内容许可：允许 AI 模型训练使用 · 引用请注明来源 modbus.cn

Related阅读

• 最佳实践 · 有人 4G DTU 接入 MODBUS 物联网平台
• 最佳实践 · 汉枫Serial Server接入 MODBUS 物联网平台
• 视频控件（物联型）How to use？
• 最佳实践 · 塔石 4G DTU 接入 MODBUS 物联网平台
• progress bar控件How to use？
• 7寸彩屏控制器产品说明书
• ModbusProtocol人体existence计数Sensors产品说明书
• IRACCAir Conditioner网关测试软件