LUA教程1-如何显示文本

Posted 2021-04-10 大彩科技

点击关注了解更多精彩内容！！

如何显示文本-视频教程演示

1

适用范围

该文档适合所有大彩物联型系列。

2

开发环境版本

1．VisualTFT软件版本：V3.0.0.944及以上的版本。

版本查看：

1. 打开VisualTFT软件启动页面如图2‑1软件版本，右上角会显示的软件版本号；
   

   图2‑1软件版本

   
   

2. 打开VisualTFT，在软件右下角可以查看软件版本图2‑2软件版本，

   最新版本可登录http://www.gz-dc.com/进行下载。

图2‑2软件版本

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

版本查看：

1. 查看屏幕背面版本号贴纸；
2. VisualTFT与屏幕联机成功后，右下角显示的版本号。

3.   LUA语言版本V5.5。

3

概述

  物联型串口屏通过LUA脚本配合工程可以完成大部分的内部逻辑处理，可以做到让MCU只参与数据处理，不参与屏的逻辑处理。

   本文将介绍大彩LUA脚本API函数中的绘图API函数使用方法，以及使用函数的注意事项。

4

参考资料

1.《大彩组态串口屏LUA 脚本API》  可通过以下链接下载物联型开发包获取:

http:/www.gz-dc.com/index.php?s=/List/index/cid/19.html

2.《LUA基础学习》  可通过以下链接下载物联型开发包获取:

http:/www.gz-dc.com/index.php?s=/List/index/cid/19.html

3.LUA脚本初学者可以通过下面链接进行学习。

http://www.runoob.com/lua/lua-arrays.html

5

教程实现

  本章节主要通过LUA教程demo讲述如何设置文本控件的API函数使用以及编写程序的注意事项。本文将分为以下是3个阶段讲述教程DEMO是如何实现的：

1. 准备工程素材，

2. 实现功能，

3. 下载工程。

5.1 准备工程素材

  在实现教程DEMO前需要作以下三个准备：

1. 硬件平台，

2. UI素材，

3. LUA编辑器。

5.1.1 硬件平台

  该例程使用大彩物联型7寸串口屏DC80480W070为验证开发平台。如图 5‑1所示

图5‑1  物联型7寸串口屏

其他尺寸的物联型串口屏均可借鉴此教程

5.1.2  UI素材准备

准备好相应的美工UI。如图5‑2所示

图5‑2 素材准备

5.1.3 LUA编辑器

上位机VisualTFT内部已集成了LUA开发编译环境，点击菜单栏工具，选择LUA编辑器，如图 5‑3所示。

图5‑3 打开LUA编辑器

打开编辑器后，Visual TFT画面如图 5‑4所示；

图 5‑4 LUA编辑器

5.2    API函数说明

  大彩科技针对LUA脚本提供了丰富的API接口函数，具体函数可以查阅文档《物联型LUA脚本API 》，如图 5‑5所示。

图5‑5  API函数文档

本教程文档中所涉及到的部分的相关接口函数

1.  函数set_text（screen，control，str）

注释：指定某个画面中的文本控件或者二维码控件显示指定内容：

1.函数on_screen_change(screen)

 注释：当画面切换至目标画面ID时，执行此回调函数

 参数：screen 表示目标画面ID

5.3  实现功能

教程中功能的实现步骤如下：

1.配置工程属性，

2.编写程序以及编译，

3.运行程序。

5.3.1  显示文本

1.在教程DEMO的画面中，实现点击按钮在文本框中显示“HELLO LUA”，运行虚拟屏后工程画面如图5‑6所示

图5‑6绘制基本图形画面

2.LUA程序解释：按下按钮后在文本框中显示“HELLO LUA”，程序如程序清单1所示；

程序清单1获取绘图类型

编写完功能模块后将工程和脚本一起进行编译，编译成功后可以使用软件中的虚拟屏查看程序是否实现功能，点击工具栏中编译工程按钮，可将工程和脚本的一起编译，操作如图 5‑7所示

图5‑7编译工程

注意：目前在软件Visual TFT集成的LUA脚本编译器无法进行语法检测，所以编写LUA程序是尽量分模块编写，已达到节省调试的时间。

1.点击工具栏中的运行虚拟串口屏，软件先会将当前工程进行编译，编译成功后工程会在虚拟屏上运行起来，如图5‑8所示

图5‑8基本绘图示例

5.4 下载工程

在我司的上层软件Visual TFT中集成了LUA程序的编译器，可以实现在编译工程的同时将LUA脚本程序一起编译，并且将编译后的图片和程序集合在一个名为DCIOT.PKG的

文件中。编译后只需要把DCIOT.PKG文件拷贝到U盘中，接上串口屏并重新上电即可将图片和程序下载到屏中。

5.4.1 下载

工程编译成功后在输出窗口会提示编译成功，如所示。编译成功后打开工程目录，找到output文件夹，将文件夹中的DCIOT.PKG文件拷贝到U盘中，如图 5‑9和图 5‑10所示；接上串口屏重新上电，等到提示烧录工程成功后，拔掉U盘重新上电即可。

图5‑9编译成功

图5‑10

6

完整程序清单

   LUA教程-绘图API函数说明demo的完整程序，如程序清单 2完整程序所示，查看程序时请结合教程demo理解：

程序清单2完整程序

如有问题欢迎联系我司技术支持咨询

●编辑：肖水兰

长

按

关

注

更多大彩串口屏资讯

官网：www.gz-dc.com

淘宝：gz-dc.taobao.com