模组Locator应用指导——以NT26U为例

Locator是一种高效定位技术，该功能通过移动网络小区的信息实现定位功能。
 

本文将以利尔达NT26U模组为例，详细介绍Locator相关的AT命令。

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

Locator授权Token配置

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

Locator相关AT命令详解

01

AT命令说明

1、定义

2、AT命令语句

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

AT命令及响应类型

02

AT声明

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

03

Locator AT命令详解

1、AT+QLBSCFG 配置Locator

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

注：

1.一般无需配置服务器域名/IP地址和端口，默认地址为：“http://locator-aep.xiot.senthink.com/locator/v0.1/locate”。用户如需使用其他服务器，可使用AT+QLBSCFG="server"配置服务器域名/IP地址和端口。和的值自动保存，其他参数值不保存，重启后丢失。

2.若需从Locator服务器获取时间，可在模组开机时执行AT+QLBSCFG="withTime"获取时间信息。

3.若需要更新当前ME时间，需在执行AT+QLBS前执行AT+QLBSCFG="timeUpdate",1。

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

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

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

平台侧操作

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

01

平台登录

登陆利尔达X平台：

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

控制台
 

02

Token值获取

模组定位服务

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

利尔达X平台获取Token值

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

模组侧操作

01

上电流程检查

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

02

激活网络

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

+CGACT: 1, 1, 100.87.213.174　　

OK

03

LBS定位示例

向上滑动阅览

AT+QLBSCFG="token"　　

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

DF714C72"　　//配置利尔达定位服务器Token值
OK

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

AT+QLBSCFG="latOrder",1　　//将位置输出顺序设置为：
+QLBS:,,
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定位配置时，所有参数部分的配置指令注意区分大小写。

错误码

值描述

术语缩写