广州大彩串口屏工程文档—PC软件问题解答

合集下载

广州大彩串口屏技术文档—基本型触摸内置外置版本区别

串口屏基本型触摸内置外置区别
一：基本型新旧串口屏系列区别
1．型号：触摸外置型号，后缀有TW升级为TF，不带触摸后缀型号不变NW。

2．功能方面完全一样。

3．工程：建工程依然可以使用原来型号，即后缀是04或者05等，可使用后缀更前的来建立。

4．尺寸定位孔完全兼容，触摸外置厚度增加触摸板厚度1.2mm。

5．触摸安装方式由触摸内置改为触摸外置。

触摸内置：触摸板位于铁框里面，直接贴合到液晶屏上
触摸外置：触摸板位于铁框外面，直接贴合到铁框上。

触摸外置的优点：若用户需要自行开模做外壳，需要把壳子做成一个平面，用户做好模具后，再加个pvc 即可。

若使用内置版本，看起来会凹进去。

6．接口，由原来的Molex座子改为现在的xh型号座子，接口定义以及座子间距不变。

选用耐高温型号。

内置版本接口座子也统一升级为xh型号接口座子。

用户端原有控制板2.54接口控制板，不需要作任何改动，直接焊接新座子替换即可。

Xh配线：
xh座子：。

广州大彩串口屏技术文档—如何把串口屏旋转90度使用

如何将将串口屏旋转90度显示1.1 概述由于市面上部分串口屏目前无法支持直接设置90°显示，但可以通过使用旋转90°的图片和字库配合以达到竖直90°显示效果，操作流程简单。

1.2 操作流程以下章节主要介绍旋转90°显示的全部操作过程。

1.2.1 美工素材准备预先准备好旋转90°的底图，如图 1.1所示。

图1.1 90度旋转的图片1.2.2 软件准备确定软件版本号。

软件版本号必须为《VER2.0.0.477》以上，低版本软件无法支持。

当前软件版本号查看方法如下：打开VisualTFT 软件，软件右下角会显示版本号，如图 1.2所示。

新软件可在大彩官网进行下载。

图 1.2 查看软件版本号1.2.3 操作流程1. 建工程新建工程，选择7寸基本型，型号：DC80480B070-01，如图 1.3所示；新建一画面。

图 1.3 新建工程2. 工程设置点击工具—>工程配置，设置屏幕旋转为90度，如图 1.4所示，或者双击工程名称，弹出工程属性窗口，选择屏幕旋转为90度，如图 1.5所示。

提示：两种设置方式是一样的图1.4 工程配置图1.5属性窗口设置3.插入旋转背景图片，放置文本控件控件1、2、3为文本控件，如图 1.6所示；编辑时候无需关心控件上显示的文字是否在同一行。

提示：编辑画面文本时，系统暂时无法调用新字库，必须运行虚拟串口屏后观看效果。

图1.6插入图片，放置文本控件4.模拟器调试编译无误后，运行“虚拟串口屏”查看显示效果。

点击菜单“调试”，选择“运行虚拟串口屏”，弹出模拟器，如图 1.7所示，此时我们可以看到字库旋转后的显示效果。

图1.7虚拟串口屏显示效果5.硬件调试资源下载：连接USB线，连接电源，屏幕显示正常后，点击开始下载。

第一次下载必须四个选项均打上√，如图 1.8所示；如果后续修改工程，进行下载，那么直需要下载“图片资源”以及“触控配置”。

广州大彩串口屏技术笔记—如何快速调整工程设置

如何快速调整工程设置1适应范围本文档适合经济型、基本型、物联型、86盒系列等串口屏产品。

2开发环境版本2.1VisualTFT软件版本：V3.0.0.732及以上；版本查看：打开VisualTFT，点击帮助->关于VisualTFT可以查看当前软件版本号；最新版本可登陆本公司官方网站进行下载。

2.2串口屏固件版本：串口屏需要升级到Modbus版本固件（RS232和RS485接口）版本查看：(1) 查看屏幕背面版本号贴纸。

(2) VisualTFT与屏幕联机成功后，右下角显示的版本号。

3功能概述1、老版本软件支持旋转90度建工程，但画布无法旋转为90度视角，造成一定的编辑困难，新版本pc软件解决此问题，但由于软件无法直接兼容老工程，故此需要通过新建工程来达到旋转画布的目的。

2、不同型号尺寸工程调整：快速由大尺寸工程调整为小尺寸工程，或者小尺寸工程调整为大尺寸工程，兼容同一个MCU控制。

4技术实现4.1新老版本软件工程快速重建使用最新版本软件，新建一个工程，新建工程后，首先右键删除默认画面，如图4.1-图4.2所示。

图错误！文档中没有指定样式的文字。

.1新建工程图错误！文档中没有指定样式的文字。

.2删除文件在工程画面，右键添加，如图4.3所示，选择原始工程的画面，可以选中第一个，然后按住shift，然后选择到最后一个画面如图4.4所示，将会一次性添加到工程上，添加完毕如图4.5所示。

图错误！文档中没有指定样式的文字。

.3添加工程画面图错误！文档中没有指定样式的文字。

.4选择画面图错误！文档中没有指定样式的文字。

.5添加完成首先，添加完画面后，进行画面顺序调整，打开原工程，一一拖动画面顺序进行排序。

然后，打开原工程文件夹，把对应的所有图片，复制到新工程的Images文件夹上。

最后，双击工程属性画面，然后找到属性窗口，进行工程属性设置，设置与原工程一致即可，如图4.6所示。

图错误！文档中没有指定样式的文字。

大彩物联型串口屏_旋转控件使用说明V1.1

