@[TOC]

gpsHxxt

模块功能：GPS模块管理

注意：此功能模块中的功能接口可以分为四大类：

1、GPS开启

2、GPS关闭

3、GPS定位数据读取

4、GPS参数和功能设置

1、2、3是通用功能，除了支持合宙的Air530H模块，理论上也支持其他厂家的串口GPS模块

4是专用功能，仅支持合宙的Air530H和Air82x系列模块

gpsHxxt.DEFAULT

常量值，GPS应用模式1.

打开GPS后，GPS定位成功时，如果有回调函数，会调用回调函数

使用此应用模式调用gpsHxxt.open打开的“GPS应用”，必须主动调用gpsHxxt.close或者gpsHxxt.closeAll才能关闭此“GPS应用”,主动关闭时，即使有回调函数，也不会调用回调函数

gpsHxxt.TIMERORSUC

常量值，GPS应用模式2.

打开GPS后，如果在GPS开启最大时长到达时，没有定位成功，如果有回调函数，会调用回调函数，然后自动关闭此“GPS应用”

打开GPS后，如果在GPS开启最大时长内，定位成功，如果有回调函数，会调用回调函数，然后自动关闭此“GPS应用”

打开GPS后，在自动关闭此“GPS应用”前，可以调用gpsHxxt.close或者gpsHxxt.closeAll主动关闭此“GPS应用”，主动关闭时，即使有回调函数，也不会调用回调函数

gpsHxxt.TIMER

常量值，GPS应用模式3.

打开GPS后，在GPS开启最大时长时间到达时，无论是否定位成功，如果有回调函数，会调用回调函数，然后自动关闭此“GPS应用”

gpsHxxt.open(mode, para)

打开一个“GPS应用”

“GPS应用”：指的是使用GPS功能的一个应用
例如，假设有如下3种需求，要打开GPS，则一共有3个“GPS应用”：
“GPS应用1”：每隔1分钟打开一次GPS
“GPS应用2”：设备发生震动时打开GPS
“GPS应用3”：收到一条特殊短信时打开GPS
只有所有“GPS应用”都关闭了，才会去真正关闭GPS
每个“GPS应用”打开或者关闭GPS时，最多有4个参数，其中 GPS应用模式和GPS应用标记共同决定了一个唯一的“GPS应用”：
1、GPS应用模式(必选)
2、GPS应用标记(必选)
3、GPS开启最大时长[可选]
4、回调函数[可选]
例如gpsHxxt.open(gpsHxxt.TIMERORSUC,{tag="TEST",val=120,cb=testGpsCb})
gpsHxxt.TIMERORSUC为GPS应用模式，"TEST"为GPS应用标记，120秒为GPS开启最大时长，testGpsCb为回调函数

参数

|名称|传入值类型|释义| |-|-|-| |mode|number|GPS应用模式，支持gpsHxxt.DEFAULT，gpsHxxt.TIMERORSUC，gpsHxxt.TIMER三种| |para|param|table类型，GPS应用参数
para.tag：string类型，GPS应用标记
para.val：number类型，GPS应用开启最大时长，mode参数为gpsHxxt.TIMERORSUC或者gpsHxxt.TIMER时，此值才有意义
para.cb：GPS应用结束时的回调函数，回调函数的调用形式为para.cb(para.tag)|

返回值

nil

例子

gpsHxxt.open(gpsHxxt.DEFAULT,{tag="TEST1",cb=test1Cb})
gpsHxxt.open(gpsHxxt.TIMERORSUC,{tag="TEST2",val=60,cb=test2Cb})
gpsHxxt.open(gpsHxxt.TIMER,{tag="TEST3",val=120,cb=test3Cb})
--另见：DEFAULT,TIMERORSUC,TIMER

gpsHxxt.close(mode, para)

关闭一个“GPS应用”

只是从逻辑上关闭一个GPS应用，并不一定真正关闭GPS，是有所有的GPS应用都处于关闭状态，才回去真正关闭GPS

参数

|名称|传入值类型|释义| |-|-|-| |mode|number|GPS应用模式，支持gpsHxxt.DEFAULT，gpsHxxt.TIMERORSUC，gpsHxxt.TIMER三种| |para|param|table类型，GPS应用参数
para.tag：string类型，GPS应用标记
para.val：number类型，GPS应用开启最大时长，mode参数为gpsHxxt.TIMERORSUC或者gpsHxxt.TIMER时，此值才有意义；使用close接口时，不需要传入此参数
para.cb：GPS应用结束时的回调函数，回调函数的调用形式为para.cb(para.tag)；使用close接口时，不需要传入此参数|

返回值

nil

例子

GPS应用模式和GPS应用标记唯一确定一个“GPS应用”，调用本接口关闭时，mode和para.tag要和gpsHxxt.open打开一个“GPS应用”时传入的mode和para.tag保持一致
gpsHxxt.close(gpsHxxt.DEFAULT,{tag="TEST1"})
gpsHxxt.close(gpsHxxt.TIMERORSUC,{tag="TEST2"})
gpsHxxt.close(gpsHxxt.TIMER,{tag="TEST3"})
--另见：open,DEFAULT,TIMERORSUC,TIMER

