一、适用范围
本文档适合大彩PM系列串口屏产品使用。
二、开发环境版本
1 VisualTFT软件版本:V3.0.1.1112及以上的版本。
2 串口屏硬件版本:M系列固件 >= V6.3.257.00。
三、概述
本例程中,介绍4G的HTTP下载的应用,通过下载图片、视频、音频说明下载流程。
四、参考资料
1 《LUA 脚本API V1.4》可通过以下链接下载物联型开发包获取:
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
4 AT指令,可以通过下面子连接了解
Uhttp://www.openluat.com/Product/file/asr1802/Luat%204G模块AT命令手册V4.2.8.pdfU
5 Air系列4G模块AT版本HTTP应用说明(若连接失效请在LUAT社区中查找)
https://ask.openluat.com/article/626/0
五、教程实现
本文主要将以下2点进行说明:
-
准备工程素材;
-
配置串口屏工程;
5.1 准备工程素材
5.1.1 准备工程素材
在实现例程前需要作以下3个准备:
-
硬件平台;
-
软件平台;
-
UI素材;
该例程使用大彩M系列7寸串口屏DC80480M070_1111_0T为验证开发平台。如图5-1所示;
图5-1 M系列7寸串口屏
其他尺寸的串口屏均可借鉴此教程。
5.1.2 软件平台
使用大彩自主研发的上位机软件VisualTFT配置工程,登陆大彩官网下载。如图5-2所示;
5.2 配置串口屏工程
本文主要介绍以下2点:
(1) 画面配置
(2) LUA编辑
5.2.1 画面配置
在画面ID0中,触发下载、下载过程、4G信号值及运营商3部分组成。
触发下载:3个按钮控件,作为触发下载条件。
控件ID1~3依次为图片下载、视频下载以及音频下载。
下载过程:控件ID4~8作为下载过程的体现:
文本控件ID4用于显示下载速度(min/Kb)
文本控件ID5显示下载信息
进度条控件ID6为显示下载进度
文本控件ID7用于显示下载进度百分比
文本控件ID8显示 ‘当前已下载大小/总下载大小’,单位Kb
4G信号和运营商:图标控件控件ID10作为信号显示、文本控件ID11用于显示运营商。画面配置如图5-3所示:
注意:其他非关键控件不在一一介绍,下文不在累述
图5-3 画面配置
5.2.2 LUA编辑
本例程中,屏幕上电执行初始化操作,如加载4G AT 指令的库、初始化4G模块、定时获取运营商和信号值等。
当用户点击图片下载的时,调用air_http_download()开始下载文件。在下载回调函数on_http_download_file_cb()里进行数据存储,显示下载信息等。若该文件单次下载不完,会多次回调on_http_download_file_cb()函数,直至下载完毕,如图5-4所示。
图5-4 下载流程
1 初始化
调用系统函数on_init()执行代码如程序清单 1所示:
程序清单 1 初始化
--[[*******************************************************************
** Function name: on_init
** Descriptions : 系统初始化时,执行此回调函数。
*******************************************************************--]]
function on_init()
dofile('Air724at.lua') --加载 http.lua 文件
uart_set_baudrate3(115200) --设置与4G模块通讯的串口3的波特率为115200
--设置4G库函数的命令发送函数,命令回调函数、调试信息打印函数
air_set_callback(on_air_send_cb,on_air_resp_callback,on_air_log_cb)
air_hw_int() --4G模块初始化设置
--开启自动获取型号强度、时间、天气功能
start_timer(timerId_Sig_Weather, 1000 , 0, 0)
set_visiable(screen_mmedia_dl,6,0) --设置进度条不可见
set_visiable(screen_mmedia_dl,7,0) --设置进度文本不可见
end
--[[*******************************************************************
** Function name: on_timer
** Descriptions : 定时器超时回到调函数。
** @ timer_id : 定时器ID
*******************************************************************--]]
function on_timer(timer_id)
on_air_timer(timer_id) --4G库函数的定时处理
--定时获取信号强度
if timer_id == timerId_Sig_Weather
then
--定时器计数,timer0_notify_cnt 每秒+1。
timer0_notify_cnt = timer0_notify_cnt + 1
if timer0_notify_cnt%15 == 0
then
--每15s调用一次,更新信号值
at_cops_csq()
timer0_notify_cnt = 0 --标志位清空
end
end
end
--[[*******************************************************************
** Function name : at_cops_csq
** Descriptions : 获取运营商信息、信号强度
** @return : nil,无返回值
*******************************************************************--]]
function at_cops_csq()
air_cmd_add('AT+COPS?','OK',1000) –获取运营商
air_cmd_add('AT+CSQ' ,'OK',1000) –获取信号
end
--[[*******************************************************************
** Function name: on_air_resp_callback
** Descriptions : 4G模块-数据回调接口
** @key : 屏幕向4G模块的发送请求
** @value : 4G模块返回的数据
*******************************************************************--]]
function on_air_resp_callback(key, value)
if value == nil
then
return --value为空时退出
end
--**********************************