旋转控件说明工程技术笔记广州大彩光电科技有限公司目录1.适用范围 (1)2.开发环境版本 (2)3.旋转控件 (3)4.示例操作 (4)1.适用范围文档仅适合物联型的串口屏产品。

2.开发环境版本1．VisualTFT软件版本：V3.0.0.944及以上的版本2.串口屏硬件版本：V3.0.287.0及以上的版本3.旋转控件1.旋转控件功能说明旋转控件是将图片使能，使图片可以进行0到360度的任意旋转。

某些情景下还可以替换别的控件，如仪表控件，将仪表制作为图片再放置旋转控件放在指针的位置就可以代替仪表控件，满足用户DIY需求。

2.旋转控件属性设置旋转控件的属性配置如下图3-1所示。

图3-1属性窗口3.图片路径选择需要设置为旋转控件的图片。

（将图片素材设置为旋转控件）4.调整a)选择“缩放”，将图片按照比例进行缩小或者放大。

b)选择“裁剪”，图片将按照原分辨率的大小显示，不会进行缩放。

5.过滤考虑到用户所用的素材格式不同，某些格式的图片在工程画面上会显示黑色或者其他颜色的背景，所以需要进行颜色过滤。

6.过滤色使图片中的某一种颜色在工程画面中不显示出来。

7.控件使能a)选择“否”，是关闭控件与数据之间的关联。

建议不要选择否。

b)选择“是”，是开启控件与数据之间的关联。

8.初始化角度图片放置在画面中的角度为0度，初始角度即图片以旋转点为圆点，顺时针旋转的角度。

9.旋转点X偏移和旋转点Y偏移旋转控件放置在画面中后，旋转点默认在图片中的左上角坐标（X=0，Y=0）。

我们在图片中选择的旋转点即为旋转点X和旋转点Y偏移后的值。

10.透明度0为控件不透明，255为控件全透明。

11.模拟时钟a)选择“是”，将旋转控件设置为时钟的指针。

b)选择“否”，不设置控件为时钟指针。

4.示例操作1.下面示例是将旋转控件运用在仪表上，作为仪表的指针。

2.所用到的的素材，带仪表的背景图，一张指针素材图片。

图4-1素材3.建立一个工程画面，把带仪表的图设为背景，并在中心点放置旋转控件作为仪表的指针并配置旋转控件的属性，如图4-2所示。

广州大彩串口屏技术文档—如何自定义字库

目录1.适用范围……………………………………………..2.开发环境版本…………………………………………3.功能概述………………………………………………4.技术实现………………………………………………4.1.1字库生成方法…………………………………………………....4.1.2字库配置…………………………………………………...........4.1.3字库下载…………………………………………………...........4.1.4注意事项…………………………………………………...........1. 适用范围文档适合经济型、基本型、物联型、86盒系列等串口屏。

2. 开发环境版本1. Visual TFT软件版本：V3.0.0.636及以上；版本查看：打开Visual TFT，点击帮助->关于Visual TFT可以查看当前软件版本号；2. 串口屏硬件版本：V2.22.649.XXX及以上。

版本查看：(1) 查看屏幕背面版本号贴纸。

(2) Visual TFT与屏幕联机成功后，右下角显示的版本号。

3. 功能概述在一些特殊场合，串口屏自带的宋体无法满足需求，为了使美工图片和字体更加协调一致，可以使用Visual TFT内置的字库生成器，来生成不同的字体（如雅黑、黑体、仿宋等），替换到串口屏内。

4. 技术实现4.1.1 字库生成方法1. 打开Visual TFT 软件，点击工具，选择字库生成，如图4.1所示。

2. 打开后界面如图，选择字体大小，字符和字模大小。

字模大小：字模大小就是点阵的大小，相当于一个字符的边界范围（目前设备最大的中文字库仅支持64*64，英文字库最大可支持到128*256）。

字体大小：字体大小就是字显示的点阵大小，不能超过字模的边界，根据实际情况去调整。

字符集分;ASCII、GBK、GB2312。

GB2312只包含国家一级二级汉字，6000多个字符；GBK包含了韩文、日文等有2万多个字符。

串口屏解决方案_关于系统键盘无法弹出的解决方案

关于系统键盘无法弹出的解决方案V1.0工程技术笔记广州大彩光电科技有限公司修订历史目录1.适用范围 (1)2.开发环境版本 (2)3.问题分析 (3)3.1虚拟屏中无法弹出系统键盘 (3)3.2工程下载之后，实体屏没有弹出系统键盘 (3)4.解决方案 (4)4.1恢复系统键盘默认设置 (4)4.2修复实体屏正常弹出系统键盘 (4)1.适用范围文档适合经济型、基本型、物联型、86盒系列等串口屏产品。

2.开发环境版本1、VisualTFT软件版本：V3.0.0.732及以上版本；版本查看：打开VisualTFT，点击帮助->关于VisualTFT可以查看当前软件版本号；2、串口屏硬件版本：V2.22.959.XXX及以上。

版本查看：(1)查看屏幕背面版本号贴纸。

(2)VisualTFT与屏幕联机成功后，右下角显示的版本号。

3.问题分析3.1虚拟屏中无法弹出系统键盘问题现象：客户在界面中放置文本控件，输入设置是弹出系统键盘输入，但是在调试虚拟屏的时候无法弹出系统键盘输出，整个界面其他同样设置的文本控件都是这样；关于客户反馈的现象，很可能是客户之前有使用过自定义键盘，然后在导出自定义键盘有误，使得自定义键盘无法使用，系统键盘也无法正常使用；用户只需要重新恢复下系统键盘就可以。