gpsHxxt.closeAll()

关闭所有“GPS应用”

参数

无

返回值

nil

例子

gpsHxxt.closeAll()
--另见：open,DEFAULT,TIMERORSUC,TIMER

gpsHxxt.isActive(mode, para)

判断一个“GPS应用”是否处于激活状态

参数

|名称|传入值类型|释义| |-|-|-| |mode|number|GPS应用模式，支持gpsHxxt.DEFAULT，gpsHxxt.TIMERORSUC，gpsHxxt.TIMER三种| |para|param|table类型，GPS应用参数
para.tag：string类型，GPS应用标记
para.val：number类型，GPS应用开启最大时长，mode参数为gpsHxxt.TIMERORSUC或者gpsHxxt.TIMER时，此值才有意义；使用isActive接口时，不需要传入此参数
para.cb：GPS应用结束时的回调函数，回调函数的调用形式为para.cb(para.tag)；使用isActive接口时，不需要传入此参数|

返回值

bool result，处于激活状态返回true，否则返回nil

例子

GPS应用模式和GPS应用标记唯一确定一个“GPS应用”，调用本接口查询状态时，mode和para.tag要和gpsHxxt.open打开一个“GPS应用”时传入的mode和para.tag保持一致
gpsHxxt.isActive(gpsHxxt.DEFAULT,{tag="TEST1"})
gpsHxxt.isActive(gpsHxxt.TIMERORSUC,{tag="TEST2"})
gpsHxxt.isActive(gpsHxxt.TIMER,{tag="TEST3"})
--另见：open,DEFAULT,TIMERORSUC,TIMER

gpsHxxt.setPowerCbFnc(cbFnc)

设置GPS模块供电控制的回调函数

如果使用的是Air800，或者供电控制使用的是LDO_VCAM，则打开GPS应用前不需要调用此接口进行设置
否则在调用gpsHxxt.open前，使用此接口，传入自定义的供电控制函数cbFnc，GPS开启时，gpsHxxt.lua自动执行cbFnc(true)，GPS关闭时，gpsHxxt.lua自动执行cbFnc(false)

参数

|名称|传入值类型|释义| |-|-|-| |cbFnc|param|function类型，用户自定义的GPS供电控制函数|

返回值

nil

例子
```
gpsHxxt.setPowerCbFnc(cbFnc)
```

gpsHxxt.setUart(id, baudrate, databits, parity, stopbits)

设置GPS模块和GSM模块之间数据通信的串口参数

如果使用的是Air800，或者使用的UART2(波特率115200，数据位8，无检验位，停止位1)，则打开GPS应用前不需要调用此接口进行设置
否则在调用gpsHxxt.open前，使用此接口，传入UART参数

参数

返回值

nil

例子

gpsHxxt.setUart(2,115200,8,uart.PAR_NONE,uart.STOP_1)

gpsHxxt.setAerialMode(H01, H10, H101, H11)

设置GPS模块搜星模式

同时仅支持配置为一种搜星模式

参数

|名称|传入值类型|释义| |-|-|-| |H01 设置为GPS|number|L1+SBAS+QZSS联合定位模式| |H10 设置为BDS|number|B1定位| |H101|number|设置为GPS+GLONASS+GALILEO+SBAS+QZSS联合定位| |H11|number|设置为GPS+BDS+GALILEO+SBAS+QZSS联合定位|

返回值

nil

例子
```
gpsHxxt.setAerialMode(nil,nil,1)
```

gpsHxxt.setNmeaMode(mode, cbFnc)

设置NMEA数据处理模式.

如果不调用此接口配置，则默认仅gpsHxxt.lua内部处理NMEA数据

参数

|名称|传入值类型|释义| |-|-|-| |mode|number|NMEA数据处理模式，0表示仅gpsHxxt.lua内部处理，1表示仅用户自己处理，2表示gpsHxxt.lua和用户同时处理| |cbFnc|param|function类型，用户处理一条NMEA数据的回调函数，mode为1和2时，此值才有意义|

返回值

nil

例子

gpsHxxt.setNmeaMode(0)
gpsHxxt.setNmeaMode(1,cbFnc)
gpsHxxt.setNmeaMode(2,cbFnc)

gpsHxxt.setRunMode(mode)

设置GPS模块的运行模式.

如果不调用此接口配置，则默认为正常运行模式

参数

|名称|传入值类型|释义| |-|-|-| |mode|number|运行模式
0：正常运行模式
1：低功耗模式|

返回值

nil

例子

gpsHxxt.setRunMode(0)
gpsHxxt.setRunMode(1)

gpsHxxt.setLocationFilter(seconds)

设置GPS定位成功后经纬度的过滤时间.

参数

