概述

QuecPython 结合 GNSS（全球导航卫星系统）模块为物联网设备提供开箱即用的定位能力解决方案。该方案支持 GPS/北斗/GLONASS/Galileo 多系统联合定位，为物联网开发者提供从硬件接入到云端服务的全栈式定位解决方案。

优势特点

• 多体系定位：支持 GNSS、LBS 和 Wi-Fi 定位功能
• 极简开发：高度封装 API 接口，无需编写底层驱动

功能概述

主要介绍如何使用 QuecPython 开发板的内置 GNSS 功能实现定位信息的获取，典型的编程工作流程分为以下几个部分：

• GNSS 初始化
• 定位数据获取

GNSS 初始化

该方法用于实现模组内置 GNSS 模块功能的初始化。

quecgnss.init()

API 详情请参考 quecgnss.init。

定位数据获取

该方法用于读取 GNSS 定位数据。

quecgnss.read(size)

API 详情请参考 quecgnss.read。

参数设置

该方法用于设置 GNSS 参数，包括卫星系统、NMEA 语句类型、是否使用 AGNSS 和 APFLASH 等。

quecgnss.configSet(config_type, config_value)

API 详情请参考 quecgnss.configSet。

示例代码

import quecgnss# 初始化
quecgnss.init()# 读取数据
data = quecgnss.read(4096)# 打印数据
print(data[1].decode())

运行结果

以下为运行结果示例，主要介绍一下定位数据的内容。

# 运行结果167,169,170,,,,,,,,1.773,1.013,1.455*15
$GPGSV,2,1,8,3,23,303,34,16,32,219,28,22,74,98,26,25,16,43,25*77
$GPGSV,2,2,8,26,70,236,28,31,59,12,38,32,55,127,34,4,5,,21*49
$BDGSV,2,1,8,163,51,192,32,166,70,11,31,167,52,197,32,169,59,334,31*61
$BDGSV,2,2,8,170,40,205,31,161,5,,31,164,5,,27,165,5,,29*59
$GNRMC,022326.000,A,3149.324624,N,11706.921702,E,0.000,261.541,180222,,E,A*38
$GNGGA,022326.000,3149.324624,N,11706.921702,E,1,12,1.013,-8.580,M,0,M,,*47
$GNGLL,3149.324624,N,11706.921702,E,022326.000,A,A*44
$GNGSA,A,3,31,32,3,16,22,25,26,,,,,,1.773,1.013,1.455*1C
$GNGSA,A,3,163,166,167,169,170,,,,,,,,1.773,1.013,1.455*15
$GPGSV,2,1,8,3,23,303,34,16,32,219,27,22,74,98,26,25,16,43,25*78
$GPGSV,2,2,8,26,70,236,28,31,59,12,37,32,55,127,34,4,5,,20*47
$BDGSV,2,1,8,163,51,192,32,166,70,11,31,167,52,197,32,169,59,334,31*61
$BDGSV,2,2,8,170,40,205,31,161,5,,31,164,5,,27,165,5,,29*59
$GNRMC,022327.000,A,3149.324611,N,11706.921713,E,0.000,261.541,180222,,E,A*3F
$GNGGA,022327.000,3149.324611,N,11706.921713,E,1,12,1.013,-8.577,M,0,M,,*48
$GNGLL,3149.324611,N,11706.921713,E,022327.000,A,A*43
...... # 数据较多，省略
$GNGSA,A,3,31,32,3,16,22,25,26,,,,,,1.837,1.120,1.456*11
$GNGSA,A,3,163,166,167,169,170,,,,,,,,1.837,1.120,1.456*18
$GPGSV,2,1,8,3,23,302,27,16,32,220,26,22,73,101,27,25,16,43,27*45
$GPGSV,2,2,8,26,70,237,28,31,59,13,33,32,54,128,28,4,5,,24*44
$BDGSV,2,1,8,163,51,192,33,166,71,11,35,167,52,198,33,169,59,334,34*6E
$BDGSV,2,2,8,170,40,205,32,161,5,,33,164,5,,28,165,5,,30*5F
$GNRMC,022507.000,A,3149.324768,N,11706.922344,E,0.000,261.541,180222,,E,A*31
$GNGGA,022507.000,3149.324768,N,11706.922344,E,1,12,1.120,-8.794,M,0,M,,*48
$GNGLL,3149.324768,N,11706.922344,E,022507.000,A,A*4D
$GNGSA,A,3,31,32,3,16,22,25,26,,,,,,1.837,1.120,1.455*12
$GNGSA,A,3,163,166,167,169,170,,,,,,,,1.837,1.120,1.455*1B
$GPGSV,2,1,8,3,23,302,26,16,32,220,26,22,73,101,27,25,16,43,26*45
$GPGSV,2,2,8,26,70,237,28,31,59,13,32,32,54,128,28,4,5,,24*45
$BDGSV,2,1,8,163,51,192,24,166,71,11,35,167,52,198,33,169,59,334,34*68
$BDGSV,2,2,8,170,40,205,31,161,5,,33,164,5,,28,165,5,,30*5C
$GNRMC,022508.000,A,3149.324754,N,11706.922338,E,0.002,261.541,180222,,E,A*38
$GNGGA,022508.000,3149.324754,N,11706.922338,E,1,12,1.120,-8.750,M,0,M,,*4B
$GNGLL,3149.324754,N,11706.922338,E,022508.000,A,A*46
$GNGSA,A,3,31,3

