演示視頻
本文檔適合大彩PM系列串口屏產品使用。
1 VisualTFT軟件版本:V3.0.1.1112及以上的版本。
版本查看:
1) 打開VisualTFT軟件啟動頁面如圖2-1軟件版本,右上角會顯示的軟件版本號;
圖2-1軟件版本
2) 打開VisualTFT,在軟件右下角可以查看軟件版本圖2-2軟件版本,最新版本可登錄http://www.bdklxf.com/進行下載。
圖2-2軟件版本
2 串口屏硬件版本:M系列固件 >= V6.3.257.00。
版本查看:
a) 查看屏幕背面版本號貼紙;
b) VisualTFT與屏幕聯(lián)機成功后,右下角顯示的版本號。
本例程中,介紹4G的HTTP下載的應用,通過下載圖片、視頻、音頻說明下載流程。
1 《LUA 腳本API V1.4》可通過以下鏈接下載物聯(lián)型開發(fā)包獲取:
2 《LUA基礎學習》可通過以下鏈接下載物聯(lián)型開發(fā)包獲取:
3 LUA腳本初學者可以通過下面鏈接進行學習。
4 AT指令,可以通過下面子連接了解
5 Air系列4G模塊AT版本HTTP應用說明(若連接失效請在LUAT社區(qū)中查找)
https://ask.openluat.com/article/626/0
本文主要將以下2點進行說明:
1. 準備工程素材;
2. 配置串口屏工程;
5.1.1 準備工程素材
在實現(xiàn)例程前需要作以下3個準備:
1. 硬件平臺;
2. 軟件平臺;
3. UI素材;
該例程使用大彩M系列7寸串口屏DC80480M070_1111_0T為驗證開發(fā)平臺。如圖5-1所示;
圖5-1 M系列7寸串口屏
其他尺寸的串口屏均可借鑒此教程。
5.1.2 軟件平臺
使用大彩自主研發(fā)的上位機軟件VisualTFT配置工程,登錄http://www.bdklxf.com/下載。如圖5-2所示;
圖5-2下載軟件
本文主要介紹以下2點:
(1) 畫面配置
(2) LUA編輯
5.2.1 畫面配置
在畫面ID0中,觸發(fā)下載、下載過程、4G信號值及運營商3部分組成。
觸發(fā)下載:3個按鈕控件,作為觸發(fā)下載條件。
- 控件ID1~3依次為圖片下載、視頻下載以及音頻下載。
下載過程:控件ID4~8作為下載過程的體現(xiàn):
- 文本控件ID4用于顯示下載速度(min/Kb)
- 文本控件ID5顯示下載信息
- 進度條控件ID6為顯示下載進度
- 文本控件ID7用于顯示下載進度百分比
- 文本控件ID8顯示 ‘當前已下載大小/總下載大小’,單位Kb
4G信號和運營商:圖標控件控件ID10作為信號顯示、文本控件ID11用于顯示運營商。畫面配置如圖5-3所示:
注意:其他非關鍵控件不在一一介紹,下文不在累述
圖5-3 畫面配置
5.2.2 LUA編輯
本例程中,屏幕上電執(zhí)行初始化操作,如加載4G AT 指令的庫、初始化4G模塊、定時獲取運營商和信號值等。
當用戶點擊圖片下載的時,調用air_http_download()開始下載文件。在下載回調函數(shù)on_http_download_file_cb()里進行數(shù)據(jù)存儲,顯示下載信息等。若該文件單次下載不完,會多次回調on_http_download_file_cb()函數(shù),直至下載完畢,如圖5-4所示。
圖5-4 下載流程
1 初始化
調用系統(tǒng)函數(shù)on_init()執(zhí)行代碼如程序清單 1所示:
程序清單 1 初始化
▲下滑查看
核心API函數(shù)
1) dofile (filename)
加載文件:本例程中加載4G AT 指令的庫
- filename: 文件名
2) uart_set_baudrate3(speed)
設置串口3的波特率:串口3為屏幕和4G模塊通訊的串口
- speed: 通訊的波特率
3) on_air_recv_data(packet)
串口接收4G模塊的返回數(shù)據(jù)的回調。
- packet: 形參為表,字節(jié)數(shù)據(jù)。
4) air_set_callback (on_air_send_cb,on_air_resp_callback,on_air_log_cb)
- on_air_send_cb:屏幕向4G模塊發(fā)送回調函數(shù)
- on_air_resp_callback:4G向屏幕返回數(shù)據(jù)回調函數(shù)
- on_air_log_cb:用戶調試信息回調函數(shù)調試
5) air_hw_int()
6) at_cops_csq()
7) air_cmd_add(sendstr,ackstr,timeout,retry,callback)
- sendstr:屏幕向4G模塊發(fā)送AT指令
- ackstr:4G模塊應答屏幕的請求
- timeou:應答超時
- retry:超時重發(fā)次數(shù),可選
- callback:應答回調函數(shù),可選
注:如果沒有設置超時重發(fā)次數(shù),則超時時直接發(fā)送隊列中的下一條指令。
8) on_air_resp_callback(key, value)
- key:屏幕向4G模塊發(fā)送請求的AT指令
- value:4G模塊返回的數(shù)據(jù)
相關AT指令:
本例程中,涉及到獲取4G模塊初始化、運營商、信號值等AT交互指令回調的判斷,在on_air_resp_callback(key, value)回調函數(shù)中,判斷4G收發(fā)的相關AT指令,如下所示:
1) 網絡數(shù)據(jù)是否激活:
屏幕發(fā)送:AT+SAPBR=1,1。在air_hw_int()函數(shù)里發(fā)送。
屏幕接收:OK。on_air_resp_callback(key, value)函數(shù)里執(zhí)行4G返回數(shù)據(jù)的判斷
2) 獲取運營商:
屏幕發(fā)送:AT+COPS?。在at_cops_csq()函數(shù)了發(fā)送。
屏幕接收:OK。on_air_resp_callback(key, value)函數(shù)里執(zhí)行4G返回數(shù)據(jù)的判斷
3) 獲取信號值:
屏幕發(fā)送:AT+CSQ。在at_cops_csq()函數(shù)了發(fā)送。
屏幕接收:OK。on_air_resp_callback(key, value)函數(shù)里執(zhí)行4G返回數(shù)據(jù)的判斷
2 HTTP下載
用戶點擊按鈕控件ID1~3,HTTP協(xié)議下載對應的圖片、視頻、音頻文件。文件,每次向服務器讀取7K大小文件,然后在下載回調函里,每次以2K字節(jié)的數(shù)據(jù)寫入文件,代碼如程序清單2所示:
程序清單 2 HTTP下載
▲下滑查看
核心API函數(shù)
1) air_http_download(url,break_size,user_callback)
- url:HTTP下載資源連接,本例程中,將圖片、視頻以及音頻的資源路徑放在數(shù)組緩沖區(qū)中,如下所示:
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:單次網絡下載的包大小,單位字節(jié)(BYTE),本例程中為7K
- user_callback:改形參是一個函數(shù)變量,HTTP下載應答屏幕的回調函數(shù)。名稱可自定義命名,如本例程為on_http_download_file_cb。
2) on_http_download_file_cb(key, value)
- key:HTTP響應數(shù)據(jù)類型
- value:HTTP響應的內容
若key = ‘data_len’,表示HTTP下載的文件大小;value 表示為文件大小,單位byte。
若key = ‘data’,表示HTTP響應數(shù)據(jù)內容;value為數(shù)據(jù)內容,類型為字節(jié)數(shù)組,大小為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次重發(fā)數(shù)據(jù)請求。
若key = ‘dl_file_read_retry’,表示 HTTPACTION 查詢讀取數(shù)據(jù)超時。若超時,內部已經處理了3次重發(fā)數(shù)據(jù)請求。
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:存儲的數(shù)據(jù),類型可以是‘數(shù)組’或‘字符串’,本例程中,4G HTTP下載返回的數(shù)據(jù)類型是數(shù)組
- open_mode:文件打開模式:本例程中,每次寫文件,將數(shù)據(jù)寫在文件尾。
注意:本文不再闡述文件讀寫的詳細說明,可參考相應的資料,如《Lua應用-文件讀寫V1.0.pdf》
4) load_surface(filename)
- filename圖片文件路徑,支持JPEG/PNG
本例程中,當下載完成key=‘finish’時,且當前下載的是圖片文件(down_mode = 1),調用此API申請圖層繪圖,并調用redraw()刷新觸發(fā)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)
視頻播放回調函數(shù)
- msg:1-播放中,0-播放完畢
- v1:當前播放進度,當前已播時長,單位s
- v2:播放總進度, 當前視頻總時長,單位s
9) on_audio_callback (state)
10) on_draw(screen)
- 界面有動畫播放、視頻播放、RTC時間顯示的動態(tài)刷新;
- 用戶操作屏幕控件控件;
- 通過LUA腳本或串口指令更新控件;
- 通過執(zhí)行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卡