全部文档
概述 硬件支持 快速开发指南 内核 驱动 通用组件 专业组件 常见问题

网络定位

​ 网络定位是使用设备自身所处的网络环境的特征进行匹配定位的一种定位方式;目前支持的定位方式有:wifi定位、基站定位以及wifi与基站联合定位;

重要数据结构及API接口

枚举

typedef enum
{
    ONEPOS_CLOSING    = 0,
    ONEPOS_RUNING     = 1,
    ONEPOS_SIG_RUNING = 2,
    ONEPOS_WILL_CLOSE = 3,
} onepos_serv_sta_t;
参数 说明
ONEPOS_CLOSING 定位服务未运行
ONEPOS_RUNING 定位服务正在周期性运行
ONEPOS_SIG_RUNING 定位服务正在单次运行
ONEPOS_WILL_CLOSE 定位服务即将从周期运行中关闭(等最后一次定位操作完成)
typedef enum
{
    ONEPOS_CIRC_RUN     = 0,
    ONEPOS_SIG_RUN      = 1,
} onepos_serv_type_t;
参数 说明
ONEPOS_CIRC_RUN 定位服务以周期性循环运行
ONEPOS_SIG_RUN 定位服务单次运行

结构体

typedef struct
{
    os_uint32_t time;           /* UNIX time stamp : s*/
    double      lat_coordinate; /* Latitude coordinate */
    double      lon_coordinate; /* Longitude coordinate */
} onepos_pos_t;
参数 说明
time 定位时间(单位:秒)
lat_coordinate 纬度(坐标系:WGS84)
lon_coordinate 经度(坐标系:WGS84)
typedef struct onepos_net_pos{
    onepos_pos_t       *pos_result;
    os_task_t          *task;
    onepos_prot_t      *prot;
    os_uint16_t         interval;
    onepos_serv_sta_t   status;
    onepos_serv_type_t  type;
}onepos_net_pos_t;
参数 说明
pos_result 指向定位结果的指针
task 周期定位任务的句柄
prot 指向与OnePos定位平台的通信协议模块
interval 周期定位的间隔
status 定位服务的运行状态
type 定位服务的运行类型

API列表

接口 说明
onepos_start_server 开启定位服务
onepos_stop_server 关闭定位服务
onepos_set_pos_interval 设置服务定位间隔
onepos_set_server_type 设置服务运行模式
onepos_get_pos_interval 查询当前服务的定位周期
onepos_get_server_sta 获取服务状态
onepos_get_latest_position 获取最新的位置信息
void onepos_start_server(void)
特别说明
会根据设置的(如果没有设置,则使用默认的)运行模式启动服务;默认的运行模式是循环定位模式;
void onepos_stop_server(void)
特殊说明
如果服务当前的定位模式是循环周期性定位,则可以调用该接口停止定位服务;对于单次定位服务,不需要停止,会自动在定位操作完成后退出服务;
os_bool_t onepos_set_pos_interval(os_int32_t interval)
参数 说明
interval 设置的定位周期时间(单位:秒)
返回 说明
OS_TRUE 设置成功
OS_FALSE 设置失败(可能是参数错误等原因)
os_bool_t onepos_set_server_type(onepos_serv_type_t type)
参数 说明
type 设置服务的运行方式(具体参见:onepos_serv_type_t定义)
返回 说明
OS_TRUE 设置成功
OS_FALSE 设置失败(可能是参数错误等原因)
os_uint32_t onepos_get_pos_interval(void)
返回 说明
os_uint32_t 定位周期时间(单位:秒)
onepos_serv_sta_t  onepos_get_server_sta(void)
返回 说明
onepos_serv_sta_t 服务运行状态(具体参见:onepos_serv_sta_t定义)
os_bool_t  onepos_get_latest_position(onepos_pos_t *src_info)
参数 说明
src_info 指向保存定位数据的内存
返回 说明
OS_TRUE 获取成功
OS_FALSE 获取失败

使用示例

参考components\position\sample目录下onepos_cmd.c文件中接口调用方式。

results matching ""

    No results matching ""