3.2工程下载之后，实体屏没有弹出系统键盘问题现象：用户将工程重新下载之后，相应的系统键盘在触发文本控件后没有弹出系统键盘；关于用户反馈的现象，很大的原因是客户那边可能之前设置的自定义键盘没有导出成功，导致和系统键盘冲突，用户重新恢复系统键盘设置之后，重新下载系统键盘即可。

4.解决方案4.1恢复系统键盘默认设置针对客户在虚拟屏中无法弹出系统键盘的现象，解决方案是，首先将系统键盘恢复成默认设置。

操作步骤是：打开Visual TFT软件，然后在菜单栏选中“工具”，在下拉菜单中选中“恢复键盘设置”-“恢复默认小键盘”/“恢复默认全键盘”，如图4-1所示。

广州大彩串口屏工程文档—串口屏指令集V4.2

大彩串口屏指令集V4.2修订历史目录1. 指令格式和指令集 (6)1.1指令格式 (6)1.1.1指令操作举例说明 (6)1.2颜色格式 (12)1.3组态指令集与基本指令集区别 (12)1.4如何快速熟悉指令集 (12)1.5组态指令集表 (13)2. 组态指令集详述 (31)2.1切换画面 (31)2.2读取画面 (31)2.3按钮控件ID值上传 (31)2.4设置按钮弹起或按下状态 (35)2.5对内指令实现按钮互斥和状态显示 (36)2.6对外指令输出 (36)2.7读取按钮控件状态 (36)2.8更新文本控件数值 (37)2.9读取文本控件数值 (39)2.10设置文本控件闪烁 (39)2.11设置文本控件滚动速度 (39)2.12设置文本控件背景色 (39)2.13取消文本控件背景色 (40)2.14设置文本控件前景色 (40)2.15更新进度条控件数值 (40)2.16获取进度条控件值 (41)2.17滑动条控件上传格式 (41)2.18更新滑动条控件数值 (42)2.19读取滑动条控件值 (42)2.20更新仪表控件数值 (43)2.21读取仪表控件数值 (43)2.22动画控件显示 (44)2.23图标控件显示 (45)2.24图标控件值上传 (46)2.25批量更新控件数值 (46)2.26曲线控件显示 (47)2.27设置下拉菜单控件 (49)2.28下拉菜单控件值上传 (51)2.29选择控件值上传 (51)2.30更新二维码控件 (53)2.31启动定时器 (54)2.32设置定时器 (54)2.33暂停定时器 (54)2.34清零定时器 (54)2.35读取定时器 (55)2.36设置光标焦点 (55)2.37手动禁止/使能屏幕更新 (55)2.38屏蔽/隐藏控件 (55)2.39RS485屏地址设置 (55)2.40RS485屏地址取消 (56)2.41锁定系统配置 (56)2.42解除系统配置锁定 (56)2.43数据记录控件添加常规记录 (56)2.44数据记录控件-清除记录数据 (56)2.45数据记录控件-设置记录显示偏移 (56)2.46数据记录控件-获取当前记录数目 (56)2.47数据记录控件-读取某一行记录 (57)2.48数据记录控件-修改常规记录 (57)2.49数据记录控件-删除某一行记录 (57)2.50数据记录控件-插入常规记录 (57)2.51数据记录控件-选中某一行数据记录 (57)2.52数据记录控件-一次添加多条记录 (58)2.53数据记录控件-SD卡导出指令（CSV格式） (58)2.54文本控件数字增量调节指令 (58)2.55视频控件-设置视频文件路径 (58)2.56视频控件-播放 (59)2.57视频控件-停止播放 (59)2.58视频控件-暂停/恢复播放 (59)3. 附录A基本指令集详述 (60)3.1握手 (60)3.2复位报告 (60)3.3复位设备 (60)3.4设置前/背景色 (60)3.5清屏 (61)3.6设置文字行列间距 (61)3.7设置文本框 (61)3.8设置图片过滤色 (61)3.9文本显示 (62)3.10光标显示 (63)3.11全屏图片显示 (63)3.12区域图片显示 (63)3.13图片剪切 (64)3.14动画显示 (64)3.15前景色画点 (65)3.16背景色画点（删除点） (65)3.17画线 (65)3.18将等间隔X坐标用前景色连接 (66)3.19按照坐标偏移量用前景色连线 (66)3.20将指定的坐标点用前景色连接 (66)3.21将指定的坐标点用背景色连接 (67)3.22按照坐标偏移量用背景色连线 (67)3.23画空心圆 (67)3.24画实心圆 (67)3.25画圆弧 (68)3.26画空心矩形 (68)3.27画实心矩形/局部清屏 (68)3.28画空心椭圆 (69)3.29画实心椭圆 (69)3.30背光调节 (69)3.31自动屏保模式 (69)3.32蜂鸣器控制 (69)3.33配置触摸屏 (70)3.34触摸屏校准 (70)3.35触摸屏体验 (71)3.36设置波特率 (71)3.37矩阵键盘控制 (72)3.38写数据到FLASH (72)3.39读取保存在FLASH中的数据 (73)3.40清除图层 (73)3.41切换画面时自动清除当前图层 (73)3.42截取当前屏幕并保存在FLASH中 (73)3.43显示保存在FLASH中的截取画面 (73)3.44RTC模式设置 (73)3.45RTC时钟设置 (74)3.46读取RTC时钟 (74)3.47将当前画面存储到TF卡 (74)3.48获取无线网络设置 (75)3.49获取网络状态 (75)3.50获取网络设置 (75)3.51获取网络服务 (75)3.52搜索无线网络 (75)3.53保存网络设置 (76)3.54保存网络服务 (76)3.55保存无线网络设置 (76)3.56发送网络数据 (76)3.57发送网络数据（十六进制） (76)3.58保存网络设置 (76)1. 指令格式和指令集1.1 指令格式一条完整的串口指令帧格式如表1.1所示。

