大彩串口屏4g应用-龙8客户端下载

4g模块初始化视频


一、适用范围


本文档适合大彩pm 4g系列串口屏产品使用。



二、开发环境版本


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

版本查看:

1) 查看屏幕背面版本号贴纸;

2) visualtft与屏幕联机成功后,右下角显示的版本号。



三、概述


本例程主要讲述4g模块上电初始化时所涉及的api函数的具体作用。



四、参考资料


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指令,可以通过下面子连接了解

http://www.openluat.com/product/file/asr1802/luat 4g模块at命令手册v4.2.8.pdf




五、开机


串口屏上电后,需要控制4g模块的pwrkey管脚启动模块。主芯片管脚拉高时,pwrkey管脚被拉低,模块启动,如图所示。这部分内容已经封装在air724at.lua库的air_hw_int()函数中。

图片

图片




六、4g初始化流程


本文主要介绍4g模块初始化的时需要执行的指令以及所使用api函数的详细说明,执行流程如下。


图片

 5-1 流程图


6.1 加载4g api库

4g模块lua函数库是对需要用到的at命令进行封装的库,初始化时需要调用库中相关的回调函数,所有需要在屏幕上电初始化的同时将4g api库加载。如程序清单 1所示


程序清单 1 加载4g库

function on_init()
    
    dofile(‘'air724at.lua') --加载 4g at指令库文件
   ......
end
6.1 设置串口收发回调函数


通过函数air_set_callback()设置对应的4g通讯相关数据收发函数。该函数主要用于定义串口屏与4g模块的通讯串口的数据发送函数、接收函数、调试信息处理函数。此函数需要再上电初始化时执行,如程序清单 2所示。


程序清单 2 设置回调函数

--[[*******************************************************************
** function name:  on_init
** descriptions:   系统初始化时,执行此回调函数。
**                    注意:回调函数的参数和函数名固定不能修改
*******************************************************************--]]
function on_init()
    
    dofile('air724at.lua')                  --加载 http.lua 文件
    air_set_callback(on_air_send_cb,on_air_resp_callback,on_air_log_cb)  --设置4g库函数的命令发送函数,命令回调函数、调试信息打印函数
     ......
end

air_set_callback()函数原型如程序清单 3所示;


程序清单 3 函数原型

--[[******************************************************************
** function name:  air_set_callback
** descriptions :  设置回调函数
** @send_cb      :  向4g发送数据的回调函数
** @resp_cb      :  所有4g返回的数据的回调函数
** @log_cb       :  调试信息回调函数
******************************************************************--]]
function air_set_callback(send_cb,resp_cb,log_cb)
    send_callback = send_cb
    resp_callback = resp_cb
    log_callback = log_cb
end

实体屏需要通过串口3将数据传递给4g模块。on_air_send_cb()数据发送函数定义,如程序清单 4所示;


程序清单 4 重定义发送函数

--[[*****************************************************************
** function name:  on_air_send_cb
** descriptions:   4g模块-发送数据
******************************************************************--]]
function on_air_send_cb(msg)
    if air_debug_mode==1  
    then
        uart_send_string(msg)   -- air_debug_mode==1 ,使用虚拟屏调试,通过串口1发送数据
        my_print(msg)
    else
        uart_send_string3(msg)   -- air_debug_mode~=0 ,使用实体屏调试,通过串口3发送数据
    end
end

on_air_resp_callback()串口收发函数定义如程序清单 5所示;


程序清单 5 重定义接收函数

--[[****************************************************************
** 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
    ......
    if key ~= nil
    then
        return              -- key为空时退出
    end
......
end

将收发函数通过air_set_callback()设置系统数据收发函数后,当需要发送时调用on_air_send_cb()可以将指令传递给4g模块,当4g模块接收到数据后,系统会调用on_air_resp_callback()函数并将4g模块接收到的数据传递进函数。


6.3 4g模块初始化

当串口屏上电初始化时,需要同步将4g模块开机初始化,所以这里需要将4g模块的初始化函数air_hw_int()放置在on_init()函数里面,以便于串口屏上电时调用。如程序清单 6所示;


程序清单 6 4g模块初始化

--[[***************************************************************************
** function name:  on_init
** descriptions:   系统初始化时,执行此回调函数。
                   注意:回调函数的参数和函数名固定不能修改
***************************************************************************--]]
function on_init()
    
    dofile('air724at.lua')                --加载 http.lua 文件
    uart_set_baudrate3(115200)          --设置与4g模块通讯的串口3的波特率为115200
    air_set_callback(on_air_send_cb,on_air_resp_callback,on_air_log_cb) --设置4g库函数的命令发送函数,命令回调函数、调试信息打印函数
    air_hw_int()                      --4g模块初始化设置
end


6.4 初始化相关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_cmd_add(sendstr,ackstr,timeout,retry,callback)

屏幕向4g模块发送at指令


  • sendstr:屏幕向4g模块发送at指令
  • ackstr:4g模块应答屏幕的请求
  • timeout:应答超时
  • retry:超时重发次数,可选
  • callback:应答回调函数,可选


注:如果没有设置超时重发次数,则超时时直接发送队列中的下一条指令。

 

6) 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模块->屏幕,返回的数据


 

7) my_print(debug_msg)

当en_debug_msg等0时不显示调试信息;等1时虚拟屏显示调试信息; 等2时实体屏串口1输出。


  • debug_msg:需要串口输出的信息


注:虚拟屏调试时, en_debug_msg 必须不等于2。实体屏调试时, en_debug_msg 必须不等于1。




欢迎联系我司销售咨询