演示视频
本文档适合大彩pm系列串口屏产品使用。
1 visualtft软件版本:v3.0.1.1112及以上的版本。
版本查看:
1) 打开visualtft软件启动页面如图2-1软件版本,右上角会显示的软件版本号;
图2-1软件版本
2) 打开visualtft,在软件右下角可以查看软件版本图2-2软件版本,最新版本可登录http://www.gz-dc.com/进行下载。
图2-2软件版本
2 串口屏硬件版本:m系列固件 >= v6.3.257.00。
版本查看:
a) 查看屏幕背面版本号贴纸;
b) visualtft与屏幕联机成功后,右下角显示的版本号。
本例程中,介绍4g的http下载的应用,通过下载图片、视频、音频说明下载流程。
1 《lua 脚本api v1.4》可通过以下链接下载物联型开发包获取:
2 《lua基础学习》可通过以下链接下载物联型开发包获取:
3 lua脚本初学者可以通过下面链接进行学习。
4 at指令,可以通过下面子连接了解
5 air系列4g模块at版本http应用说明(若连接失效请在luat社区中查找)
https://ask.openluat.com/article/626/0
本文主要将以下2点进行说明:
1. 准备工程素材;
2. 配置串口屏工程;
5.1.1 准备工程素材
在实现例程前需要作以下3个准备:
1. 硬件平台;
2. 软件平台;
3. ui素材;
该例程使用大彩m系列7寸串口屏dc80480m070_1111_0t为验证开发平台。如图5-1所示;
图5-1 m系列7寸串口屏
其他尺寸的串口屏均可借鉴此教程。
5.1.2 软件平台
使用大彩自主研发的上位机软件visualtft配置工程,登录http://www.gz-dc.com/下载。如图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 初始化
▲下滑查看
核心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)
- on_air_send_cb:屏幕向4g模块发送回调函数
- on_air_resp_callback:4g向屏幕返回数据回调函数
- on_air_log_cb:用户调试信息回调函数调试
5) air_hw_int()
6) at_cops_csq()
7) air_cmd_add(sendstr,ackstr,timeout,retry,callback)
- sendstr:屏幕向4g模块发送at指令
- ackstr:4g模块应答屏幕的请求
- timeou:应答超时
- retry:超时重发次数,可选
- callback:应答回调函数,可选
注:如果没有设置超时重发次数,则超时时直接发送队列中的下一条指令。
8) on_air_resp_callback(key, value)
- 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下载
▲下滑查看
核心api函数
1) air_http_download(url,break_size,user_callback)
- 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)
- 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)
- 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)
- surface图层资源指针
6) play_sound(filename)
- filenam:音频文件路径,支持mp3/wav
注意:本文不再阐述音频的详细说明,,可参考相应的资料,如 《m系列-播放sd卡里视频、音频文件 v1.0.pdf》
7) play_video(file,left,top,width,height)
- file:文件路径,支持mp4
- left:起始坐标x
- top:起始坐标y
- width:视频显示的宽度
- height:视频显示的高度
注意:本文不再阐述视频的详细说明,,可参考相应的资料,如 《m系列-播放sd卡里视频、音频文件 v1.0.pdf》
8) on_video_notify(msg,v1, v2)
视频播放回调函数
- msg:1-播放中,0-播放完毕
- v1:当前播放进度,当前已播时长,单位s
- v2:播放总进度, 当前视频总时长,单位s
9) on_audio_callback (state)
10) on_draw(screen)
- 界面有动画播放、视频播放、rtc时间显示的动态刷新;
- 用户操作屏幕控件控件;
- 通过lua脚本或串口指令更新控件;
- 通过执行redraw;
11) draw_surface (surface,dstx,dsty,width,height,srcx,srcy)
- 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-5所示;
图5-5编译成功
在菜单栏中,文件→打开工程目录,在‘dciot_build’目录的‘private’拷贝到sd卡中,如图5-6和图5-7所示;把sd卡接上串口屏后重新上电,等到提示烧录工程成功后,拔掉sd卡重新上电即可。
图5-6量产向导
图5-7拷贝到sd卡