LUA教程8-背光亮度保存

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 及以上的版本。

版本查看：

a)  查看屏幕背面版本号贴纸；

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

3.    LUA语言版本V5.5。

3

概述

   物联型可以通过LUA脚本配合工程完成丰富多样的操作。

本文将介绍在掉电状态下还能保存背光亮度的方法。在 LUA脚本中使用文件IO系统把数据保存到内存中，并能在重新上电后把数据读出来。工程中通过点击按钮实现保存，再点击读取按钮后，读取上次保存的值，并设置背光亮度值。

4

参考文档

1.《物联型LUA 脚本API_v1.0》  可通过以下链接下载物联型开发包获取:

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

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

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

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

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

5

工程设计

   本章节主要讲述通过LUA实现背光亮度掉电保存的方法。本文将分为以下是4个阶段讲述教程DEMO是如何实现的：

1.工程准备，

2.工程配置与功能，

3.LUA编写及调试，

4.下载与运行。

5.1     工程准备

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

1.硬件平台，

2.UI素材，

3.LUA编辑器。

5.1.1  硬件平台

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

图  5‑1  物联型7寸

5.1     素材准备

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

图 5‑2  素材准备

5.1.3  LUA编辑器

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

图  5‑3  打开LUA编辑器

LUA编辑器的开发环境，如图 5‑4所示。

图 5‑4  LUA编辑器界面

5.2     API函数说明

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

图 5‑5  API函数文档

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

1.函数on_control_notify(screen,control,value)

注释：此函数可以在用户触摸修改控件后被回调。函数有三个参数：

screen表示画面ID

control表示控件的编号

value表示控件的值。

2. 函数get_backlight()

注释：此函数获取背光亮度值。

返回背光亮度值

3. 函数set_backlight(level)，level表示背光值

注释：此函数背光亮度。

4. 函数set_value(screen,control,value)

注释：此函数可以设置控件的值。函数有三个参数：

screen表示画面ID

control表示控件的编号

value表示控件的值。

5. 函数io.open (filename [, mode])

注释：此函数可以打开文件。函数有两个参数：

filename表示文件名

[,mode]表示模式。可写可不写。

返回文件句柄

6. 函数file:write(text)

注释：此函数可以对文件写入数据。函数有一个参数：

text表示写入文件的字符串。

7. 函数file:read([, mode])

注释：此函数可以读出文件的数据。函数有一个参数：

[,mode]表示读的方式。可写可不写。

返回读出的字符串

8. 函数file: seek(optional whence, optional offset)

注释：此函数设置和获取当前文件位置。函数有两个参数：

whence表示设置的方式。可写可不写。

offset表示设置的位置。可写可不写。

都不写时，返回当前位置。

9. 自定义函数writefile(filename,info)，此函数使用file:write(text)保存数据。

10. 自定义函数readfile(filename)，此函数使用file:read([, mode])读取数据。

  注：更多API函数请参考文档《物联型LUA脚本API_V1.0》和网站：www.runoob.com/lua

5.3     教程实现过程

串口屏的背光亮度通过LUA脚本保存到内存中。通过点击按钮实现保存动作，再点击读取按钮后，读取上次保存的值，并设置背光亮度值，教程中功能的实现步骤如下：

1. 配置工程属性，
2. 编写LUA程序，
3. 运行程序。

   
   

5.3.1  背光亮度保存

1. 首先设置一个进度条，滑动通知选择关联滑动条。 因为背光值太低时会黑屏，所以初始值选择20。 如要使用自定义图片，则在背景类型选择透明，前景类型选择前景图片，再在前景图片中选择自定义的图片，如图 5‑6所示。

图 5‑6  按钮的属性

然后设置滑动条，滑块的编号等于进度条的编号加一，滑动条初始值与进度条一致，设置自定义图片的操作也基本一样，如图 5‑7。

图 5‑7  设置滑动条

设置一个按钮用来触发LUA中的保存函数，事件通知选择是，再设置按下图片并选择裁剪，如图 5‑8。

图 5‑8  设置保存按钮

设置一个按钮，事件通知选择是，如图 5‑9。

图 5‑9设置读取按钮

2.滑动滑块时，设置背光，如程序清单5‑1。

程序清单5‑1设置背光亮度值

在按下按钮后，读取文件的数据，然后设置背光并设置进度条，如程序清单 5‑2。

程序清单5‑2读出数据

把程序编写入软件的LUA编辑器中，如图 5‑10所示。

图 5‑10  把程序写入LUA编辑器

3.把工程下载到串口屏中，滑动滑块设置背光，点击保存。重新上电，点击读取，背光被设置为上一次的保存值。

5.4     编译和下载

在我司的上层软件Visual TFT中集成了LUA程序的编译器，可以实现在编译工程的同时将LUA脚本程序一起编译，并且将编译后的图片和程序集合在一个名为DCIOT.PKG的文件中。编译后只需要把DCIOT.PKG文件拷贝到U盘中，接上串口屏并重新上电即可将图片和程序下载到屏中。

6

完程程序清单

  背光亮度保存demo的完整程序，如程序清单 3所示，查看程序时请结合教程demo理解：

程序清单 3 完整程序

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

●编辑：肖水兰

长

按

关

注

更多大彩串口屏资讯

官网：www.gz-dc.com

淘宝：gz-dc.taobao.com