LuatOS exgnss库：简化物联网GNSS定位开发

1. 项目概述

在物联网设备开发中，GNSS定位功能是许多应用场景的核心需求。传统使用libgnss核心库实现GNSS功能时，开发者需要手动配置串口、电源、debug、AGPS等多个参数，步骤繁琐且容易出错。LuatOS推出的exgnss扩展库正是为了解决这一问题而生，它通过封装底层细节，提供了更简洁高效的API接口。

exgnss扩展库的主要优势体现在三个方面：一是简化了初始化流程，通过setup和open两个接口即可完成大部分配置；二是内置了三种经典应用场景模式，开发者无需重复编写基础逻辑；三是提供了丰富的定位数据解析功能，可以直接获取格式化后的位置信息。

2. 核心功能解析

2.1 三种工作模式详解

exgnss扩展库提供了三种工作模式，满足不同场景下的定位需求：

1. DEFAULT模式：常开模式，开启后会持续进行定位，直到开发者主动调用close接口关闭。这种模式适合需要持续获取位置信息的应用场景，如车辆追踪、资产监控等。

2. TIMER模式：定时模式，开启后会在指定时间后自动关闭，无论是否定位成功。这种模式适合对功耗敏感的应用，如定期上报位置的物联网设备。

3. TIMERORSUC模式：智能定时模式，在指定时间内如果定位成功则立即关闭，否则在时间到达后关闭。这种模式在定位速度和功耗之间取得了平衡，适合大多数常规应用场景。

2.2 关键API解析

2.2.1 setup接口配置

setup接口是使用exgnss库的第一步，它接收一个table类型的参数，用于配置GNSS模块的各项参数。其中几个关键配置项包括：

• gnssmode：定位模式选择，1为全卫星定位，2为单北斗定位
• agps_enable：是否启用AGPS辅助定位，开启后可显著提升首次定位速度
• hz：定位频率设置，支持1/2/4/5Hz，数值越高定位数据更新越频繁

提示：对于外挂GNSS模块的设备，需要特别注意配置gnss_volgpio参数指定供电控制引脚，而内置GNSS的模组如Air780EGH则无需此配置。

2.2.2 定位数据获取

exgnss提供了多种获取定位数据的接口，最常用的是rmc()和gga()：

• rmc()返回包含经纬度、速度