NT26U Locator应用指导

yutao

　　1 引言

　　本文档详细介绍了在Lierda NT26U模组Locator相关的AT命令。Locator是一种高效定位技术，该功能通过移动网络小区的信息实现定位功能。

　　Locator鉴权

　　使用Locator定位服务，需要用于身份验证的授权Token。重启模组或关机后，授权Token仍然有效。AT+QLBSCFG="Token"用于查看首次使用该服务时是否已经配置了Token值。若未配置，请输入Token值。具体步骤如下图所示。

图1.1 Locator授权Token配置

　　注：为方便阅读，本文AT示例省略了部分回车换行，实际返回值以《AT指令手册》或模组实测为准。

　　2 Locator相关AT命令详解

　　2.1 AT命令说明

　　2.1.1 定义

　　2.1.2 AT命令语句

　　前缀AT或at必须加在每个命令行的开头。输入<CR>将终止命令行。通常，命令后面跟随形式为<CR><LF><response><CR><LF>的响应。在本文档中表现命令和响应的表格中，省略了<CR><LF>，仅显示命令和响应。

表2-1 AT命令及响应类型

　　2.2 AT声明

　　本文中的示例仅为方便用户了解AT命令的使用方法，不构成利尔达对终端流程设计的建议或意见，也不代表模组应被设置成相应示例中的状态。某些AT命令存在多个示例，这些示例之间不存在承接关系或连续性。

　　2.3 Locator AT命令详解

　　2.3.1 AT+QLBSCFG 配置Locator

　　该命令用于查询/设置Locator AT相关配置信息。

　　注：1.一般情况下，不需要配置服务器域名/IP地址和端口。默认地址为“http://locator-aep.xiot.senthink.com/locator/v0.1/locate”。用户如需使用其他服务器，可以使用AT+QLBSCFG="server"配置服务器域名/IP地址和端口。<asynch_mode>和<Token_value>的值自动保存，其他参数值不保存，重启后丢失。
　　　　2.若需要从Locator服务器获取时间，可以在模组开机时执行AT+QLBSCFG="withTime"获取时间信息。
　　　　3.若需要更新当前ME时间，需在执行AT+QLBS前执行AT+QLBSCFG="timeUpdate",1。

　　2.3.2 AT+QLBS通过Locator获取位置信息

　　该命令用于通过Locator获取位置信息。

　　注：Locator支持Wi-Fi辅助定位。对于不支持自动Wi-Fi扫描的模组，也可以通过 AT 命令手动输入Wi-Fi信息以获取位置信息。

　　3 平台侧操作

　　用户在使用模组进行Locator定位时，需要申请并配置Token值，这里给出利尔达X平台定位服务器的环境搭建流程和使用指导。

　　3.1 平台登录

　　登陆利尔达X平台：https://account.xiot.senthink.com/，未注册的用户可使用手机号和邮箱进行注册，登录后点击“控制台”。

图3.1 控制台

　　3.2 Token值获取

图3.2 模组定位服务

　　登陆后平台界面如图3.2所示，点击“模组定位服务”进入该窗口界面，开通服务后获取Token值如图3.3所示：

图3.3 利尔达X平台获取Token值

　　使用LBS定位服务时，必须先申请并配置Token值后再使用，否则定位次数会受到限制。

　　4 模组侧操作

　　4.1上电流程检查

　　AT　　//判断模组是否上电开机成功
　　AT+CPIN?　　//判断是否读取SIM卡成功
　　AT+CEREG? 　　//判断PS域附着状态，第二个参数为1或5表示附着正常

　　4.2激活网络

　　AT+CGACT=1　　//模组上电后，激活模组网络
　　+CGACT: 1, 1, 100.87.213.174
　　OK

　　4.3 LBS定位示例

　　AT+QLBSCFG="token"　　+QLBSCFG: "token",""
　　OK

　　AT+QLBSCFG="token","B84E427D95B1DF4A3F49B18DDF714C72"　　//配置利尔达定位服务器Token值
　　OK

　　AT+QLBSCFG="token"　　//查询利尔达定位服务器的Token值
　　+QLBSCFG: "Token","****************"
　　OK

　　AT+QLBSCFG="latOrder",1　　//将位置输出顺序设置为：
　　+QLBS: <loc_result>,<latitude>,<longitude>
　　OK

　　AT+QLBS　　//通过(多基站)三角测量法获取位置信息
　　+QLBS:0,119.98743569863267,30.27717016278133
　　OK

　　AT+QLBSCFG="asynch",1　　//配置为异步定位模式(该指令执行后在定位结果回复前可发送其他指令)
　　OK

　　AT+QLBS　　//通过(多基站)三角测量法获取位置信息
　　OK　　//返回OK后可执行其他AT命令
　　+QLBS:0,119.98743569863267,30.27717016278133

　　注：用户使用AT指令进行LBS定位配置时，所有参数部分的配置指令注意区分大小写。

　　5 错误码

表5-1 <err>值描述

　　6 术语缩写

表6-1 术语缩写