# 数据介绍NMEA端口数据分类：$GPGGA 卫星定位信息$GPGSA  卫星PRN数据$GPGSV  可视卫星信息$GPRMC 推荐定位信息$GPVTG  地面速度信息$GPDTM 大地坐标系信息$GPGNS  GNSS定位数据
NMEA语句解析：
GSV 语句的基本格式如下：$GPGSV,(1),(2),(3),(4),(5),(6),(7),...,(4),(5),(6),(7)*hh(CR)(LF)字段1：GSV 语句总数字段2：本句 GSV 的编号字段3：可见卫星的总数（00~12，前面的 0 也将被传输）字段4：卫星编号（01~32，前面的 0 也将被传输）字段5：卫星仰角（00~90 度，前面的 0 也将被传输）字段6：卫星方位角（000~359 度，前面的 0 也将被传输）字段7：信噪比（00~99dB，没有跟踪到卫星时为空）（就是常说的CN值）GGA 语句的基本格式如下：$GPGGA,(1),(2),(3),(4),(5),(6),(7),(8),(9),(10),(11),(12)*hh(CR)(LF)字段1：UTC 时间，hhmmss.sss，时分秒格式字段2：纬度ddmm.mmmm，度分格式（前导位数不足则补0）字段3：纬度N（北纬）或S（南纬）字段4：经度dddmm.mmmm，度分格式（前导位数不足则补0）字段5：经度E（东经）或W（西经）字段6：GPS状态，0=未定位，1=非差分定位，2=差分定位，3=无效PPS，6=正在估算字段7：正在使用的卫星数量（00 - 12）（前导位数不足则补0）字段8：HDOP水平精度因子（0.5 - 99.9）字段9：海拔高度（-9999.9 - 99999.9）字段10：海拔高度单位，米字段11：地球椭球面相对大地水准面的高度字段12：地球椭球面相对大地水准面的高度单位，米GSA 语句的基本格式如下：$GPGSA,(1),(2),(3),(3),,,,,,,,,,(3),(4),(5),(6),(7)*hh(CR)(LF)字段1：定位模式，A=自动手动2D/3D，M=手动2D/3D字段2：定位类型，1=未定位，2=2D定位，3=3D定位字段3：PRN码（伪随机噪声码），第1信道正在使用的卫星PRN码编号（00）（前导位数不足则补0）（最多12个）字段4：PDOP综合位置精度因子（0.0 - 500.0）字段5：HDOP综合位置精度因子（0.0 - 500.0）字段6：VDOP水平精度因子（0.0 - 500.0）字段7：卫星系统IDVTG语句的基本格式如下：$GPVTG,(1),(2),(3),(4),(5),(6),(7),(8),(9)*hh(CR)(LF)字段1：运动角度，000 - 359，（前导位数不足则补0）字段2：T=真北参照系字段3：运动角度，000 - 359，（前导位数不足则补0）字段4：M=磁北参照系字段5：水平运动速度（0.00）（前导位数不足则补0）字段6：N=节，Knots字段7：水平运动速度（0.00）（前导位数不足则补0）字段8：K=公里/时，km/h字段9：状态指示 E(航迹推算) A(非DGPS)RMC语句的基本格式如下：$GPRMC,(1),(2),(3),(4),(5),(6),(7),(8),(9),(10),(11),(12),(13)*hh(CR)(LF)字段1：UTC时间，hhmmss.sss格式字段2：状态，A=定位，V=未定位字段3：纬度ddmm.mmmm，度分格式（前导位数不足则补0）字段4：纬度N（北纬）或S（南纬）字段5：经度dddmm.mmmm，度分格式（前导位数不足则补0）字段6：经度E（东经）或W（西经）字段7：速度，节，Knots字段8：方位角，度字段9：UTC日期，DDMMYY格式字段10：磁偏角，（000 - 180）度（前导位数不足则补0）字段11：磁偏角方向，E=东W=西字段12：状态指示 E(航迹推算) A(非DGPS)字段13：导航状态，V 表示不提供导航状态DTM语句的基本格式如下：$GNDTM,<1>,<2>,<3>,<4>,<5>,<6>,<7>,<8>*<9>(CR)(LF)<1>本地坐标系代码 W84，P90<2>坐标系子代码 空<3>纬度偏移量<4>纬度半球N（北半球）或S（南半球）<5>经度偏移量<6>经度半球E（东经）或W（西经）<7>高度偏移量<8>坐标系代码 W84<9>校验码GNS语句的基本格式如下：$GNGNS,<1>,<2>,<3>,<4>,<5>,<6>,<7>,<8>.<9>,<10>,<11>,<12>,<13>,*<14>(CR)(LF)<1> UTC时间: 定位时间 hhmmss.ss——000000.00~235959.99<2> 纬度: ddmm.mmmmm——0000．00000~8959.9999<3> 南纬北纬: 北纬N，S南纬<4>经度:dddmm.mmmmm——0000．00000~17959.99999<5>东经西经: 东经E，西经W<6>定位模式: N-未定位；A-已定位；D-普通差分定位；P-高精度定位；R-RTK定位固定解；F-RTK定位浮点解；E-估算值；M-注入位置；S-模拟输入<7>定位卫星:参与定位卫星，00-99<8>HDOP：水平精度因子，0.5-99.9<9>海拔：单位：米<10>大地水准面: 地球椭球面相对大地水准面的高度<11>差异数据时间：GN开头时为空<12>基准站ID：GN开头时为空<13>导航状态—— C=告警， S=安全， U=不安全， V=无效<14>校验和