广州大彩串口屏工程技术笔记-菜单控件应用

目文档适合广州大彩串口屏经济型、基本型、物联型、862. 盒系列等串口屏产品。

开发环境版本 1. VisualTFT 软件版本：V3.0.0.636 及以上；版本查看：打开VisualTFT ，点击帮助->关于VisualTFT 可以查看当前软件版本号；最新版本可登陆进行下载2. 串口屏硬件版本：V2.22.649.XXX 及以上。

版本查看：(1) 查看屏幕背面版本号贴纸。

(2) VisualTFT 与屏幕联机成功后，右下角显示的版本号。

菜单控件，弹出菜单供用户进行选择，选择后快速地将所选数据显示在屏幕上。

把菜单控件放置在一个新建画面中，菜单控件放置完成，如图 3-1 所示。

图 3 -1 放置菜单控件4.技术实现4.1属性窗口属性窗口是对控件属性进行更改的一个界面，熟悉属性窗口可以更好地对控件功能进行应用，如图 3-2 所示。

图 3 -2 属性窗口1.控件设置（1）菜单外观：分为单色和自定义图片。

A:选择单色，可进行菜单字体以及背景部分设置，如图 3-3所示。

图 3 -3 单色B:选择自定义图片，同时设置弹起时、按下时的图片，如图 3-4所示。

图 3 -4 自定义图片注：若设置自定义图片，并且需要用到裁剪功能，请将图片分辨率调整为屏幕分辨率大小，此处不建议使用裁剪功能。

（2）字体：可以选择字体的大小。

（3）背景色：选择菜单控件的背景色。

（4）前景色：选择菜单控件上文字的颜色。

2.菜单设置（1）菜单风格：分为弹出菜单和固定菜单，如图 3-5所示。

A：弹出菜单，菜单需要点击按钮或者发出指令，菜单会弹出来。

B：固定菜单，菜单一直固定显示在屏幕上。

图 3 -5 菜单风格（2）菜单方向：水平或者垂直，建议按需设置，调试查看哪种方向适合使用。

（3）菜单项数：显示菜单有多少项。

（4）菜单数据：选中菜单中的选项后显示在文本控件上的数据,数据由用户自定义，数据与数据之间用半角“；”隔开。

4.2查看ID要完成控件的功能应用，前提必须知道怎么查看控件和画面的ID。

广州大彩串口屏技术文档—数据记录控件应用

数据记录控件应用1适应范围本文档适合经济型、基本型、物联型、86盒系列等串口屏产品。

2.2串口屏固件版本：串口屏需要升级到Modbus版本固件（RS232和RS485接口）版本查看：(1) 查看屏幕背面版本号贴纸。

(2) VisualTFT与屏幕联机成功后，右下角显示的版本号。

3功能概述数据记录控件，用于记录数据、数据表格、报警值时间等。

控件记录历史告警、当前告警或者用作通用表格，记录数据掉电保存，若需要查看记录的数据，直接在屏幕上进行查看,多数据可以使用滑条查看。

4技术实现4.1属性窗口熟悉数据记录控件的属性窗口可以更好地对控件的属性进行设置，如图为数据记录控件的属性窗口。

图4-1文本控件的属性窗口4.1.1 显示设置1.字体：设置数据记录显示的字体和字体大小。

2.文字颜色：设置字体的显示颜色。

3.显示网格：是否显示网格。

4.网格颜色：设置网格的显示颜色。

5.显示背景：是否显示背景。

6.背景颜色：选择背景的显示颜色。

7.允许选择：是否允许选中数据所在行。

是，点击数据所在行颜色改变并发出通知给主机；否，不允许选择。

8.显示滚动条：是否显示滚动条。

4.1.2 记录设置1、记录类型，可以选择不同的记录类型。

a)当前告警:同一个编号的告警数据仅能记录一次，无法重复记录，但不限制记录顺序，若解除告警数据后，则可再次记录一次。

如图 4-2所示。

图4-2记录不重复数据b)历史告警:同一个告警编号可重复记录，不限制记录的次数，如图 4-3所示。

图4-3历史告警c)历史告警与解除时间：表格分为 3 列，第一列是告警解析，第二列告警时间，第三列是解除告警时间,如图 4-4所示。

图4-4历史告警与解除时间d)通用表格：可用作记录数据功能，数据类型可以是中文、字母、数字，如图 4 5所示。

【VIP专享】广州大彩串口屏工程文档—关于硬件问题解答说明

硬件类问题目录1.1初学者购买屏后如何快速入门 ··························································· 1.2如何查看固件版本号······································································· 1.3什么是带组态控件功能···································································· 1.4经济型、基本型、RS485型和小尺寸Nano的区别 ·································· 1.5RS232和TTL电平设置 ··································································· 1.6波特率强制恢复············································································· 1.7485串口屏跟RS232使用区别 ··························································· 1.8如何实现低功耗············································································· 1.9RTC电池型号 ··············································································· 1.10CRC校验模式··············································································· 1.11通讯电缆是否可以定制···································································· 1.12通讯8P端子是否可以更换 ······························································· 1.13通讯端子PCB封装········································································· 1.14产品是否有配套外壳······································································· 1.15产品定制条件················································································ 1.16是否有电容屏……………………… … …… ………………… ……………....硬件类问题1.1 初学者购买屏后如何快速入门在有串口屏之后，首先在网上“资料下载”栏中，下载《串口屏开发包》，如图 1.1所示，开发包里面包含了PC软件、软件视频教程、数据手册、常用问题解答和程序例程等。

