大彩串口屏4G应用-HTTP定位和获取天气

一、适合范围

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

 

二、适合范围

1. VisualTFT软件版本：V3.0.1.1112及以上的版本。

2. 串口屏硬件版本： M系列固件 >= V6.3.257.00。

 

三、概述

本例程中，通过获取天气、定位来介绍4G的HTTP GET的应用。

 

四、参考资料

 

《LUA 脚本API V1.4》可通过以下链接下载物联型开发包获取:

http:/www.gz-dc.com/index.php?s=/List/index/cid/19.html

《LUA基础学习》可通过以下链接下载物联型开发包获取:

http:/www.gz-dc.com/index.php?s=/List/index/cid/19.html

 

LUA脚本初学者可以通过下面链接进行学习。

http://www.runoob.com/lua/lua-arrays.html

 

AT指令，可以通过下面子连接了解

http://www.openluat.com/Product/file/asr1802/Luat%204G模块AT命令手册V4.2.8.pdf

 

百度地图API逆地址解析:

http://lbsyun.baidu.com/index.php?title=webapi/guide/webservice-geocoding-abroad

 

济南易客云网络科技提供HTTP天气访问接口:

付费：https://www.tianqiapi.com/index/doc?version=v61

免费：https://www.tianqiapi.com/index/doc?version=v6

 

 

五、教程实现

本文主要将以下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配置工程，登录http://www.gz-dc.com/下载。如图5-2所示；

图5-2下载软件

 

 

5.2 配置串口屏工程

本文主要介绍以下2点：

(1) 画面配置

(2) LUA编辑

5.2.1 画面配置

在画面ID0中，SIM卡信息显示、地点、时间及天气4部分组成。

SIM卡信息：图标件ID1表示信号等级、文本控件ID2表示运营商、文本控件ID3用于显示SIM卡ID。

地点：文本控件ID7于显示所在的城市。

时间日期：文本控件ID5用于显示时间，文本控件ID6用于显示日期。

温度天气：文本控件ID8显示温度，文本控件ID9用于用于显示天气描述（多云、晴等），图标控件ID10显示多云等等的图标。

画面配置如图5-3所示：

注意：其他非关键控件不在一一介绍，下文不在累述

图5-3 画面配置

 

5.2..2 LUA编辑 

本例程中，屏幕上电执行初始化操作，如加载4G AT 指令的库、初始化和4G模块的交互的函数、初始化4G模块、开启定时器获取运营商和信号值。

当4G模块初始化完成后，获取运营商/信号值以及获取经纬度。当4G模块返回对应经纬度后，根据经纬度得到所在城市，在根据城市获取该城市的气温以及天气状态。流程如下所示。

 

1. 初始化

调用系统函数on_init()执行代码如程序清单 1所示：

 

温馨提示：因平台限制， 程序清单 1初始化 请移步下载http://www.gz-dc.com/article/id/6645.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) at_cops_csq()

    自定义封装函数，获取运行商和信号值

 

6) air_cmd_add(sendstr,ackstr,timeout,retry,callback)

    屏幕向4G模块发送AT指令

• sendstr：屏幕向4G模块发送AT指令
• ackstr  ：4G模块应答屏幕的请求
• timeou ：应答超时
• retry   ：超时重发次数，可选
• callback：应答回调函数，可选

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

 

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

 

2. 获取经纬度

当4G初始化完成后，获取经纬度，代码如程序清单 2所示：

 

温馨提示：因平台限制，程序清单 2  获取经纬度 请移步下载http://www.gz-dc.com/article/id/6645.html

 

核心API函数

1) get_local_latitude_longitude()

    获取经纬度。屏幕向4G模块发送获取经纬度的AT指令’AT+CIPGSMLOC=1,1’,在on_air_resp_callback回调函数解析返回的数据。

 

3. 获取城市名

当获取经纬度后，根据经纬度，获取所在的城市，代码如程序清单 3所示：
 

温馨提示：因平台限制，程序清单 3  获取所在城市 请移步下载http://www.gz-dc.com/article/id/6645.html

 

核心API函数

1) baiduAPI_get_local ()

函数内部封装4G AT指令集HTTP Get资源请求函数air_http_get（），本例程中根据百度提供的资源接口，拼接经纬度发送请求。若百度响应改请求，则触发回到平baiduAPI_get_local_cb（）函数。

 

4. 获取时间/天气

当获取经中文城市名称后，获取所在的该城市的温度和天气，代码程序清单 4所示：

 

温馨提示：因平台限制， 程序清单 4  获取天气 请移步下载http://www.gz-dc.com/article/id/6645.html

 

核心API函数

1) http_get_wea_and_tim e()

函数内部封装4G AT指令集HTTP Get资源请求函数air_http_get（），本例程中根据济南易客云网络科技提供付费和免费的资源接口。其中免费的访问获取次数是200次/天，付费的是5000次/天。该服务器响应请求自动回调on_get_wea_cb处理响应的信息。同理，获取同步云端时间调用http_get_time()即可。

 

5.3 下载工程

在菜单栏中，文件→打开工程目录，在‘dciot_build’目录的‘private’文件夹拷贝到SD卡中，如图5-4和图5-5所示；把SD卡接上串口屏后重新上电，等到提示烧录工程成功后，拔掉SD卡重新上电即可。

图5-4下载文件

 

图5-5拷贝到SD卡