串口在线下载文件功能说明.pdfVIP

串口在线下载文件功能说明

通过串口更新串口屏所需的文件，可以方便的实现文件更新。本文讲述如何通过串口更新

SDWb系列或VTc系列串口屏所需的文件如工程文件、Lua脚本文件、固件等等。

开发调试阶段，使用VGUS开发工具自带的“串口调试工具2”，通过串口在线下载工程文件

和Lua脚本文件。不需要再频繁插拔TF卡，提高开发的效率。

文件传输协议开放，可结合用户主板，实现自主的文件自动更新功能。结合网络实现远程文

件更新功能。

一、快速使用

1.使用环境要求

上位机：需使用2023.05.28及以后版本的VGUS开发工具。

串口屏固件：SDWb系列串口屏固件日期以后支持普通文件下载，固件日期在以后支持“追加文件”下载。

2.串口调试工具2

打开方式：VGUS开发工具→工具→串口调试工具→串口调试工具2（新手推荐）→配置文件

更新→配置文件下载。然后添加所需下载的文件，如图1所示：

图1串口调试工具2界面

串口调试工具2选项设置说明：

串口号：选择所用串口对应的串口号，图1中识别出来的为COM3。

波特率：需要与VGUS开发工具→屏参配置→波特率的设置一致。如果使用Lua脚本修改了

波特率，需要使用Lua脚本中所设置的波特率。

R3：需要与VGUS开发工具→屏参配置→帧头高字节的设置一致。

RA：需要与VGUS开发工具→屏参配置→帧头低字节的设置一致。

CRC校验：需要与VGUS开发工具→屏参配置→CRC16帧校验的设置一致。

3.SDWb串口工作模式设置

SDWb系列串口屏支持串口0、串口1两个串口，都可以用于在线下载，但是需要正确设置串

口工作模式。

3.1串口0工作模式设置

串口0为主串口，使用该串口下载，需要将工作模式设置成“VGUS指令集协议”，其它工作

模式不支持通过串口在线下载文件。详细设置方法见《基于VGUS的Lua脚本使用说明》的2.2.1

章节。

如果未使用Lua脚本，串口0默认的工作模式即为“VGUS指令集协议”。

3.2串口1工作模式设置

串口1为串口屏的附加串口。该串口对应的插座为J20。仅部分型号可以使用串口1。

串口1默认的工作模式为“自定义串口协议”。需要使用Lua脚本，将串口1的工作模式设置

为“下载调试协议”，串口1仅在该模式下支持通过串口在线下载文件。详细设置方法见《基于

VGUS的Lua脚本使用说明》的2.2.1章节。

当串口0工作在其它工作模式，不能通过串口下载文件时，可以考虑使用串口1下载。

注意：VTc系列串口屏只支持一个串口，串口协议固定为“VGUS指令集协议”。所以该系列

串口屏通过串口实现在线下载时，无需考虑串口工作模式设置。

4.下载文件

添加所需下载文件，如图所示，添加了工程文件和Lua脚本文件。

可在左侧勾选所需下载的文件，未选中的文件不会参与下载。

点击下载按钮即可开始下载。

文件下载进度及下载结果可在下载日志中查看。图2表示两个文件均下载成功。

串口屏也会同步显示下载进度以及下载结果。

图2文件下载进度及下载结果

二、支持文件说明

串口在线下载通过文件名或文件后缀名判断所下载文件的用途，所以文件的命名需要符合规

范。命名仅支持字母、数字、下划线。通过识别字符判断文件用途，相关文件名必须符合表1、表

2所示。

表1SDWb系列串口屏支持串口在线下载的文件

文件类型文件名备注

VGUS编译后生成的工程文件，位于工程根

界面工程文件SDWb_ProjectXXX.bin

目录下的VT_SET_SDWb文件夹。

Lua脚本