大彩串口屏4G应用-HTTP下载文件

一、适用范围
本文档适合大彩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点进行说明:
1. 准备工程素材;
2. 配置串口屏工程;
5.1 准备工程素材
5.1.1 准备工程素材
在实现例程前需要作以下3个准备:
1. 硬件平台;
2. 软件平台;
3. ui素材;
该例程使用大彩m系列7寸串口屏dc80480m070_1111_0t为验证开发平台。如图5-1所示;
图5-1  m系列7寸串口屏
其他尺寸的串口屏均可借鉴此教程。
5.1.2 软件平台
使用大彩自主研发的上位机软件visualtft配置工程,登录大彩官网下载。如图5-2所示;
图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 初始化 详见http://www.gz-dc.com/article/id/6782.html
核心api函数
1) dofile (filename)
加载文件:本例程中加载4g at 指令的库
filename: 文件名 
2) uart_set_baudrate3(speed)
设置串口3的波特率:串口3为屏幕和4g模块通讯的串口
speed: 通讯的波特率 
3) on_air_recv_data(packet)
串口接收4g模块的返回数据的回调。
packet: 形参为表,字节数据。 
4) air_set_callback (on_air_send_cb,on_air_resp_callback,on_air_log_cb)
设置4g库里的回调函数。形参类型为函数,参数依次为命令发送函数,命令回调函数、调试信息打印函数,可自定义函数名。
on_air_send_cb:屏幕向4g模块发送回调函数on_air_resp_callback:4g向屏幕返回数据回调函数on_air_log_cb:用户调试信息回调函数调试 
5) air_hw_int()
4g at 指令的库函数,初始化4g模块
6) at_cops_csq()
自定义封装函数,获取运行商和信号值
7) air_cmd_add(sendstr,ackstr,timeout,retry,callback)
屏幕向4g模块发送at指令
sendstr:屏幕向4g模块发送at指令ackstr:4g模块应答屏幕的请求timeou:应答超时retry:超时重发次数,可选callback:应答回调函数,可选注:如果没有设置超时重发次数,则超时时直接发送队列中的下一条指令。
8) on_air_resp_callback(key, value)
4g应答屏幕回调函数:屏幕发送at指令,4g应答后均会回调该函数,初始化设置:air_set_callback(on_air_send_cb,on_air_resp_callback,on_air_log_cb)。
key:屏幕向4g模块发送请求的at指令value:4g模块返回的数据 
相关at指令:
本例程中,涉及到获取4g模块初始化、运营商、信号值等at交互指令回调的判断,在on_air_resp_callback(key, value)回调函数中,判断4g收发的相关at指令,如下所示:
1) 网络数据是否激活: 
屏幕发送:at+sapbr=1,1。在air_hw_int()函数里发送。
屏幕接收:ok。on_air_resp_callback(key, value)函数里执行4g返回数据的判断
2) 获取运营商:
屏幕发送:at+cops?。在at_cops_csq()函数了发送。
屏幕接收:ok。on_air_resp_callback(key, value)函数里执行4g返回数据的判断
3) 获取信号值:
屏幕发送:at+csq。在at_cops_csq()函数了发送。
屏幕接收:ok。on_air_resp_callback(key, value)函数里执行4g返回数据的判断
2  http下载
用户点击按钮控件id1~3,http协议下载对应的图片、视频、音频文件。文件,每次向服务器读取7k大小文件,然后在下载回调函里,每次以2k字节的数据写入文件,代码如程序清单2所示:
因平台限制,程序清单 2  http下载 详见http://www.gz-dc.com/article/id/6782.html
核心api函数
1) air_http_download(url,break_size,user_callback)
4g库函数,http下载文件。
url:http下载资源连接,本例程中,将图片、视频以及音频的资源路径放在数组缓冲区中,如下所示: 
local httpdownfile_uritb =                    {'http://video.gz-dc.com/logo_480320_165kv2.jpg',                     'http://video.gz-dc.com/video2_62m9s.mp4',                     'http://video.gz-dc.com/music503k32s.mp3'}
break_size:单次网络下载的包大小,单位字节(byte),本例程中为7kuser_callback:改形参是一个函数变量,http下载应答屏幕的回调函数。名称可自定义命名,如本例程为on_http_download_file_cb。 
2) on_http_download_file_cb(key, value)
用户自定义函数,http下载回调函数。
key:http响应数据类型value:http响应的内容若key = ‘data_len’,表示http下载的文件大小;value 表示为文件大小,单位byte。
若key = ‘data’,表示http响应数据内容;value为数据内容,类型为字节数组,大小为air_http_download(url,break_size,user_callback)设置的break_size。
若key = ‘finish’,表示http下载完成;value为文件总大小,单位byte
若key = ‘timeout’,表示http下载超时。
若key = ‘dl_file_head_retry’,表示 httpaction 查询头信息超时。若超时,内部已经处理了3次重发数据请求。
若key = ‘dl_file_read_retry’,表示 httpaction 查询读取数据超时。若超时,内部已经处理了3次重发数据请求。
3) my_write_filedata(file, data, open_mode)
用户自定义函数,写文件。本例程,将4g http下载返回的数据写在文件中。
file:存储路径,本例程中,将图片、视频以及音频下载后的文件指定存储在屏内(3为屏内盘符),路径定义如下所示: 
local httpdownsave_filetb = {'3:/image.jpg','3:/bench.mp4', '3:/my dream.mp3'}
data:存储的数据,类型可以是‘数组’或‘字符串’,本例程中,4g http下载返回的数据类型是数组open_mode:文件打开模式:本例程中,每次写文件,将数据写在文件尾。注意:本文不再阐述文件读写的详细说明,可参考相应的资料,如《lua应用-文件读写v1.0.pdf》
4) load_surface(filename)
加载图片到图层。
filename图片文件路径,支持jpeg/png本例程中,当下载完成key=‘finish’时,且当前下载的是图片文件(down_mode = 1),调用此api申请图层绘图,并调用redraw()刷新触发on_draw()显示。
注意:本文不再阐述绘图的详细说明,可参考相应的资料,如《lua教程7-绘图api使用说明.pdf》
5) destroy_surface (surface)
销毁图层,w系列支持、m系列 >= v6.1.241.00、f系列不支持
surface图层资源指针 
6) play_sound(filename)
播放指定的声音文件
filenam:音频文件路径,支持mp3/wav本例程中,当下载完成key=‘finish’时,且当前下载的是音频文件(down_mode = 3),调用此api播放音频。若播放完毕,触发音频播放结束通知on_audio_callback(),在重复播放该音频文件。
注意:本文不再阐述音频的详细说明,,可参考相应的资料,如 《m系列-播放sd卡里视频、音频文件 v1.0.pdf》
7) play_video(file,left,top,width,height)
播放指定的视频文件
file:文件路径,支持mp4left:起始坐标xtop:起始坐标ywidth:视频显示的宽度height:视频显示的高度本例程中,当下载完成key=‘finish’时,且当前下载的是视频文件(down_mode = 2),调用此api播放视频,播放过程触发on_video_notify(msg,v1, v2)。若msg=0,表示播放完毕,在重复播放该视频文件。
注意:本文不再阐述视频的详细说明,,可参考相应的资料,如 《m系列-播放sd卡里视频、音频文件 v1.0.pdf》
8) on_video_notify(msg,v1, v2)
视频播放回调函数
msg:1-播放中,0-播放完毕v1:当前播放进度,当前已播时长,单位sv2:播放总进度, 当前视频总时长,单位s 
9) on_audio_callback (state)
声音播放结束回调通知,state保留未使用。
10) on_draw(screen)
当界面的显示内容需要更新时,系统自动调用此函数,用户在此函数中添加自定义的绘图操作。用户绘制的内容叠加在画面内容之上。此函数为系统回调函数,用户不要直接调用。下面几种情况会触发此函数:
界面有动画播放、视频播放、rtc时间显示的动态刷新;用户操作屏幕控件控件;通过lua脚本或串口指令更新控件;通过执行redraw;界面上有任何变化,都会触发此函数
11) draw_surface (surface,dstx,dsty,width,height,srcx,srcy)
绘制图层,相比于draw_image_file,此方法效率较高,w系列支持、m系列 >= v6.1.241.00支持(裁剪显示)、f系列不支持
surface图层资源指针dstx图片显示x坐标dsty图片显示y坐标width图片显示宽度[可选]height图片显示高度[可选]srcx图片裁剪x坐标[可选]srcy图片裁剪y坐标[可选]例如:
平铺显示:draw_surface(surface, dstx, dsty)
缩放显示:draw_surface(surface, dstx, dsty, width, height),此方法m型不支持
裁剪显示:draw_surface(surface, dstx, dsty, width, height ,srcx, srcy)
5.3 下载工程
工程编译成功后在输出窗口会提示编译成功,如图5-5所示;
图5-5编译成功
在菜单栏中,文件→打开工程目录,在‘dciot_build’目录的‘private’拷贝到sd卡中,如图5-6和图5-7所示;把sd卡接上串口屏后重新上电,等到提示烧录工程成功后,拔掉sd卡重新上电即可。
图5-6量产向导
图5-7拷贝到sd卡

有源增益控制时钟控制双极性步进电机驱动器
LM317集成可调稳压器的电源电路图和简介
缓冲器反馈路径中的电阻器:问问为什么!
基于Modbus的应急电源监控系统的研究
如何加快推动5G和工业互联网的融合发展
大彩串口屏4G应用-HTTP下载文件
世界最快机械硬盘:1GB缓存、400MB/s写入!
采用DSP+MCU方案实现实时监测电力参数的监测仪表的设计
电源设计MOS管驱动电路
加速度计功耗内卷,但别忘了这些性能
数码相机摄像机充电电池选购与使用中的一些注意事项
全方位解决方案:OLED拼接屏服务如何确保数字展示成功
麒麟950、联发科Helio X25、骁龙820性能混战
基于ARM微处理器的MPEG-2解复用器设计方案
国产智能驾驶传感器系统龙头募资4亿开拓产能,豪恩气电开启申购
山西水电气暖能源可视化管理, 电力能源管理系统
BCM设计与开发的全面详解
华为P30 Pro对比苹果iPhone XS Max究竟谁更强
关于aigo移动固态硬盘S7 Pro不掉速的秘密,你造吗?
华为宣布Mate 10将在2月正式登陆美国