大彩串口屏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卡
航空和航天工业是基于粉末床的金属激光熔融技术
Owl车用摄像头融资1000万美金，总融资金额达到2800万美元
广州亚运会陆地安防设施
新一代“毫米波”视频输出技术了解一下
标清,标清是什么意思
大彩串口屏4G应用-HTTP定位和获取天气
电池bms主要功能有哪些？bms主要有哪六个功能
一氧化碳检测仪与可燃气体检测仪有什么区别？-欧森杰
电动汽车制造商特斯拉重组其自动驾驶软件团队,马斯克亲自掌管
小型气象站在农业发展中的应用，你了解多少？
二极管中的死区电压和导通电压有什么区别吗？
g80处理器和骁龙662哪个好
iphone8什么时候上市？iphone8最新消息：iphone8即将上市，iphone8五大黑科技爆料，9月上市
关于TIM延时讲解
ADI解决方案如何降低BOM供应短缺的风险
网络虚拟技术在现代制造业中的应用
比蝉翼还薄的音箱你见过吗？
焊锡丝的规格分类及普及？
差分信号的应用优势
Athlete+，被德国红点奖盯上的蓝牙耳机
本文档适合大彩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卡
航空和航天工业是基于粉末床的金属激光熔融技术
Owl车用摄像头融资1000万美金，总融资金额达到2800万美元
广州亚运会陆地安防设施
新一代“毫米波”视频输出技术了解一下
标清,标清是什么意思
大彩串口屏4G应用-HTTP定位和获取天气
电池bms主要功能有哪些？bms主要有哪六个功能
一氧化碳检测仪与可燃气体检测仪有什么区别？-欧森杰
电动汽车制造商特斯拉重组其自动驾驶软件团队,马斯克亲自掌管
小型气象站在农业发展中的应用，你了解多少？
二极管中的死区电压和导通电压有什么区别吗？
g80处理器和骁龙662哪个好
iphone8什么时候上市？iphone8最新消息：iphone8即将上市，iphone8五大黑科技爆料，9月上市
关于TIM延时讲解
ADI解决方案如何降低BOM供应短缺的风险
网络虚拟技术在现代制造业中的应用
比蝉翼还薄的音箱你见过吗？
焊锡丝的规格分类及普及？
差分信号的应用优势
Athlete+，被德国红点奖盯上的蓝牙耳机