广州大彩串口屏技术文档—关于显示类问题解答

串口屏的显示类问题解答说明1 屏幕上电黑屏或闪烁2 文本显示出错或乱码3 文本显示速度慢4 如何改变文本控件的背景色5 文本无法显示6 如何确保文本显示正确7 画面切换速度慢8 图片显示异常9 按钮按下时的效果图显示错误10 RTC时钟显示异常11 是否外部指令更改按钮和切换画面1.屏幕上电黑屏或闪烁只要电压正常，上电后屏幕一定会正常显示图片。

若有触摸功能，点击触摸蜂鸣器会进行鸣叫，画面可以进行跳转。

反之，若上电显示黑屏、白屏，屏幕滚动、闪动等现象，均为电压异常，必须首先排查电源问题。

常见电源故障有：电源被限流、电源线太长有压降、功率与实际标称不一致。

总言之，连接屏幕上电，必须保证屏幕的VCC和GND有4.8V以上电压。

若电压正常后依然黑屏，则点击触摸看蜂鸣器是否有声响或进行PC联机，若蜂鸣器正常，联机正常，则可能是背光芯片烧坏，请直接与技术联系。

另外USB线无法作为电源线使用。

2 文本显示出错或乱码实际大量文本动态刷新过程中，有些串口屏反应文本出现乱码，这些乱码不是固定出现而是随机出现。

出现此类问题，99.9%都是MCU发出的文本指令中出现了错误的内码，导致显示异常，建议用以下几个方面进行测试：检查串口通讯。

检查通讯电缆线是否过长，波特率是否过高，是否接触不良或焊机虚焊，排除硬件问题。

a.检查串口屏是否异常。

直接将串口屏与电脑串口相连，进入指令助手，选择自定义调试，然后输入N条测试指令，设置间隔时间，选择循环发送模式，如图 3.1所示，看屏幕是否有出现乱码，排除串口屏问题。

图3.1 自定义循环调试b.飞线引出串口测试。

我们将主板的TXD、RXD和GND飞线出来，直接接到电脑第3方串口调试助手(例如丁丁串口调试助手)，然后不断监听显示，如图 3.2所示。

一旦串口屏出现了乱码，马上查看指令窗口数据，看是否出现帧丢失和数据出错，找到错误之处。

图3.2 第3方调试助手监听主机数据c.若串口屏主机无法避免发送错误帧的可能，建议使用CRC校验通讯模式。

大彩物联型串口屏如何遍历U盘、SD卡中音频和视频文件

如何遍历U盘、SD卡中音频和视频文件_V1.0工程技术笔记广州大彩光电科技有限公司目录1.适用范围 (1)2.开发环境版本 (2)3.例程简介 (3)4.如何遍历U盘中、SD卡中的视频和音频 (4)4.1工程配置 (4)4.2编写LUA脚本 (5)1.适用范围文档适合物联型串口屏产品。

2.开发环境版本1．VisualTFT软件版本：V3.0.0.944及以上的版本。

2.串口屏硬件版本：V3.0.287.0及以上的版本。

3.例程简介物联型串口屏通过添加LUA程序可以实现遍历外部的U盘或SD卡中的文件。

在我司提供的范例工程demo中，可以实现遍历外部U盘和SD卡下目录所有的音频和视频文件并播放遍历出来的音频和视频。

4.如何遍历U盘中、SD卡中的视频和音频串口屏实现遍历U盘中、SD卡中的视频和音频需要完成以下4个步骤：1.将工程需要的视频进行格式转换（MP4格式）；（参考文档《串口屏如何播放视频》）;2.将视频或音频添加到U盘或SD卡中；3.在工程配置；（具体配置参考例程Demo）;4.编写LUA程序。

4.1工程配置例程画面中一共有三个画面，分别是首页、视频、音频画面。

1.首页画面配置如图4-1所示；图4-1首页2.视频画面配置，如图4-2所示；画面中的视频播放控件的属性窗口中“播放结束时”设为发送通知，如图4-2所示图4-2设置视频播放控件3.音频画面配置，如图4-3所示;编号1到10的控件为文本控件用于显示遍历出来的音频名字，编号11到20为图标控件用于提示当前正在播放的音频，编号35到44为按钮控件，按下按钮播放对应文本框中的音频。

