158 lines
6.8 KiB
C
158 lines
6.8 KiB
C
/*********************************************************************************/
|
||
/* FILE NAME : scene_recognition.h */
|
||
/* AUTHOR : Zhang Jingrui, ID: 11082826, Version: V0.1_Beta, Data:2019-03-28 */
|
||
/* DESCRIPTION: This header file conterns the prototype description of the external */
|
||
/* interface funtions of the scene recognition module and the definit- */
|
||
/* ion of related resources. */
|
||
/* HISTORY : (NONE) */
|
||
/********************************************************************************/
|
||
|
||
#ifndef _PDR_SCENE_RECOGNITION_H_
|
||
#define _PDR_SCENE_RECOGNITION_H_
|
||
|
||
/* Header Files Including -----------------------------------------*/
|
||
/*=================================================================*/
|
||
#include "pdr_sensor.h"
|
||
|
||
/* Macro Declaration ----------------------------------------------*/
|
||
/*=================================================================*/
|
||
|
||
#define _TIME_BUFFER_SIZE 10 /* Buffer size for the time calculation. */
|
||
#define _ACCURACY_BUFFER_SIZE 9 /* Accuracy time-based buffer size. */
|
||
#define _GNSS_INDEX_LEN 103 /* Structural array size in _GnssInfo. */
|
||
|
||
/* Extern Variable Declaration ------------------------------------*/
|
||
/*=================================================================*/
|
||
//extern int scene_recognition_debug_flag ;
|
||
//extern int scene_recognition_log_debug_flag ;
|
||
|
||
/* Status Declaration ---------------------------------------------*/
|
||
/*=================================================================*/
|
||
/* Usage: 场景识别模块初始化、重置操作结果状态标志位 */
|
||
typedef enum SCENE_INIT_STATE
|
||
{
|
||
// 场景识别模块初始化相关状态
|
||
INIT_SUCCESS = 0,
|
||
INIT_NOT_PERFORMED,
|
||
|
||
INIT_ERROR_MEMORY_OCCUPIED, // 模块资源未提前释放，需先释放资源
|
||
INIT_ERROR_MEMORY_INIT_FAILED, // 初始化内存申请失败
|
||
INIT_ERROR_REDUNDANCY, // 模块重复初始化，此时初始化无效。若需要重启模块，可以：
|
||
// 方法1：先关闭模块，关闭成功后，重新初始化模块。
|
||
// 方法2：重启模块，效果同方法1。
|
||
// 场景识别模块重置相关状态(for debug)
|
||
INIT_RESET_SUCCESS = 0,
|
||
INIT_RESET_FAILED
|
||
} SCENE_INIT_STATE;
|
||
|
||
/* Usage: 场景分类结果 */
|
||
typedef enum SCENE_RECOGNITION_RESULT
|
||
{
|
||
RECOG_UNKNOWN, // 未能确定场景的状态(默认状态)
|
||
RECOG_OPEN_AREA, // 场景open-area
|
||
RECOG_OTHERS, // 除了上述确定场景外的其他场景
|
||
RECOG_ERROR_PARAM_INCRECT, // 输入参数检查错误
|
||
RECOG_ERROR_NMEA_INFO_MISS, // 输入参数正确但是内容有误
|
||
/* 预研检测结果(不稳定) */
|
||
RECOG_MULTIPATH // 检测多径
|
||
} SCENE_RECOGNITION_RESULT;
|
||
|
||
/* Usage: 场景识别模块资源释放操作结果 */
|
||
typedef enum SCENE_DESTROY_STATE
|
||
{
|
||
DESTROY_SUCCESS = 0,
|
||
DESTROY_FIALED,
|
||
DESTROY_ERROR,
|
||
DESTROY_INVALID // 无效释放操作，表示没有对应的初始化或重置操作
|
||
} SCENE_DESTROY_STATE;
|
||
|
||
|
||
/* Status Declaration--------------------------------------------*/
|
||
/*===============================================================*/
|
||
|
||
// 描述当前场景识别模块的工作状态
|
||
typedef enum _SCENE_MODEL_WORK_STATE
|
||
{
|
||
MODEL_OFF,
|
||
MODEL_ON
|
||
} _SCENE_MODEL_WORK_STATE;
|
||
|
||
/* Usage: Identifier of the quality of the satellites' signal source. */
|
||
typedef enum _SIGNAL_QUALITY
|
||
{
|
||
SIG_UNKNOWN,
|
||
GOOD,
|
||
BAD
|
||
} SIGNAL_QUALITY;
|
||
|
||
/* Usage: extract and save information from Nmea_t for the module. */
|
||
/* This is the interface for the Nmea_t. */
|
||
typedef struct _GnssInfo
|
||
{
|
||
int update; // GNSS更新标志位 1：更新 0：不更新
|
||
double local_timestamp; // 当地时间
|
||
float accuracy; // GPS 输出的Accuracy参数，Accuracy > 0 当其为负数表示无效
|
||
int sat_visible_number; // 当前时间可见卫星数量
|
||
float snr_list[_GNSS_INDEX_LEN]; // 当前时间可见卫星的SNR列表
|
||
int sat_used_list[_GNSS_INDEX_LEN]; // 当前使用卫星列表
|
||
} GnssInfo;
|
||
|
||
/* Usage: 标记GNSS中的各个卫星系统 */
|
||
|
||
/* Struct Declaration -------------------------------------------*/
|
||
/*===============================================================*/
|
||
|
||
|
||
/* Function Declaration -------------------------------------------*/
|
||
/*=================================================================*/
|
||
#ifdef __cplusplus
|
||
extern "C" {
|
||
#endif
|
||
|
||
/* Function Name: sceneRecognitionInit() */
|
||
/* Usage: Initialization module for configuring related resources */
|
||
/* and must be executed once first beforing using the scene */
|
||
/* recognition module funcition. */
|
||
/* Param @ (NONE) */
|
||
/* Return @ init_res: Result state of the initialization process. */
|
||
SCENE_INIT_STATE SceneRecog_Init(void);
|
||
|
||
/* Function Name: scene_recognition_reset() */
|
||
/* Usage: 初始化模块，配置相关资源，在使用模块前必须首先被执行。 */
|
||
/* Param @ (NONE) */
|
||
/* Return @ init_res: 重置执行结果。 */
|
||
SCENE_INIT_STATE scene_recognition_reset(void);
|
||
|
||
/**----------------------------------------------------------------------
|
||
* Function : sceneRecognitionProc
|
||
* Description : GNSS场景识别处理流程：
|
||
* 1）将nmea转换为gnss
|
||
* 2) 通过accuracy、snr、卫星数量分析GNSS信号质量
|
||
* 3) 返回结果
|
||
* Input : PDR的nmea结构体
|
||
* Return : 场景识别结果
|
||
* Date : 2020/02/18
|
||
*---------------------------------------------------------------------**/
|
||
SCENE_RECOGNITION_RESULT sceneRecognitionProc(const Nmea_t* nmea);
|
||
|
||
/* Function Name: scene_recognition_destroy() */
|
||
/* Usage: 场景识别处理结束后的资源释放操作，资源释放后无法继续进行场 */
|
||
/* 景识别过程。 */
|
||
/* Param @ (NONE) */
|
||
/* Return @ destroy_state: 资源释放操作结果。 */
|
||
SCENE_DESTROY_STATE scene_recognition_destroy(void);
|
||
|
||
/**----------------------------------------------------------------------
|
||
* Function : isOpenArea
|
||
* Description : GNSS开阔地检测，通过输入GNSS信号，分析当前信号质量，从而确定
|
||
* 目标是否处于开阔场地。
|
||
* Return : 0 : 非开阔地 1：开阔地(信号质量较好)
|
||
* Author : Zhang Jingrui, Geek ID: 11082826
|
||
* Date : 2020/02/18 logzhan
|
||
*---------------------------------------------------------------------**/
|
||
int isOpenArea(const Nmea_t* nmea);
|
||
|
||
#ifdef __cplusplus
|
||
}
|
||
#endif
|
||
#endif //__SCENE_RECOGNITION_H__
|