You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
1166 lines
45 KiB
1166 lines
45 KiB
/* Copyright (c) 2013-2017 The Linux Foundation. All rights reserved.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions are
|
|
* met:
|
|
* * Redistributions of source code must retain the above copyright
|
|
* notice, this list of conditions and the following disclaimer.
|
|
* * Redistributions in binary form must reproduce the above
|
|
* copyright notice, this list of conditions and the following
|
|
* disclaimer in the documentation and/or other materials provided
|
|
* with the distribution.
|
|
* * Neither the name of The Linux Foundation nor the names of its
|
|
* contributors may be used to endorse or promote products derived
|
|
* from this software without specific prior written permission.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESS OR IMPLIED
|
|
* WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
|
|
* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT
|
|
* ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS
|
|
* BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
|
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
|
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
|
|
* BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
|
|
* WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
|
|
* OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
|
|
* IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
*/
|
|
|
|
#ifndef GPS_EXTENDED_C_H
|
|
#define GPS_EXTENDED_C_H
|
|
|
|
#include <ctype.h>
|
|
#include <stdbool.h>
|
|
#include <stdlib.h>
|
|
#include <string.h>
|
|
#include <loc_gps.h>
|
|
#include <LocationAPI.h>
|
|
#include <time.h>
|
|
|
|
/**
|
|
* @file
|
|
* @brief C++ declarations for GPS types
|
|
*/
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif /* __cplusplus */
|
|
|
|
/** Location has valid source information. */
|
|
#define LOCATION_HAS_SOURCE_INFO 0x0020
|
|
/** LocGpsLocation has valid "is indoor?" flag */
|
|
#define LOC_GPS_LOCATION_HAS_IS_INDOOR 0x0040
|
|
/** LocGpsLocation has valid floor number */
|
|
#define LOC_GPS_LOCATION_HAS_FLOOR_NUMBER 0x0080
|
|
/** LocGpsLocation has valid map URL*/
|
|
#define LOC_GPS_LOCATION_HAS_MAP_URL 0x0100
|
|
/** LocGpsLocation has valid map index */
|
|
#define LOC_GPS_LOCATION_HAS_MAP_INDEX 0x0200
|
|
|
|
/** Sizes for indoor fields */
|
|
#define GPS_LOCATION_MAP_URL_SIZE 400
|
|
#define GPS_LOCATION_MAP_INDEX_SIZE 16
|
|
|
|
/** Position source is ULP */
|
|
#define ULP_LOCATION_IS_FROM_HYBRID 0x0001
|
|
/** Position source is GNSS only */
|
|
#define ULP_LOCATION_IS_FROM_GNSS 0x0002
|
|
/** Position source is ZPP only */
|
|
#define ULP_LOCATION_IS_FROM_ZPP 0x0004
|
|
/** Position is from a Geofence Breach Event */
|
|
#define ULP_LOCATION_IS_FROM_GEOFENCE 0X0008
|
|
/** Position is from Hardware FLP */
|
|
#define ULP_LOCATION_IS_FROM_HW_FLP 0x0010
|
|
/** Position is from NLP */
|
|
#define ULP_LOCATION_IS_FROM_NLP 0x0020
|
|
/** Position is from PIP */
|
|
#define ULP_LOCATION_IS_FROM_PIP 0x0040
|
|
/** Position is from external DR solution*/
|
|
#define ULP_LOCATION_IS_FROM_EXT_DR 0X0080
|
|
|
|
#define ULP_MIN_INTERVAL_INVALID 0xffffffff
|
|
#define ULP_MAX_NMEA_STRING_SIZE 201
|
|
|
|
/*Emergency SUPL*/
|
|
#define LOC_GPS_NI_TYPE_EMERGENCY_SUPL 4
|
|
|
|
#define LOC_AGPS_CERTIFICATE_MAX_LENGTH 2000
|
|
#define LOC_AGPS_CERTIFICATE_MAX_SLOTS 10
|
|
|
|
typedef uint32_t LocPosTechMask;
|
|
#define LOC_POS_TECH_MASK_DEFAULT ((LocPosTechMask)0x00000000)
|
|
#define LOC_POS_TECH_MASK_SATELLITE ((LocPosTechMask)0x00000001)
|
|
#define LOC_POS_TECH_MASK_CELLID ((LocPosTechMask)0x00000002)
|
|
#define LOC_POS_TECH_MASK_WIFI ((LocPosTechMask)0x00000004)
|
|
#define LOC_POS_TECH_MASK_SENSORS ((LocPosTechMask)0x00000008)
|
|
#define LOC_POS_TECH_MASK_REFERENCE_LOCATION ((LocPosTechMask)0x00000010)
|
|
#define LOC_POS_TECH_MASK_INJECTED_COARSE_POSITION ((LocPosTechMask)0x00000020)
|
|
#define LOC_POS_TECH_MASK_AFLT ((LocPosTechMask)0x00000040)
|
|
#define LOC_POS_TECH_MASK_HYBRID ((LocPosTechMask)0x00000080)
|
|
|
|
enum loc_registration_mask_status {
|
|
LOC_REGISTRATION_MASK_ENABLED,
|
|
LOC_REGISTRATION_MASK_DISABLED,
|
|
LOC_REGISTRATION_MASK_SET
|
|
};
|
|
|
|
typedef enum {
|
|
LOC_SUPPORTED_FEATURE_ODCPI_2_V02 = 0, /**< Support ODCPI version 2 feature */
|
|
LOC_SUPPORTED_FEATURE_WIFI_AP_DATA_INJECT_2_V02 /**< Support Wifi AP data inject version 2 feature */
|
|
} loc_supported_feature_enum;
|
|
|
|
typedef struct {
|
|
/** set to sizeof(UlpLocation) */
|
|
size_t size;
|
|
LocGpsLocation gpsLocation;
|
|
/* Provider indicator for HYBRID or GPS */
|
|
uint16_t position_source;
|
|
LocPosTechMask tech_mask;
|
|
/*allows HAL to pass additional information related to the location */
|
|
int rawDataSize; /* in # of bytes */
|
|
void * rawData;
|
|
bool is_indoor;
|
|
float floor_number;
|
|
char map_url[GPS_LOCATION_MAP_URL_SIZE];
|
|
unsigned char map_index[GPS_LOCATION_MAP_INDEX_SIZE];
|
|
} UlpLocation;
|
|
|
|
typedef struct {
|
|
/** set to sizeof(UlpNmea) */
|
|
size_t size;
|
|
char nmea_str[ULP_MAX_NMEA_STRING_SIZE];
|
|
unsigned int len;
|
|
} UlpNmea;
|
|
|
|
|
|
/** AGPS type */
|
|
typedef int16_t AGpsExtType;
|
|
#define LOC_AGPS_TYPE_INVALID -1
|
|
#define LOC_AGPS_TYPE_ANY 0
|
|
#define LOC_AGPS_TYPE_SUPL 1
|
|
#define LOC_AGPS_TYPE_C2K 2
|
|
#define LOC_AGPS_TYPE_WWAN_ANY 3
|
|
#define LOC_AGPS_TYPE_WIFI 4
|
|
#define LOC_AGPS_TYPE_SUPL_ES 5
|
|
|
|
/** SSID length */
|
|
#define SSID_BUF_SIZE (32+1)
|
|
|
|
typedef int16_t AGpsBearerType;
|
|
#define AGPS_APN_BEARER_INVALID -1
|
|
#define AGPS_APN_BEARER_IPV4 0
|
|
#define AGPS_APN_BEARER_IPV6 1
|
|
#define AGPS_APN_BEARER_IPV4V6 2
|
|
|
|
/** GPS extended callback structure. */
|
|
typedef struct {
|
|
/** set to sizeof(LocGpsCallbacks) */
|
|
size_t size;
|
|
loc_gps_set_capabilities set_capabilities_cb;
|
|
loc_gps_acquire_wakelock acquire_wakelock_cb;
|
|
loc_gps_release_wakelock release_wakelock_cb;
|
|
loc_gps_create_thread create_thread_cb;
|
|
loc_gps_request_utc_time request_utc_time_cb;
|
|
} GpsExtCallbacks;
|
|
|
|
/** Callback to report the xtra server url to the client.
|
|
* The client should use this url when downloading xtra unless overwritten
|
|
* in the gps.conf file
|
|
*/
|
|
typedef void (* report_xtra_server)(const char*, const char*, const char*);
|
|
|
|
/** Callback structure for the XTRA interface. */
|
|
typedef struct {
|
|
loc_gps_xtra_download_request download_request_cb;
|
|
loc_gps_create_thread create_thread_cb;
|
|
report_xtra_server report_xtra_server_cb;
|
|
} GpsXtraExtCallbacks;
|
|
|
|
/** Represents the status of AGPS. */
|
|
typedef struct {
|
|
/** set to sizeof(AGpsExtStatus) */
|
|
size_t size;
|
|
|
|
AGpsExtType type;
|
|
LocAGpsStatusValue status;
|
|
uint32_t ipv4_addr;
|
|
struct sockaddr_storage addr;
|
|
char ssid[SSID_BUF_SIZE];
|
|
char password[SSID_BUF_SIZE];
|
|
} AGpsExtStatus;
|
|
|
|
/** Callback with AGPS status information.
|
|
* Can only be called from a thread created by create_thread_cb.
|
|
*/
|
|
typedef void (* agps_status_extended)(AGpsExtStatus* status);
|
|
|
|
/** Callback structure for the AGPS interface. */
|
|
typedef struct {
|
|
agps_status_extended status_cb;
|
|
loc_gps_create_thread create_thread_cb;
|
|
} AGpsExtCallbacks;
|
|
|
|
|
|
typedef void (*loc_ni_notify_callback)(LocGpsNiNotification *notification, bool esEnalbed);
|
|
/** GPS NI callback structure. */
|
|
typedef struct
|
|
{
|
|
/**
|
|
* Sends the notification request from HAL to GPSLocationProvider.
|
|
*/
|
|
loc_ni_notify_callback notify_cb;
|
|
} GpsNiExtCallbacks;
|
|
|
|
typedef enum loc_server_type {
|
|
LOC_AGPS_CDMA_PDE_SERVER,
|
|
LOC_AGPS_CUSTOM_PDE_SERVER,
|
|
LOC_AGPS_MPC_SERVER,
|
|
LOC_AGPS_SUPL_SERVER
|
|
} LocServerType;
|
|
|
|
typedef enum loc_position_mode_type {
|
|
LOC_POSITION_MODE_INVALID = -1,
|
|
LOC_POSITION_MODE_STANDALONE = 0,
|
|
LOC_POSITION_MODE_MS_BASED,
|
|
LOC_POSITION_MODE_MS_ASSISTED,
|
|
LOC_POSITION_MODE_RESERVED_1,
|
|
LOC_POSITION_MODE_RESERVED_2,
|
|
LOC_POSITION_MODE_RESERVED_3,
|
|
LOC_POSITION_MODE_RESERVED_4,
|
|
LOC_POSITION_MODE_RESERVED_5
|
|
|
|
} LocPositionMode;
|
|
|
|
/**
|
|
* @brief Minimum allowed value for fix interval.
|
|
*
|
|
* This value is a sanity limit in GPS framework. The hardware has own internal
|
|
* limits that may not match this value
|
|
*
|
|
* @sa GPS_DEFAULT_FIX_INTERVAL_MS
|
|
*/
|
|
|
|
#define GPS_MIN_POSSIBLE_FIX_INTERVAL_MS 100
|
|
/**
|
|
* @brief Default value for fix interval.
|
|
*
|
|
* This value is used by default whenever appropriate.
|
|
*
|
|
* @sa GPS_MIN_POSSIBLE_FIX_INTERVAL_MS
|
|
*/
|
|
#define GPS_DEFAULT_FIX_INTERVAL_MS 1000
|
|
|
|
/** Flags to indicate which values are valid in a GpsLocationExtended. */
|
|
typedef uint16_t GpsLocationExtendedFlags;
|
|
/** GpsLocationExtended has valid pdop, hdop, vdop. */
|
|
#define GPS_LOCATION_EXTENDED_HAS_DOP 0x0001
|
|
/** GpsLocationExtended has valid altitude mean sea level. */
|
|
#define GPS_LOCATION_EXTENDED_HAS_ALTITUDE_MEAN_SEA_LEVEL 0x0002
|
|
/** UlpLocation has valid magnetic deviation. */
|
|
#define GPS_LOCATION_EXTENDED_HAS_MAG_DEV 0x0004
|
|
/** UlpLocation has valid mode indicator. */
|
|
#define GPS_LOCATION_EXTENDED_HAS_MODE_IND 0x0008
|
|
/** GpsLocationExtended has valid vertical uncertainty */
|
|
#define GPS_LOCATION_EXTENDED_HAS_VERT_UNC 0x0010
|
|
/** GpsLocationExtended has valid speed uncertainty */
|
|
#define GPS_LOCATION_EXTENDED_HAS_SPEED_UNC 0x0020
|
|
/** GpsLocationExtended has valid heading uncertainty */
|
|
#define GPS_LOCATION_EXTENDED_HAS_BEARING_UNC 0x0040
|
|
/** GpsLocationExtended has valid horizontal reliability */
|
|
#define GPS_LOCATION_EXTENDED_HAS_HOR_RELIABILITY 0x0080
|
|
/** GpsLocationExtended has valid vertical reliability */
|
|
#define GPS_LOCATION_EXTENDED_HAS_VERT_RELIABILITY 0x0100
|
|
/** GpsLocationExtended has valid Horizontal Elliptical Uncertainty (Semi-Major Axis) */
|
|
#define GPS_LOCATION_EXTENDED_HAS_HOR_ELIP_UNC_MAJOR 0x0200
|
|
/** GpsLocationExtended has valid Horizontal Elliptical Uncertainty (Semi-Minor Axis) */
|
|
#define GPS_LOCATION_EXTENDED_HAS_HOR_ELIP_UNC_MINOR 0x0400
|
|
/** GpsLocationExtended has valid Elliptical Horizontal Uncertainty Azimuth */
|
|
#define GPS_LOCATION_EXTENDED_HAS_HOR_ELIP_UNC_AZIMUTH 0x0800
|
|
/** GpsLocationExtended has valid gnss sv used in position data */
|
|
#define GPS_LOCATION_EXTENDED_HAS_GNSS_SV_USED_DATA 0x1000
|
|
/** GpsLocationExtended has valid navSolutionMask */
|
|
#define GPS_LOCATION_EXTENDED_HAS_NAV_SOLUTION_MASK 0x2000
|
|
|
|
typedef uint32_t LocNavSolutionMask;
|
|
/* Bitmask to specify whether SBAS ionospheric correction is used */
|
|
#define LOC_NAV_MASK_SBAS_CORRECTION_IONO ((LocNavSolutionMask)0x0001)
|
|
/* Bitmask to specify whether SBAS fast correction is used */
|
|
#define LOC_NAV_MASK_SBAS_CORRECTION_FAST ((LocNavSolutionMask)0x0002)
|
|
/**< Bitmask to specify whether SBAS long-tem correction is used */
|
|
#define LOC_NAV_MASK_SBAS_CORRECTION_LONG ((LocNavSolutionMask)0x0004)
|
|
/**< Bitmask to specify whether SBAS integrity information is used */
|
|
#define LOC_NAV_MASK_SBAS_INTEGRITY ((LocNavSolutionMask)0x0008)
|
|
|
|
/** GPS PRN Range */
|
|
#define GPS_SV_PRN_MIN 1
|
|
#define GPS_SV_PRN_MAX 32
|
|
#define GLO_SV_PRN_MIN 65
|
|
#define GLO_SV_PRN_MAX 96
|
|
#define QZSS_SV_PRN_MIN 193
|
|
#define QZSS_SV_PRN_MAX 197
|
|
#define BDS_SV_PRN_MIN 201
|
|
#define BDS_SV_PRN_MAX 235
|
|
#define GAL_SV_PRN_MIN 301
|
|
#define GAL_SV_PRN_MAX 336
|
|
|
|
typedef uint32_t LocPosTechMask;
|
|
#define LOC_POS_TECH_MASK_DEFAULT ((LocPosTechMask)0x00000000)
|
|
#define LOC_POS_TECH_MASK_SATELLITE ((LocPosTechMask)0x00000001)
|
|
#define LOC_POS_TECH_MASK_CELLID ((LocPosTechMask)0x00000002)
|
|
#define LOC_POS_TECH_MASK_WIFI ((LocPosTechMask)0x00000004)
|
|
#define LOC_POS_TECH_MASK_SENSORS ((LocPosTechMask)0x00000008)
|
|
#define LOC_POS_TECH_MASK_REFERENCE_LOCATION ((LocPosTechMask)0x00000010)
|
|
#define LOC_POS_TECH_MASK_INJECTED_COARSE_POSITION ((LocPosTechMask)0x00000020)
|
|
#define LOC_POS_TECH_MASK_AFLT ((LocPosTechMask)0x00000040)
|
|
#define LOC_POS_TECH_MASK_HYBRID ((LocPosTechMask)0x00000080)
|
|
|
|
typedef enum {
|
|
LOC_RELIABILITY_NOT_SET = 0,
|
|
LOC_RELIABILITY_VERY_LOW = 1,
|
|
LOC_RELIABILITY_LOW = 2,
|
|
LOC_RELIABILITY_MEDIUM = 3,
|
|
LOC_RELIABILITY_HIGH = 4
|
|
}LocReliability;
|
|
|
|
typedef struct {
|
|
struct timespec apTimeStamp;
|
|
/*boottime received from pps-ktimer*/
|
|
float apTimeStampUncertaintyMs;
|
|
/* timestamp uncertainty in milli seconds */
|
|
}Gnss_ApTimeStampStructType;
|
|
|
|
typedef struct {
|
|
uint64_t gps_sv_used_ids_mask;
|
|
uint64_t glo_sv_used_ids_mask;
|
|
uint64_t gal_sv_used_ids_mask;
|
|
uint64_t bds_sv_used_ids_mask;
|
|
uint64_t qzss_sv_used_ids_mask;
|
|
} GnssSvUsedInPosition;
|
|
|
|
/** Represents gps location extended. */
|
|
typedef struct {
|
|
/** set to sizeof(GpsLocationExtended) */
|
|
size_t size;
|
|
/** Contains GpsLocationExtendedFlags bits. */
|
|
uint16_t flags;
|
|
/** Contains the Altitude wrt mean sea level */
|
|
float altitudeMeanSeaLevel;
|
|
/** Contains Position Dilusion of Precision. */
|
|
float pdop;
|
|
/** Contains Horizontal Dilusion of Precision. */
|
|
float hdop;
|
|
/** Contains Vertical Dilusion of Precision. */
|
|
float vdop;
|
|
/** Contains Magnetic Deviation. */
|
|
float magneticDeviation;
|
|
/** vertical uncertainty in meters */
|
|
float vert_unc;
|
|
/** speed uncertainty in m/s */
|
|
float speed_unc;
|
|
/** heading uncertainty in degrees (0 to 359.999) */
|
|
float bearing_unc;
|
|
/** horizontal reliability. */
|
|
LocReliability horizontal_reliability;
|
|
/** vertical reliability. */
|
|
LocReliability vertical_reliability;
|
|
/* Horizontal Elliptical Uncertainty (Semi-Major Axis) */
|
|
float horUncEllipseSemiMajor;
|
|
/* Horizontal Elliptical Uncertainty (Semi-Minor Axis) */
|
|
float horUncEllipseSemiMinor;
|
|
/* Elliptical Horizontal Uncertainty Azimuth */
|
|
float horUncEllipseOrientAzimuth;
|
|
|
|
Gnss_ApTimeStampStructType timeStamp;
|
|
/** Gnss sv used in position data */
|
|
GnssSvUsedInPosition gnss_sv_used_ids;
|
|
/** Nav solution mask to indicate sbas corrections */
|
|
LocNavSolutionMask navSolutionMask;
|
|
/** Position technology used in computing this fix */
|
|
LocPosTechMask tech_mask;
|
|
} GpsLocationExtended;
|
|
|
|
enum loc_sess_status {
|
|
LOC_SESS_SUCCESS,
|
|
LOC_SESS_INTERMEDIATE,
|
|
LOC_SESS_FAILURE
|
|
};
|
|
|
|
// Nmea sentence types mask
|
|
typedef uint32_t NmeaSentenceTypesMask;
|
|
#define LOC_NMEA_MASK_GGA_V02 ((NmeaSentenceTypesMask)0x00000001) /**< Enable GGA type */
|
|
#define LOC_NMEA_MASK_RMC_V02 ((NmeaSentenceTypesMask)0x00000002) /**< Enable RMC type */
|
|
#define LOC_NMEA_MASK_GSV_V02 ((NmeaSentenceTypesMask)0x00000004) /**< Enable GSV type */
|
|
#define LOC_NMEA_MASK_GSA_V02 ((NmeaSentenceTypesMask)0x00000008) /**< Enable GSA type */
|
|
#define LOC_NMEA_MASK_VTG_V02 ((NmeaSentenceTypesMask)0x00000010) /**< Enable VTG type */
|
|
#define LOC_NMEA_MASK_PQXFI_V02 ((NmeaSentenceTypesMask)0x00000020) /**< Enable PQXFI type */
|
|
#define LOC_NMEA_MASK_PSTIS_V02 ((NmeaSentenceTypesMask)0x00000040) /**< Enable PSTIS type */
|
|
#define LOC_NMEA_MASK_GLGSV_V02 ((NmeaSentenceTypesMask)0x00000080) /**< Enable GLGSV type */
|
|
#define LOC_NMEA_MASK_GNGSA_V02 ((NmeaSentenceTypesMask)0x00000100) /**< Enable GNGSA type */
|
|
#define LOC_NMEA_MASK_GNGNS_V02 ((NmeaSentenceTypesMask)0x00000200) /**< Enable GNGNS type */
|
|
#define LOC_NMEA_MASK_GARMC_V02 ((NmeaSentenceTypesMask)0x00000400) /**< Enable GARMC type */
|
|
#define LOC_NMEA_MASK_GAGSV_V02 ((NmeaSentenceTypesMask)0x00000800) /**< Enable GAGSV type */
|
|
#define LOC_NMEA_MASK_GAGSA_V02 ((NmeaSentenceTypesMask)0x00001000) /**< Enable GAGSA type */
|
|
#define LOC_NMEA_MASK_GAVTG_V02 ((NmeaSentenceTypesMask)0x00002000) /**< Enable GAVTG type */
|
|
#define LOC_NMEA_MASK_GAGGA_V02 ((NmeaSentenceTypesMask)0x00004000) /**< Enable GAGGA type */
|
|
#define LOC_NMEA_MASK_PQGSA_V02 ((NmeaSentenceTypesMask)0x00008000) /**< Enable PQGSA type */
|
|
#define LOC_NMEA_MASK_PQGSV_V02 ((NmeaSentenceTypesMask)0x00010000) /**< Enable PQGSV type */
|
|
#define LOC_NMEA_MASK_DEBUG_V02 ((NmeaSentenceTypesMask)0x00020000) /**< Enable DEBUG type */
|
|
|
|
#define LOC_NMEA_ALL_SUPPORTED_MASK (LOC_NMEA_MASK_GGA_V02 | LOC_NMEA_MASK_RMC_V02 | \
|
|
LOC_NMEA_MASK_GSV_V02 | LOC_NMEA_MASK_GSA_V02 | LOC_NMEA_MASK_VTG_V02 | \
|
|
LOC_NMEA_MASK_PQXFI_V02 | LOC_NMEA_MASK_PSTIS_V02 | LOC_NMEA_MASK_GLGSV_V02 | \
|
|
LOC_NMEA_MASK_GNGSA_V02 | LOC_NMEA_MASK_GNGNS_V02 | LOC_NMEA_MASK_GARMC_V02 | \
|
|
LOC_NMEA_MASK_GAGSV_V02 | LOC_NMEA_MASK_GAGSA_V02 | LOC_NMEA_MASK_GAVTG_V02 | \
|
|
LOC_NMEA_MASK_GAGGA_V02 | LOC_NMEA_MASK_PQGSA_V02 | LOC_NMEA_MASK_PQGSV_V02 | \
|
|
LOC_NMEA_MASK_DEBUG_V02 )
|
|
|
|
typedef enum {
|
|
LOC_ENG_IF_REQUEST_SENDER_ID_QUIPC = 0,
|
|
LOC_ENG_IF_REQUEST_SENDER_ID_MSAPM,
|
|
LOC_ENG_IF_REQUEST_SENDER_ID_MSAPU,
|
|
LOC_ENG_IF_REQUEST_SENDER_ID_GPSONE_DAEMON,
|
|
LOC_ENG_IF_REQUEST_SENDER_ID_MODEM,
|
|
LOC_ENG_IF_REQUEST_SENDER_ID_UNKNOWN
|
|
} loc_if_req_sender_id_e_type;
|
|
|
|
|
|
#define smaller_of(a, b) (((a) > (b)) ? (b) : (a))
|
|
#define MAX_APN_LEN 100
|
|
|
|
// This will be overridden by the individual adapters
|
|
// if necessary.
|
|
#define DEFAULT_IMPL(rtv) \
|
|
{ \
|
|
LOC_LOGD("%s: default implementation invoked", __func__); \
|
|
return rtv; \
|
|
}
|
|
|
|
enum loc_api_adapter_err {
|
|
LOC_API_ADAPTER_ERR_SUCCESS = 0,
|
|
LOC_API_ADAPTER_ERR_GENERAL_FAILURE = 1,
|
|
LOC_API_ADAPTER_ERR_UNSUPPORTED = 2,
|
|
LOC_API_ADAPTER_ERR_INVALID_HANDLE = 4,
|
|
LOC_API_ADAPTER_ERR_INVALID_PARAMETER = 5,
|
|
LOC_API_ADAPTER_ERR_ENGINE_BUSY = 6,
|
|
LOC_API_ADAPTER_ERR_PHONE_OFFLINE = 7,
|
|
LOC_API_ADAPTER_ERR_TIMEOUT = 8,
|
|
LOC_API_ADAPTER_ERR_SERVICE_NOT_PRESENT = 9,
|
|
LOC_API_ADAPTER_ERR_INTERNAL = 10,
|
|
LOC_API_ADAPTER_ERR_ALREADY_INITIALIZED = 11,
|
|
LOC_API_ADAPTER_ERR_OCCUPIED = 12,
|
|
|
|
/* equating engine down to phone offline, as they are the same errror */
|
|
LOC_API_ADAPTER_ERR_ENGINE_DOWN = LOC_API_ADAPTER_ERR_PHONE_OFFLINE,
|
|
LOC_API_ADAPTER_ERR_FAILURE = 101,
|
|
LOC_API_ADAPTER_ERR_UNKNOWN
|
|
};
|
|
|
|
enum loc_api_adapter_event_index {
|
|
LOC_API_ADAPTER_REPORT_POSITION = 0, // Position report comes in loc_parsed_position_s_type
|
|
LOC_API_ADAPTER_REPORT_SATELLITE, // Satellite in view report
|
|
LOC_API_ADAPTER_REPORT_NMEA_1HZ, // NMEA report at 1HZ rate
|
|
LOC_API_ADAPTER_REPORT_NMEA_POSITION, // NMEA report at position report rate
|
|
LOC_API_ADAPTER_REQUEST_NI_NOTIFY_VERIFY, // NI notification/verification request
|
|
LOC_API_ADAPTER_REQUEST_ASSISTANCE_DATA, // Assistance data, eg: time, predicted orbits request
|
|
LOC_API_ADAPTER_REQUEST_LOCATION_SERVER, // Request for location server
|
|
LOC_API_ADAPTER_REPORT_IOCTL, // Callback report for loc_ioctl
|
|
LOC_API_ADAPTER_REPORT_STATUS, // Misc status report: eg, engine state
|
|
LOC_API_ADAPTER_REQUEST_WIFI, //
|
|
LOC_API_ADAPTER_SENSOR_STATUS, //
|
|
LOC_API_ADAPTER_REQUEST_TIME_SYNC, //
|
|
LOC_API_ADAPTER_REPORT_SPI, //
|
|
LOC_API_ADAPTER_REPORT_NI_GEOFENCE, //
|
|
LOC_API_ADAPTER_GEOFENCE_GEN_ALERT, //
|
|
LOC_API_ADAPTER_REPORT_GENFENCE_BREACH, //
|
|
LOC_API_ADAPTER_PEDOMETER_CTRL, //
|
|
LOC_API_ADAPTER_MOTION_CTRL, //
|
|
LOC_API_ADAPTER_REQUEST_WIFI_AP_DATA, // Wifi ap data
|
|
LOC_API_ADAPTER_BATCH_FULL, // Batching on full
|
|
LOC_API_ADAPTER_BATCHED_POSITION_REPORT, // Batching on fix
|
|
LOC_API_ADAPTER_BATCHED_GENFENCE_BREACH_REPORT, //
|
|
LOC_API_ADAPTER_GNSS_MEASUREMENT_REPORT, //GNSS Measurement Report
|
|
LOC_API_ADAPTER_GNSS_SV_POLYNOMIAL_REPORT, //GNSS SV Polynomial Report
|
|
LOC_API_ADAPTER_GDT_UPLOAD_BEGIN_REQ, // GDT upload start request
|
|
LOC_API_ADAPTER_GDT_UPLOAD_END_REQ, // GDT upload end request
|
|
LOC_API_ADAPTER_GNSS_MEASUREMENT, // GNSS Measurement report
|
|
LOC_API_ADAPTER_REQUEST_TIMEZONE, // Timezone injection request
|
|
LOC_API_ADAPTER_REPORT_GENFENCE_DWELL_REPORT, // Geofence dwell report
|
|
LOC_API_ADAPTER_REQUEST_SRN_DATA, // request srn data from AP
|
|
LOC_API_ADAPTER_EVENT_MAX
|
|
};
|
|
|
|
#define LOC_API_ADAPTER_BIT_PARSED_POSITION_REPORT (1<<LOC_API_ADAPTER_REPORT_POSITION)
|
|
#define LOC_API_ADAPTER_BIT_SATELLITE_REPORT (1<<LOC_API_ADAPTER_REPORT_SATELLITE)
|
|
#define LOC_API_ADAPTER_BIT_NMEA_1HZ_REPORT (1<<LOC_API_ADAPTER_REPORT_NMEA_1HZ)
|
|
#define LOC_API_ADAPTER_BIT_NMEA_POSITION_REPORT (1<<LOC_API_ADAPTER_REPORT_NMEA_POSITION)
|
|
#define LOC_API_ADAPTER_BIT_NI_NOTIFY_VERIFY_REQUEST (1<<LOC_API_ADAPTER_REQUEST_NI_NOTIFY_VERIFY)
|
|
#define LOC_API_ADAPTER_BIT_ASSISTANCE_DATA_REQUEST (1<<LOC_API_ADAPTER_REQUEST_ASSISTANCE_DATA)
|
|
#define LOC_API_ADAPTER_BIT_LOCATION_SERVER_REQUEST (1<<LOC_API_ADAPTER_REQUEST_LOCATION_SERVER)
|
|
#define LOC_API_ADAPTER_BIT_IOCTL_REPORT (1<<LOC_API_ADAPTER_REPORT_IOCTL)
|
|
#define LOC_API_ADAPTER_BIT_STATUS_REPORT (1<<LOC_API_ADAPTER_REPORT_STATUS)
|
|
#define LOC_API_ADAPTER_BIT_REQUEST_WIFI (1<<LOC_API_ADAPTER_REQUEST_WIFI)
|
|
#define LOC_API_ADAPTER_BIT_SENSOR_STATUS (1<<LOC_API_ADAPTER_SENSOR_STATUS)
|
|
#define LOC_API_ADAPTER_BIT_REQUEST_TIME_SYNC (1<<LOC_API_ADAPTER_REQUEST_TIME_SYNC)
|
|
#define LOC_API_ADAPTER_BIT_REPORT_SPI (1<<LOC_API_ADAPTER_REPORT_SPI)
|
|
#define LOC_API_ADAPTER_BIT_REPORT_NI_GEOFENCE (1<<LOC_API_ADAPTER_REPORT_NI_GEOFENCE)
|
|
#define LOC_API_ADAPTER_BIT_GEOFENCE_GEN_ALERT (1<<LOC_API_ADAPTER_GEOFENCE_GEN_ALERT)
|
|
#define LOC_API_ADAPTER_BIT_REPORT_GENFENCE_BREACH (1<<LOC_API_ADAPTER_REPORT_GENFENCE_BREACH)
|
|
#define LOC_API_ADAPTER_BIT_BATCHED_GENFENCE_BREACH_REPORT (1<<LOC_API_ADAPTER_BATCHED_GENFENCE_BREACH_REPORT)
|
|
#define LOC_API_ADAPTER_BIT_PEDOMETER_CTRL (1<<LOC_API_ADAPTER_PEDOMETER_CTRL)
|
|
#define LOC_API_ADAPTER_BIT_MOTION_CTRL (1<<LOC_API_ADAPTER_MOTION_CTRL)
|
|
#define LOC_API_ADAPTER_BIT_REQUEST_WIFI_AP_DATA (1<<LOC_API_ADAPTER_REQUEST_WIFI_AP_DATA)
|
|
#define LOC_API_ADAPTER_BIT_BATCH_FULL (1<<LOC_API_ADAPTER_BATCH_FULL)
|
|
#define LOC_API_ADAPTER_BIT_BATCHED_POSITION_REPORT (1<<LOC_API_ADAPTER_BATCHED_POSITION_REPORT)
|
|
#define LOC_API_ADAPTER_BIT_GNSS_MEASUREMENT_REPORT (1<<LOC_API_ADAPTER_GNSS_MEASUREMENT_REPORT)
|
|
#define LOC_API_ADAPTER_BIT_GNSS_SV_POLYNOMIAL_REPORT (1<<LOC_API_ADAPTER_GNSS_SV_POLYNOMIAL_REPORT)
|
|
#define LOC_API_ADAPTER_BIT_GDT_UPLOAD_BEGIN_REQ (1<<LOC_API_ADAPTER_GDT_UPLOAD_BEGIN_REQ)
|
|
#define LOC_API_ADAPTER_BIT_GDT_UPLOAD_END_REQ (1<<LOC_API_ADAPTER_GDT_UPLOAD_END_REQ)
|
|
#define LOC_API_ADAPTER_BIT_GNSS_MEASUREMENT (1<<LOC_API_ADAPTER_GNSS_MEASUREMENT)
|
|
#define LOC_API_ADAPTER_BIT_REQUEST_TIMEZONE (1<<LOC_API_ADAPTER_REQUEST_TIMEZONE)
|
|
#define LOC_API_ADAPTER_BIT_REPORT_GENFENCE_DWELL (1<<LOC_API_ADAPTER_REPORT_GENFENCE_DWELL_REPORT)
|
|
#define LOC_API_ADAPTER_BIT_REQUEST_SRN_DATA (1<<LOC_API_ADAPTER_REQUEST_SRN_DATA)
|
|
|
|
|
|
typedef unsigned int LOC_API_ADAPTER_EVENT_MASK_T;
|
|
|
|
typedef enum loc_api_adapter_msg_to_check_supported {
|
|
LOC_API_ADAPTER_MESSAGE_LOCATION_BATCHING, // Batching 1.0
|
|
LOC_API_ADAPTER_MESSAGE_BATCHED_GENFENCE_BREACH, // Geofence Batched Breach
|
|
LOC_API_ADAPTER_MESSAGE_DISTANCE_BASE_TRACKING, // DBT 2.0
|
|
LOC_API_ADAPTER_MESSAGE_ADAPTIVE_LOCATION_BATCHING, // Batching 1.5
|
|
LOC_API_ADAPTER_MESSAGE_DISTANCE_BASE_LOCATION_BATCHING, // Batching 2.0
|
|
LOC_API_ADAPTER_MESSAGE_UPDATE_TBF_ON_THE_FLY, // Updating Tracking TBF On The Fly
|
|
|
|
LOC_API_ADAPTER_MESSAGE_MAX
|
|
} LocCheckingMessagesID;
|
|
|
|
typedef int IzatDevId_t;
|
|
|
|
typedef uint32_t LOC_GPS_LOCK_MASK;
|
|
#define isGpsLockNone(lock) ((lock) == 0)
|
|
#define isGpsLockMO(lock) ((lock) & ((LOC_GPS_LOCK_MASK)1))
|
|
#define isGpsLockMT(lock) ((lock) & ((LOC_GPS_LOCK_MASK)2))
|
|
#define isGpsLockAll(lock) (((lock) & ((LOC_GPS_LOCK_MASK)3)) == 3)
|
|
|
|
/*++ ***********************************************
|
|
** Satellite Measurement and Satellite Polynomial
|
|
** Structure definitions
|
|
** ***********************************************
|
|
--*/
|
|
#define GNSS_SV_POLY_VELOCITY_COEF_MAX_SIZE 12
|
|
#define GNSS_SV_POLY_XYZ_0_TH_ORDER_COEFF_MAX_SIZE 3
|
|
#define GNSS_SV_POLY_XYZ_N_TH_ORDER_COEFF_MAX_SIZE 9
|
|
#define GNSS_SV_POLY_SV_CLKBIAS_COEFF_MAX_SIZE 4
|
|
#define GNSS_LOC_SV_MEAS_LIST_MAX_SIZE 16
|
|
|
|
enum ulp_gnss_sv_measurement_valid_flags{
|
|
|
|
ULP_GNSS_SV_MEAS_GPS_TIME = 0,
|
|
ULP_GNSS_SV_MEAS_PSUEDO_RANGE,
|
|
ULP_GNSS_SV_MEAS_MS_IN_WEEK,
|
|
ULP_GNSS_SV_MEAS_SUB_MSEC,
|
|
ULP_GNSS_SV_MEAS_CARRIER_PHASE,
|
|
ULP_GNSS_SV_MEAS_DOPPLER_SHIFT,
|
|
ULP_GNSS_SV_MEAS_CNO,
|
|
ULP_GNSS_SV_MEAS_LOSS_OF_LOCK,
|
|
|
|
ULP_GNSS_SV_MEAS_MAX_VALID_FLAGS
|
|
};
|
|
|
|
#define ULP_GNSS_SV_MEAS_BIT_GPS_TIME (1<<ULP_GNSS_SV_MEAS_GPS_TIME)
|
|
#define ULP_GNSS_SV_MEAS_BIT_PSUEDO_RANGE (1<<ULP_GNSS_SV_MEAS_PSUEDO_RANGE)
|
|
#define ULP_GNSS_SV_MEAS_BIT_MS_IN_WEEK (1<<ULP_GNSS_SV_MEAS_MS_IN_WEEK)
|
|
#define ULP_GNSS_SV_MEAS_BIT_SUB_MSEC (1<<ULP_GNSS_SV_MEAS_SUB_MSEC)
|
|
#define ULP_GNSS_SV_MEAS_BIT_CARRIER_PHASE (1<<ULP_GNSS_SV_MEAS_CARRIER_PHASE)
|
|
#define ULP_GNSS_SV_MEAS_BIT_DOPPLER_SHIFT (1<<ULP_GNSS_SV_MEAS_DOPPLER_SHIFT)
|
|
#define ULP_GNSS_SV_MEAS_BIT_CNO (1<<ULP_GNSS_SV_MEAS_CNO)
|
|
#define ULP_GNSS_SV_MEAS_BIT_LOSS_OF_LOCK (1<<ULP_GNSS_SV_MEAS_LOSS_OF_LOCK)
|
|
|
|
enum ulp_gnss_sv_poly_valid_flags{
|
|
|
|
ULP_GNSS_SV_POLY_GLO_FREQ = 0,
|
|
ULP_GNSS_SV_POLY_T0,
|
|
ULP_GNSS_SV_POLY_IODE,
|
|
ULP_GNSS_SV_POLY_FLAG,
|
|
ULP_GNSS_SV_POLY_POLYCOEFF_XYZ0,
|
|
ULP_GNSS_SV_POLY_POLYCOEFF_XYZN,
|
|
ULP_GNSS_SV_POLY_POLYCOEFF_OTHER,
|
|
ULP_GNSS_SV_POLY_SV_POSUNC,
|
|
ULP_GNSS_SV_POLY_IONODELAY,
|
|
ULP_GNSS_SV_POLY_IONODOT,
|
|
ULP_GNSS_SV_POLY_SBAS_IONODELAY,
|
|
ULP_GNSS_SV_POLY_SBAS_IONODOT,
|
|
ULP_GNSS_SV_POLY_TROPODELAY,
|
|
ULP_GNSS_SV_POLY_ELEVATION,
|
|
ULP_GNSS_SV_POLY_ELEVATIONDOT,
|
|
ULP_GNSS_SV_POLY_ELEVATIONUNC,
|
|
ULP_GNSS_SV_POLY_VELO_COEFF,
|
|
ULP_GNSS_SV_POLY_ENHANCED_IOD,
|
|
|
|
ULP_GNSS_SV_POLY_VALID_FLAGS
|
|
|
|
};
|
|
|
|
#define ULP_GNSS_SV_POLY_BIT_GLO_FREQ (1<<ULP_GNSS_SV_POLY_GLO_FREQ)
|
|
#define ULP_GNSS_SV_POLY_BIT_T0 (1<<ULP_GNSS_SV_POLY_T0)
|
|
#define ULP_GNSS_SV_POLY_BIT_IODE (1<<ULP_GNSS_SV_POLY_IODE)
|
|
#define ULP_GNSS_SV_POLY_BIT_FLAG (1<<ULP_GNSS_SV_POLY_FLAG)
|
|
#define ULP_GNSS_SV_POLY_BIT_POLYCOEFF_XYZ0 (1<<ULP_GNSS_SV_POLY_POLYCOEFF_XYZ0)
|
|
#define ULP_GNSS_SV_POLY_BIT_POLYCOEFF_XYZN (1<<ULP_GNSS_SV_POLY_POLYCOEFF_XYZN)
|
|
#define ULP_GNSS_SV_POLY_BIT_POLYCOEFF_OTHER (1<<ULP_GNSS_SV_POLY_POLYCOEFF_OTHER)
|
|
#define ULP_GNSS_SV_POLY_BIT_SV_POSUNC (1<<ULP_GNSS_SV_POLY_SV_POSUNC)
|
|
#define ULP_GNSS_SV_POLY_BIT_IONODELAY (1<<ULP_GNSS_SV_POLY_IONODELAY)
|
|
#define ULP_GNSS_SV_POLY_BIT_IONODOT (1<<ULP_GNSS_SV_POLY_IONODOT)
|
|
#define ULP_GNSS_SV_POLY_BIT_SBAS_IONODELAY (1<<ULP_GNSS_SV_POLY_SBAS_IONODELAY)
|
|
#define ULP_GNSS_SV_POLY_BIT_SBAS_IONODOT (1<<ULP_GNSS_SV_POLY_SBAS_IONODOT)
|
|
#define ULP_GNSS_SV_POLY_BIT_TROPODELAY (1<<ULP_GNSS_SV_POLY_TROPODELAY)
|
|
#define ULP_GNSS_SV_POLY_BIT_ELEVATION (1<<ULP_GNSS_SV_POLY_ELEVATION)
|
|
#define ULP_GNSS_SV_POLY_BIT_ELEVATIONDOT (1<<ULP_GNSS_SV_POLY_ELEVATIONDOT)
|
|
#define ULP_GNSS_SV_POLY_BIT_ELEVATIONUNC (1<<ULP_GNSS_SV_POLY_ELEVATIONUNC)
|
|
#define ULP_GNSS_SV_POLY_BIT_VELO_COEFF (1<<ULP_GNSS_SV_POLY_VELO_COEFF)
|
|
#define ULP_GNSS_SV_POLY_BIT_ENHANCED_IOD (1<<ULP_GNSS_SV_POLY_ENHANCED_IOD)
|
|
|
|
|
|
typedef enum
|
|
{
|
|
GNSS_LOC_SV_SYSTEM_GPS = 1,
|
|
/**< GPS satellite. */
|
|
GNSS_LOC_SV_SYSTEM_GALILEO = 2,
|
|
/**< GALILEO satellite. */
|
|
GNSS_LOC_SV_SYSTEM_SBAS = 3,
|
|
/**< SBAS satellite. */
|
|
GNSS_LOC_SV_SYSTEM_COMPASS = 4,
|
|
/**< COMPASS satellite. */
|
|
GNSS_LOC_SV_SYSTEM_GLONASS = 5,
|
|
/**< GLONASS satellite. */
|
|
GNSS_LOC_SV_SYSTEM_BDS = 6
|
|
/**< BDS satellite. */
|
|
} Gnss_LocSvSystemEnumType;
|
|
|
|
typedef enum
|
|
{
|
|
GNSS_LOC_FREQ_SOURCE_INVALID = 0,
|
|
/**< Source of the frequency is invalid */
|
|
GNSS_LOC_FREQ_SOURCE_EXTERNAL = 1,
|
|
/**< Source of the frequency is from external injection */
|
|
GNSS_LOC_FREQ_SOURCE_PE_CLK_REPORT = 2,
|
|
/**< Source of the frequency is from Navigation engine */
|
|
GNSS_LOC_FREQ_SOURCE_UNKNOWN = 3
|
|
/**< Source of the frequency is unknown */
|
|
} Gnss_LocSourceofFreqEnumType;
|
|
|
|
typedef struct
|
|
{
|
|
size_t size;
|
|
float clockDrift;
|
|
/**< Receiver clock Drift \n
|
|
- Units: meter per sec \n
|
|
*/
|
|
float clockDriftUnc;
|
|
/**< Receiver clock Drift uncertainty \n
|
|
- Units: meter per sec \n
|
|
*/
|
|
Gnss_LocSourceofFreqEnumType sourceOfFreq;
|
|
}Gnss_LocRcvrClockFrequencyInfoStructType;
|
|
|
|
typedef struct
|
|
{
|
|
size_t size;
|
|
uint8_t leapSec;
|
|
/**< GPS time leap second delta to UTC time \n
|
|
- Units: sec \n
|
|
*/
|
|
uint8_t leapSecUnc;
|
|
/**< Uncertainty for GPS leap second \n
|
|
- Units: sec \n
|
|
*/
|
|
}Gnss_LeapSecondInfoStructType;
|
|
|
|
typedef enum
|
|
{
|
|
GNSS_LOC_SYS_TIME_BIAS_VALID = 0x01,
|
|
/**< System time bias valid */
|
|
GNSS_LOC_SYS_TIME_BIAS_UNC_VALID = 0x02,
|
|
/**< System time bias uncertainty valid */
|
|
}Gnss_LocInterSystemBiasValidMaskType;
|
|
|
|
typedef struct
|
|
{
|
|
size_t size;
|
|
uint32_t validMask;
|
|
/* Validity mask as per Gnss_LocInterSystemBiasValidMaskType */
|
|
|
|
float timeBias;
|
|
/**< System-1 to System-2 Time Bias \n
|
|
- Units: msec \n
|
|
*/
|
|
float timeBiasUnc;
|
|
/**< System-1 to System-2 Time Bias uncertainty \n
|
|
- Units: msec \n
|
|
*/
|
|
}Gnss_InterSystemBiasStructType;
|
|
|
|
|
|
typedef struct
|
|
{
|
|
size_t size;
|
|
uint16_t systemWeek;
|
|
/**< System week number for GPS, BDS and GAL satellite systems. \n
|
|
Set to 65535 when invalid or not available. \n
|
|
Not valid for GLONASS system. \n
|
|
*/
|
|
|
|
uint32_t systemMsec;
|
|
/**< System time msec. Time of Week for GPS, BDS, GAL and
|
|
Time of Day for GLONASS.
|
|
- Units: msec \n
|
|
*/
|
|
float systemClkTimeBias;
|
|
/**< System clock time bias \n
|
|
- Units: msec \n
|
|
System time = systemMsec - systemClkTimeBias \n
|
|
*/
|
|
float systemClkTimeUncMs;
|
|
/**< Single sided maximum time bias uncertainty \n
|
|
- Units: msec \n
|
|
*/
|
|
}Gnss_LocSystemTimeStructType;
|
|
|
|
typedef struct {
|
|
|
|
size_t size;
|
|
uint8_t gloFourYear;
|
|
/**< GLONASS four year number from 1996. Refer to GLONASS ICD.\n
|
|
Applicable only for GLONASS and shall be ignored for other constellations. \n
|
|
If unknown shall be set to 255
|
|
*/
|
|
|
|
uint16_t gloDays;
|
|
/**< GLONASS day number in four years. Refer to GLONASS ICD.
|
|
Applicable only for GLONASS and shall be ignored for other constellations. \n
|
|
If unknown shall be set to 65535
|
|
*/
|
|
|
|
uint32_t gloMsec;
|
|
/**< GLONASS time of day in msec. Refer to GLONASS ICD.
|
|
- Units: msec \n
|
|
*/
|
|
|
|
float gloClkTimeBias;
|
|
/**< System clock time bias (sub-millisecond) \n
|
|
- Units: msec \n
|
|
System time = systemMsec - systemClkTimeBias \n
|
|
*/
|
|
|
|
float gloClkTimeUncMs;
|
|
/**< Single sided maximum time bias uncertainty \n
|
|
- Units: msec \n
|
|
*/
|
|
}Gnss_LocGloTimeStructType; /* Type */
|
|
|
|
typedef struct {
|
|
|
|
size_t size;
|
|
uint32_t refFCount;
|
|
/**< Receiver frame counter value at reference tick */
|
|
|
|
uint8_t systemRtc_valid;
|
|
/**< Validity indicator for System RTC */
|
|
|
|
uint64_t systemRtcMs;
|
|
/**< Platform system RTC value \n
|
|
- Units: msec \n
|
|
*/
|
|
|
|
uint32_t sourceOfTime;
|
|
/**< Source of time information */
|
|
|
|
}Gnss_LocGnssTimeExtStructType;
|
|
|
|
|
|
|
|
typedef enum
|
|
{
|
|
GNSS_LOC_MEAS_STATUS_NULL = 0x00000000,
|
|
/**< No information state */
|
|
GNSS_LOC_MEAS_STATUS_SM_VALID = 0x00000001,
|
|
/**< Code phase is known */
|
|
GNSS_LOC_MEAS_STATUS_SB_VALID = 0x00000002,
|
|
/**< Sub-bit time is known */
|
|
GNSS_LOC_MEAS_STATUS_MS_VALID = 0x00000004,
|
|
/**< Satellite time is known */
|
|
GNSS_LOC_MEAS_STATUS_BE_CONFIRM = 0x00000008,
|
|
/**< Bit edge is confirmed from signal */
|
|
GNSS_LOC_MEAS_STATUS_VELOCITY_VALID = 0x00000010,
|
|
/**< Satellite Doppler measured */
|
|
GNSS_LOC_MEAS_STATUS_VELOCITY_FINE = 0x00000020,
|
|
/**< TRUE: Fine Doppler measured, FALSE: Coarse Doppler measured */
|
|
GNSS_LOC_MEAS_STATUS_FROM_RNG_DIFF = 0x00000200,
|
|
/**< Range update from Satellite differences */
|
|
GNSS_LOC_MEAS_STATUS_FROM_VE_DIFF = 0x00000400,
|
|
/**< Doppler update from Satellite differences */
|
|
GNSS_LOC_MEAS_STATUS_DONT_USE_X = 0x00000800,
|
|
/**< Don't use measurement if bit is set */
|
|
GNSS_LOC_MEAS_STATUS_DONT_USE_M = 0x000001000,
|
|
/**< Don't use measurement if bit is set */
|
|
GNSS_LOC_MEAS_STATUS_DONT_USE_D = 0x000002000,
|
|
/**< Don't use measurement if bit is set */
|
|
GNSS_LOC_MEAS_STATUS_DONT_USE_S = 0x000004000,
|
|
/**< Don't use measurement if bit is set */
|
|
GNSS_LOC_MEAS_STATUS_DONT_USE_P = 0x000008000
|
|
/**< Don't use measurement if bit is set */
|
|
}Gnss_LocSvMeasStatusMaskType;
|
|
|
|
typedef struct
|
|
{
|
|
size_t size;
|
|
uint32_t svMs;
|
|
/**< Satellite time milisecond.\n
|
|
For GPS, BDS, GAL range of 0 thru (604800000-1) \n
|
|
For GLONASS range of 0 thru (86400000-1) \n
|
|
Valid when PD_LOC_MEAS_STATUS_MS_VALID bit is set in measurement status \n
|
|
Note: All SV times in the current measurement block are alredy propagated to common reference time epoch. \n
|
|
- Units: msec \n
|
|
*/
|
|
float svSubMs;
|
|
/**<Satellite time sub-millisecond. \n
|
|
Total SV Time = svMs + svSubMs \n
|
|
- Units: msec \n
|
|
*/
|
|
float svTimeUncMs;
|
|
/**< Satellite Time uncertainty \n
|
|
- Units: msec \n
|
|
*/
|
|
float dopplerShift;
|
|
/**< Satellite Doppler \n
|
|
- Units: meter per sec \n
|
|
*/
|
|
float dopplerShiftUnc;
|
|
/**< Satellite Doppler uncertainty\n
|
|
- Units: meter per sec \n
|
|
*/
|
|
}Gnss_LocSVTimeSpeedStructType;
|
|
|
|
typedef enum
|
|
{
|
|
GNSS_SV_STATE_IDLE = 0,
|
|
GNSS_SV_STATE_SEARCH = 1,
|
|
GNSS_SV_STATE_SEARCH_VERIFY = 2,
|
|
GNSS_SV_STATE_BIT_EDGE = 3,
|
|
GNSS_SV_STATE_VERIFY_TRACK = 4,
|
|
GNSS_SV_STATE_TRACK = 5,
|
|
GNSS_SV_STATE_RESTART = 6,
|
|
GNSS_SV_STATE_DPO_TRACK = 7
|
|
} Gnss_LocSVStateEnumType;
|
|
|
|
typedef enum
|
|
{
|
|
GNSS_LOC_SVINFO_MASK_HAS_EPHEMERIS = 0x01,
|
|
/**< Ephemeris is available for this SV */
|
|
GNSS_LOC_SVINFO_MASK_HAS_ALMANAC = 0x02
|
|
/**< Almanac is available for this SV */
|
|
}Gnss_LocSvInfoMaskT;
|
|
|
|
typedef enum
|
|
{
|
|
GNSS_LOC_SV_SRCH_STATUS_IDLE = 1,
|
|
/**< SV is not being actively processed */
|
|
GNSS_LOC_SV_SRCH_STATUS_SEARCH = 2,
|
|
/**< The system is searching for this SV */
|
|
GNSS_LOC_SV_SRCH_STATUS_TRACK = 3
|
|
/**< SV is being tracked */
|
|
}Gnss_LocSvSearchStatusEnumT;
|
|
|
|
|
|
typedef struct
|
|
{
|
|
size_t size;
|
|
uint16_t gnssSvId;
|
|
/**< GNSS SV ID.
|
|
\begin{itemize1}
|
|
\item Range: \begin{itemize1}
|
|
\item For GPS: 1 to 32
|
|
\item For GLONASS: 1 to 32
|
|
\item For SBAS: 120 to 151
|
|
\item For BDS: 201 to 237
|
|
\end{itemize1} \end{itemize1}
|
|
The GPS and GLONASS SVs can be disambiguated using the system field.
|
|
*/
|
|
uint8_t gloFrequency;
|
|
/**< GLONASS frequency number + 7 \n
|
|
Valid only for GLONASS System \n
|
|
Shall be ignored for all other systems \n
|
|
- Range: 1 to 14 \n
|
|
*/
|
|
Gnss_LocSvSearchStatusEnumT svStatus;
|
|
/**< Satellite search state \n
|
|
@ENUM()
|
|
*/
|
|
bool healthStatus_valid;
|
|
/**< SV Health Status validity flag\n
|
|
- 0: Not valid \n
|
|
- 1: Valid \n
|
|
*/
|
|
uint8_t healthStatus;
|
|
/**< Health status.
|
|
\begin{itemize1}
|
|
\item Range: 0 to 1; 0 = unhealthy, \n 1 = healthy, 2 = unknown
|
|
\vspace{-0.18in} \end{itemize1}
|
|
*/
|
|
Gnss_LocSvInfoMaskT svInfoMask;
|
|
/**< Indicates whether almanac and ephemeris information is available. \n
|
|
@MASK()
|
|
*/
|
|
uint64_t measurementStatus;
|
|
/**< Bitmask indicating SV measurement status.
|
|
Valid bitmasks: \n
|
|
@MASK()
|
|
*/
|
|
uint16_t CNo;
|
|
/**< Carrier to Noise ratio \n
|
|
- Units: 0.1 dBHz \n
|
|
*/
|
|
uint16_t gloRfLoss;
|
|
/**< GLONASS Rf loss reference to Antenna. \n
|
|
- Units: dB, Scale: 0.1 \n
|
|
*/
|
|
bool lossOfLock;
|
|
/**< Loss of signal lock indicator \n
|
|
- 0: Signal in continuous track \n
|
|
- 1: Signal not in track \n
|
|
*/
|
|
int16_t measLatency;
|
|
/**< Age of the measurement. Positive value means measurement precedes ref time. \n
|
|
- Units: msec \n
|
|
*/
|
|
Gnss_LocSVTimeSpeedStructType svTimeSpeed;
|
|
/**< Unfiltered SV Time and Speed information
|
|
*/
|
|
float dopplerAccel;
|
|
/**< Satellite Doppler Accelertion\n
|
|
- Units: Hz/s \n
|
|
*/
|
|
bool multipathEstValid;
|
|
/**< Multipath estimate validity flag\n
|
|
- 0: Multipath estimate not valid \n
|
|
- 1: Multipath estimate valid \n
|
|
*/
|
|
float multipathEstimate;
|
|
/**< Estimate of multipath in measurement\n
|
|
- Units: Meters \n
|
|
*/
|
|
bool fineSpeedValid;
|
|
/**< Fine speed validity flag\n
|
|
- 0: Fine speed not valid \n
|
|
- 1: Fine speed valid \n
|
|
*/
|
|
float fineSpeed;
|
|
/**< Carrier phase derived speed \n
|
|
- Units: m/s \n
|
|
*/
|
|
bool fineSpeedUncValid;
|
|
/**< Fine speed uncertainty validity flag\n
|
|
- 0: Fine speed uncertainty not valid \n
|
|
- 1: Fine speed uncertainty valid \n
|
|
*/
|
|
float fineSpeedUnc;
|
|
/**< Carrier phase derived speed \n
|
|
- Units: m/s \n
|
|
*/
|
|
bool carrierPhaseValid;
|
|
/**< Carrier Phase measurement validity flag\n
|
|
- 0: Carrier Phase not valid \n
|
|
- 1: Carrier Phase valid \n
|
|
*/
|
|
double carrierPhase;
|
|
/**< Carrier phase measurement [L1 cycles] \n
|
|
*/
|
|
bool cycleSlipCountValid;
|
|
/**< Cycle slup count validity flag\n
|
|
- 0: Not valid \n
|
|
- 1: Valid \n
|
|
*/
|
|
uint8_t cycleSlipCount;
|
|
/**< Increments when a CSlip is detected */
|
|
|
|
bool svDirectionValid;
|
|
/**< Validity flag for SV direction */
|
|
|
|
float svAzimuth;
|
|
/**< Satellite Azimuth
|
|
- Units: radians \n
|
|
*/
|
|
float svElevation;
|
|
/**< Satellite Elevation
|
|
- Units: radians \n
|
|
*/
|
|
} Gnss_SVMeasurementStructType;
|
|
|
|
/**< Maximum number of satellites in measurement block for given system. */
|
|
|
|
typedef struct
|
|
{
|
|
size_t size;
|
|
Gnss_LocSvSystemEnumType system;
|
|
/**< Specifies the Satellite System Type
|
|
*/
|
|
bool isSystemTimeValid;
|
|
/**< Indicates whether System Time is Valid:\n
|
|
- 0x01 (TRUE) -- System Time is valid \n
|
|
- 0x00 (FALSE) -- System Time is not valid
|
|
*/
|
|
Gnss_LocSystemTimeStructType systemTime;
|
|
/**< System Time Information \n
|
|
*/
|
|
bool isGloTime_valid;
|
|
Gnss_LocGloTimeStructType gloTime;
|
|
|
|
bool isSystemTimeExt_valid;
|
|
Gnss_LocGnssTimeExtStructType systemTimeExt;
|
|
|
|
uint8_t numSvs;
|
|
/* Number of SVs in this report block */
|
|
|
|
Gnss_SVMeasurementStructType svMeasurement[GNSS_LOC_SV_MEAS_LIST_MAX_SIZE];
|
|
/**< Satellite measurement Information \n
|
|
*/
|
|
} Gnss_ClockMeasurementStructType;
|
|
|
|
|
|
typedef struct
|
|
{
|
|
size_t size;
|
|
uint8_t seqNum;
|
|
/**< Current message Number */
|
|
uint8_t maxMessageNum;
|
|
/**< Maximum number of message that will be sent for present time epoch. */
|
|
|
|
bool leapSecValid;
|
|
Gnss_LeapSecondInfoStructType leapSec;
|
|
|
|
Gnss_InterSystemBiasStructType gpsGloInterSystemBias;
|
|
|
|
Gnss_InterSystemBiasStructType gpsBdsInterSystemBias;
|
|
|
|
Gnss_InterSystemBiasStructType gpsGalInterSystemBias;
|
|
|
|
Gnss_InterSystemBiasStructType bdsGloInterSystemBias;
|
|
|
|
Gnss_InterSystemBiasStructType galGloInterSystemBias;
|
|
|
|
Gnss_InterSystemBiasStructType galBdsInterSystemBias;
|
|
|
|
bool clockFreqValid;
|
|
Gnss_LocRcvrClockFrequencyInfoStructType clockFreq; /* Freq */
|
|
bool gnssMeasValid;
|
|
Gnss_ClockMeasurementStructType gnssMeas;
|
|
Gnss_ApTimeStampStructType timeStamp;
|
|
|
|
} GnssSvMeasurementSet;
|
|
|
|
typedef enum
|
|
{
|
|
GNSS_SV_POLY_COEFF_VALID = 0x01,
|
|
/**< SV position in orbit coefficients are valid */
|
|
GNSS_SV_POLY_IONO_VALID = 0x02,
|
|
/**< Iono estimates are valid */
|
|
|
|
GNSS_SV_POLY_TROPO_VALID = 0x04,
|
|
/**< Tropo estimates are valid */
|
|
|
|
GNSS_SV_POLY_ELEV_VALID = 0x08,
|
|
/**< Elevation, rate, uncertainty are valid */
|
|
|
|
GNSS_SV_POLY_SRC_ALM_CORR = 0x10,
|
|
/**< Polynomials based on XTRA */
|
|
|
|
GNSS_SV_POLY_SBAS_IONO_VALID = 0x20,
|
|
/**< SBAS IONO and rate are valid */
|
|
|
|
GNSS_SV_POLY_GLO_STR4 = 0x40
|
|
/**< GLONASS String 4 has been received */
|
|
}Gnss_SvPolyStatusMaskType;
|
|
|
|
|
|
typedef struct
|
|
{
|
|
size_t size;
|
|
uint16_t gnssSvId;
|
|
/* GPS: 1-32, GLO: 65-96, 0: Invalid,
|
|
SBAS: 120-151, BDS:201-237,GAL:301 to 336
|
|
All others are reserved
|
|
*/
|
|
int8_t freqNum;
|
|
/* Freq index, only valid if u_SysInd is GLO */
|
|
|
|
uint8_t svPolyFlags;
|
|
/* Indicate the validity of the elements
|
|
as per Gnss_SvPolyStatusMaskType
|
|
*/
|
|
|
|
uint32_t is_valid;
|
|
|
|
uint16_t iode;
|
|
/* Ephemeris reference time
|
|
GPS:Issue of Data Ephemeris used [unitless].
|
|
GLO: Tb 7-bit, refer to ICD02
|
|
*/
|
|
double T0;
|
|
/* Reference time for polynominal calculations
|
|
GPS: Secs in week.
|
|
GLO: Full secs since Jan/01/96
|
|
*/
|
|
double polyCoeffXYZ0[GNSS_SV_POLY_XYZ_0_TH_ORDER_COEFF_MAX_SIZE];
|
|
/* C0X, C0Y, C0Z */
|
|
double polyCoefXYZN[GNSS_SV_POLY_XYZ_N_TH_ORDER_COEFF_MAX_SIZE];
|
|
/* C1X, C2X ... C2Z, C3Z */
|
|
float polyCoefOther[GNSS_SV_POLY_SV_CLKBIAS_COEFF_MAX_SIZE];
|
|
/* C0T, C1T, C2T, C3T */
|
|
float svPosUnc; /* SV position uncertainty [m]. */
|
|
float ionoDelay; /* Ionospheric delay at d_T0 [m]. */
|
|
float ionoDot; /* Iono delay rate [m/s]. */
|
|
float sbasIonoDelay;/* SBAS Ionospheric delay at d_T0 [m]. */
|
|
float sbasIonoDot; /* SBAS Iono delay rate [m/s]. */
|
|
float tropoDelay; /* Tropospheric delay [m]. */
|
|
float elevation; /* Elevation [rad] at d_T0 */
|
|
float elevationDot; /* Elevation rate [rad/s] */
|
|
float elevationUnc; /* SV elevation [rad] uncertainty */
|
|
double velCoef[GNSS_SV_POLY_VELOCITY_COEF_MAX_SIZE];
|
|
/* Coefficients of velocity poly */
|
|
uint32_t enhancedIOD; /* Enhanced Reference Time */
|
|
} GnssSvPolynomial;
|
|
|
|
/* Various Short Range Node Technology type*/
|
|
typedef enum {
|
|
SRN_AP_DATA_TECH_TYPE_NONE,
|
|
SRN_AP_DATA_TECH_TYPE_BT,
|
|
SRN_AP_DATA_TECH_TYPE_BTLE,
|
|
SRN_AP_DATA_TECH_TYPE_NFC,
|
|
SRN_AP_DATA_TECH_TYPE_MOBILE_CODE,
|
|
SRN_AP_DATA_TECH_TYPE_OTHER
|
|
} Gnss_SrnTech;
|
|
|
|
/* Mac Address type requested by modem */
|
|
typedef enum {
|
|
SRN_AP_DATA_PUBLIC_MAC_ADDR_TYPE_INVALID, /* No valid mac address type send */
|
|
SRN_AP_DATA_PUBLIC_MAC_ADDR_TYPE_PUBLIC, /* SRN AP MAC Address type PUBLIC */
|
|
SRN_AP_DATA_PUBLIC_MAC_ADDR_TYPE_PRIVATE, /* SRN AP MAC Address type PRIVATE */
|
|
SRN_AP_DATA_PUBLIC_MAC_ADDR_TYPE_OTHER, /* SRN AP MAC Address type OTHER */
|
|
}Gnss_Srn_MacAddr_Type;
|
|
|
|
typedef struct
|
|
{
|
|
size_t size;
|
|
Gnss_SrnTech srnTechType; /* SRN Technology type in request */
|
|
bool srnRequest; /* scan - start(true) or stop(false) */
|
|
bool e911Mode; /* If in E911 emergency */
|
|
Gnss_Srn_MacAddr_Type macAddrType; /* SRN AP MAC Address type */
|
|
} GnssSrnDataReq;
|
|
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif /* __cplusplus */
|
|
|
|
#endif /* GPS_EXTENDED_C_H */
|