|名称|传入值类型|释义| |-|-|-| |seconds|number|可选参数，默认为0 单位秒，GPS定位成功后，丢弃前seconds秒的位置信息|

返回值

nil

例子
```
gpsHxxt.setLocationFilter(2)
```

gpsHxxt.isOpen()

获取GPS模块是否处于开启状态

参数

无

返回值

bool result，true表示开启状态，false或者nil表示关闭状态

例子
```
gpsHxxt.isOpen()
```

gpsHxxt.isFix()

获取GPS模块是否定位成功

参数

无

返回值

bool result，true表示定位成功，false或者nil表示定位失败

例子
```
gpsHxxt.isFix()
```

gpsHxxt.isOnece()

获取GPS模块是否首次定位成功过

参数

无

返回值

bool result，true表示曾经定位成功

例子
```
gpsHxxt.isOnece()
```

gpsHxxt.getLocation(typ)

获取度格式的经纬度信息

参数

|名称|传入值类型|释义| |-|-|-| |typ|string|可选参数，默认为nil 返回的经纬度格式，typ为"DEGREE_MINUTE"时表示返回度分格式，其余表示返回度格式|

返回值

table location
例如typ为"DEGREE_MINUTE"时返回{lngType="E",lng="12128.44954",latType="N",lat="3114.50931"}
例如typ不是"DEGREE_MINUTE"时返回{lngType="E",lng="121.123456",latType="N",lat="31.123456"}
lngType：string类型，表示经度类型，取值"E"，"W"
lng：string类型，表示度格式的经度值，无效时为""
latType：string类型，表示纬度类型，取值"N"，"S"
lat：string类型，表示度格式的纬度值，无效时为""

例子
```
gpsHxxt.getLocation()
```

gpsHxxt.getAltitude()

获取海拔

参数

无

返回值

number altitude，海拔，单位米

例子
```
gpsHxxt.getAltitude()
```

gpsHxxt.getSpeed()

获取速度

参数

无

返回值

number kmSpeed，第一个返回值为公里每小时的速度 number nmSpeed，第二个返回值为海里每小时的速度

例子
```
gpsHxxt.getSpeed()
```

gpsHxxt.getOrgSpeed()

获取原始速度,字符串带浮点

参数

无

返回值

number speed 海里每小时的速度

例子
```
gpsHxxt.getOrgSpeed()
```

gpsHxxt.getCourse()

获取方向角

参数

无

返回值

number course，方向角

例子
```
gpsHxxt.getCourse()
```

gpsHxxt.getViewedSateCnt()

获取可见卫星的个数

参数

无

返回值

number count，可见卫星的个数

例子
```
gpsHxxt.getViewedSateCnt()
```

gpsHxxt.getUsedSateCnt()

获取定位使用的卫星个数

参数

无

返回值

number count，定位使用的卫星个数

例子
```
gpsHxxt.getUsedSateCnt()
```

gpsHxxt.getGgaloc()

获取GGA语句中度分格式的经纬度信息

参数

无

返回值

string lng，度分格式的经度值(dddmm.mmmm)，西经会添加一个-前缀，无效时为""；例如"12112.3456"表示东经121度12.3456分，"-12112.3456"表示西经121度12.3456分 string lat，度分格式的纬度值(ddmm.mmmm)，南纬会添加一个-前缀，无效时为""；例如"3112.3456"表示北纬31度12.3456分，"-3112.3456"表示南纬31度12.3456分

例子
```
gpsHxxt.getGgaloc()
```

gpsHxxt.getUtcTime()

获取RMC语句中的UTC时间

只有同时满足如下两个条件，返回值才有效
1、开启了GPS，并且定位成功
2、调用setParseItem接口，第一个参数设置为true

参数

无

返回值

table utcTime，UTC时间，nil表示无效，例如{year=2018,month=4,day=24,hour=11,min=52,sec=10}

例子
```
gpsHxxt.getUtcTime()
```

gpsHxxt.getSep()

获取定位使用的大地高

参数

无

返回值

number sep，大地高

例子
```
gpsHxxt.getSep()
```

gpsHxxt.getSateSn()

获取GSA语句中的可见卫星号

只有同时满足如下两个条件，返回值才有效
1、开启了GPS，并且定位成功
2、调用setParseItem接口，第三个参数设置为true

参数

无

返回值

string viewedSateId，可用卫星号，""表示无效

例子
```
gpsHxxt.getSateSn()
```

gpsHxxt.getGsv()

获取GSV语句中的可见卫星的信噪比

只有同时满足如下两个条件，返回值才有效
1、开启了GPS，并且定位成功
2、调用setParseItem接口，第二个参数设置为true

参数

无

返回值

string gsv，信噪比

例子
```
gpsHxxt.getGsv()
```

gpsHxxt.setParseItem(utcTime, gsv, gsaId)

设置是否需要解析的字段

参数

返回值

无

例子
```
gpsHxxt.setParseItem(true,true,true)
```

gpsHxxt.md 14 KB Permalink Geschiedenis Ruwe