图4-3音乐画面4.2编写LUA脚本工程创建时在工程目录下会生成一个main.lua文件，点击Visual TFF软件的工具栏选择LUA编程后可以编写main.lua文件，如图4-4所示；图4-4LUA编程当串口屏检测到U盘或SD卡插入时会调用LUA脚本的函数on_sd_inserted(dir)或是on_usb_inserted(dir)并将U盘或者SD卡的路径传如函数中；只需要在函数on_sd_inserted(dir)或是on_usb_inserted(dir)中调用遍历目录的函数即可实现遍历SD卡或U盘的音频和视频文件，程序如下：……--当检测到SD卡插入串口屏后会调用此函数function on_sd_inserted(dir)--SD卡回调函数listdir(dir)--遍历目录endfunction on_usb_inserted(dir)--U盘函数listdir(dir)--遍历目录end……---获取扩展名function getExtension(str)return str:match(".+%.(%w+)$")--调用LUA的库函数获取字符串end--遍历目录的函数，将目录中的音频和视频文件遍历出来function listdir(rootpath)for entry in lfs.dir(rootpath)doif entry~='.'and entry~='..'then--跳过目录中的.和..local path=rootpath..'/'..entrylocal attr=lfs.attributes(path)--获取指定路径的属性if attr.mode~='directory'thenext=getExtension(path)--获取扩展名if ext=='mp4'then--筛选MP4文件videofilenames[videofilecount]=pathvideofilecount=videofilecount+1endif ext=='jpg'or ext=='jpeg'or ext=='png'then--筛选图片文件pic_names[picfilecount]=pathpicfilecount=picfilecount+1endif ext=='wav'or ext=='mp3'then--筛选音频文件music_names[musicfilecount]=pathmusicfilecount=musicfilecount+1endelselistdir(path)endendendend……如果成功遍历后，切换到音乐画面，如图4-5所示；会将插入串口屏的SD卡里的音频文件名显示在文本框中，LUA脚本程序如下：function update_music_ui()--将遍历出来的音频名字更新到音频画面--向前播放if videoplay_index<first_music_index thenfirst_music_index=videoplay_indexend--向后播放if videoplay_index>=first_music_index+10thenfirst_music_index=videoplay_index-9endfor i=0,9doif first_music_index+i<musicfilecount thenset_visiable(2,11+i,1)--图标local filename=string.match(music_names[first_music_index+i],".+/(.+)")set_text(2,1+i,''..filename)--显示音频名字elseset_visiable(2,11+i,0)--图标set_text(2,1+i,'')end--正在播放的音乐,图标和文字都高亮显示if first_music_index+i==videoplay_index thenset_value(2,11+i,1)--图标set_back_color(2,1+i,0x5aeb)elseset_value(2,11+i,0)--图标set_back_color(2,1+i,0x3186)endendendfunction on_control_notify(screen,control,value)--load_config('e:/config.txt')--load_ad('e:/sub.txt')if screen==0then--首页if control==4then--按钮4按下playing_mode=1change_screen(0)endif control==5then--按钮5按下playing_mode=2change_screen(2)--切换到音频画面update_music_ui()play_next_video()--播放下一首歌endif control==6then--视频模式playing_mode=0change_screen(1)--切换到视频画面play_next_video()--播放下一个视频endend图4-5遍历U盘中的音乐详细程序需要参考源文件，以上程序为截取源程序中的部分函数。

大彩工业串口屏--常见问题集锦1212

快速功能解答阅读以下问题前，请先仔细阅读手册，大部分都可以在手册上找到答案，部分可以在此文档找到答案，如没有找到您所需要的答案，您可以与我们联系，联系时候请先把问题描述清楚，以便快捷沟通郑重声明，本产品作为从机显示，也就是被动显示，不作主动控制功能，按键类可以上传对应的按键值，对应的客户端的MCU可以在接收到按键值后做一定操作，这部分操作包括对屏的操作，或者对应客户端控制的一下模块的操作调试板说明：调试板是方便电脑与屏连接使用，不含任何转换电平功能，短接点J7、J11，请勿轻易更改，另外，电脑通讯是232电平，屏后面短接点J5短接为TTL，断开为232，如有连接不上，请查看一下是否短接（请详细查看丝印）对应功能搜索指引：如需查找对应功能，请在PDF上搜索对应的功能码或者关键词；如遇到不明白的指令，请在pdf上搜索对应功能码解读一、设置类1、整个工程属性设置先找到属性窗口，然后左击一下《工程画面》，属性窗口处弹出工程设置相关属性（如图1），注意设备类型一定要与屏的设备类型保持一致，否则下载后会出现显示错误，但软件不会提示。

自动调节背光部分与背光指令相反2、进度条，滑块，仪表设置先找到属性窗口，然后左击一下进度条或者滑块或者仪表，属性窗口弹出对应的设置选项，请仔细查看设置3、文本控件设置可以设置弹出键盘，键盘有小键盘，有大键盘，可以设置为主机输入；文本控件显示可以设置为密码显示，也就是不显示出来，只显示“*****”4、字库配置：详细参考《字库升级说明》5、自动调节背光设置：（如图1）6、二、下载类1、usb无法下载请先连接电源，上电，然后确认usb线是否连接好，请在“我的电脑”里的“设备管理器”里查看；如不行请更换不同的USB接口测试；如还是无法下载，请更换一根质量好的USB线；另外，如出现USB无法识别情况，请重新安装一下驱动，驱动包在安装目录下的《driver》2、串口无法下载NANO型只支持串口下载，如NANO型出现下载失败，或者无法下载，请确认是否已经连接好串口；部分基本型和标准型固件不支持串口下载；如发现下载速度过慢，可以设置更高的波特率进行下载，波特率请参照说明书，另外，注意电脑的波特率最高只能1152003、SD卡无法下载基本型与标准型支持SD卡下载，如SD卡下载失败或者无法下载，我司出厂下载使用“闪迪128MB”，不同牌子的SD卡可能会出现不兼容现象，如仍然无法使用SD卡下载，请转到USB下载，或者从我司购买SD卡4、三、显示类1、文字NANO型字库错乱：NANO型字库空间为2M，所有字库大小不能超过2M，超出后会导致字库显示错乱，图片出现白条等，重新下载字库，工程图片等就可以了2、图片出现白条，横杠等，重新下载工程就可以了，部分usb质量差会导致出现此现象3、客户部分图片不需要添加到工程页面上，可以直接在图片文件上一次添加多个图片，但图片分辨率必须小于或者等于设备的分辨率，超出的设备不显示4、图片出现晕圈现象，脱层显示部分图片下载到工程上会出现晕圈现象，原因是图片渐变较多，屏为65535色，渐变太多容易影响显示，解决方法是减少图片渐变，另外注意图片是美工过程中保存图片建议为16位色图片5、按钮按下的图片不对应界面的图片的分辨率建议以界面屏的分辨率大小为准，按钮设置为剪切功能时候，是对应其中的图片的分辨率的，如图片小或者大了，可能剪切不到对应的显示图片6、RTC时钟显示异常我们目前只有标准型的模块支持RTC时钟功能，如发现时钟显示异常，如显示时间错乱，或者时间相差比较远，可进行以下处理：一、重新校正时间，显示即可恢复正常，可以在调试助手中设置，也可以通过说明书上的指令设置。

