From 781ef50bf2f695e69719eafb16f0c831ebe8173d Mon Sep 17 00:00:00 2001
From: "joey.zhou" <2775152163@qq.com>
Date: Fri, 11 Apr 2025 11:49:11 +0800
Subject: [PATCH 1/3] gnss
---
en/gnsslib/quecgnss.md | 473 +++++++++++++++++++++++++++++++++++++----
zh/gnsslib/quecgnss.md | 32 +--
2 files changed, 446 insertions(+), 59 deletions(-)
diff --git a/en/gnsslib/quecgnss.md b/en/gnsslib/quecgnss.md
index 0f4c9eb..6223b0e 100644
--- a/en/gnsslib/quecgnss.md
+++ b/en/gnsslib/quecgnss.md
@@ -1,20 +1,25 @@
-# quecgnss - Internal GNSS Resolver
+# quecgnss - 内置GNSS
-This feature provides the APIs of the built-in GNSS feature.
+此模块提供内置GNSS的使用接口
-> QuecPython modules list that support built-in GNSS:
-> ECX00U AA/LA series
-> EG91XU AA series
-> EC800M GA/GB/GC/GD series
-> BG95M1/M3 model
+> QuecPython模组当前内置GNSS支持列表：
+> ECX00U AA/LA系列
+> EG91XU AA系列
+> EC800M GA/GB/GC/GD系列
+> EG810M GA系列
+> EC800G GA系列
+> BG95M1/M3型号
-**Example**
+**使用示例**
```python
import quecgnss
def main():
+ quecgnss.configSet(0,1)#设置定位星系为GPS+Beidou
+ quecgnss.configSet(2,1)#打开AGPS
+ quecgnss.configSet(4,1)#打开备电
ret = quecgnss.init()
if ret == 0:
print('GNSS init ok.')
@@ -32,7 +37,7 @@ if __name__ == '__main__':
#===================================================================================================
-#Execution Result
+#运行结果
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
@@ -50,7 +55,7 @@ $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
-...... # Omit some data due to large data quantity.
+...... # 数据较多，省略
$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
@@ -72,8 +77,190 @@ $GNGLL,3149.324754,N,11706.922338,E,022508.000,A,A*46
$GNGSA,A,3,31,3
```
+## GNSS 定位数据介绍
-## Initialize GNSS
+```python
+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：卫星系统ID
+
+VTG语句的基本格式如下：
+
+ $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> 校验和
+```
+
+## GNSS 功能初始化
### **`quecgnss.init`**
@@ -81,14 +268,12 @@ $GNGSA,A,3,31,3
quecgnss.init()
```
-Initializes the built-in GNSS feature.
-
-**Return Value**
-`0` - Successful execution
+模组内置GNSS模块功能的初始化。
-`-1` - Failed execution
+**返回值描述**
+成功返回整型 `0`，失败返回整型 `-1`。
-## Get GNSS Working Status
+## GNSS 工作状态获取
### **`quecgnss.get_state`**
@@ -96,17 +281,17 @@ Initializes the built-in GNSS feature.
quecgnss.get_state()
```
-Gets the current working status of the built-in GNSS feature.
+获取GNSS模块当前工作状态
-**Return Value**
+**返回值描述**
-| Value | Type | Description |
-| ----- | ---- | ------------------------------------------------------------ |
-| 0 | int | GNSS feature is disabled. |
-| 1 | int | GNSS firmware is being updated. |
-| 2 | int | GNSS is positioning. In this mode, the module can read the GNSS location data. After obtaining the location data, the user needs to analyze the corresponding sentence to determine whether the location data is effective. For example, if the status of GNRMC sentences is A or V, A indicates valid positioning and V indicates invalid positioning. |
+| 返回值 | 类型 | 说明 |
+| ------ | ---- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| 0 | int | GNSS模块处于关闭状态 |
+| 1 | int | GNSS模块固件升级中 |
+| 2 | int | GNSS模块定位中，这种模式下即可开始读取GNSS定位数据，定位数据是否有效需要用户获取到定位数据后，解析对应语句来判断，比如判断GNRMC语句的status是 A 还是 V，A 表示定位有效，V 表示定位无效。 |
-## Enable or Disable GNSS
+## GNSS开关
### `quecgnss.gnssEnable`
@@ -114,23 +299,21 @@ Gets the current working status of the built-in GNSS feature.
quecgnss.gnssEnable(opt)
```
-Enables or disables GNSS feature. If you use the built-in GNSS feature for the first time after powering the module on, you need not call this function to enable GNSS feature, but call *quecgnss.init()* directly. *quecgnss.init()* will automatically enable the GNSS feature when GNSS feature is initialized.
+开启或者关闭GNSS模块。如果是上电后第一次使用内置GNSS功能，一般不需要调用该接口来开启GNSS功能，直接调用init()接口即可，init() 接口在初始化时会自动开启GNSS功能。
-**Parameter**
+**参数描述**
-`opt` - Integer type. Enable or disable GNSS.
+`opt`，int类型
- `0` - Disable the GNSS feature.
+ `0` - 关闭GNSS功能
- `1` - Enable the GNSS feature.
+ `1` - 开启GNSS功能
-**Return Value**
+**返回值描述**
- `0` - Successful execution
+成功返回整型 `0`，失败返回整型 `-1`。
- `-1` - Failed execution
-
-## Get GNSS Location Data
+## GNSS定位数据获取
### `quecgnss.read`
@@ -138,17 +321,221 @@ Enables or disables GNSS feature. If you use the built-in GNSS feature for the f
quecgnss.read(size)
```
-Gets GNSS location data.
+读取GNSS定位数据。
+
+**参数描述**
+
+`size`，int类型，指定读取数据的大小，单位字节。
+
+**返回值描述**
+
+成功返回一个元组，失败返回整型-1。元组形式如下：
+`(size, data)`
+`size` - 实际读取数据的大小
+`data` - GNSS定位数据
+
+## GNSS/LTE优先级设置
+
+> 当前仅BG95M1/M3型号支持该功能。
+
+### `quecgnss.setPriority`
+
+```python
+quecgnss.setPriority(Priority)
+```
+
+在部分模组上，GNSS和LTE会复用射频资源，该接口用来控制GNSS和LTE之间使用射频资源的优先级
+
+**参数描述**
+
+`Priority`，int类型，设定GNSS/LTE优先级的值。
+
+不同平台GNSS/LTE优先级的对应关系：
+
+| 优先级 | BG95M1/M3 |
+| ------ | -------- |
+| 0 | GNSS>LTE |
+| 1 | LTE>GNSS |
+
+**返回值描述**
+
+成功返回整型 `0`，失败返回整型 `-1`。
+
+## GNSS/LTE优先级获取
+
+> 当前仅BG95M1/M3型号支持该功能。
+
+### `quecgnss.getPriority`
+
+```python
+quecgnss.getPriority()
+```
+
+在部分模组上，GNSS和LTE会复用射频资源，该接口用来读取GNSS和LTE之间使用射频资源的优先级
+
+**返回值描述**
+
+返回一个整型，代表GNSS/LTE优先级。
+
+不同平台GNSS/LTE优先级的对应关系：
+
+| 优先级 | BG95M1/M3 |
+| ------ | -------- |
+| 0 | GNSS>LTE |
+| 1 | LTE>GNSS |
+
+## 内置GNSS配置参数设置
+
+> 当前仅EC800M GA/GB/GC/GD系列、EG810M GA系列、EC200UCN_AA型号支持该功能
+
+### `quecgnss.configSet`
+
+```python
+quecgnss.configSet(config_type, config_value)
+```
+
+设置GNSS参数，包括卫星系统、NMEA语句类型、是否使用AGNSS和APFLASH等
+
+**参数描述**
+
+* `config_type`，int，要设置的GNSS配置选项类型，含义如下：
+
+| 参数 | 类型 |
+| ---- | ---------------------- |
+| 0 | 配置使用的卫星系统 |
+| 1 | 配置输出的NMEA语句类型 |
+| 2 | 配置是否使能AGPS |
+| 3 | 配置是否使能APFLASH |
+| 4 | 配置是否使能GNSS备电 |
+
+* `config_value`，int，GNSS配置选项的值，含义如下：
+
+卫星系统（config_type = 0）：
+
+| 参数 | 含义 |
+| ---- | ----------------------- |
+| 0 | GPS |
+| 1 | GPS + BeiDou |
+| 3 | GPS + GLONASS + Galileo |
+| 4 | GPS + GLONASS |
+| 5 | GPS + BeiDou + Galileo |
+| 6 | GPS + Galileo |
+| 7 | BeiDou |
+
+NMEA语句类型（config_type = 1）：该项以bitmap表示，需要打开的选项置为1
+如需要输出GGA+RMC+GSV+GSA+VTG时，应使用bitmap（011111），换算为十进制为31
+
+| 参数 | 含义 |
+| ---- | ------------------------ |
+| 0 | 禁止输出NMEA语句(000000) |
+| 1 | GGA(000001) |
+| 2 | RMC(000010) |
+| 4 | GSV(000100) |
+| 8 | GSA(001000) |
+| 16 | VTG(010000) |
+| 32 | GLL(100000) |
+| 63 | 全部输出(111111) |
+
+是否使能AGPS（config_type = 2）：打开该项时，GNSS会从网络下载星历，并在启动时尝试使用星历加速
+
+| 参数 | 含义 |
+| ---- | -------- |
+| 0 | 关闭AGPS |
+| 1 | 打开AGPS |
+
+是否使能APFLASH（config_type = 3）：打开该项时，GNSS会在Quecpython模组保存星历，并在启动时尝试使用星历加速
+
+| 参数 | 含义 |
+| ---- | ----------- |
+| 0 | 关闭APFLASH |
+| 1 | 打开APFLASH |
+
+是否使能备电 （config_type = 4）：打开该项并正确连接备电时，GNSS芯片可自行保存星历信息
+
+>EC800M GB/GD系列支持备电
+
+| 参数 | 含义 |
+| ---- | ----------- |
+| 0 | 关闭备电 |
+| 1 | 打开备电 |
+
+**返回值描述**
+
+int，0为成功，否则为失败
+
+## 内置GNSS配置参数读取
+
+> 当前仅EC800M GA/GB/GC/GD系列、EG810M GA系列支持该功能
+
+### `quecgnss.configGet`
+
+```python
+quecgnss.configGet(config_type)
+```
+
+读取GNSS参数，包括卫星系统、NMEA语句类型、是否使用AGNSS和APFLASH等
+
+**参数描述**
+
+* `config_type`，int，要读取的GNSS配置选项类型，含义如下：
+
+| 参数 | 类型 |
+| ---- | ---------------------- |
+| 0 | 配置使用的卫星系统 |
+| 1 | 配置输出的NMEA语句类型 |
+| 2 | 配置是否使能AGPS |
+| 3 | 配置是否使能APFLASH |
+| 4 | 配置是否使能GNSS备电 |
+
+**返回值描述**
+
+int，含义如下（-1为失败）
+
+卫星系统（config_type = 0）：
+
+| 参数 | 含义 |
+| ---- | ----------------------- |
+| 0 | GPS |
+| 1 | GPS + BeiDou |
+| 3 | GPS + GLONASS + Galileo |
+| 4 | GPS + GLONASS |
+| 5 | GPS + BeiDou + Galileo |
+| 6 | GPS + Galileo |
+| 7 | BeiDou |
+
+NMEA语句类型（config_type = 1）：该项以bitmap表示，被打开的选项置为1
+如输出GGA+RMC+GSV+GSA+VTG时，返回的值为31，换算为二进制即为bitmap（011111）
+
+| 参数 | 含义 |
+| ---- | ------------------------ |
+| 0 | 禁止输出NMEA语句(000000) |
+| 1 | GGA(000001) |
+| 2 | RMC(000010) |
+| 4 | GSV(000100) |
+| 8 | GSA(001000) |
+| 16 | VTG(010000) |
+| 32 | GLL(100000) |
+| 63 | 全部输出(111111) |
+
+是否使能AGPS（config_type = 2）：打开该项时，GNSS会从网络下载星历，并在启动时尝试使用星历加速
-**Parameter**
+| 参数 | 含义 |
+| ---- | -------- |
+| 0 | 关闭AGPS |
+| 1 | 打开AGPS |
-`size` - Integer type. Size of the data to be read. Unit: byte.
+是否使能APFLASH（config_type = 3）：打开该项时，GNSS会在Quecpython模组保存星历，并在启动时尝试使用星历加速
-**Return Value**
+| 参数 | 含义 |
+| ---- | ----------- |
+| 0 | 关闭APFLASH |
+| 1 | 打开APFLASH |
-A tuple `(size, data)` - Successful execution
+是否使能备电 （config_type = 4）：打开该项并正确连接备电时，GNSS芯片可自行保存星历信息
-`size` - Size of the data read.
-`data` - GNSS location data.
+>EC800M GB/GD系列支持备电
--1 - Failed execution
\ No newline at end of file
+| 参数 | 含义 |
+| ---- | ----------- |
+| 0 | 关闭备电 |
+| 1 | 打开备电 |
\ No newline at end of file
diff --git a/zh/gnsslib/quecgnss.md b/zh/gnsslib/quecgnss.md
index 1031721..6223b0e 100644
--- a/zh/gnsslib/quecgnss.md
+++ b/zh/gnsslib/quecgnss.md
@@ -82,12 +82,12 @@ $GNGSA,A,3,31,3
```python
NMEA端口数据分类：
$GPGGA 卫星定位信息
- $GPGSA 卫星PRN数据
- $GPGSV 可视卫星信息
+ $GPGSA 卫星PRN数据
+ $GPGSV 可视卫星信息
$GPRMC 推荐定位信息
- $GPVTG 地面速度信息
+ $GPVTG 地面速度信息
$GPDTM 大地坐标系信息
- $GPGNS GNSS定位数据
+ $GPGNS GNSS定位数据
NMEA语句解析：
GSV 语句的基本格式如下：
@@ -237,27 +237,27 @@ GNS语句的基本格式如下：
<3> 南纬北纬: 北纬N，S南纬
- <4>经度:dddmm.mmmmm——0000．00000~17959.99999
+ <4> 经度:dddmm.mmmmm——0000．00000~17959.99999
- <5>东经西经: 东经E，西经W
+ <5> 东经西经: 东经E，西经W
- <6>定位模式: N-未定位；A-已定位；D-普通差分定位；P-高精度定位；R-RTK定位固定解；F-RTK定位浮点解；E-估算值；M-注入位置；S-模拟输入
+ <6> 定位模式: N-未定位；A-已定位；D-普通差分定位；P-高精度定位；R-RTK定位固定解；F-RTK定位浮点解；E-估算值；M-注入位置；S-模拟输入
- <7>定位卫星:参与定位卫星，00-99
+ <7> 定位卫星:参与定位卫星，00-99
- <8>HDOP：水平精度因子，0.5-99.9
+ <8> HDOP：水平精度因子，0.5-99.9
- <9>海拔：单位：米
+ <9> 海拔：单位：米
- <10>大地水准面: 地球椭球面相对大地水准面的高度
+ <10> 大地水准面: 地球椭球面相对大地水准面的高度
- <11>差异数据时间：GN开头时为空
+ <11> 差异数据时间：GN开头时为空
- <12>基准站ID：GN开头时为空
+ <12> 基准站ID：GN开头时为空
- <13>导航状态—— C=告警， S=安全， U=不安全， V=无效
+ <13> 导航状态—— C=告警， S=安全， U=不安全， V=无效
- <14>校验和
+ <14> 校验和
```
## GNSS 功能初始化
@@ -386,7 +386,7 @@ quecgnss.getPriority()
## 内置GNSS配置参数设置
-> 当前仅EC800M GA/GB/GC/GD系列、EG810M GA系列支持该功能
+> 当前仅EC800M GA/GB/GC/GD系列、EG810M GA系列、EC200UCN_AA型号支持该功能
### `quecgnss.configSet`
--
Gitee
From 473c077a676523ba9efbb70243143f2a31fa4654 Mon Sep 17 00:00:00 2001
From: "joey.zhou" <2775152163@qq.com>
Date: Fri, 11 Apr 2025 11:53:27 +0800
Subject: [PATCH 2/3] gnss
---
en/gnsslib/quecgnss.md | 430 ++++++++++++++++++++---------------------
1 file changed, 206 insertions(+), 224 deletions(-)
diff --git a/en/gnsslib/quecgnss.md b/en/gnsslib/quecgnss.md
index 6223b0e..d221e93 100644
--- a/en/gnsslib/quecgnss.md
+++ b/en/gnsslib/quecgnss.md
@@ -1,25 +1,20 @@
-# quecgnss - 内置GNSS
+# quecgnss - Internal GNSS Resolver
-此模块提供内置GNSS的使用接口
+This feature provides the APIs of the built-in GNSS feature.
-> QuecPython模组当前内置GNSS支持列表：
-> ECX00U AA/LA系列
-> EG91XU AA系列
-> EC800M GA/GB/GC/GD系列
-> EG810M GA系列
-> EC800G GA系列
-> BG95M1/M3型号
+> QuecPython modules list that support built-in GNSS:
+> ECX00U AA/LA series
+> EG91XU AA series
+> EC800M GA/GB/GC/GD series
+> BG95M1/M3 model
-**使用示例**
+**Example**
```python
import quecgnss
def main():
- quecgnss.configSet(0,1)#设置定位星系为GPS+Beidou
- quecgnss.configSet(2,1)#打开AGPS
- quecgnss.configSet(4,1)#打开备电
ret = quecgnss.init()
if ret == 0:
print('GNSS init ok.')
@@ -37,7 +32,7 @@ if __name__ == '__main__':
#===================================================================================================
-#运行结果
+#Execution Result
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
@@ -55,7 +50,7 @@ $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
-...... # 数据较多，省略
+...... # Omit some data due to large data quantity.
$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
@@ -77,190 +72,173 @@ $GNGLL,3149.324754,N,11706.922338,E,022508.000,A,A*46
$GNGSA,A,3,31,3
```
-## GNSS 定位数据介绍
+
+## GNSS positioning data introduction
```python
-NMEA端口数据分类：
- $GPGGA 卫星定位信息
- $GPGSA 卫星PRN数据
- $GPGSV 可视卫星信息
- $GPRMC 推荐定位信息
- $GPVTG 地面速度信息
- $GPDTM 大地坐标系信息
- $GPGNS GNSS定位数据
-NMEA语句解析：
-GSV 语句的基本格式如下：
+NMEA port data classification:
+ $GPGGA Satellite positioning information
+ $GPGSA Satellite PRN data
+ $GPGSV Visual satellite information
+ $GPRMC Recommended location information
+ $GPVTG Ground speed information
+ $GPDTM Geodetic coordinate system information
+ $GPGNS GNSS location data
+NMEA statement parsing:
+The basic format of a GSV statement is as follows:
$GPGSV,(1),(2),(3),(4),(5),(6),(7),...,(4),(5),(6),(7)*hh(CR)(LF)
- 字段1：GSV 语句总数
+ Field 1：Total GSV statements
- 字段2：本句 GSV 的编号
+ Field 2：GSV number of this sentence
- 字段3：可见卫星的总数（00~12，前面的 0 也将被传输）
+ Field 3：The total number of visible satellites (00~12, the previous 0 will also be transmitted)
- 字段4：卫星编号（01~32，前面的 0 也将被传输）
+ Field 4：Satellite number (01~32, the previous 0 will also be transmitted)
- 字段5：卫星仰角（00~90 度，前面的 0 也将被传输）
+ Field 5：Satellite elevation (00~90 degrees, the previous 0 will also be transmitted)
- 字段6：卫星方位角（000~359 度，前面的 0 也将被传输）
+ Field 6：Satellite azimuth (000~359 degrees, the previous 0 will also be transmitted)
- 字段7：信噪比（00~99dB，没有跟踪到卫星时为空）（就是常说的CN值）
+ Field 7： Signal-to-noise ratio (00~99dB, empty when no satellite is tracked) (the CN value is often said)
-GGA 语句的基本格式如下：
+The basic format of the GGA statement is as follows:
$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=正在估算
+ Field 1：UTC time, hhmmss.sss, in minute-second format
- 字段7：正在使用的卫星数量（00 - 12）（前导位数不足则补0）
+ Field 2：Latitude ddmm.mmmm, degree division format (0 if leading number is insufficient)
- 字段8：HDOP水平精度因子（0.5 - 99.9）
+ Field 3：Latitude N (North latitude) or S (South latitude)
- 字段9：海拔高度（-9999.9 - 99999.9）
+ Field 4：Longitude DDDDMM.mmmm, degree division format (0 if leading digit is insufficient)
- 字段10：海拔高度单位，米
+ Field 5：Longitude E (East) or W (West)
- 字段11：地球椭球面相对大地水准面的高度
+ Field 6：GPS status, 0= unlocated, 1= non-differential positioning, 2= differential positioning, 3= invalid PPS, 6= Estimating
- 字段12：地球椭球面相对大地水准面的高度单位，米
+ Field 7：Number of satellites in use (00-12) (0 if leading digit is insufficient)
-GSA 语句的基本格式如下：
+ Field 8：HDOP horizontal accuracy factor (0.5-99.9)
- $GPGSA,(1),(2),(3),(3),,,,,,,,,,(3),(4),(5),(6),(7)*hh(CR)(LF)
+ Field 9：Altitude (-9999.9-99999.9)
- 字段1：定位模式，A=自动手动2D/3D，M=手动2D/3D
+ Field 10：Unit of altitude, meters
- 字段2：定位类型，1=未定位，2=2D定位，3=3D定位
+ Field 11：The height of the Earth's ellipsoid relative to the geoid
- 字段3：PRN码（伪随机噪声码），第1信道正在使用的卫星PRN码编号（00）（前导位数不足则补0）（最多12个）
+ Field 12：Unit of height of the Earth's ellipsoid relative to the geoid, in meters
- 字段4：PDOP综合位置精度因子（0.0 - 500.0）
-
- 字段5：HDOP综合位置精度因子（0.0 - 500.0）
-
- 字段6：VDOP水平精度因子（0.0 - 500.0）
-
- 字段7：卫星系统ID
-
-VTG语句的基本格式如下：
+The basic format of a VTG statement is as follows:
$GPVTG,(1),(2),(3),(4),(5),(6),(7),(8),(9)*hh(CR)(LF)
- 字段1：运动角度，000 - 359，（前导位数不足则补0）
+ Field 1：Motion Angle, 000-359, (0 if leading digit is insufficient)
- 字段2：T=真北参照系
+ Field 2：T = true North reference system
- 字段3：运动角度，000 - 359，（前导位数不足则补0）
+ Field 3：Motion Angle, 000-359, (0 if leading digit is insufficient)
- 字段4：M=磁北参照系
+ Field 4：M = Magnetic North reference system
- 字段5：水平运动速度（0.00）（前导位数不足则补0）
+ Field 5：Horizontal motion speed (0.00) (0 if leading digit is insufficient)
- 字段6：N=节，Knots
+ Field 6：N = sections, Knots
- 字段7：水平运动速度（0.00）（前导位数不足则补0）
+ Field 7：Horizontal motion speed (0.00) (0 if leading digit is insufficient)
- 字段8：K=公里/时，km/h
+ Field 8：K = km/hour, km/h
- 字段9：状态指示 E(航迹推算) A(非DGPS)
+ Field 9：Status Indicator E(Dead reckoning) A(Non-DGPS)
-RMC语句的基本格式如下：
+The basic format of the RMC statement is as follows:
$GPRMC,(1),(2),(3),(4),(5),(6),(7),(8),(9),(10),(11),(12),(13)*hh(CR)(LF)
- 字段1：UTC时间，hhmmss.sss格式
+ Field 1：UTC time in hhmmss.sss format
- 字段2：状态，A=定位，V=未定位
+ Field 2：Status, A = located, V = not located
- 字段3：纬度ddmm.mmmm，度分格式（前导位数不足则补0）
+ Field 3：Latitude ddmm.mmmm, degree division format (0 if leading number is insufficient)
- 字段4：纬度N（北纬）或S（南纬）
+ Field 4：Latitude N (North latitude) or S (South latitude)
- 字段5：经度dddmm.mmmm，度分格式（前导位数不足则补0）
+ Field 5：Longitude DDDDMM.mmmm, degree division format (0 if leading digit is insufficient)
- 字段6：经度E（东经）或W（西经）
+ Field 6：Longitude E (East) or W (West)
- 字段7：速度，节，Knots
+ Field 7：Speed, Knots, Knots
- 字段8：方位角，度
+ Field 8：Azimuth, degree
- 字段9：UTC日期，DDMMYY格式
+ Field 9：UTC date in DDMMYY format
- 字段10：磁偏角，（000 - 180）度（前导位数不足则补0）
+ Field 10：Magnetic declination, (000-180) degrees (0 if leading digit is insufficient)
- 字段11：磁偏角方向，E=东W=西
+ Field 11：Magnetic declination direction, E = East W = west
- 字段12：状态指示 E(航迹推算) A(非DGPS)
+ Field 12：Status Indicator E(Dead reckoning) A(Non-DGPS)
- 字段13：导航状态，V 表示不提供导航状态
+ Field 13：Navigation status. V indicates that no navigation status is provided
-DTM语句的基本格式如下：
+The basic format of a DTM statement is as follows:
$GNDTM,<1>,<2>,<3>,<4>,<5>,<6>,<7>,<8>*<9>(CR)(LF)
- <1>本地坐标系代码 W84，P90
+ <1>Local coordinate system codes W84, P90
- <2>坐标系子代码 空
+ <2>Coordinate subcode is empty
- <3>纬度偏移量
+ <3>Latitude offset
- <4>纬度半球N（北半球）或S（南半球）
+ <4>Latitude hemispheres N (Northern Hemisphere) or S (Southern Hemisphere)
- <5>经度偏移量
+ <5>Longitude offset
- <6>经度半球E（东经）或W（西经）
+ <6>Longitude hemisphere E (East longitude) or W (West longitude)
- <7>高度偏移量
+ <7>Height offset
- <8>坐标系代码 W84
+ <8>Coordinate system code W84
- <9>校验码
+ <9>Check code
-GNS语句的基本格式如下：
+The basic format of a GNS statement is as follows:
$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
+ <1> UTC time: Location time hhmmss.ss -- 000000.00~235959.99
- <2> 纬度: ddmm.mmmmm——0000．00000~8959.9999
+ <2> Latitude: ddmm.mmmmm -- 0000.00000 ~8959.9999
- <3> 南纬北纬: 北纬N，S南纬
+ <3> North latitude: N latitude, S latitude south
- <4> 经度:dddmm.mmmmm——0000．00000~17959.99999
+ <4> Longitude: DDDDmm.mmmmm -- 0000.00000 ~17959.99999
- <5> 东经西经: 东经E，西经W
+ <5> East Longitude West longitude: E, W
- <6> 定位模式: N-未定位；A-已定位；D-普通差分定位；P-高精度定位；R-RTK定位固定解；F-RTK定位浮点解；E-估算值；M-注入位置；S-模拟输入
+ <6> Positioning mode: N- not positioned; A- Located; D-ordinary differential positioning; P- High precision positioning; R-RTK positioning fixed solution; F-RTK locating floating-point solutions; E- estimated value; M- injection position; S- Analog input
- <7> 定位卫星:参与定位卫星，00-99
+ <7> Positioning satellites: Participating positioning satellites, 00-99
- <8> HDOP：水平精度因子，0.5-99.9
+ <8> HDOP: Horizontal accuracy factor, 0.5-99.9
- <9> 海拔：单位：米
+ <9> Altitude: Unit: meters
- <10> 大地水准面: 地球椭球面相对大地水准面的高度
+ <10> Geoid: The height of the Earth's ellipsoid relative to the geoid
- <11> 差异数据时间：GN开头时为空
+ <11> Differential data time: null at the beginning of GN
- <12> 基准站ID：GN开头时为空
+ <12> Base station ID: GN is null at the beginning
- <13> 导航状态—— C=告警， S=安全， U=不安全， V=无效
+ <13> Navigation status -- C= alarm, S= Safe, U= unsafe, V= invalid
- <14> 校验和
+ <14> Checksum
```
-## GNSS 功能初始化
+## Initialize GNSS
### **`quecgnss.init`**
@@ -268,12 +246,14 @@ GNS语句的基本格式如下：
quecgnss.init()
```
-模组内置GNSS模块功能的初始化。
+Initializes the built-in GNSS feature.
+
+**Return Value**
+`0` - Successful execution
-**返回值描述**
-成功返回整型 `0`，失败返回整型 `-1`。
+`-1` - Failed execution
-## GNSS 工作状态获取
+## Get GNSS Working Status
### **`quecgnss.get_state`**
@@ -281,17 +261,17 @@ quecgnss.init()
quecgnss.get_state()
```
-获取GNSS模块当前工作状态
+Gets the current working status of the built-in GNSS feature.
-**返回值描述**
+**Return Value**
-| 返回值 | 类型 | 说明 |
-| ------ | ---- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| 0 | int | GNSS模块处于关闭状态 |
-| 1 | int | GNSS模块固件升级中 |
-| 2 | int | GNSS模块定位中，这种模式下即可开始读取GNSS定位数据，定位数据是否有效需要用户获取到定位数据后，解析对应语句来判断，比如判断GNRMC语句的status是 A 还是 V，A 表示定位有效，V 表示定位无效。 |
+| Value | Type | Description |
+| ----- | ---- | ------------------------------------------------------------ |
+| 0 | int | GNSS feature is disabled. |
+| 1 | int | GNSS firmware is being updated. |
+| 2 | int | GNSS is positioning. In this mode, the module can read the GNSS location data. After obtaining the location data, the user needs to analyze the corresponding sentence to determine whether the location data is effective. For example, if the status of GNRMC sentences is A or V, A indicates valid positioning and V indicates invalid positioning. |
-## GNSS开关
+## Enable or Disable GNSS
### `quecgnss.gnssEnable`
@@ -299,21 +279,23 @@ quecgnss.get_state()
quecgnss.gnssEnable(opt)
```
-开启或者关闭GNSS模块。如果是上电后第一次使用内置GNSS功能，一般不需要调用该接口来开启GNSS功能，直接调用init()接口即可，init() 接口在初始化时会自动开启GNSS功能。
+Enables or disables GNSS feature. If you use the built-in GNSS feature for the first time after powering the module on, you need not call this function to enable GNSS feature, but call *quecgnss.init()* directly. *quecgnss.init()* will automatically enable the GNSS feature when GNSS feature is initialized.
+
+**Parameter**
-**参数描述**
+`opt` - Integer type. Enable or disable GNSS.
-`opt`，int类型
+ `0` - Disable the GNSS feature.
- `0` - 关闭GNSS功能
+ `1` - Enable the GNSS feature.
- `1` - 开启GNSS功能
+**Return Value**
-**返回值描述**
+ `0` - Successful execution
-成功返回整型 `0`，失败返回整型 `-1`。
+ `-1` - Failed execution
-## GNSS定位数据获取
+## Get GNSS Location Data
### `quecgnss.read`
@@ -321,22 +303,22 @@ quecgnss.gnssEnable(opt)
quecgnss.read(size)
```
-读取GNSS定位数据。
+Gets GNSS location data.
-**参数描述**
+**Parameter**
-`size`，int类型，指定读取数据的大小，单位字节。
+`size` - Integer type. Size of the data to be read. Unit: byte.
-**返回值描述**
+**Return Value**
-成功返回一个元组，失败返回整型-1。元组形式如下：
+Return a tuple on success, integer -1 on failure. The tuple form is as follows:
`(size, data)`
-`size` - 实际读取数据的大小
-`data` - GNSS定位数据
+'size' - The size of the actual read data
+'data' - GNSS positioning data
-## GNSS/LTE优先级设置
+## GNSS/LTE priority Settings
-> 当前仅BG95M1/M3型号支持该功能。
+> Currently only BG95M1/M3 models support this feature.
### `quecgnss.setPriority`
@@ -344,26 +326,26 @@ quecgnss.read(size)
quecgnss.setPriority(Priority)
```
-在部分模组上，GNSS和LTE会复用射频资源，该接口用来控制GNSS和LTE之间使用射频资源的优先级
+On some modules, GNSS and LTE reuse RF resources, and this interface is used to control the priority of using RF resources between GNSS and LTE
-**参数描述**
+**Parameter Description**
-`Priority`，int类型，设定GNSS/LTE优先级的值。
+`Priority`,type int, sets the value of GNSS/LTE priority.
-不同平台GNSS/LTE优先级的对应关系：
+The corresponding relationship between GNSS/LTE priorities of different platforms:
-| 优先级 | BG95M1/M3 |
+|Priority| BG95M1/M3|
| ------ | -------- |
| 0 | GNSS>LTE |
| 1 | LTE>GNSS |
-**返回值描述**
+**Return value description**
-成功返回整型 `0`，失败返回整型 `-1`。
+Return integer '0' on success, integer '-1' on failure.
-## GNSS/LTE优先级获取
+## GNSS/LTE priority acquisition
-> 当前仅BG95M1/M3型号支持该功能。
+> Currently only BG95M1/M3 models support this feature.
### `quecgnss.getPriority`
@@ -371,22 +353,22 @@ quecgnss.setPriority(Priority)
quecgnss.getPriority()
```
-在部分模组上，GNSS和LTE会复用射频资源，该接口用来读取GNSS和LTE之间使用射频资源的优先级
+On some modules, GNSS and LTE reuse RF resources, and this interface is used to read the priority of using RF resources between GNSS and LTE
-**返回值描述**
+**Return value description**
-返回一个整型，代表GNSS/LTE优先级。
+Returns an integer representing the GNSS/LTE priority.
-不同平台GNSS/LTE优先级的对应关系：
+The corresponding relationship between GNSS/LTE priorities of different platforms:
-| 优先级 | BG95M1/M3 |
+|Priority| BG95M1/M3|
| ------ | -------- |
| 0 | GNSS>LTE |
| 1 | LTE>GNSS |
-## 内置GNSS配置参数设置
+## Built-in GNSS configuration parameter Settings
-> 当前仅EC800M GA/GB/GC/GD系列、EG810M GA系列、EC200UCN_AA型号支持该功能
+> Currently, only EC800M GA/GB/GC/GD series, EG810M GA series, and EC200UCN_AA models support this function
### `quecgnss.configSet`
@@ -394,25 +376,25 @@ quecgnss.getPriority()
quecgnss.configSet(config_type, config_value)
```
-设置GNSS参数，包括卫星系统、NMEA语句类型、是否使用AGNSS和APFLASH等
+Set GNSS parameters, including satellite system, NMEA statement type, whether AGNSS and APFLASH are used, etc
-**参数描述**
+**Parameter Description**
-* `config_type`，int，要设置的GNSS配置选项类型，含义如下：
+* `config_type`, int, the GNSS configuration option type to set, meaning as follows:
-| 参数 | 类型 |
+| Parameter | Type |
| ---- | ---------------------- |
-| 0 | 配置使用的卫星系统 |
-| 1 | 配置输出的NMEA语句类型 |
-| 2 | 配置是否使能AGPS |
-| 3 | 配置是否使能APFLASH |
-| 4 | 配置是否使能GNSS备电 |
+| 0 | The satellite system used in the configuration |
+| 1 | Configures the type of NMEA statement to output |
+| 2 | Configures whether to enable AGPS |
+| 3 | Configures whether to enable APFLASH |
+| 4 | Configure whether to enable GNSS backup |
-* `config_value`，int，GNSS配置选项的值，含义如下：
+* `config_value`, int, GNSS configuration option value, meaning as follows:
-卫星系统（config_type = 0）：
+Satellite system (config_type = 0) :
-| 参数 | 含义 |
+| Parameter | Meaning |
| ---- | ----------------------- |
| 0 | GPS |
| 1 | GPS + BeiDou |
@@ -422,50 +404,50 @@ quecgnss.configSet(config_type, config_value)
| 6 | GPS + Galileo |
| 7 | BeiDou |
-NMEA语句类型（config_type = 1）：该项以bitmap表示，需要打开的选项置为1
-如需要输出GGA+RMC+GSV+GSA+VTG时，应使用bitmap（011111），换算为十进制为31
+NMEA statement type (config_type = 1) : This is represented by bitmap, with the option to be opened set to 1
+If you need to output GGA+RMC+GSV+GSA+VTG, bitmap (011111) should be used and converted to decimal 31
-| 参数 | 含义 |
+| Parameter | Meaning |
| ---- | ------------------------ |
-| 0 | 禁止输出NMEA语句(000000) |
+| 0 | Disable output NMEA statement (000000) |
| 1 | GGA(000001) |
| 2 | RMC(000010) |
| 4 | GSV(000100) |
| 8 | GSA(001000) |
| 16 | VTG(010000) |
| 32 | GLL(100000) |
-| 63 | 全部输出(111111) |
+| 63 | All output (111111) |
-是否使能AGPS（config_type = 2）：打开该项时，GNSS会从网络下载星历，并在启动时尝试使用星历加速
+AGPS enabled (config_type = 2) : When this option is turned on, GNSS downloads ephemeris from the network and attempts to use ephemeris acceleration at startup
-| 参数 | 含义 |
+| Parameter | Meaning |
| ---- | -------- |
-| 0 | 关闭AGPS |
-| 1 | 打开AGPS |
+| 0 | Closing AGPS |
+| 1 | Open AGPS |
-是否使能APFLASH（config_type = 3）：打开该项时，GNSS会在Quecpython模组保存星历，并在启动时尝试使用星历加速
+APFLASH enabled (config_type = 3) : When this is enabled, GNSS saves ephemeris in the Quecpython module and attempts to use ephemeris acceleration at startup
-| 参数 | 含义 |
+| Parameter | Meaning |
| ---- | ----------- |
-| 0 | 关闭APFLASH |
-| 1 | 打开APFLASH |
+| 0 | Closing APFLASH |
+| 1 | Open APFLASH |
-是否使能备电 （config_type = 4）：打开该项并正确连接备电时，GNSS芯片可自行保存星历信息
+Power backup enabled (config_type = 4) : When this option is enabled and the backup power is correctly connected, the GNSS chip can save ephemeris information by itself
->EC800M GB/GD系列支持备电
+>The EC800M GB/GD series supports backup power supply
-| 参数 | 含义 |
+| Parameter | Meaning |
| ---- | ----------- |
-| 0 | 关闭备电 |
-| 1 | 打开备电 |
+| 0 | Turn off the backup power|
+| 1 | Turn on the backup power |
-**返回值描述**
+**eturn value description**
-int，0为成功，否则为失败
+int, 0 indicates success, otherwise, failure
-## 内置GNSS配置参数读取
+## Built-in GNSS configuration parameter reading
-> 当前仅EC800M GA/GB/GC/GD系列、EG810M GA系列支持该功能
+> Currently, only EC800M GA/GB/GC/GD series and EG810M GA series support this function
### `quecgnss.configGet`
@@ -473,27 +455,27 @@ int，0为成功，否则为失败
quecgnss.configGet(config_type)
```
-读取GNSS参数，包括卫星系统、NMEA语句类型、是否使用AGNSS和APFLASH等
+Read GNSS parameters, including satellite system, NMEA statement type, whether AGNSS and APFLASH are used, etc
-**参数描述**
+**Parameter Description**
-* `config_type`，int，要读取的GNSS配置选项类型，含义如下：
+* `config_type`, int, the type of GNSS configuration options to be read, meaning as follows:
-| 参数 | 类型 |
+| Parameter | Type |
| ---- | ---------------------- |
-| 0 | 配置使用的卫星系统 |
-| 1 | 配置输出的NMEA语句类型 |
-| 2 | 配置是否使能AGPS |
-| 3 | 配置是否使能APFLASH |
-| 4 | 配置是否使能GNSS备电 |
+| 0 | Configuration of the satellite system used |
+| 1 | Configures the type of NMEA statement to output |
+| 2 | Configures whether to enable AGPS |
+| 3 | Configures whether to enable APFLASH |
+| 4 | Configure whether to enable GNSS backup |
-**返回值描述**
+**Return value description**
-int，含义如下（-1为失败）
+int, meaning as follows (-1 indicates failure)
-卫星系统（config_type = 0）：
+Satellite system (config_type = 0) :
-| 参数 | 含义 |
+| Parameter | Meaning |
| ---- | ----------------------- |
| 0 | GPS |
| 1 | GPS + BeiDou |
@@ -503,39 +485,39 @@ int，含义如下（-1为失败）
| 6 | GPS + Galileo |
| 7 | BeiDou |
-NMEA语句类型（config_type = 1）：该项以bitmap表示，被打开的选项置为1
-如输出GGA+RMC+GSV+GSA+VTG时，返回的值为31，换算为二进制即为bitmap（011111）
+NMEA statement type (config_type = 1) : This is represented by bitmap, with the open option set to 1
+For example, when GGA+RMC+GSV+GSA+VTG is output, the returned value is 31, which is converted to binary bitmap (011111)
-| 参数 | 含义 |
+| Parameter | Meaning |
| ---- | ------------------------ |
-| 0 | 禁止输出NMEA语句(000000) |
+| 0 | disables output of the NMEA statement (000000) |
| 1 | GGA(000001) |
| 2 | RMC(000010) |
| 4 | GSV(000100) |
| 8 | GSA(001000) |
| 16 | VTG(010000) |
| 32 | GLL(100000) |
-| 63 | 全部输出(111111) |
+| 63 | All output is (111111) |
-是否使能AGPS（config_type = 2）：打开该项时，GNSS会从网络下载星历，并在启动时尝试使用星历加速
+AGPS enabled (config_type = 2) : When this option is turned on, GNSS downloads ephemeris from the network and attempts to use ephemeris acceleration at startup
-| 参数 | 含义 |
+| Parameter | Meaning |
| ---- | -------- |
-| 0 | 关闭AGPS |
-| 1 | 打开AGPS |
+| 0 | Closing AGPS |
+| 1 | Open AGPS |
-是否使能APFLASH（config_type = 3）：打开该项时，GNSS会在Quecpython模组保存星历，并在启动时尝试使用星历加速
+APFLASH enabled (config_type = 3) : When this is enabled, GNSS saves ephemeris in the Quecpython module and attempts to use ephemeris acceleration at startup
-| 参数 | 含义 |
+| Parameter | Meaning |
| ---- | ----------- |
-| 0 | 关闭APFLASH |
-| 1 | 打开APFLASH |
+| 0 | Closing APFLASH |
+| 1 | Open APFLASH |
-是否使能备电 （config_type = 4）：打开该项并正确连接备电时，GNSS芯片可自行保存星历信息
+Power backup enabled (config_type = 4) : When this option is enabled and the backup power is correctly connected, the GNSS chip can save ephemeris information by itself
->EC800M GB/GD系列支持备电
+>The EC800M GB/GD series supports backup power supply
-| 参数 | 含义 |
+| Parameter | Meaning |
| ---- | ----------- |
-| 0 | 关闭备电 |
-| 1 | 打开备电 |
\ No newline at end of file
+| 0 | Turn off the backup power |
+| 1 | Turn on the backup power |
\ No newline at end of file
--
Gitee
From 89f56a5dd718e98489263c082867bfd1cea6816c Mon Sep 17 00:00:00 2001
From: "joey.zhou" <2775152163@qq.com>
Date: Fri, 11 Jul 2025 10:36:52 +0800
Subject: [PATCH 3/3] quecgnss
---
en/gnsslib/quecgnss.md | 2 +-
zh/gnsslib/quecgnss.md | 2 +-
2 files changed, 2 insertions(+), 2 deletions(-)
diff --git a/en/gnsslib/quecgnss.md b/en/gnsslib/quecgnss.md
index d221e93..22be09e 100644
--- a/en/gnsslib/quecgnss.md
+++ b/en/gnsslib/quecgnss.md
@@ -447,7 +447,7 @@ int, 0 indicates success, otherwise, failure
## Built-in GNSS configuration parameter reading
-> Currently, only EC800M GA/GB/GC/GD series and EG810M GA series support this function
+> Currently, only EC800M GA/GB/GC/GD series, EG810M GA series, and EC200UCN_AA models support this function
### `quecgnss.configGet`
diff --git a/zh/gnsslib/quecgnss.md b/zh/gnsslib/quecgnss.md
index 6223b0e..d54041d 100644
--- a/zh/gnsslib/quecgnss.md
+++ b/zh/gnsslib/quecgnss.md
@@ -465,7 +465,7 @@ int，0为成功，否则为失败
## 内置GNSS配置参数读取
-> 当前仅EC800M GA/GB/GC/GD系列、EG810M GA系列支持该功能
+> 当前仅EC800M GA/GB/GC/GD系列、EG810M GA系列、EC200UCN_AA型号支持该功能
### `quecgnss.configGet`
--
Gitee