http定位和获取天气演示
本文档适合大彩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的http get的应用。
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
5
百度地图api逆地址解析:
http://lbsyun.baidu.com/index.php?title=webapi/guide/webservice-geocoding-abroad
6
济南易客云网络科技提供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初始化
▲下滑查看
核心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 获取经纬度
▲下滑查看
核心api函数
1) get_local_latitude_longitude()
获取经纬度。屏幕向4g模块发送获取经纬度的at指令’at cipgsmloc=1,1’,在on_air_resp_callback回调函数解析返回的数据。
3. 获取城市名
当获取经纬度后,根据经纬度,获取所在的城市,代码如程序清单 3所示:
程序清单 3 获取所在城市
▲下滑查看
核心api函数
1) baiduapi_get_local ()
函数内部封装4g at指令集http get资源请求函数air_http_get(),本例程中根据百度提供的资源接口,拼接经纬度发送请求。若百度响应改请求,则触发回到平baiduapi_get_local_cb()函数。
4. 获取时间/天气
当获取经中文城市名称后,获取所在的该城市的温度和天气,代码程序清单 4所示:
程序清单 4 获取天气
▲下滑查看
核心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卡