LUA教程13-如何设置开机音乐和替换开机logo

Posted 2021-04-10 大彩科技

如何设置开机音乐和替换开机logo-视频教程演示

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脚本配合工程完成丰富多样的操作。

本文将介绍如何实现开机音乐功能以及使用多种按键提示音的方法。

4

参考文档

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

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

实现教程

本文将分为以下是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.2  素材准备

准备好相应的美工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函数文档

5.3  如何设置开机音乐

   物联型串口屏可以通过LUA脚本设置开机音乐，具体步骤如下：

1. 添加音频进工程；
2. 编写LUA程序。

5.3.1  添加音频文件

新建的工程目录下带有一个Sounds文件夹，工程所添加的音频文件会自动复制进Sounds目录下并随工程下载到串口屏内部存储分区A中，将音频添加到工程里如图 5‑6所示。

注意：音频的格式只支持wav或者mp3格式，音频路径和文件名字为字母（a-z）、数字(0-9)和下划线（_）组合，不支持其他字符。

图5‑6添加音频到工程

  

5.3.2  编写LUA程序

在软件Visual TFT的工具中打开LUA编程，如图 5‑7所示；

图 5‑7打开LUA脚本编程

串口屏开机完成后会调用函数on_init()初始化串口屏。所以只需要在on_init()函数里调用播放音乐的API函数即可实现开机完成后播放音乐。LUA程序如下：

5.3.3 U盘更新开机logo

物联型串口屏可以通过LUA脚本从U盘中读取图片更新开机logo。LUA脚本代码如下：

函数on_usb_inserted(dir)是一个回调函数，当串口屏检测到U盘插入后会调用该函数并传入U盘路径作为参数；upgrade_logo(dir..'/logo.jpg')函数是专门用于更新开机logo的API函数，参数dir..’/logo.jpg’是U盘根目录下logo图片的路径。

  

5.4     编译和下载

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

6

完整程序清单

 文本保存demo的完整程序，如程序清单 1所示，查看程序时请结合教程demo理解：

程序清单 1完整程序

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

●编辑：肖水兰

长

按

关

注

更多大彩串口屏资讯

官网：www.gz-dc.com

淘宝：gz-dc.taobao.com