大彩串口屏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），本例程中为7K
• user_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.mp 3'}

 

• 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：文件路径，支持MP4
• left：起始坐标x
• top：起始坐标y
• width：视频显示的宽度
• 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:当前播放进度，当前已播时长，单位s
• v2:播放总进度, 当前视频总时长，单位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卡