全部文档
OneOS简介 硬件支持 快速开发指南 编译构造工具 API参考文档 高级语言 用户编程手册 应用笔记 FAQ

OneOS-Position

简介

位置服务组件可以对使用操作系统的合作伙伴提供室内外定位功能。该定位功能依据多数智能硬件本身情况而设计,无需增加额外产品成本,就能在当前硬件支持的情况下给出精度最高的定位结果;目前的位置服务组件的定位方式主要有:Wi-Fi定位、卫星导航定位。后续还会开放定位服务器相关接口,以方便开发者使用。

目录结构

目录 说明
Kconfig 配置脚本
SConscript 编译脚本
include 头文件目录
source 源文件目录

重要数据结构

目前组件的定位结果对应的是GNSS位置信息;

GNSS定位结果数据结构

根据不同的NMEA数据集封装了不同的结构体,这些语句集的结构体作为GNSS位置结构体的一个子集,可以通过相关宏定义来控制使用不同的子集;目前支持的NMEA数据集有:RMC、GGA、GSV、GLL、GSA、VTG、ZDA。

typedef struct 
{
  nmea_rmc_t  rmc_frame;
  nmea_gga_t  gga_frame;
  nmea_gsv_t  gsv_frame;
  nmea_gll_t  gll_frame;
  nmea_gsa_t  gsa_frame;
  nmea_vtg_t  vtg_frame;
  nmea_zda_t  zda_frame;
  os_uint32_t valid_flag;
} nmea_t;
重要成员 说明
rmc_frame RMC数据集(推荐最低指定GNSS数据)
gga_frame GGA数据集(GPS定位信息,用于全球定位系统的定位数据)
gsv_frame GSV数据集(可见的GNSS卫星)
gll_frame GGL数据集(地理位置——经度/纬度)
gsa_frame GSA数据集(GPS精度因子与使用的卫星)
vtg_frame VTG数据集(地面航向与地面速度,水平航向与航速)
zda_frame ZDA数据集(时间与日期)
valid_flag 当前GNSS数据结构中有效数据集标志

获取位置API列表

接口 说明
get_gnss_data 获取GNSS定位结果

get_gnss_data

os_bool_t get_gnss_data(nmea_t* nmea, 
                        gnss_data_flag_t get_data_type_flag)
参数 说明
nmea 指向GNSS数据结构体,用来保存位置信息
get_data_type_flag 要获取的数据集类别
返回 说明
os_bool_t 成功获取返回true,获取超时返回false

使用示例

参考components\position\source目录下onepos_cmd.c使用范例。

results matching ""

    No results matching ""