大彩串口屏4G应用-4G模块初始化流程

卡米拉

http://video.gz-dc.com/4G%E6%A8%A1%E5%9D%97%E5%88%9D%E5%A7%8B%E5%8C%96%E8%A7%86%E9%A2%91.mp4

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%204G模块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库

1. function on_init()
   
2.    
   
3.     dofile(‘'air724at.lua') --加载 4G AT指令库文件
   
4.    ......
   
5. end

复制代码

6.1 设置串口收发回调函数

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

程序清单 2 设置回调函数

1. <font color="#000000">--[[*******************************************************************
   
2. ** Function name:  on_init
   
3. ** Descriptions:   系统初始化时，执行此回调函数。
   
4. **                    注意：回调函数的参数和函数名固定不能修改
   
5. *******************************************************************--]]
   
6. function on_init()
   
7.    
   
8.     dofile('air724at.lua')                  --加载 http.lua 文件
   
9.     air_set_callback(on_air_send_cb,on_air_resp_callback,on_air_log_cb)  --设置4G库函数的命令发送函数，命令回调函数、调试信息打印函数
   
10.      ......
    
11. end</font>

复制代码

air_set_callback（）函数原型如程序清单 3所示；

程序清单 3 函数原型

1. <font color="#000000">--[[******************************************************************
   
2. ** Function name:  air_set_callback
   
3. ** Descriptions :  设置回调函数
   
4. ** @send_cb      :  向4G发送数据的回调函数
   
5. ** @resp_cb      :  所有4G返回的数据的回调函数
   
6. ** @log_cb       :  调试信息回调函数
   
7. ******************************************************************--]]
   
8. function air_set_callback(send_cb,resp_cb,log_cb)
   
9.     send_callback = send_cb
   
10.     resp_callback = resp_cb
    
11.     log_callback = log_cb
    
12. end</font>

复制代码

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

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

1. <font color="#000000">--[[*****************************************************************
   
2. ** Function name:  on_air_send_cb
   
3. ** Descriptions:   4G模块-发送数据
   
4. ******************************************************************--]]
   
5. function on_air_send_cb(msg)
   
6.     if air_debug_mode==1  
   
7.     then
   
8.         uart_send_string(msg)   -- air_debug_mode==1 ，使用虚拟屏调试，通过串口1发送数据
   
9.         my_print(msg)
   
10.     else
    
11.         uart_send_string3(msg)   -- air_debug_mode~=0 ，使用实体屏调试，通过串口3发送数据
    
12.     end
    
13. end</font>

复制代码

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

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

1. <font color="#000000">--[[****************************************************************
   
2. ** Function name:  on_air_resp_callback
   
3. ** Descriptions :  4G模块-数据回调接口
   
4. ** @key           :  屏幕->4G模块的发送请求
   
5. ** @value         :  4G模块->返回的数据
   
6. ****************************************************************--]]
   
7. function on_air_resp_callback(key, value)  
   
8.     if value == nil
   
9.     then
   
10.         return              --value为空时退出
    
11.     end
    
12.     ......
    
13.     if key ~= nil
    
14.     then
    
15.         return              -- key为空时退出
    
16.     end
    
17. ......
    
18. end</font>

复制代码

将收发函数通过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模块初始化

1. --[[***************************************************************************
   
2. ** Function name:  on_init
   
3. ** Descriptions:   系统初始化时，执行此回调函数。
   
4.                    注意：回调函数的参数和函数名固定不能修改
   
5. ***************************************************************************--]]
   
6. function on_init()
   
7.    
   
8.     dofile('air724at.lua')                --加载 http.lua 文件
   
9.     uart_set_baudrate3(115200)          --设置与4G模块通讯的串口3的波特率为115200
   
10.     air_set_callback(on_air_send_cb,on_air_resp_callback,on_air_log_cb) --设置4G库函数的命令发送函数，命令回调函数、调试信息打印函数
    
11.     air_hw_int()                      --4G模块初始化设置
    
12. 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。