广州大彩串口屏技术笔记—常见硬件类问题解答

大彩串口屏常见硬件类问题解答1.1 初学者购买串口屏后如何快速入门初学者购买大彩串口屏后，首先在广州大彩科技官网的“资料下载”栏中，下载《串口屏开发包》，如图1.1 所示，开发包里面包含了PC 软件、软件视频教程、数据手册、常用问题解答和程序例程等。

初学者只需根据开发包里面的学习步骤，一步步体验，认真阅读例程代码，即可迅速掌握开发。

图 1.1 官网下载开发包资料1.2 如何查看串口屏固件版本号固件版本号代表了设备输入的程序版本。

用户在使用串口屏时候，若遇到了一些难以解决的问题，建议将问题描述和设备版本信息一起发送给技术支持。

获取版本的方法如下：1.直接看屏背面标签。

正常情况下，产品出厂前背面均有型号和标签，用户只需将产型号和版本标签告诉支持人员即可，如图1.2 所示。

图 1.2 固件版本标签纸2.如果屏背面无贴固件标签，则参照图1.3 所示进行连接(若无串口调试板，需要自行焊线进行连接)，然后打开VisualTFT软件，选择串口COM 通道，点击"联机设备"，如图1.4 所示。

联机成功后，软件右下角将显示对应产品版本号，如图 1.5 所示，然后用户将其固件版本截图发给技术支持。

图 1.3PC与串口屏联机图 1.4PC联机设备图 1.5PC查看产品版本号1.3 什么是带组态控件功能所谓组态功能就是屏幕很多功能直接在PC 中配置即可完成，无需单片机的参与，减少程序开发量。

例如我司串口屏有有几个典型的组态控件：按钮控件、文本控件、动画控件、仪表和进度控件等，它们具备的功能如下：(1) 按钮控件通过上位机VisualTFT软件对工程画面中的所有按钮进行配置，即可在无用户程序参与下，自动实现画面的切换，按钮的按下和弹起，自定义指令输出等功能。

画面中任何按钮被按下，屏幕都会将此按钮的ID 编号上传给用户，无需计算坐标值。

(2) 文本控件上位机预先将文本在工程画面中的位置、颜色、字体和背景色设置好，用户只需对相应的文本ID 进行读写数据，无需关心坐标值、颜色和字体等信息。

广州大彩串口屏技术文档—如何下载工程

如何下载工程1.1 概述串口屏下载工程方式有3种：USB、SD 卡和串口，其中部分型号不支持USB 下载。

1.1.1 USB下载1.上电，点亮屏幕，以显示出稳定图案为正常。

供电电压参考手册，基本型系列除了3.5寸、10.4寸外，其他尺寸供电均为5-26V，3.5寸基本型，供电5V，10.4寸供电9-26V。

2.插上USB线，如图 1.1所示。

图1.1 插入USB3.在已建好的工程基础上，点击编译，编译通过后，点击编译按钮旁边的LOAD。

不需要连接串口。

图1.2 编译以及下载下载工程也可以通过量产向导下载。

图1.3量产向导通过量产向导下载工程。

图1.4 量产向导4.点击下载，软件右下角将会出现下载进度条，静待下载进度条完毕。

图1.5 下载进度条注意：若出现USB无法下载，请参考常见问题解答处理，文档在软件的帮助栏处。

1.1.2 串口下载串口下载方法跟USB下载方法类似，步骤除了第二步由插入USB线改为串口联机成功，联机成功后，软件右下角将会提示已联机设备，以及版本号。

如图 1.7所示。

图1.6 联机设备联机操作方法：选择串口，并将屏的硬件DIN跟串口线的TXD连接，DOUT跟串口线的RXD连接。

若电脑没有串口线，则无法通过串口通讯，以及下载。

图1.7 联机成功注意：若无法串口联机，请参考常见问题解答处理，文档在软件的帮助栏处。

建议使用115200波特率下载，波特率越高，下载速度越快，修改波特率方法，直接软件的指令助手，设备配置，解锁配置，修改波特率，然后重新断开设备，联机设备。

1.1.3 SD下载SD卡下载，方便批量生产使用。

SD卡容量越小越好，建议使用128M大小SD卡，部分大容量SD卡以及杂牌SD 卡不兼容。

1.首先，生成SD卡资源包选择工具，量产向导，选中需要下载的部分，如图片，工程配置等，如图 1.8所示图1.8 生成SD卡资源包点击生成SD卡资源包，生成的文件如图 1.9所示。

将全部文件直接复制到SD卡上然后点亮屏幕，插入SD卡，等待烧录完毕。

广州大彩串口屏技术文档—弹出自定义键盘应用

弹出自定义键盘应用1.1 概述随着用户使用不同美工图片，内置的系统键盘将无法完美匹配用户美工，或者内置键盘太小，不合适当前工程应用；自定义系统键盘，方便用户自行根据自身美工图片来调整对应的系统键盘，以及一些特殊符号的应用。

1.1.1 缺点无法使用中文拼音输入法。

