tkl_cellular_gnss.h

浏览该文件的文档.

 
#ifndef _TKL_CELLULAR_GNSS_H_
#define _TKL_CELLULAR_GNSS_H_
#include "tuya_cloud_types.h"
 
#ifdef __cplusplus
extern "C" {
#endif
 
#define TUYA_GNSS_NMEA_MAX_LENGTH  1823                 
typedef UINT32_T TUYA_CELLULAR_GNSS_DEV_HANDLE;
 
typedef enum{
    TY_CELL_GNSS_GPS_BDS = 0x00,
    TY_CELL_GNSS_GPS_GLONASS = 0x01,
    TY_CELL_GNSS_GPS = 0x02,
    TY_CELL_GNSS_BDS = 0x03,
    TY_CELL_GNSS_GLONASS = 0x04,
    TY_CELL_GNSS_GALILEO = 0x05,
}TUYA_CELLULAR_GNSS_SYS_MODE_E;
 
typedef enum
{
    TY_CELL_GNSS_STATUS_NONE            = 0, 
    TY_CELL_GNSS_STATUS_SESSION_BEGIN   = 1, 
    TY_CELL_GNSS_STATUS_SESSION_END     = 2, 
    TY_CELL_GNSS_STATUS_ENGINE_ON       = 3, 
    TY_CELL_GNSS_STATUS_ENGINE_OFF      = 4, 
}TUYA_CELLULAR_GNSS_STATUS_E;
 
typedef enum
{
    TY_CELL_GNSS_CAPABILITY_SCHEDULING      = 0x01, 
    TY_CELL_GNSS_CAPABILITY_MSB             = 0x02, 
    TY_CELL_GNSS_CAPABILITY_MSA             = 0x04, 
    TY_CELL_GNSS_CAPABILITY_SINGLE_SHOT     = 0x08, 
    TY_CELL_GNSS_CAPABILITY_ON_DEMAND_TIME  = 0x10, 
}TUYA_CELLULAR_GNSS_CAPABILITY_T;
 
typedef enum
{
    TY_CELL_GNSS_NFY_MSG_ID_STATUS_INFO = 0,        
    TY_CELL_GNSS_NFY_MSG_ID_LOCATION_INFO,          
    TY_CELL_GNSS_NFY_MSG_ID_SV_INFO,                
    TY_CELL_GNSS_NFY_MSG_ID_NMEA_INFO,              
    TY_CELL_GNSS_NFY_MSG_ID_CAPABILITIES_INFO,      
    TY_CELL_GNSS_NFY_MSG_ID_AGPS_STATUS,            
    TY_CELL_GNSS_NFY_MSG_ID_NI_NOTIFICATION,
    TY_CELL_GNSS_NFY_MSG_ID_XTRA_REPORT_SERVER,     
}TUYA_CELLULAR_GNSS_NOTIFY_MSG_ID_E;
 
typedef enum
{
    TY_CELL_GNSS_POS_MODE_STANDALONE        = 0, 
    TY_CELL_GNSS_POS_MODE_MS_BASED          = 1, 
    TY_CELL_GNSS_POS_MODE_MS_ASSISTED       = 2, 
}TUYA_CELLULAR_GNSS_POS_MODE_E;
 
 
#pragma pack(1)
 
#define     TUYA_CELLULAR_GNSS_MAX_SEVER_ADDR_LENGTH    255 
typedef struct
{
    CHAR_T server1[TUYA_CELLULAR_GNSS_MAX_SEVER_ADDR_LENGTH + 1];  
    CHAR_T server2[TUYA_CELLULAR_GNSS_MAX_SEVER_ADDR_LENGTH + 1];  
    CHAR_T server3[TUYA_CELLULAR_GNSS_MAX_SEVER_ADDR_LENGTH + 1];  
}TUYA_CELLULAR_GNSS_XRTA_REPT_SERVER_INFO_T;
 
 
#define TY_CELL_GNSS_GPS_SSID_BUF_SIZE    32          
#define TY_CELL_GNSS_IPV6_ADDR_LEN        16          
typedef enum
{
    TY_CELL_GNSS_AGPS_TYPE_INVALID          = -1,   
    TY_CELL_GNSS_AGPS_TYPE_ANY              = 0,    
    TY_CELL_GNSS_AGPS_TYPE_SUPL             = 1,    
    TY_CELL_GNSS_AGPS_TYPE_C2K              = 2,    
    TY_CELL_GNSS_AGPS_TYPE_WWAN_ANY         = 3,    
    TY_CELL_GNSS_AGPS_TYPE_WIFI             = 4,    
    TY_CELL_GNSS_AGPS_TYPE_SUPL_ES          = 5,    
}TY_CELL_GNSS_AGPS_TYPE_E;
 
typedef enum
{
    TY_CELL_GNSS_REQUEST_AGPS_DATA_CONN     = 1,    
    TY_CELL_GNSS_RELEASE_AGPS_DATA_CONN     = 2,    
    TY_CELL_GNSS_AGPS_DATA_CONNECTED        = 3,    
    TY_CELL_GNSS_AGPS_DATA_CONN_DONE        = 4,    
    TY_CELL_GNSS_AGPS_DATA_CONN_FAILED      = 5,    
}TY_CELL_GNSS_AGPS_STATUS_E;
 
typedef struct
{
    UINT_T                          size;       
    TY_CELL_GNSS_AGPS_TYPE_E        type;       
    TY_CELL_GNSS_AGPS_STATUS_E      status;     
    int                             ipv4_addr;  
    char                            ipv6_addr[TY_CELL_GNSS_IPV6_ADDR_LEN + 1];        
    char                            ssid[TY_CELL_GNSS_GPS_SSID_BUF_SIZE + 1];         
    char                            password[TY_CELL_GNSS_GPS_SSID_BUF_SIZE + 1];     
}TUYA_CELLULAR_GNSS_AGPS_STATUS_T;
 
typedef enum
{
    TY_CELL_GNSS_LOCATION_LAT_LONG_VALID   = 0x0001, 
    TY_CELL_GNSS_LOCATION_ALTITUDE_VALID   = 0x0002, 
    TY_CELL_GNSS_LOCATION_SPEED_VALID      = 0x0004, 
    TY_CELL_GNSS_LOCATION_BEARING_VALID    = 0x0008, 
    TY_CELL_GNSS_LOCATION_ACCURACY_VALID   = 0x0010, 
    TY_CELL_GNSS_LOCATION_SOURCE_INFO_VALID= 0x0020, 
    TY_CELL_GNSS_LOCATION_IS_INDOOR_VALID  = 0x0040, 
    TY_CELL_GNSS_LOCATION_FLOOR_NUMBE_VALID= 0x0080, 
    TY_CELL_GNSS_LOCATION_MAP_URL_VALID    = 0x0100, 
    TY_CELL_GNSS_LOCATION_MAP_INDEX_VALID  = 0x0200, 
}TY_CELL_GNSS_LOACTION_VAILD_FLAG_E;
 
typedef struct
{
    INT64_T     timestamp;                              
    CHAR_T        nmea[TUYA_GNSS_NMEA_MAX_LENGTH + 1];    
    INT_T         length;                                 
}TUYA_CELLULAR_GNSS_NMEA_T;  /* Message */
 
typedef struct{
    INT_T         flags;                    
    DOUBLE_T      latitude;               
    DOUBLE_T      longitude;              
    DOUBLE_T      altitude;               
    FLOAT_T       speed;                  
    FLOAT_T       bearing;                
    FLOAT_T       accuracy;               
}TUYA_CELLULAR_GNSS_LOCATION_INFO_T;
 
typedef struct
{
    UINT_T        size;                   
    INT_T         prn;                    
    FLOAT_T       snr;                    
    FLOAT_T       elevation;              
    FLOAT_T       azimuth;                
}TUYA_CELLLULAR_GNSS_SV_INFO_T;                      /* Type */
 
#define     TUYA_GPS_SUPPORT_SVS_MAX   80  
typedef struct
{
    uint32_t                        size;                                   
    int                             num_svs;                                
    TUYA_CELLLULAR_GNSS_SV_INFO_T    sv_list[TUYA_GPS_SUPPORT_SVS_MAX];    
    uint32_t                         ephemeris_mask;                         
    uint32_t                         almanac_mask;                           
    uint32_t                         used_in_fix_mask;                       
}TUYA_CELLULAR_GNSS_SV_STATUS_T; /* Type */
 
typedef struct
{
    INT64_T time;               
    INT64_T time_reference;     
    INT32_T uncertainty;        
}TUYA_CELLULAR_GNSS_INJECT_TIME_INFO_T;  /* Message */
 
typedef struct
{
    DOUBLE_T  latitude;   
    DOUBLE_T  longitude;  
    FLOAT_T   accuracy;   
}TUYA_CELLULAR_GNSS_INJECT_LOCATION_INFO_T;
 
typedef enum
{
    TY_CELL_GNSS_POS_RECURRENCE_PERIODIC    = 0, 
    TY_CELL_GNSS_POS_RECURRENCE_SINGLE      = 1, 
}TUYA_CELLULAR_GNSS_POS_RECURRENCE_T;
 
typedef struct
{
  TUYA_CELLULAR_GNSS_POS_MODE_E       mode;               /*  Position mode.      */
  TUYA_CELLULAR_GNSS_POS_RECURRENCE_T recurrence;         /*  Recurrence          */
  uint32_t                  min_interval;       /*  Minimum Interval, NMEA report frequency, 1000 means 1Hz, 100 means 10Hz    */
  uint32_t                  preferred_accuracy; /*  Preferred Accuracy , 30m or more, the less it takes longer timer. */
  uint32_t                  preferred_time;     /*  Preferred Time, first cold-boot may take 100s or more, hot boot may take 2s      */
}TUYA_CELLULAR_GNSS_MODE_INFO_T;
 
 
#pragma pack()
 
typedef VOID (*TKL_GNSS_REGISTION_NOTIFY)(TUYA_CELLULAR_GNSS_NOTIFY_MSG_ID_E msg,VOID *data,INT_T len);
 
OPERATE_RET tkl_cellular_gnss_init(TUYA_CELLULAR_GNSS_DEV_HANDLE *handle);
 
OPERATE_RET tkl_cellular_gnss_deinit(TUYA_CELLULAR_GNSS_DEV_HANDLE handle);
 
OPERATE_RET tkl_cellular_gnss_register_notify(TKL_GNSS_REGISTION_NOTIFY notify);
 
OPERATE_RET tkl_cellular_gnss_set_position_mode(TUYA_CELLULAR_GNSS_DEV_HANDLE nohandletify, TUYA_CELLULAR_GNSS_MODE_INFO_T pt_mode);
 
 
OPERATE_RET tkl_cellular_gnss_set_system_mode(TUYA_CELLULAR_GNSS_DEV_HANDLE nohandletify, TUYA_CELLULAR_GNSS_SYS_MODE_E pt_mode);
 
 
OPERATE_RET tkl_cellular_gnss_start_navigation(TUYA_CELLULAR_GNSS_DEV_HANDLE handle);
 
OPERATE_RET tkl_cellular_gnss_stop_navigation(TUYA_CELLULAR_GNSS_DEV_HANDLE handle);
 
OPERATE_RET tkl_cellular_gnss_get_location(TUYA_CELLULAR_GNSS_DEV_HANDLE handle,TUYA_CELLULAR_GNSS_LOCATION_INFO_T *location,INT_T timeout_sec);
 
OPERATE_RET tkl_cellular_gnss_injecttime(TUYA_CELLULAR_GNSS_DEV_HANDLE handle,TUYA_CELLULAR_GNSS_INJECT_TIME_INFO_T *pt_info);
 
 
OPERATE_RET tkl_cellular_gnss_injectlocation(TUYA_CELLULAR_GNSS_DEV_HANDLE handle, TUYA_CELLULAR_GNSS_INJECT_LOCATION_INFO_T *pt_info);
 
OPERATE_RET tkl_cellular_gnss_ioctl(TUYA_CELLULAR_GNSS_DEV_HANDLE handle,INT_T cmd,VOID *pdata,INT_T datalen);
 
#ifdef __cplusplus
}
#endif
#endif