1.2 操作1.2.1 准备美工图片准备好系统键盘使用的图片，按下图片以及弹起图片图1.1 按下和弹起对应图片1.2.2 键盘配置在工程新建画面上，放置一个图片，图片放置以画面左上角坐标（0,0）为起点，放置好弹起时的图片，如箭头所示，放置一个文本控件，控件设置为自定义键盘输入图1.2 放置文本控件然后在0的位置放置一个按钮，按钮属性设置为自定义按键，键值设置为0，其他的各个按键依次进行配置。

注意：键盘上放置的按钮，必须统一设置按下去的图片格式必须一致，否则键盘将无法使用按下去效果。

1.2.3 导出系统键盘点击软件工具，选择导出键盘，键盘宽度设置跟放置的图片保持一致，然后点击确认。

图1.3 导出键盘注意：如果软件版本不支持此功能，请到网上更新软件1.2.4 键盘移植1．导出键盘后，通过软件的量产向导，下载系统键盘。

图1.4 下载系统键盘2．对应的这个工程打开后，系统键盘是刚生成的键盘，其他工程如需要对应这个键盘，可以不通过刚刚设置方法来进行生成；可直接复制此工程文件下的《keyboard0》，《keyboard1》，以及对应的键盘美工素材图片到其他工程上。

3．对应keyboard0是系统小键盘，keyboard1是系统全键盘。

4．设计好小键盘后，必须再设计一个全键盘配套，否则将无法使用全键盘。

1.2.5 恢复软件自带系统键盘若新键盘不满意，需要更换回原来系统自带键盘，只需要删除工程目录下文件keyboard0、keyboard1，然后通过量产向导下载一次系统键盘。

大彩物联型串口屏如何使用云端更新屏幕固件和视频广告

如何使用云端更新屏幕固件和视频广告_V1.0工程技术笔记广州大彩光电科技有限公司目录1.适用范围 (1)2.开发环境版本 (2)3.云端更新屏幕固件和视频广告 (3)4.如何实现 (4)4.1搭建服务器 (4)4.2配置串口屏WIFI (5)4.3远程更新 (5)1.适用范围文档适合物联型串口屏产品。

2.开发环境版本1．VisualTFT软件版本：V3.0.0.944及以上的版本。

2.串口屏硬件版本：V3.0.287.0及以上的版本。

3.云端更新屏幕固件和视频广告物联型串口屏可以通过WIFI连接到云端服务器下载更新固件程序、工程文件、图片、视频、音频的PKG压缩文件，实现远程升级的功能。

4.如何实现PKG是多文件压缩打包格式，可以是固件程序、工程文件、图片、视频、音频等文件集合。

工程编译之后，在output目录下自动生成DCIOT.PKG。

通过云端服务器将文件下载到串口屏后，串口屏识别到DCIOT.PKG文件后会自动解压更新压缩包里的内容。

具体的实现步骤如下：1.准备一个可以接入下载文件的云端服务器（如没有则需要自己搭建）；2.配置串口屏的WIFI；3.调用API接口函数从云端下载PKG文件。

4.1搭建服务器如有服务器则不需要进行此步骤。

例程使用的FTP协议进行在线升级需要搭建服务器，测试所使用的是免费开源的FileZillaFTP软件进行搭建服务器。

直接以管理员权限运行FileZillaServer.exe启动FTP服务，如图4-1所示。

然后运行FileZilla ServerInterface.exe 进行FTP用户和权限配置，如图4-2所示。

图4-1FileZilla ServerI软件图4-2配置组权限配置完毕后，在WINDOWS资源浏览器中输入ftp://本机的IP地址，如果可以可以连接FTP服务器，就表示配置成功。

4.2配置串口屏WIFI配置串口屏WIFI除了通过指令助手发送指令配置之外，还可以通过调用LUA脚本函数配置WIFI。

大彩工业串口屏--常见问题集锦1212

大彩工业串口屏--常见问题集锦1212快速功能解答阅读以下问题前，请先仔细阅读手册，大部分都可以在手册上找到答案，部分可以在此文档找到答案，如没有找到您所需要的答案，您可以与我们联系，联系时候请先把问题描述清楚，以便快捷沟通郑重声明，本产品作为从机显示，也就是被动显示，不作主动控制功能，按键类可以上传对应的按键值，对应的客户端的MCU可以在接收到按键值后做一定操作，这部分操作包括对屏的操作，或者对应客户端控制的一下模块的操作调试板说明：调试板是方便电脑与屏连接使用，不含任何转换电平功能，短接点J7、J11，请勿轻易更改，另外，电脑通讯是232电平，屏后面短接点J5短接为TTL，断开为232，如有连接不上，请查看一下是否短接（请详细查看丝印）对应功能搜索指引：如需查找对应功能，请在PDF上搜索对应的功能码或者关键词；如遇到不明白的指令，请在pdf上搜索对应功能码解读一、设置类1、整个工程属性设置先找到属性窗口，然后左击一下《工程画面》，属性窗口处弹出工程设置相关属性（如图1），注意设备类型一定要与屏的设备类型保持一致，否则下载后会出现显示错误，但软件不会提示。

广州大彩串口屏技术文档—进度条控件和滑块控件应用

进度条控件和滑块控件应用1.适用范围..............................................................................................2.开发环境版本......................................................................................3. 功能概述...............................................................................................4. 技术实现..............................................................................................4.1进度条控件属性...................................................................................................4.2滑块控件属性......................................................................................................4.3例程操作..............................................................................................................1. 适用范围文档适合经济型、基本型、物联型、86盒系列等串口屏产品。

2. 开发环境版本1. Visual TFT软件版本：V3.0.0.636 及以上；版本查看：打开Visual TFT，点击帮助->关于Visual TFT可以查看当前软件版本号；2. 串口屏硬件版本：V2.22.649.XXX及以上。