12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285228622872288228922902291229222932294229522962297229822992300230123022303230423052306230723082309231023112312231323142315231623172318231923202321232223232324232523262327232823292330233123322333233423352336233723382339234023412342234323442345234623472348234923502351235223532354235523562357235823592360236123622363236423652366236723682369237023712372237323742375237623772378237923802381238223832384238523862387238823892390239123922393239423952396239723982399240024012402240324042405240624072408240924102411241224132414241524162417241824192420242124222423242424252426242724282429243024312432243324342435243624372438243924402441244224432444244524462447244824492450245124522453245424552456245724582459246024612462246324642465246624672468246924702471247224732474 |
- /* Copyright (c) 2013-2021 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.
- */
- /*
- Copyright (c) 2022 Qualcomm Innovation Center, Inc. All rights reserved.
- Redistribution and use in source and binary forms, with or without
- modification, are permitted (subject to the limitations in the
- disclaimer below) 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 Qualcomm Innovation Center, Inc. nor the names of its
- contributors may be used to endorse or promote products derived
- from this software without specific prior written permission.
- NO EXPRESS OR IMPLIED LICENSES TO ANY PARTY'S PATENT RIGHTS ARE
- GRANTED BY THIS LICENSE. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT
- HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED
- WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
- MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
- IN NO EVENT SHALL THE COPYRIGHT HOLDER 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>
- struct timespec32_t {
- uint32_t tv_sec; /* seconds */
- uint32_t tv_nsec; /* and nanoseconds */
- };
- /**
- * @file
- * @brief C++ declarations for GPS types
- */
- #ifdef __cplusplus
- extern "C" {
- #endif /* __cplusplus */
- #define GNSS_INVALID_JAMMER_IND 0x7FFFFFFF
- /** Position source is ULP */
- #define ULP_LOCATION_IS_FROM_HYBRID 0x0001
- /** Position source is GNSS only */
- #define ULP_LOCATION_IS_FROM_GNSS 0x0002
- /** Position is from a Geofence Breach Event */
- #define ULP_LOCATION_IS_FROM_GEOFENCE 0X0004
- /** Position is from Hardware FLP */
- #define ULP_LOCATION_IS_FROM_HW_FLP 0x0008
- /** Position is from NLP */
- #define ULP_LOCATION_IS_FROM_NLP 0x0010
- /** Position is from external DR solution*/
- #define ULP_LOCATION_IS_FROM_EXT_DR 0X0020
- /** Raw GNSS position fixes */
- #define ULP_LOCATION_IS_FROM_GNSS_RAW 0X0040
- typedef uint32_t LocSvInfoSource;
- /** SVinfo source is GNSS/DR */
- #define ULP_SVINFO_IS_FROM_GNSS ((LocSvInfoSource)0x0001)
- /** Raw SVinfo from GNSS */
- #define ULP_SVINFO_IS_FROM_DR ((LocSvInfoSource)0x0002)
- #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
- /* TBM Threshold for tracking in background power mode : in millis */
- #define TRACKING_TBM_THRESHOLD_MILLIS 480000
- /** Maximum number of satellites in an ephemeris report. */
- #define GNSS_EPHEMERIS_LIST_MAX_SIZE_V02 32
- 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)
- #define LOC_POS_TECH_MASK_PPE ((LocPosTechMask)0x00000100)
- #define LOC_POS_TECH_MASK_VEH ((LocPosTechMask)0x00000200)
- #define LOC_POS_TECH_MASK_VIS ((LocPosTechMask)0x00000400)
- #define LOC_POS_TECH_MASK_INS ((LocPosTechMask)0x00000800)
- #define LOC_POS_TECH_MASK_PDR ((LocPosTechMask)0x00001000)
- #define LOC_POS_TECH_MASK_PROPAGATED ((LocPosTechMask)0x00002000)
- enum loc_registration_mask_status {
- LOC_REGISTRATION_MASK_ENABLED,
- LOC_REGISTRATION_MASK_DISABLED,
- LOC_REGISTRATION_MASK_SET
- };
- /* The entries in the following enum should mimic the entries in qmiLocSupportedFeatureEnumT_v02
- in location_service_v02.h */
- typedef enum {
- /**< Support ODCPI version 2 feature */
- LOC_SUPPORTED_FEATURE_ODCPI_2_V02 = 0,
- /**< Support Wifi AP data inject version 2 feature */
- LOC_SUPPORTED_FEATURE_WIFI_AP_DATA_INJECT_2_V02,
- /**< Support debug NMEA feature */
- LOC_SUPPORTED_FEATURE_DEBUG_NMEA_V02,
- /**< Support GNSS Only position reports */
- LOC_SUPPORTED_FEATURE_GNSS_ONLY_POSITION_REPORT,
- /**< Support FDCL */
- LOC_SUPPORTED_FEATURE_FDCL,
- /**< Support constellation enablement */
- LOC_SUPPORTED_FEATURE_CONSTELLATION_ENABLEMENT_V02,
- /**< Support AGPM feature */
- LOC_SUPPORTED_FEATURE_AGPM_V02,
- /**< Support XTRA integrity */
- LOC_SUPPORTED_FEATURE_XTRA_INTEGRITY,
- /**< Support FDCL V2 */
- LOC_SUPPORTED_FEATURE_FDCL_2,
- /**< Support location privacy */
- LOC_SUPPORTED_FEATURE_LOCATION_PRIVACY,
- /**< Support NAVIC constellation */
- LOC_SUPPORTED_FEATURE_NAVIC,
- /**< Support measurements correction */
- LOC_SUPPORTED_FEATURE_MEASUREMENTS_CORRECTION,
- /**< Support Robust Location feature */
- LOC_SUPPORTED_FEATURE_ROBUST_LOCATION,
- /**< Support precise location dgnss */
- LOC_SUPPORTED_FEATURE_EDGNSS,
- /**< Support the multiband GNSS configuration feature */
- LOC_SUPPORTED_FEATURE_MULTIBAND_CONFIG,
- /**< Support the configuration for DSDA */
- LOC_SUPPORTED_FEATURE_DSDA_CONFIGURATION,
- /**< Support the Multiple Attribution Apps(UTH clients Lock control) feature */
- LOC_SUPPORTED_FEATURE_MULTIPLE_ATTRIBUTION_APPS,
- /**< Support the FLP, NLP Z-Source provider feature */
- LOC_SUPPORTED_FEATURE_QMI_FLP_NLP_SOURCE,
- /**< Support the feature to report engine debug data */
- LOC_SUPPORTED_FEATURE_ENGINE_DEBUG_DATA,
- /**< Support the feature to report feature update in QMI_LOC_EVENT_REPORT_IND */
- LOC_SUPPORTED_FEATURE_DYNAMIC_FEATURE_STATUS
- } loc_supported_feature_enum;
- typedef struct {
- /** set to sizeof(UlpLocation) */
- uint32_t size;
- LocGpsLocation gpsLocation;
- /* Provider indicator for HYBRID or GPS */
- uint16_t position_source;
- LocPosTechMask tech_mask;
- bool unpropagatedPosition;
- } UlpLocation;
- typedef struct {
- /** set to sizeof(UlpNmea) */
- uint32_t size;
- char nmea_str[ULP_MAX_NMEA_STRING_SIZE];
- unsigned int len;
- } UlpNmea;
- /** AGPS type */
- typedef int8_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 0
- #define AGPS_APN_BEARER_IPV4 1
- #define AGPS_APN_BEARER_IPV6 2
- #define AGPS_APN_BEARER_IPV4V6 3
- typedef uint32_t LocApnTypeMask;
- /**< Denotes APN type for Default/Internet traffic */
- #define LOC_APN_TYPE_MASK_DEFAULT ((LocApnTypeMask)0x00000001)
- /**< Denotes APN type for IP Multimedia Subsystem */
- #define LOC_APN_TYPE_MASK_IMS ((LocApnTypeMask)0x00000002)
- /**< Denotes APN type for Multimedia Messaging Service */
- #define LOC_APN_TYPE_MASK_MMS ((LocApnTypeMask)0x00000004)
- /**< Denotes APN type for Dial Up Network */
- #define LOC_APN_TYPE_MASK_DUN ((LocApnTypeMask)0x00000008)
- /**< Denotes APN type for Secure User Plane Location */
- #define LOC_APN_TYPE_MASK_SUPL ((LocApnTypeMask)0x00000010)
- /**< Denotes APN type for High Priority Mobile Data */
- #define LOC_APN_TYPE_MASK_HIPRI ((LocApnTypeMask)0x00000020)
- /**< Denotes APN type for over the air administration */
- #define LOC_APN_TYPE_MASK_FOTA ((LocApnTypeMask)0x00000040)
- /**< Denotes APN type for Carrier Branded Services */
- #define LOC_APN_TYPE_MASK_CBS ((LocApnTypeMask)0x00000080)
- /**< Denotes APN type for Initial Attach */
- #define LOC_APN_TYPE_MASK_IA ((LocApnTypeMask)0x00000100)
- /**< Denotes APN type for emergency */
- #define LOC_APN_TYPE_MASK_EMERGENCY ((LocApnTypeMask)0x00000200)
- typedef uint32_t AGpsTypeMask;
- #define AGPS_ATL_TYPE_SUPL ((AGpsTypeMask)0x00000001)
- #define AGPS_ATL_TYPE_SUPL_ES ((AGpsTypeMask)0x00000002)
- #define AGPS_ATL_TYPE_WWAN ((AGpsTypeMask)0x00000004)
- typedef struct {
- void* statusV4Cb;
- AGpsTypeMask atlType;
- } AgpsCbInfo;
- typedef struct {
- void* visibilityControlCb;
- void* isInEmergencySession;
- } NfwCbInfo;
- /** GPS extended callback structure. */
- typedef struct {
- /** set to sizeof(LocGpsCallbacks) */
- uint32_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) */
- uint32_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,
- LOC_AGPS_MO_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 uint64_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
- /** GpsLocationExtended has valid LocPosTechMask */
- #define GPS_LOCATION_EXTENDED_HAS_POS_TECH_MASK 0x4000
- /** GpsLocationExtended has valid LocSvInfoSource */
- #define GPS_LOCATION_EXTENDED_HAS_SV_SOURCE_INFO 0x8000
- /** GpsLocationExtended has valid position dynamics data */
- #define GPS_LOCATION_EXTENDED_HAS_POS_DYNAMICS_DATA 0x10000
- /** GpsLocationExtended has GPS Time */
- #define GPS_LOCATION_EXTENDED_HAS_GPS_TIME 0x20000
- /** GpsLocationExtended has Extended Dilution of Precision */
- #define GPS_LOCATION_EXTENDED_HAS_EXT_DOP 0x40000
- /** GpsLocationExtended has North standard deviation */
- #define GPS_LOCATION_EXTENDED_HAS_NORTH_STD_DEV 0x80000
- /** GpsLocationExtended has East standard deviation*/
- #define GPS_LOCATION_EXTENDED_HAS_EAST_STD_DEV 0x100000
- /** GpsLocationExtended has North Velocity */
- #define GPS_LOCATION_EXTENDED_HAS_NORTH_VEL 0x200000
- /** GpsLocationExtended has East Velocity */
- #define GPS_LOCATION_EXTENDED_HAS_EAST_VEL 0x400000
- /** GpsLocationExtended has up Velocity */
- #define GPS_LOCATION_EXTENDED_HAS_UP_VEL 0x800000
- /** GpsLocationExtended has North Velocity Uncertainty */
- #define GPS_LOCATION_EXTENDED_HAS_NORTH_VEL_UNC 0x1000000
- /** GpsLocationExtended has East Velocity Uncertainty */
- #define GPS_LOCATION_EXTENDED_HAS_EAST_VEL_UNC 0x2000000
- /** GpsLocationExtended has up Velocity Uncertainty */
- #define GPS_LOCATION_EXTENDED_HAS_UP_VEL_UNC 0x4000000
- /** GpsLocationExtended has Clock Bias */
- #define GPS_LOCATION_EXTENDED_HAS_CLOCK_BIAS 0x8000000
- /** GpsLocationExtended has Clock Bias std deviation*/
- #define GPS_LOCATION_EXTENDED_HAS_CLOCK_BIAS_STD_DEV 0x10000000
- /** GpsLocationExtended has Clock drift*/
- #define GPS_LOCATION_EXTENDED_HAS_CLOCK_DRIFT 0x20000000
- /** GpsLocationExtended has Clock drift std deviation**/
- #define GPS_LOCATION_EXTENDED_HAS_CLOCK_DRIFT_STD_DEV 0x40000000
- /** GpsLocationExtended has leap seconds **/
- #define GPS_LOCATION_EXTENDED_HAS_LEAP_SECONDS 0x80000000
- /** GpsLocationExtended has time uncertainty **/
- #define GPS_LOCATION_EXTENDED_HAS_TIME_UNC 0x100000000
- /** GpsLocationExtended has heading rate **/
- #define GPS_LOCATION_EXTENDED_HAS_HEADING_RATE 0x200000000
- /** GpsLocationExtended has multiband signals **/
- #define GPS_LOCATION_EXTENDED_HAS_MULTIBAND 0x400000000
- /** GpsLocationExtended has sensor calibration confidence */
- #define GPS_LOCATION_EXTENDED_HAS_CALIBRATION_CONFIDENCE 0x800000000
- /** GpsLocationExtended has sensor calibration status */
- #define GPS_LOCATION_EXTENDED_HAS_CALIBRATION_STATUS 0x1000000000
- /** GpsLocationExtended has the engine type that produced this
- * position, the bit mask will only be set when there are two
- * or more position engines running in the system */
- #define GPS_LOCATION_EXTENDED_HAS_OUTPUT_ENG_TYPE 0x2000000000
- /** GpsLocationExtended has the engine mask that indicates the
- * set of engines contribute to the fix. */
- #define GPS_LOCATION_EXTENDED_HAS_OUTPUT_ENG_MASK 0x4000000000
- /** GpsLocationExtended has dgnss correction source */
- #define GPS_LOCATION_EXTENDED_HAS_DGNSS_CORRECTION_SOURCE_TYPE 0x8000000000
- /** GpsLocationExtended has dgnss correction source ID */
- #define GPS_LOCATION_EXTENDED_HAS_DGNSS_CORRECTION_SOURCE_ID 0x10000000000
- /** GpsLocationExtended has dgnss constellation usage */
- #define GPS_LOCATION_EXTENDED_HAS_DGNSS_CONSTELLATION_USAGE 0x20000000000
- /** GpsLocationExtended has dgnss ref station Id */
- #define GPS_LOCATION_EXTENDED_HAS_DGNSS_REF_STATION_ID 0x40000000000
- /** GpsLocationExtended has dgnss data age */
- #define GPS_LOCATION_EXTENDED_HAS_DGNSS_DATA_AGE 0x80000000000
- /** GpsLocationExtended has the conformityIndex computed from
- * robust location feature. */
- #define GPS_LOCATION_EXTENDED_HAS_CONFORMITY_INDEX 0x100000000000
- /** GpsLocationExtended has the llaVRPased. */
- #define GPS_LOCATION_EXTENDED_HAS_LLA_VRP_BASED 0x200000000000
- /** GpsLocationExtended has the velocityVRPased. */
- #define GPS_LOCATION_EXTENDED_HAS_ENU_VELOCITY_LLA_VRP_BASED 0x400000000000
- /** GpsLocationExtended has drSolutionStatusMask. */
- #define GPS_LOCATION_EXTENDED_HAS_DR_SOLUTION_STATUS_MASK 0x800000000000
- /** GpsLocationExtended has altitudeAssumed. */
- #define GPS_LOCATION_EXTENDED_HAS_ALTITUDE_ASSUMED 0x1000000000000
- #define GPS_LOCATION_EXTENDED_HAS_SYSTEM_TICK 0x2000000000000
- /** GpsLocationExtended has system tick unc. */
- #define GPS_LOCATION_EXTENDED_HAS_SYSTEM_TICK_UNC 0x4000000000000
- 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)
- /**< Bitmask to specify whether Position Report is DGNSS corrected */
- #define LOC_NAV_MASK_DGNSS_CORRECTION ((LocNavSolutionMask)0x0010)
- /**< Bitmask to specify whether Position Report is RTK corrected */
- #define LOC_NAV_MASK_RTK_CORRECTION ((LocNavSolutionMask)0x0020)
- /**< Bitmask to specify whether Position Report is PPP corrected */
- #define LOC_NAV_MASK_PPP_CORRECTION ((LocNavSolutionMask)0x0040)
- /**< Bitmask to specify whether Position Report is RTK fixed corrected */
- #define LOC_NAV_MASK_RTK_FIXED_CORRECTION ((LocNavSolutionMask)0x0080)
- /**< Bitmask specifying whether only SBAS corrected SVs are used for the fix */
- #define LOC_NAV_MASK_ONLY_SBAS_CORRECTED_SV_USED ((LocNavSolutionMask)0x0100)
- typedef uint32_t LocPosDataMask;
- /* Bitmask to specify whether Navigation data has Forward Acceleration */
- #define LOC_NAV_DATA_HAS_LONG_ACCEL ((LocPosDataMask)0x0001)
- /* Bitmask to specify whether Navigation data has Sideward Acceleration */
- #define LOC_NAV_DATA_HAS_LAT_ACCEL ((LocPosDataMask)0x0002)
- /* Bitmask to specify whether Navigation data has Vertical Acceleration */
- #define LOC_NAV_DATA_HAS_VERT_ACCEL ((LocPosDataMask)0x0004)
- /* Bitmask to specify whether Navigation data has Heading Rate */
- #define LOC_NAV_DATA_HAS_YAW_RATE ((LocPosDataMask)0x0008)
- /* Bitmask to specify whether Navigation data has Body pitch */
- #define LOC_NAV_DATA_HAS_PITCH ((LocPosDataMask)0x0010)
- /* Bitmask to specify whether Navigation data has Forward Acceleration Unc */
- #define LOC_NAV_DATA_HAS_LONG_ACCEL_UNC ((LocPosDataMask)0x0020)
- /* Bitmask to specify whether Navigation data has Sideward Acceleration Unc*/
- #define LOC_NAV_DATA_HAS_LAT_ACCEL_UNC ((LocPosDataMask)0x0040)
- /* Bitmask to specify whether Navigation data has Vertical Acceleration Unc*/
- #define LOC_NAV_DATA_HAS_VERT_ACCEL_UNC ((LocPosDataMask)0x0080)
- /* Bitmask to specify whether Navigation data has Heading Rate Unc*/
- #define LOC_NAV_DATA_HAS_YAW_RATE_UNC ((LocPosDataMask)0x0100)
- /* Bitmask to specify whether Navigation data has Body pitch Unc*/
- #define LOC_NAV_DATA_HAS_PITCH_UNC ((LocPosDataMask)0x0200)
- typedef uint32_t GnssAdditionalSystemInfoMask;
- /* Bitmask to specify whether Tauc is valid */
- #define GNSS_ADDITIONAL_SYSTEMINFO_HAS_TAUC ((GnssAdditionalSystemInfoMask)0x0001)
- /* Bitmask to specify whether leapSec is valid */
- #define GNSS_ADDITIONAL_SYSTEMINFO_HAS_LEAP_SEC ((GnssAdditionalSystemInfoMask)0x0002)
- /** 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 SBAS_SV_PRN_MIN 120
- #define SBAS_SV_PRN_MAX 191
- #define QZSS_SV_PRN_MIN 193
- #define QZSS_SV_PRN_MAX 197
- #define BDS_SV_PRN_MIN 201
- #define BDS_SV_PRN_MAX 263
- #define GAL_SV_PRN_MIN 301
- #define GAL_SV_PRN_MAX 336
- #define NAVIC_SV_PRN_MIN 401
- #define NAVIC_SV_PRN_MAX 414
- #define GLO_SV_PRN_SLOT_UNKNOWN 255
- /* Checking svIdOneBase can be set to the corresponding bit in mask */
- #define svFitsMask(mask, svIdOneBase) \
- ((svIdOneBase) >= 1 && (svIdOneBase) <= (sizeof(mask) << 3))
- /* Setting svIdOneBase specific bit in the mask if the bit offset fits */
- #define setSvMask(mask, svIdOneBase) \
- if (svFitsMask(mask, svIdOneBase)) mask |= (1ULL << ((svIdOneBase) - 1))
- #define isValInRangeInclusive(val, min, max) ((val) >= (min) && (val) <= (max))
- #define isGloSlotUnknown(val) ((val) == GLO_SV_PRN_SLOT_UNKNOWN)
- 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 enum {
- LOC_IN_EMERGENCY_UNKNOWN = 0,
- LOC_IN_EMERGENCY_SET = 1,
- LOC_IN_EMERGENCY_NOT_SET = 2
- }LocInEmergency;
- typedef struct {
- struct timespec32_t 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;
- uint64_t navic_sv_used_ids_mask;
- } GnssSvUsedInPosition;
- typedef struct {
- uint64_t gps_l1ca_sv_used_ids_mask; // GPS L1CA
- uint64_t gps_l1c_sv_used_ids_mask; // GPS L1C
- uint64_t gps_l2_sv_used_ids_mask; // GPS L2
- uint64_t gps_l5_sv_used_ids_mask; // GPS L5
- uint64_t glo_g1_sv_used_ids_mask; // GLO G1
- uint64_t glo_g2_sv_used_ids_mask; // GLO G2
- uint64_t gal_e1_sv_used_ids_mask; // GAL E1
- uint64_t gal_e5a_sv_used_ids_mask; // GAL E5A
- uint64_t gal_e5b_sv_used_ids_mask; // GAL E5B
- uint64_t bds_b1i_sv_used_ids_mask; // BDS B1I
- uint64_t bds_b1c_sv_used_ids_mask; // BDS B1C
- uint64_t bds_b2i_sv_used_ids_mask; // BDS B2I
- uint64_t bds_b2ai_sv_used_ids_mask; // BDS B2AI
- uint64_t qzss_l1ca_sv_used_ids_mask; // QZSS L1CA
- uint64_t qzss_l1s_sv_used_ids_mask; // QZSS L1S
- uint64_t qzss_l2_sv_used_ids_mask; // QZSS L2
- uint64_t qzss_l5_sv_used_ids_mask; // QZSS L5
- uint64_t sbas_l1_sv_used_ids_mask; // SBAS L1
- uint64_t bds_b2aq_sv_used_ids_mask; // BDS B2AQ
- } GnssSvMbUsedInPosition;
- /* Body Frame parameters */
- typedef struct {
- /** Contains Body frame LocPosDataMask bits. */
- uint32_t bodyFrameDatamask;
- /* Forward Acceleration in body frame (m/s2)*/
- float longAccel;
- /** Uncertainty of Forward Acceleration in body frame */
- float longAccelUnc;
- /* Sideward Acceleration in body frame (m/s2)*/
- float latAccel;
- /** Uncertainty of Side-ward Acceleration in body frame */
- float latAccelUnc;
- /* Vertical Acceleration in body frame (m/s2)*/
- float vertAccel;
- /** Uncertainty of Vertical Acceleration in body frame */
- float vertAccelUnc;
- /* Heading Rate (Radians/second) */
- float yawRate;
- /** Uncertainty of Heading Rate */
- float yawRateUnc;
- /* Body pitch (Radians) */
- float pitch;
- /** Uncertainty of Body pitch */
- float pitchRadUnc;
- }LocPositionDynamics;
- typedef struct {
- /** Position dilution of precision.
- Range: 1 (highest accuracy) to 50 (lowest accuracy) */
- float PDOP;
- /** Horizontal dilution of precision.
- Range: 1 (highest accuracy) to 50 (lowest accuracy) */
- float HDOP;
- /** Vertical dilution of precision.
- Range: 1 (highest accuracy) to 50 (lowest accuracy) */
- float VDOP;
- /** geometric dilution of precision.
- Range: 1 (highest accuracy) to 50 (lowest accuracy) */
- float GDOP;
- /** time dilution of precision.
- Range: 1 (highest accuracy) to 50 (lowest accuracy) */
- float TDOP;
- }LocExtDOP;
- /* GPS Time structure */
- typedef struct {
- /**< Current GPS week as calculated from midnight, Jan. 6, 1980. \n
- - Units: Weeks */
- uint16_t gpsWeek;
- /**< Amount of time into the current GPS week. \n
- - Units: Milliseconds */
- uint32_t gpsTimeOfWeekMs;
- }GPSTimeStruct;
- typedef uint8_t CarrierPhaseAmbiguityType;
- #define CARRIER_PHASE_AMBIGUITY_RESOLUTION_NONE ((CarrierPhaseAmbiguityType)0)
- #define CARRIER_PHASE_AMBIGUITY_RESOLUTION_FLOAT ((CarrierPhaseAmbiguityType)1)
- #define CARRIER_PHASE_AMBIGUITY_RESOLUTION_FIXED ((CarrierPhaseAmbiguityType)2)
- typedef enum {
- LOC_DGNSS_CORR_SOURCE_TYPE_INVALID = 0, /**< Invalid DGNSS correction source type \n */
- LOC_DGNSS_CORR_SOURCE_TYPE_RTCM = 1, /**< DGNSS correction source type RTCM \n */
- LOC_DGNSS_CORR_SOURCE_TYPE_3GPP = 2, /**< DGNSS correction source type 3GPP \n */
- }LocDgnssCorrectionSourceType;
- typedef uint16_t GnssMeasUsageStatusBitMask;
- /** Used in fix */
- #define GNSS_MEAS_USED_IN_PVT ((GnssMeasUsageStatusBitMask)0x00000001ul)
- /** Measurement is Bad */
- #define GNSS_MEAS_USAGE_STATUS_BAD_MEAS ((GnssMeasUsageStatusBitMask)0x00000002ul)
- /** Measurement has too low C/N */
- #define GNSS_MEAS_USAGE_STATUS_CNO_TOO_LOW ((GnssMeasUsageStatusBitMask)0x00000004ul)
- /** Measurement has too low elevation */
- #define GNSS_MEAS_USAGE_STATUS_ELEVATION_TOO_LOW ((GnssMeasUsageStatusBitMask)0x00000008ul)
- /** No ephemeris available for this measurement */
- #define GNSS_MEAS_USAGE_STATUS_NO_EPHEMERIS ((GnssMeasUsageStatusBitMask)0x00000010ul)
- /** No corrections available for the measurement */
- #define GNSS_MEAS_USAGE_STATUS_NO_CORRECTIONS ((GnssMeasUsageStatusBitMask)0x00000020ul)
- /** Corrections has timed out for the measurement */
- #define GNSS_MEAS_USAGE_STATUS_CORRECTION_TIMEOUT ((GnssMeasUsageStatusBitMask)0x00000040ul)
- /** Measurement is unhealthy */
- #define GNSS_MEAS_USAGE_STATUS_UNHEALTHY ((GnssMeasUsageStatusBitMask)0x00000080ul)
- /** Configuration is disabled for this measurement */
- #define GNSS_MEAS_USAGE_STATUS_CONFIG_DISABLED ((GnssMeasUsageStatusBitMask)0x00000100ul)
- /** Measurement not used for other reasons */
- #define GNSS_MEAS_USAGE_STATUS_OTHER ((GnssMeasUsageStatusBitMask)0x00000200ul)
- /** Flags to indicate valid fields in epMeasUsageInfo */
- typedef uint16_t GnssMeasUsageInfoValidityMask;
- #define GNSS_PSEUDO_RANGE_RESIDUAL_VALID ((GnssMeasUsageInfoValidityMask)0x00000001ul)
- #define GNSS_DOPPLER_RESIDUAL_VALID ((GnssMeasUsageInfoValidityMask)0x00000002ul)
- #define GNSS_CARRIER_PHASE_RESIDUAL_VALID ((GnssMeasUsageInfoValidityMask)0x00000004ul)
- #define GNSS_CARRIER_PHASE_AMBIGUITY_TYPE_VALID ((GnssMeasUsageInfoValidityMask)0x00000008ul)
- typedef uint16_t GnssSvPolyStatusMask;
- #define GNSS_SV_POLY_SRC_ALM_CORR_V02 ((GnssSvPolyStatusMask)0x01)
- #define GNSS_SV_POLY_GLO_STR4_V02 ((GnssSvPolyStatusMask)0x02)
- #define GNSS_SV_POLY_DELETE_V02 ((GnssSvPolyStatusMask)0x04)
- #define GNSS_SV_POLY_SRC_GAL_FNAV_OR_INAV_V02 ((GnssSvPolyStatusMask)0x08)
- typedef uint16_t GnssSvPolyStatusMaskValidity;
- #define GNSS_SV_POLY_SRC_ALM_CORR_VALID_V02 ((GnssSvPolyStatusMaskValidity)0x01)
- #define GNSS_SV_POLY_GLO_STR4_VALID_V02 ((GnssSvPolyStatusMaskValidity)0x02)
- #define GNSS_SV_POLY_DELETE_VALID_V02 ((GnssSvPolyStatusMaskValidity)0x04)
- #define GNSS_SV_POLY_SRC_GAL_FNAV_OR_INAV_VALID_V02 ((GnssSvPolyStatusMaskValidity)0x08)
- typedef struct {
- /** Specifies GNSS signal type
- Mandatory Field*/
- GnssSignalTypeMask gnssSignalType;
- /** Specifies GNSS Constellation Type
- Mandatory Field*/
- Gnss_LocSvSystemEnumType gnssConstellation;
- /** Unique SV Identifier.
- * SV Range for supported constellation is specified as below:
- * - For GPS: 1 to 32
- * - For GLONASS: 65 to 96
- * - For SBAS: 120 to 158 and 183 to 191
- * - For QZSS: 193 to 197
- * - For BDS: 201 to 263
- * - For GAL: 301 to 336
- * - For NAVIC: 401 to 414 */
- uint16_t gnssSvId;
- /** GLONASS frequency number + 7.
- Valid only for a GLONASS system and
- is to be ignored for all other systems.
- Range: 1 to 14 */
- uint8_t gloFrequency;
- /** Carrier phase ambiguity type. */
- CarrierPhaseAmbiguityType carrierPhaseAmbiguityType;
- /** Validity mask */
- GnssMeasUsageStatusBitMask measUsageStatusMask;
- /** Specifies measurement usage status
- Mandatory Field*/
- GnssMeasUsageInfoValidityMask validityMask;
- /** Computed pseudorange residual.
- Unit: Meters */
- float pseudorangeResidual;
- /** Computed doppler residual.
- Unit: Meters/sec*/
- float dopplerResidual;
- /** Computed carrier phase residual.
- Unit: Cycles*/
- float carrierPhaseResidual;
- /** Carrier phase ambiguity value.
- Unit: Cycles*/
- float carrierPhasAmbiguity;
- } GpsMeasUsageInfo;
- /** Represents gps location extended. */
- typedef struct {
- /** set to sizeof(GpsLocationExtended) */
- uint32_t size;
- /** Contains GpsLocationExtendedFlags bits. */
- uint64_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
- * confidence level is at 68% */
- float vert_unc;
- /** horizontal speed uncertainty in m/s
- * confidence level is at 68% */
- float speed_unc;
- /** heading uncertainty in degrees (0 to 359.999)
- * confidence level is at 68% */
- float bearing_unc;
- /** horizontal reliability. */
- LocReliability horizontal_reliability;
- /** vertical reliability. */
- LocReliability vertical_reliability;
- /** Horizontal Elliptical Uncertainty (Semi-Major Axis)
- * Confidence level is at 39% */
- float horUncEllipseSemiMajor;
- /** Horizontal Elliptical Uncertainty (Semi-Minor Axis)
- * Confidence level is at 39% */
- float horUncEllipseSemiMinor;
- /** Elliptical Horizontal Uncertainty Azimuth */
- float horUncEllipseOrientAzimuth;
- Gnss_ApTimeStampStructType timeStamp;
- /** Gnss sv used in position data */
- GnssSvUsedInPosition gnss_sv_used_ids;
- /** Gnss sv used in position data for multiband */
- GnssSvMbUsedInPosition gnss_mb_sv_used_ids;
- /** Nav solution mask to indicate sbas corrections */
- LocNavSolutionMask navSolutionMask;
- /** Position technology used in computing this fix */
- LocPosTechMask tech_mask;
- /** SV Info source used in computing this fix */
- LocSvInfoSource sv_source;
- /** Body Frame Dynamics: 4wayAcceleration and pitch set with validity */
- GnssLocationPositionDynamics bodyFrameData;
- /** GPS Time */
- GPSTimeStruct gpsTime;
- GnssSystemTime gnssSystemTime;
- /** Dilution of precision associated with this position*/
- LocExtDOP extDOP;
- /** North standard deviation.
- Unit: Meters */
- float northStdDeviation;
- /** East standard deviation.
- Unit: Meters */
- float eastStdDeviation;
- /** North Velocity.
- Unit: Meters/sec */
- float northVelocity;
- /** East Velocity.
- Unit: Meters/sec */
- float eastVelocity;
- /** Up Velocity.
- Unit: Meters/sec */
- float upVelocity;
- /** North Velocity standard deviation.
- * Unit: Meters/sec.
- * Confidence level is at 68% */
- float northVelocityStdDeviation;
- /** East Velocity standard deviation.
- * Unit: Meters/sec
- * Confidence level is at 68% */
- float eastVelocityStdDeviation;
- /** Up Velocity standard deviation
- * Unit: Meters/sec
- * Confidence level is at 68% */
- float upVelocityStdDeviation;
- /** Estimated clock bias. Unit: Nano seconds */
- float clockbiasMeter;
- /** Estimated clock bias std deviation. Unit: Nano seconds */
- float clockBiasStdDeviationMeter;
- /** Estimated clock drift. Unit: Meters/sec */
- float clockDrift;
- /** Estimated clock drift std deviation. Unit: Meters/sec */
- float clockDriftStdDeviation;
- /** Number of valid reference stations. Range:[0-4] */
- uint8_t numValidRefStations;
- /** Reference station(s) number */
- uint16_t referenceStation[4];
- /** Number of measurements received for use in fix.
- Shall be used as maximum index in-to svUsageInfo[].
- Set to 0, if svUsageInfo reporting is not supported.
- Range: 0-EP_GNSS_MAX_MEAS */
- uint8_t numOfMeasReceived;
- /** Measurement Usage Information */
- GpsMeasUsageInfo measUsageInfo[GNSS_SV_MAX];
- /** Leap Seconds */
- uint8_t leapSeconds;
- /** Time uncertainty in milliseconds,
- * SPE engine: confidence level is 99%
- * all other engines: confidence level is not specified */
- float timeUncMs;
- /** Heading Rate is in NED frame.
- Range: 0 to 359.999. 946
- Unit: Degrees per Seconds */
- float headingRateDeg;
- /** Sensor calibration confidence percent. Range: 0 - 100 */
- uint8_t calibrationConfidence;
- DrCalibrationStatusMask calibrationStatus;
- /** location engine type. When the fix. when the type is set to
- LOC_ENGINE_SRC_FUSED, the fix is the propagated/aggregated
- reports from all engines running on the system (e.g.:
- DR/SPE/PPE). To check which location engine contributes to
- the fused output, check for locOutputEngMask. */
- LocOutputEngineType locOutputEngType;
- /** when loc output eng type is set to fused, this field
- indicates the set of engines contribute to the fix. */
- PositioningEngineMask locOutputEngMask;
- /** DGNSS Correction Source for position report: RTCM, 3GPP
- * etc. */
- LocDgnssCorrectionSourceType dgnssCorrectionSourceType;
- /** If DGNSS is used, the SourceID is a 32bit number identifying
- * the DGNSS source ID */
- uint32_t dgnssCorrectionSourceID;
- /** If DGNSS is used, which constellation was DGNSS used for to
- * produce the pos report. */
- GnssConstellationTypeMask dgnssConstellationUsage;
- /** If DGNSS is used, DGNSS Reference station ID used for
- * position report */
- uint16_t dgnssRefStationId;
- /** If DGNSS is used, DGNSS data age in milli-seconds */
- uint32_t dgnssDataAgeMsec;
- /** When robust location is enabled, this field
- * will how well the various input data considered for
- * navigation solution conform to expectations.
- * Range: 0 (least conforming) to 1 (most conforming) */
- float conformityIndex;
- GnssLocationPositionDynamicsExt bodyFrameDataExt;
- /** VRR-based latitude/longitude/altitude */
- LLAInfo llaVRPBased;
- /** VRR-based east, north, and up velocity */
- float enuVelocityVRPBased[3];
- DrSolutionStatusMask drSolutionStatusMask;
- /** When this field is valid, it will indicates whether altitude
- * is assumed or calculated.
- * false: Altitude is calculated.
- * true: Altitude is assumed; there may not be enough
- * satellites to determine the precise altitude. */
- bool altitudeAssumed;
- /** System Tick at GPS Time */
- uint64_t systemTick;
- /** Uncertainty for System Tick at GPS Time in milliseconds */
- float systemTickUnc;
- } GpsLocationExtended;
- // struct that contains complete position info from engine
- typedef struct {
- UlpLocation location;
- GpsLocationExtended locationExtended;
- enum loc_sess_status sessionStatus;
- } EngineLocationInfo;
- // 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_MASK_GPDTM_V02 ((NmeaSentenceTypesMask)0x00040000) /**< Enable GPDTM type */
- #define LOC_NMEA_MASK_GNGGA_V02 ((NmeaSentenceTypesMask)0x00080000) /**< Enable GNGGA type */
- #define LOC_NMEA_MASK_GNRMC_V02 ((NmeaSentenceTypesMask)0x00100000) /**< Enable GNRMC type */
- #define LOC_NMEA_MASK_GNVTG_V02 ((NmeaSentenceTypesMask)0x00200000) /**< Enable GNVTG type */
- #define LOC_NMEA_MASK_GAGNS_V02 ((NmeaSentenceTypesMask)0x00400000) /**< Enable GAGNS type */
- #define LOC_NMEA_MASK_GBGGA_V02 ((NmeaSentenceTypesMask)0x00800000) /**< Enable GBGGA type */
- #define LOC_NMEA_MASK_GBGSA_V02 ((NmeaSentenceTypesMask)0x01000000) /**< Enable GBGSA type */
- #define LOC_NMEA_MASK_GBGSV_V02 ((NmeaSentenceTypesMask)0x02000000) /**< Enable GBGSV type */
- #define LOC_NMEA_MASK_GBRMC_V02 ((NmeaSentenceTypesMask)0x04000000) /**< Enable GBRMC type */
- #define LOC_NMEA_MASK_GBVTG_V02 ((NmeaSentenceTypesMask)0x08000000) /**< Enable GBVTG type */
- #define LOC_NMEA_MASK_GQGSV_V02 ((NmeaSentenceTypesMask)0x10000000) /**< Enable GQGSV type */
- #define LOC_NMEA_MASK_GIGSV_V02 ((NmeaSentenceTypesMask)0x20000000) /**< Enable GIGSV type */
- #define LOC_NMEA_MASK_GNDTM_V02 ((NmeaSentenceTypesMask)0x40000000) /**< Enable GNDTM type */
- #define LOC_NMEA_MASK_TAGBLOCK_V02 ((NmeaSentenceTypesMask)0x80000000) /**< Enable TAGBLOCK type */
- // all bitmasks of general supported NMEA sentenses - debug is not part of this
- #define LOC_NMEA_ALL_GENERAL_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_GPDTM_V02 | LOC_NMEA_MASK_GNGGA_V02 | LOC_NMEA_MASK_GNRMC_V02 | \
- LOC_NMEA_MASK_GNVTG_V02 | LOC_NMEA_MASK_GAGNS_V02 | LOC_NMEA_MASK_GBGGA_V02 | \
- LOC_NMEA_MASK_GBGSA_V02 | LOC_NMEA_MASK_GBGSV_V02 | LOC_NMEA_MASK_GBRMC_V02 | \
- LOC_NMEA_MASK_GBVTG_V02 | LOC_NMEA_MASK_GQGSV_V02 | LOC_NMEA_MASK_GIGSV_V02 | \
- LOC_NMEA_MASK_GNDTM_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,
- /* 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_REQUEST_POSITION_INJECTION, // Position injection request
- LOC_API_ADAPTER_BATCH_STATUS, // batch status
- LOC_API_ADAPTER_FDCL_SERVICE_REQ, // FDCL service request
- LOC_API_ADAPTER_REPORT_UNPROPAGATED_POSITION, // Unpropagated Position report
- LOC_API_ADAPTER_BS_OBS_DATA_SERVICE_REQ, // BS observation data request
- LOC_API_ADAPTER_GNSS_SV_EPHEMERIS_REPORT, // GNSS SV Ephemeris Report
- LOC_API_ADAPTER_LOC_SYSTEM_INFO, // Location system info event
- LOC_API_ADAPTER_GNSS_NHZ_MEASUREMENT_REPORT, // GNSS SV nHz measurement report
- LOC_API_ADAPTER_EVENT_REPORT_INFO, // Event report info
- LOC_API_ADAPTER_LATENCY_INFORMATION_REPORT, // Latency information report
- LOC_API_ADAPTER_FEATURE_STATUS_UPDATE, // Dynamic feature status update
- LOC_API_ADAPTER_ENGINE_DEBUG_DATA_REPORT, // Engine Debug data report
- LOC_API_ADAPTER_EVENT_MAX
- };
- #define LOC_API_ADAPTER_BIT_PARSED_POSITION_REPORT (1ULL<<LOC_API_ADAPTER_REPORT_POSITION)
- #define LOC_API_ADAPTER_BIT_SATELLITE_REPORT (1ULL<<LOC_API_ADAPTER_REPORT_SATELLITE)
- #define LOC_API_ADAPTER_BIT_NMEA_1HZ_REPORT (1ULL<<LOC_API_ADAPTER_REPORT_NMEA_1HZ)
- #define LOC_API_ADAPTER_BIT_NMEA_POSITION_REPORT (1ULL<<LOC_API_ADAPTER_REPORT_NMEA_POSITION)
- #define LOC_API_ADAPTER_BIT_NI_NOTIFY_VERIFY_REQUEST (1ULL<<LOC_API_ADAPTER_REQUEST_NI_NOTIFY_VERIFY)
- #define LOC_API_ADAPTER_BIT_ASSISTANCE_DATA_REQUEST (1ULL<<LOC_API_ADAPTER_REQUEST_ASSISTANCE_DATA)
- #define LOC_API_ADAPTER_BIT_LOCATION_SERVER_REQUEST (1ULL<<LOC_API_ADAPTER_REQUEST_LOCATION_SERVER)
- #define LOC_API_ADAPTER_BIT_IOCTL_REPORT (1ULL<<LOC_API_ADAPTER_REPORT_IOCTL)
- #define LOC_API_ADAPTER_BIT_STATUS_REPORT (1ULL<<LOC_API_ADAPTER_REPORT_STATUS)
- #define LOC_API_ADAPTER_BIT_REQUEST_WIFI (1ULL<<LOC_API_ADAPTER_REQUEST_WIFI)
- #define LOC_API_ADAPTER_BIT_SENSOR_STATUS (1ULL<<LOC_API_ADAPTER_SENSOR_STATUS)
- #define LOC_API_ADAPTER_BIT_REQUEST_TIME_SYNC (1ULL<<LOC_API_ADAPTER_REQUEST_TIME_SYNC)
- #define LOC_API_ADAPTER_BIT_REPORT_SPI (1ULL<<LOC_API_ADAPTER_REPORT_SPI)
- #define LOC_API_ADAPTER_BIT_REPORT_NI_GEOFENCE (1ULL<<LOC_API_ADAPTER_REPORT_NI_GEOFENCE)
- #define LOC_API_ADAPTER_BIT_GEOFENCE_GEN_ALERT (1ULL<<LOC_API_ADAPTER_GEOFENCE_GEN_ALERT)
- #define LOC_API_ADAPTER_BIT_REPORT_GENFENCE_BREACH (1ULL<<LOC_API_ADAPTER_REPORT_GENFENCE_BREACH)
- #define LOC_API_ADAPTER_BIT_BATCHED_GENFENCE_BREACH_REPORT (1ULL<<LOC_API_ADAPTER_BATCHED_GENFENCE_BREACH_REPORT)
- #define LOC_API_ADAPTER_BIT_PEDOMETER_CTRL (1ULL<<LOC_API_ADAPTER_PEDOMETER_CTRL)
- #define LOC_API_ADAPTER_BIT_MOTION_CTRL (1ULL<<LOC_API_ADAPTER_MOTION_CTRL)
- #define LOC_API_ADAPTER_BIT_REQUEST_WIFI_AP_DATA (1ULL<<LOC_API_ADAPTER_REQUEST_WIFI_AP_DATA)
- #define LOC_API_ADAPTER_BIT_BATCH_FULL (1ULL<<LOC_API_ADAPTER_BATCH_FULL)
- #define LOC_API_ADAPTER_BIT_BATCHED_POSITION_REPORT (1ULL<<LOC_API_ADAPTER_BATCHED_POSITION_REPORT)
- #define LOC_API_ADAPTER_BIT_GNSS_MEASUREMENT_REPORT (1ULL<<LOC_API_ADAPTER_GNSS_MEASUREMENT_REPORT)
- #define LOC_API_ADAPTER_BIT_GNSS_SV_POLYNOMIAL_REPORT (1ULL<<LOC_API_ADAPTER_GNSS_SV_POLYNOMIAL_REPORT)
- #define LOC_API_ADAPTER_BIT_GDT_UPLOAD_BEGIN_REQ (1ULL<<LOC_API_ADAPTER_GDT_UPLOAD_BEGIN_REQ)
- #define LOC_API_ADAPTER_BIT_GDT_UPLOAD_END_REQ (1ULL<<LOC_API_ADAPTER_GDT_UPLOAD_END_REQ)
- #define LOC_API_ADAPTER_BIT_GNSS_MEASUREMENT (1ULL<<LOC_API_ADAPTER_GNSS_MEASUREMENT)
- #define LOC_API_ADAPTER_BIT_REQUEST_TIMEZONE (1ULL<<LOC_API_ADAPTER_REQUEST_TIMEZONE)
- #define LOC_API_ADAPTER_BIT_REPORT_GENFENCE_DWELL (1ULL<<LOC_API_ADAPTER_REPORT_GENFENCE_DWELL_REPORT)
- #define LOC_API_ADAPTER_BIT_REQUEST_SRN_DATA (1ULL<<LOC_API_ADAPTER_REQUEST_SRN_DATA)
- #define LOC_API_ADAPTER_BIT_POSITION_INJECTION_REQUEST (1ULL<<LOC_API_ADAPTER_REQUEST_POSITION_INJECTION)
- #define LOC_API_ADAPTER_BIT_BATCH_STATUS (1ULL<<LOC_API_ADAPTER_BATCH_STATUS)
- #define LOC_API_ADAPTER_BIT_FDCL_SERVICE_REQ (1ULL<<LOC_API_ADAPTER_FDCL_SERVICE_REQ)
- #define LOC_API_ADAPTER_BIT_PARSED_UNPROPAGATED_POSITION_REPORT (1ULL<<LOC_API_ADAPTER_REPORT_UNPROPAGATED_POSITION)
- #define LOC_API_ADAPTER_BIT_BS_OBS_DATA_SERVICE_REQ (1ULL<<LOC_API_ADAPTER_BS_OBS_DATA_SERVICE_REQ)
- #define LOC_API_ADAPTER_BIT_GNSS_SV_EPHEMERIS_REPORT (1ULL<<LOC_API_ADAPTER_GNSS_SV_EPHEMERIS_REPORT)
- #define LOC_API_ADAPTER_BIT_LOC_SYSTEM_INFO (1ULL<<LOC_API_ADAPTER_LOC_SYSTEM_INFO)
- #define LOC_API_ADAPTER_BIT_GNSS_NHZ_MEASUREMENT (1ULL<<LOC_API_ADAPTER_GNSS_NHZ_MEASUREMENT_REPORT)
- #define LOC_API_ADAPTER_BIT_EVENT_REPORT_INFO (1ULL<<LOC_API_ADAPTER_EVENT_REPORT_INFO)
- #define LOC_API_ADAPTER_BIT_LATENCY_INFORMATION (1ULL<<LOC_API_ADAPTER_LATENCY_INFORMATION_REPORT)
- #define LOC_API_ADAPTER_BIT_FEATURE_STATUS_UPDATE (1ULL<<LOC_API_ADAPTER_FEATURE_STATUS_UPDATE)
- #define LOC_API_ADAPTER_BIT_ENGINE_DEBUG_DATA_REPORT (1ULL<<LOC_API_ADAPTER_ENGINE_DEBUG_DATA_REPORT)
- typedef uint64_t 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_OUTDOOR_TRIP_BATCHING, // Outdoor Trip Batching
- 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
- /** Max number of GNSS SV measurement */
- #define GNSS_LOC_SV_MEAS_LIST_MAX_SIZE 128
- 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)
- #define ULP_GNSS_SV_POLY_BIT_GLO_FREQ (0x000000001)
- #define ULP_GNSS_SV_POLY_BIT_T0 (0x000000002)
- #define ULP_GNSS_SV_POLY_BIT_IODE (0x000000004)
- #define ULP_GNSS_SV_POLY_BIT_FLAG (0x000000008)
- #define ULP_GNSS_SV_POLY_BIT_POLYCOEFF_XYZ0 (0x000000010)
- #define ULP_GNSS_SV_POLY_BIT_POLYCOEFF_XYZN (0x000000020)
- #define ULP_GNSS_SV_POLY_BIT_POLYCOEFF_OTHER (0x000000040)
- #define ULP_GNSS_SV_POLY_BIT_SV_POSUNC (0x000000080)
- #define ULP_GNSS_SV_POLY_BIT_IONODELAY (0x000000100)
- #define ULP_GNSS_SV_POLY_BIT_IONODOT (0x000000200)
- #define ULP_GNSS_SV_POLY_BIT_SBAS_IONODELAY (0x000000400)
- #define ULP_GNSS_SV_POLY_BIT_SBAS_IONODOT (0x000000800)
- #define ULP_GNSS_SV_POLY_BIT_TROPODELAY (0x000001000)
- #define ULP_GNSS_SV_POLY_BIT_ELEVATION (0x000002000)
- #define ULP_GNSS_SV_POLY_BIT_ELEVATIONDOT (0x000004000)
- #define ULP_GNSS_SV_POLY_BIT_ELEVATIONUNC (0x000008000)
- #define ULP_GNSS_SV_POLY_BIT_VELO_COEFF (0x000010000)
- #define ULP_GNSS_SV_POLY_BIT_ENHANCED_IOD (0x000020000)
- #define ULP_GNSS_SV_POLY_BIT_GPS_ISC_L1CA (0x000040000)
- #define ULP_GNSS_SV_POLY_BIT_GPS_ISC_L2C (0x000080000)
- #define ULP_GNSS_SV_POLY_BIT_GPS_ISC_L5I5 (0x000100000)
- #define ULP_GNSS_SV_POLY_BIT_GPS_ISC_L5Q5 (0x000200000)
- #define ULP_GNSS_SV_POLY_BIT_GPS_TGD (0x000400000)
- #define ULP_GNSS_SV_POLY_BIT_GLO_TGD_G1G2 (0x000800000)
- #define ULP_GNSS_SV_POLY_BIT_BDS_TGD_B1 (0x001000000)
- #define ULP_GNSS_SV_POLY_BIT_BDS_TGD_B2 (0x002000000)
- #define ULP_GNSS_SV_POLY_BIT_BDS_TGD_B2A (0x004000000)
- #define ULP_GNSS_SV_POLY_BIT_BDS_ISC_B2A (0x008000000)
- #define ULP_GNSS_SV_POLY_BIT_GAL_BGD_E1E5A (0x010000000)
- #define ULP_GNSS_SV_POLY_BIT_GAL_BGD_E1E5B (0x020000000)
- #define ULP_GNSS_SV_POLY_BIT_NAVIC_TGD_L5 (0x040000000)
- #define ULP_GNSS_SV_POLY_BIT_BDS_TGD_B1C (0x080000000)
- #define ULP_GNSS_SV_POLY_BIT_BDS_ISC_B1C (0x100000000)
- 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
- {
- uint32_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
- {
- uint32_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
- {
- uint32_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 {
- uint32_t size;
- uint8_t systemRtc_valid;
- /**< Validity indicator for System RTC */
- uint64_t systemRtcMs;
- /**< Platform system RTC value \n
- - Units: msec \n
- */
- }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_LP_VALID = 0x00000040,
- /**< TRUE/FALSE -- Lock Point is valid/invalid */
- GNSS_LOC_MEAS_STATUS_LP_POS_VALID = 0x00000080,
- /**< TRUE/FALSE -- Lock Point is positive/negative */
- 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 = 0x00001000,
- /**< Don't use measurement if bit is set */
- GNSS_LOC_MEAS_STATUS_DONT_USE_D = 0x00002000,
- /**< Don't use measurement if bit is set */
- GNSS_LOC_MEAS_STATUS_DONT_USE_S = 0x00004000,
- /**< Don't use measurement if bit is set */
- GNSS_LOC_MEAS_STATUS_DONT_USE_P = 0x00008000,
- /**< Don't use measurement if bit is set */
- GNSS_LOC_MEAS_STATUS_GNSS_FRESH_MEAS = 0x08000000
- /**< TRUE -- Fresh GNSS measurement observed in last second */
- }Gnss_LocSvMeasStatusMaskType;
- typedef struct
- {
- uint32_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 uint32_t LocSvDgnssMeasStatusMask;
- #define LOC_MASK_DGNSS_EPOCH_TIME_VALID 0x1 /**< DGNSS Epoch time is valid */
- #define LOC_MASK_DGNSS_MEAS_STATUS_PR_VALID 0x2 /**< Pseudo Range correction is valid */
- #define LOC_MASK_DGNSS_MEAS_STATUS_PRR_VALID 0x4 /**< Pseudo Range rate correction is valid */
- typedef struct {
- LocSvDgnssMeasStatusMask dgnssMeasStatus;
- /**< Bitmask indicating the DGNSS SV measurement status. */
- uint32_t diffDataEpochTimeMsec;
- /**< Age of differential data in Milli Seconds with respect to the Measurement time. */
- float prCorrMeters;
- /**< Pseudo Range correction in meters. */
- float prrCorrMetersPerSec;
- /**< Pseudo Range rate correction in meters per second. */
- } Gnss_LocDgnssSVMeasurement;
- typedef struct
- {
- uint32_t size;
- Gnss_LocSvSystemEnumType gnssSystem;
- // 0 signal type mask indicates invalid value
- GnssSignalTypeMask gnssSignalTypeMask;
- uint16_t gnssSvId;
- /** Unique SV Identifier.
- * For SV Range of supported constellation, please refer to the
- * comment section of gnssSvId in GpsMeasUsageInfo.
- */
- 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
- If any MSB bit in 0xFFC0000000000000 DONT_USE is set, the measurement
- must not be used by the client.
- @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
- */
- uint64_t validMeasStatusMask;
- /**< Bitmask indicating SV measurement status Validity.
- Valid bitmasks: \n
- If any MSB bit in 0xFFC0000000000000 DONT_USE is set, the measurement
- must not be used by the client.
- @MASK()
- */
- bool carrierPhaseUncValid;
- /**< Validity flag for SV direction */
- float carrierPhaseUnc;
- /** < DGNSS Measurements Report for SVs */
- Gnss_LocDgnssSVMeasurement dgnssSvMeas;
- } Gnss_SVMeasurementStructType;
- typedef uint64_t GpsSvMeasHeaderFlags;
- #define GNSS_SV_MEAS_HEADER_HAS_LEAP_SECOND 0x000000001
- #define GNSS_SV_MEAS_HEADER_HAS_CLOCK_FREQ 0x000000002
- #define GNSS_SV_MEAS_HEADER_HAS_AP_TIMESTAMP 0x000000004
- #define GNSS_SV_MEAS_HEADER_HAS_GPS_GLO_INTER_SYSTEM_BIAS 0x000000008
- #define GNSS_SV_MEAS_HEADER_HAS_GPS_BDS_INTER_SYSTEM_BIAS 0x000000010
- #define GNSS_SV_MEAS_HEADER_HAS_GPS_GAL_INTER_SYSTEM_BIAS 0x000000020
- #define GNSS_SV_MEAS_HEADER_HAS_BDS_GLO_INTER_SYSTEM_BIAS 0x000000040
- #define GNSS_SV_MEAS_HEADER_HAS_GAL_GLO_INTER_SYSTEM_BIAS 0x000000080
- #define GNSS_SV_MEAS_HEADER_HAS_GAL_BDS_INTER_SYSTEM_BIAS 0x000000100
- #define GNSS_SV_MEAS_HEADER_HAS_GPS_SYSTEM_TIME 0x000000200
- #define GNSS_SV_MEAS_HEADER_HAS_GAL_SYSTEM_TIME 0x000000400
- #define GNSS_SV_MEAS_HEADER_HAS_BDS_SYSTEM_TIME 0x000000800
- #define GNSS_SV_MEAS_HEADER_HAS_QZSS_SYSTEM_TIME 0x000001000
- #define GNSS_SV_MEAS_HEADER_HAS_GLO_SYSTEM_TIME 0x000002000
- #define GNSS_SV_MEAS_HEADER_HAS_GPS_SYSTEM_TIME_EXT 0x000004000
- #define GNSS_SV_MEAS_HEADER_HAS_GAL_SYSTEM_TIME_EXT 0x000008000
- #define GNSS_SV_MEAS_HEADER_HAS_BDS_SYSTEM_TIME_EXT 0x000010000
- #define GNSS_SV_MEAS_HEADER_HAS_QZSS_SYSTEM_TIME_EXT 0x000020000
- #define GNSS_SV_MEAS_HEADER_HAS_GLO_SYSTEM_TIME_EXT 0x000040000
- #define GNSS_SV_MEAS_HEADER_HAS_GPSL1L5_TIME_BIAS 0x000080000
- #define GNSS_SV_MEAS_HEADER_HAS_GALE1E5A_TIME_BIAS 0x000100000
- #define GNSS_SV_MEAS_HEADER_HAS_BDSB1IB2A_TIME_BIAS 0x000200000
- #define GNSS_SV_MEAS_HEADER_HAS_GPS_NAVIC_INTER_SYSTEM_BIAS 0x000400000
- #define GNSS_SV_MEAS_HEADER_HAS_GAL_NAVIC_INTER_SYSTEM_BIAS 0x000800000
- #define GNSS_SV_MEAS_HEADER_HAS_GLO_NAVIC_INTER_SYSTEM_BIAS 0x001000000
- #define GNSS_SV_MEAS_HEADER_HAS_BDS_NAVIC_INTER_SYSTEM_BIAS 0x002000000
- #define GNSS_SV_MEAS_HEADER_HAS_NAVIC_SYSTEM_TIME 0x004000000
- #define GNSS_SV_MEAS_HEADER_HAS_NAVIC_SYSTEM_TIME_EXT 0x008000000
- #define GNSS_SV_MEAS_HEADER_HAS_DGNSS_CORRECTION_SOURCE_TYPE 0x010000000
- #define GNSS_SV_MEAS_HEADER_HAS_DGNSS_CORRECTION_SOURCE_ID 0x020000000
- #define GNSS_SV_MEAS_HEADER_HAS_DGNSS_REF_STATION_ID 0x040000000
- #define GNSS_SV_MEAS_HEADER_HAS_REF_COUNT_TICKS 0x080000000
- #define GNSS_SV_MEAS_HEADER_HAS_GPSL1L2C_TIME_BIAS 0x100000000
- #define GNSS_SV_MEAS_HEADER_HAS_GLOG1G2_TIME_BIAS 0x200000000
- #define GNSS_SV_MEAS_HEADER_HAS_BDSB1IB1C_TIME_BIAS 0x400000000
- #define GNSS_SV_MEAS_HEADER_HAS_GALE1E5B_TIME_BIAS 0x800000000
- #define GNSS_SV_MEAS_HEADER_HAS_REF_COUNT_TICKS_UNC 0x1000000000
- typedef struct
- {
- uint32_t size;
- // see defines in GNSS_SV_MEAS_HEADER_HAS_XXX_XXX
- uint64_t flags;
- Gnss_LeapSecondInfoStructType leapSec;
- Gnss_LocRcvrClockFrequencyInfoStructType clockFreq; /* Freq */
- Gnss_ApTimeStampStructType apBootTimeStamp;
- Gnss_InterSystemBiasStructType gpsGloInterSystemBias;
- Gnss_InterSystemBiasStructType gpsBdsInterSystemBias;
- Gnss_InterSystemBiasStructType gpsGalInterSystemBias;
- Gnss_InterSystemBiasStructType bdsGloInterSystemBias;
- Gnss_InterSystemBiasStructType galGloInterSystemBias;
- Gnss_InterSystemBiasStructType galBdsInterSystemBias;
- Gnss_InterSystemBiasStructType gpsNavicInterSystemBias;
- Gnss_InterSystemBiasStructType galNavicInterSystemBias;
- Gnss_InterSystemBiasStructType gloNavicInterSystemBias;
- Gnss_InterSystemBiasStructType bdsNavicInterSystemBias;
- Gnss_InterSystemBiasStructType gpsL1L5TimeBias;
- Gnss_InterSystemBiasStructType galE1E5aTimeBias;
- Gnss_InterSystemBiasStructType bdsB1iB2aTimeBias;
- Gnss_InterSystemBiasStructType gpsL1L2cTimeBias;
- Gnss_InterSystemBiasStructType gloG1G2TimeBias;
- Gnss_InterSystemBiasStructType bdsB1iB1cTimeBias;
- Gnss_InterSystemBiasStructType galE1E5bTimeBias;
- GnssSystemTimeStructType gpsSystemTime;
- GnssSystemTimeStructType galSystemTime;
- GnssSystemTimeStructType bdsSystemTime;
- GnssSystemTimeStructType qzssSystemTime;
- GnssSystemTimeStructType navicSystemTime;
- GnssGloTimeStructType gloSystemTime;
- /** GPS system RTC time information. */
- Gnss_LocGnssTimeExtStructType gpsSystemTimeExt;
- /** GAL system RTC time information. */
- Gnss_LocGnssTimeExtStructType galSystemTimeExt;
- /** BDS system RTC time information. */
- Gnss_LocGnssTimeExtStructType bdsSystemTimeExt;
- /** QZSS system RTC time information. */
- Gnss_LocGnssTimeExtStructType qzssSystemTimeExt;
- /** GLONASS system RTC time information. */
- Gnss_LocGnssTimeExtStructType gloSystemTimeExt;
- /** NAVIC system RTC time information. */
- Gnss_LocGnssTimeExtStructType navicSystemTimeExt;
- /** Receiver tick at frame count */
- uint64_t refCountTicks;
- float refCountTicksUnc;
- /** DGNSS corrections source type RTCM, 3GPP etc, if DGNSS was
- * used for these measurements. */
- LocDgnssCorrectionSourceType dgnssCorrectionSourceType;
- /** DGNSS SourceID: 32bit number identifying the DGNSS source
- * ID, if DGNSS was used for these measurements. */
- uint32_t dgnssCorrectionSourceID;
- /** DGNSS Ref station ID: 32bit number identifying the DGNSS
- * ref station ID, if DGNSS was used for these measurements. */
- uint16_t dgnssRefStationId;
- } GnssSvMeasurementHeader;
- typedef struct {
- uint32_t size;
- bool isNhz;
- GnssSvMeasurementHeader svMeasSetHeader;
- uint32_t svMeasCount;
- Gnss_SVMeasurementStructType svMeas[GNSS_LOC_SV_MEAS_LIST_MAX_SIZE];
- } GnssSvMeasurementSet;
- typedef struct {
- uint32_t size; // set to sizeof(GnssMeasurements)
- GnssSvMeasurementSet gnssSvMeasurementSet;
- GnssMeasurementsNotification gnssMeasNotification;
- } GnssMeasurements;
- 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 {
- uint32_t size;
- uint16_t gnssSvId;
- /** Unique SV Identifier.
- * For SV Range of supported constellation, please refer to the
- * comment section of gnssSvId in GpsMeasUsageInfo.
- */
- int8_t freqNum;
- /** Freq index, only valid if u_SysInd is GLO */
- GnssSvPolyStatusMaskValidity svPolyStatusMaskValidity;
- GnssSvPolyStatusMask svPolyStatusMask;
- uint64_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 */
- float gpsIscL1ca;
- float gpsIscL2c;
- float gpsIscL5I5;
- float gpsIscL5Q5;
- float gpsTgd;
- float gloTgdG1G2;
- float bdsTgdB1;
- float bdsTgdB2;
- float bdsTgdB2a;
- float bdsIscB2a;
- float galBgdE1E5a;
- float galBgdE1E5b;
- float navicTgdL5;
- float bdsTgdB1c;
- float bdsIscB1c;
- } GnssSvPolynomial;
- typedef enum {
- GNSS_EPH_ACTION_UPDATE_SRC_UNKNOWN_V02 = 0, /**<Update ephemeris. Source of ephemeris is unknown */
- GNSS_EPH_ACTION_UPDATE_SRC_OTA_V02 = 1, /**<Update ephemeris. Source of ephemeris is OTA */
- GNSS_EPH_ACTION_UPDATE_SRC_NETWORK_V02 = 2, /**<Update ephemeris. Source of ephemeris is Network */
- GNSS_EPH_ACTION_UPDATE_MAX_V02 = 999, /**<Max value for update ephemeris action. DO NOT USE */
- GNSS_EPH_ACTION_DELETE_SRC_UNKNOWN_V02 = 1000, /**<Delete previous ephemeris from unknown source */
- GNSS_EPH_ACTION_DELETE_SRC_NETWORK_V02 = 1001, /**<Delete previous ephemeris from network */
- GNSS_EPH_ACTION_DELETE_SRC_OTA_V02 = 1002, /**<Delete previous ephemeris from OTA */
- GNSS_EPH_ACTION_DELETE_MAX_V02 = 1999, /**<Max value for delete ephemeris action. DO NOT USE */
- } GnssEphAction;
- typedef enum {
- GAL_EPH_SIGNAL_SRC_UNKNOWN_V02 = 0, /**< GALILEO signal is unknown */
- GAL_EPH_SIGNAL_SRC_E1B_V02 = 1, /**< GALILEO signal is E1B */
- GAL_EPH_SIGNAL_SRC_E5A_V02 = 2, /**< GALILEO signal is E5A */
- GAL_EPH_SIGNAL_SRC_E5B_V02 = 3, /**< GALILEO signal is E5B */
- } GalEphSignalSource;
- typedef struct {
- uint16_t gnssSvId;
- /** Unique SV Identifier.
- * For SV Range of supported constellation, please refer to the
- * comment section of gnssSvId in GpsMeasUsageInfo.
- */
- GnssEphAction updateAction;
- /**< Specifies the action and source of ephemeris. \n
- - Type: int32 enum */
- uint16_t IODE;
- /**< Issue of data ephemeris used (unit-less). \n
- GPS: IODE 8 bits.\n
- BDS: AODE 5 bits. \n
- GAL: SIS IOD 10 bits. \n
- - Type: uint16
- - Units: Unit-less */
- double aSqrt;
- /**< Square root of semi-major axis. \n
- - Type: double
- - Units: Square Root of Meters */
- double deltaN;
- /**< Mean motion difference from computed value. \n
- - Type: double
- - Units: Radians/Second */
- double m0;
- /**< Mean anomaly at reference time. \n
- - Type: double
- - Units: Radians */
- double eccentricity;
- /**< Eccentricity . \n
- - Type: double
- - Units: Unit-less */
- double omega0;
- /**< Longitude of ascending node of orbital plane at the weekly epoch. \n
- - Type: double
- - Units: Radians */
- double i0;
- /**< Inclination angle at reference time. \n
- - Type: double
- - Units: Radians */
- double omega;
- /**< Argument of Perigee. \n
- - Type: double
- - Units: Radians */
- double omegaDot;
- /**< Rate of change of right ascension. \n
- - Type: double
- - Units: Radians/Second */
- double iDot;
- /**< Rate of change of inclination angle. \n
- - Type: double
- - Units: Radians/Second */
- double cUc;
- /**< Amplitude of the cosine harmonic correction term to the argument of latitude. \n
- - Type: double
- - Units: Radians */
- double cUs;
- /**< Amplitude of the sine harmonic correction term to the argument of latitude. \n
- - Type: double
- - Units: Radians */
- double cRc;
- /**< Amplitude of the cosine harmonic correction term to the orbit radius. \n
- - Type: double
- - Units: Meters */
- double cRs;
- /**< Amplitude of the sine harmonic correction term to the orbit radius. \n
- - Type: double
- - Units: Meters */
- double cIc;
- /**< Amplitude of the cosine harmonic correction term to the angle of inclination. \n
- - Type: double
- - Units: Radians */
- double cIs;
- /**< Amplitude of the sine harmonic correction term to the angle of inclination. \n
- - Type: double
- - Units: Radians */
- uint32_t toe;
- /**< Reference time of ephemeris. \n
- - Type: uint32
- - Units: Seconds */
- uint32_t toc;
- /**< Clock data reference time of week. \n
- - Type: uint32
- - Units: Seconds */
- double af0;
- /**< Clock bias correction coefficient. \n
- - Type: double
- - Units: Seconds */
- double af1;
- /**< Clock drift coefficient. \n
- - Type: double
- - Units: Seconds/Second */
- double af2;
- /**< Clock drift rate correction coefficient. \n
- - Type: double
- - Units: Seconds/Seconds^2 */
- } GnssEphCommon;
- /* GPS Navigation Model Info */
- typedef struct {
- GnssEphCommon commonEphemerisData;
- /**< Common ephemeris data. */
- uint8_t signalHealth;
- /**< Signal health. \n
- Bit 0 : L5 Signal Health. \n
- Bit 1 : L2 Signal Health. \n
- Bit 2 : L1 Signal Health. \n
- - Type: uint8
- - Values: 3 bit mask of signal health, where set bit indicates unhealthy signal */
- uint8_t URAI;
- /**< User Range Accuracy Index. \n
- - Type: uint8
- - Units: Unit-less */
- uint8_t codeL2;
- /**< Indicates which codes are commanded ON for the L2 channel (2-bits). \n
- - Type: uint8
- Valid Values: \n
- - 00 : Reserved
- - 01 : P code ON
- - 10 : C/A code ON */
- uint8_t dataFlagL2P;
- /**< L2 P-code indication flag. \n
- - Type: uint8
- - Value 1 indicates that the Nav data stream was commanded OFF on the P-code of the L2 channel. */
- double tgd;
- /**< Time of group delay. \n
- - Type: double
- - Units: Seconds */
- uint8_t fitInterval;
- /**< Indicates the curve-fit interval used by the CS. \n
- - Type: uint8
- Valid Values:
- - 0 : Four hours
- - 1 : Greater than four hours */
- uint16_t IODC;
- /**< Issue of Data, Clock. \n
- - Type: uint16
- - Units: Unit-less */
- } GpsEphemeris;
- /* GLONASS Navigation Model Info */
- typedef struct {
- uint16_t gnssSvId;
- /**< GNSS SV ID.
- - Type: uint16
- - Range: 65 to 96 if known. When the slot number to SV ID mapping is unknown, set to 255 */
- GnssEphAction updateAction;
- /**< Specifies the action and source of ephemeris. \n
- - Type: int32 enum */
- uint8_t bnHealth;
- /**< SV health flags. \n
- - Type: uint8
- Valid Values: \n
- - 0 : Healthy
- - 1 : Unhealthy */
- uint8_t lnHealth;
- /**< Ln SV health flags. GLONASS-M. \n
- - Type: uint8
- Valid Values: \n
- - 0 : Healthy
- - 1 : Unhealthy */
- uint8_t tb;
- /**< Index of a time interval within current day according to UTC(SU) + 03 hours 00 min. \n
- - Type: uint8
- - Units: Unit-less */
- uint8_t ft;
- /**< SV accuracy index. \n
- - Type: uint8
- - Units: Unit-less */
- uint8_t gloM;
- /**< GLONASS-M flag. \n
- - Type: uint8
- Valid Values: \n
- - 0 : GLONASS
- - 1 : GLONASS-M */
- uint8_t enAge;
- /**< Characterizes "Age" of current information. \n
- - Type: uint8
- - Units: Days */
- uint8_t gloFrequency;
- /**< GLONASS frequency number + 8. \n
- - Type: uint8
- - Range: 1 to 14
- */
- uint8_t p1;
- /**< Time interval between two adjacent values of tb parameter. \n
- - Type: uint8
- - Units: Minutes */
- uint8_t p2;
- /**< Flag of oddness ("1") or evenness ("0") of the value of tb \n
- for intervals 30 or 60 minutes. \n
- - Type: uint8 */
- float deltaTau;
- /**< Time difference between navigation RF signal transmitted in L2 sub-band \n
- and aviation RF signal transmitted in L1 sub-band. \n
- - Type: floating point
- - Units: Seconds */
- double position[3];
- /**< Satellite XYZ position. \n
- - Type: array of doubles
- - Units: Meters */
- double velocity[3];
- /**< Satellite XYZ velocity. \n
- - Type: array of doubles
- - Units: Meters/Second */
- double acceleration[3];
- /**< Satellite XYZ sola-luni acceleration. \n
- - Type: array of doubles
- - Units: Meters/Second^2 */
- float tauN;
- /**< Satellite clock correction relative to GLONASS time. \n
- - Type: floating point
- - Units: Seconds */
- float gamma;
- /**< Relative deviation of predicted carrier frequency value \n
- from nominal value at the instant tb. \n
- - Type: floating point
- - Units: Unit-less */
- double toe;
- /**< Complete ephemeris time, including N4, NT and Tb. \n
- [(N4-1)*1461 + (NT-1)]*86400 + tb*900 \n
- - Type: double
- - Units: Seconds */
- uint16_t nt;
- /**< Current date, calendar number of day within four-year interval. \n
- Starting from the 1-st of January in a leap year. \n
- - Type: uint16
- - Units: Days */
- } GlonassEphemeris;
- /* BDS Navigation Model Info */
- typedef struct {
- GnssEphCommon commonEphemerisData;
- /**< Common ephemeris data. */
- uint8_t svHealth;
- /**< Satellite health information applied to both B1 and B2 (SatH1). \n
- - Type: uint8
- Valid Values: \n
- - 0 : Healthy
- - 1 : Unhealthy */
- uint8_t AODC;
- /**< Age of data clock. \n
- - Type: uint8
- - Units: Hours */
- double tgd1;
- /**< Equipment group delay differential on B1 signal. \n
- - Type: double
- - Units: Nano-Seconds */
- double tgd2;
- /**< Equipment group delay differential on B2 signal. \n
- - Type: double
- - Units: Nano-Seconds */
- uint8_t URAI;
- /**< User range accuracy index (4-bits). \n
- - Type: uint8
- - Units: Unit-less */
- } BdsEphemeris;
- /* GALIELO Navigation Model Info */
- typedef struct {
- GnssEphCommon commonEphemerisData;
- /**< Common ephemeris data. */
- GalEphSignalSource dataSourceSignal;
- /**< Galileo Signal Source. \n
- Valid Values: \n
- - GAL_EPH_SIGNAL_SRC_UNKNOWN (0) -- GALILEO signal is unknown
- - GAL_EPH_SIGNAL_SRC_E1B (1) -- GALILEO signal is E1B
- - GAL_EPH_SIGNAL_SRC_E5A (2) -- GALILEO signal is E5A
- - GAL_EPH_SIGNAL_SRC_E5B (3) -- GALILEO signal is E5B */
- uint8_t sisIndex;
- /**< Signal-in-space index for dual frequency E1-E5b/E5a depending on dataSignalSource. \n
- - Type: uint8
- - Units: Unit-less */
- double bgdE1E5a;
- /**< E1-E5a Broadcast group delay from F/Nav (E5A). \n
- - Type: double
- - Units: Seconds */
- double bgdE1E5b;
- /**< E1-E5b Broadcast group delay from I/Nav (E1B or E5B). \n
- For E1B or E5B signal, both bgdE1E5a and bgdE1E5b are valid. \n
- For E5A signal, only bgdE1E5a is valid. \n
- Signal source identified using dataSignalSource. \n
- - Type: double
- - Units: Seconds */
- uint8_t svHealth;
- /**< SV health status of signal identified by dataSourceSignal. \n
- - Type: uint8
- Valid Values: \n
- - 0 : Healthy
- - 1 : Unhealthy */
- } GalileoEphemeris;
- /** GPS Navigation model for each SV */
- typedef struct {
- uint16_t numOfEphemeris;
- GpsEphemeris gpsEphemerisData[GNSS_EPHEMERIS_LIST_MAX_SIZE_V02];
- } GpsEphemerisResponse;
- /** GLONASS Navigation model for each SV */
- typedef struct {
- uint16_t numOfEphemeris;
- GlonassEphemeris gloEphemerisData[GNSS_EPHEMERIS_LIST_MAX_SIZE_V02];
- } GlonassEphemerisResponse;
- /** BDS Navigation model for each SV */
- typedef struct {
- uint16_t numOfEphemeris;
- BdsEphemeris bdsEphemerisData[GNSS_EPHEMERIS_LIST_MAX_SIZE_V02];
- } BdsEphemerisResponse;
- /** GALILEO Navigation model for each SV */
- typedef struct {
- uint16_t numOfEphemeris;
- GalileoEphemeris galEphemerisData[GNSS_EPHEMERIS_LIST_MAX_SIZE_V02];
- } GalileoEphemerisResponse;
- /** QZSS Navigation model for each SV */
- typedef struct {
- uint16_t numOfEphemeris;
- GpsEphemeris qzssEphemerisData[GNSS_EPHEMERIS_LIST_MAX_SIZE_V02];
- } QzssEphemerisResponse;
- typedef struct {
- /** Indicates GNSS Constellation Type
- Mandatory field */
- Gnss_LocSvSystemEnumType gnssConstellation;
- /** GPS System Time of the ephemeris report */
- bool isSystemTimeValid;
- GnssSystemTimeStructType systemTime;
- union {
- /** GPS Ephemeris */
- GpsEphemerisResponse gpsEphemeris;
- /** GLONASS Ephemeris */
- GlonassEphemerisResponse glonassEphemeris;
- /** BDS Ephemeris */
- BdsEphemerisResponse bdsEphemeris;
- /** GALILEO Ephemeris */
- GalileoEphemerisResponse galileoEphemeris;
- /** QZSS Ephemeris */
- QzssEphemerisResponse qzssEphemeris;
- } ephInfo;
- } GnssSvEphemerisReport;
- typedef struct {
- /** GPS System Time of the iono model report */
- bool isSystemTimeValid;
- GnssSystemTimeStructType systemTime;
- /** Indicates GNSS Constellation Type */
- Gnss_LocSvSystemEnumType gnssConstellation;
- float alpha0;
- /**< Klobuchar Model Parameter Alpha 0.
- - Type: float
- - Unit: Seconds
- */
- float alpha1;
- /**< Klobuchar Model Parameter Alpha 1.
- - Type: float
- - Unit: Seconds / Semi-Circle
- */
- float alpha2;
- /**< Klobuchar Model Parameter Alpha 2.
- - Type: float
- - Unit: Seconds / Semi-Circle^2
- */
- float alpha3;
- /**< Klobuchar Model Parameter Alpha 3.
- - Type: float
- - Unit: Seconds / Semi-Circle^3
- */
- float beta0;
- /**< Klobuchar Model Parameter Beta 0.
- - Type: float
- - Unit: Seconds
- */
- float beta1;
- /**< Klobuchar Model Parameter Beta 1.
- - Type: float
- - Unit: Seconds / Semi-Circle
- */
- float beta2;
- /**< Klobuchar Model Parameter Beta 2.
- - Type: float
- - Unit: Seconds / Semi-Circle^2
- */
- float beta3;
- /**< Klobuchar Model Parameter Beta 3.
- - Type: float
- - Unit: Seconds / Semi-Circle^3
- */
- } GnssKlobucharIonoModel;
- typedef struct {
- /** GPS System Time of the report */
- bool isSystemTimeValid;
- GnssSystemTimeStructType systemTime;
- GnssAdditionalSystemInfoMask validityMask;
- double tauC;
- int8_t leapSec;
- } GnssAdditionalSystemInfo;
- /* 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
- {
- uint32_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;
- /* Provides the current GNSS SV Type configuration to the client.
- * This is fetched via direct call to GNSS Adapter bypassing
- * Location API */
- typedef std::function<void(
- const GnssSvTypeConfig& config
- )> GnssSvTypeConfigCallback;
- /*
- * Represents the status of AGNSS augmented to support IPv4.
- */
- struct AGnssExtStatusIpV4 {
- AGpsExtType type;
- LocApnTypeMask apnTypeMask;
- LocAGpsStatusValue status;
- /*
- * 32-bit IPv4 address.
- */
- uint32_t ipV4Addr;
- LocSubId subId;
- };
- /*
- * Represents the status of AGNSS augmented to support IPv6.
- */
- struct AGnssExtStatusIpV6 {
- AGpsExtType type;
- LocApnTypeMask apnTypeMask;
- LocAGpsStatusValue status;
- /*
- * 128-bit IPv6 address.
- */
- uint8_t ipV6Addr[16];
- };
- /*
- * Represents the the Nfw Notification structure
- */
- #define GNSS_MAX_NFW_APP_STRING_LEN 64
- #define GNSS_MAX_NFW_STRING_LEN 20
- typedef enum {
- GNSS_NFW_CTRL_PLANE = 0,
- GNSS_NFW_SUPL = 1,
- GNSS_NFW_IMS = 10,
- GNSS_NFW_SIM = 11,
- GNSS_NFW_OTHER_PROTOCOL_STACK = 100
- } GnssNfwProtocolStack;
- typedef enum {
- GNSS_NFW_CARRIER = 0,
- GNSS_NFW_OEM = 10,
- GNSS_NFW_MODEM_CHIPSET_VENDOR = 11,
- GNSS_NFW_GNSS_CHIPSET_VENDOR = 12,
- GNSS_NFW_OTHER_CHIPSET_VENDOR = 13,
- GNSS_NFW_AUTOMOBILE_CLIENT = 20,
- GNSS_NFW_OTHER_REQUESTOR = 100
- } GnssNfwRequestor;
- typedef enum {
- GNSS_NFW_REJECTED = 0,
- GNSS_NFW_ACCEPTED_NO_LOCATION_PROVIDED = 1,
- GNSS_NFW_ACCEPTED_LOCATION_PROVIDED = 2,
- } GnssNfwResponseType;
- typedef struct {
- char proxyAppPackageName[GNSS_MAX_NFW_APP_STRING_LEN];
- GnssNfwProtocolStack protocolStack;
- char otherProtocolStackName[GNSS_MAX_NFW_STRING_LEN];
- GnssNfwRequestor requestor;
- char requestorId[GNSS_MAX_NFW_STRING_LEN];
- GnssNfwResponseType responseType;
- bool inEmergencyMode;
- bool isCachedLocation;
- } GnssNfwNotification;
- typedef uint16_t GnssMeasurementCorrectionsCapabilitiesMask;
- typedef enum {
- GNSS_MEAS_CORR_LOS_SATS = 1 << 0,
- GNSS_MEAS_CORR_EXCESS_PATH_LENGTH = 1 << 1,
- GNSS_MEAS_CORR_REFLECTING_PLANE = 1 << 2,
- } GnssMeasurementCorrectionsCapabilities;
- /* Represents GNSS NMEA Report Rate Configuration */
- typedef enum {
- GNSS_NMEA_REPORT_RATE_UNKNOWN = 0,
- GNSS_NMEA_REPORT_RATE_1HZ = 1,
- GNSS_NMEA_REPORT_RATE_NHZ = 2
- } GnssNMEARptRate;
- /* ODCPI Request Info */
- enum OdcpiRequestType {
- ODCPI_REQUEST_TYPE_START,
- ODCPI_REQUEST_TYPE_STOP
- };
- struct OdcpiRequestInfo {
- uint32_t size;
- OdcpiRequestType type;
- uint32_t tbfMillis;
- bool isEmergencyMode;
- bool isCivicAddressRequired;
- };
- struct EngineServiceInfo {
- bool ppeIntEnabled; // flag to indicate whether internal ppe is enabled
- };
- /* Callback to send ODCPI request to framework */
- typedef std::function<void(const OdcpiRequestInfo& request)> OdcpiRequestCallback;
- /* ODCPI callback priorities*/
- enum OdcpiPrioritytype {
- //ODCPI callback registered by AFW via IGNSS AIDL has LOW priority
- ODCPI_HANDLER_PRIORITY_LOW,
- ODCPI_HANDLER_PRIORITY_DEFAULT = ODCPI_HANDLER_PRIORITY_LOW,
- //ODCPI callback registered by IzatProvider on LE/KaiOS has medium priority
- ODCPI_HANDLER_PRIORITY_MEDIUM,
- //Non emergency ODCPI callback registered by IzatManager for RTT position injection
- //has high priority
- ODCPI_HANDLER_PRIORITY_HIGH
- };
- /*
- * Callback with AGNSS(IpV4) status information.
- *
- * @param status Will be of type AGnssExtStatusIpV4.
- */
- typedef void (*AgnssStatusIpV4Cb)(AGnssExtStatusIpV4 status);
- /*
- * Callback with AGNSS(IpV6) status information.
- *
- * @param status Will be of type AGnssExtStatusIpV6.
- */
- typedef void (*AgnssStatusIpV6Cb)(AGnssExtStatusIpV6 status);
- /*
- * Callback with NFW information.
- */
- typedef void(*NfwStatusCb)(GnssNfwNotification notification);
- typedef bool(*IsInEmergencySession)(void);
- enum AntennaInfoStatus {
- ANTENNA_INFO_SUCCESS = 0,
- ANTENNA_INFO_ERROR_ALREADY_INIT = 1,
- ANTENNA_INFO_ERROR_GENERIC = 2
- };
- /*
- * Callback with Measurement corrections information.
- */
- typedef void(*measCorrSetCapabilitiesCb)(GnssMeasurementCorrectionsCapabilitiesMask capabilities);
- /*
- * Callback with AGNSS(IpV6) status information.
- *
- * @param status Will be of type AGnssExtStatusIpV6.
- */
- typedef void (*AgnssStatusIpV6Cb)(AGnssExtStatusIpV6 status);
- /*
- * Callback with Antenna information.
- */
- typedef void(*antennaInfoCb)(std::vector<GnssAntennaInformation> gnssAntennaInformations);
- typedef struct {
- uint32_t size; // set to sizeof
- uint64_t elapsedRealTime; // in ns
- uint64_t elapsedRealTimeUnc; // in ns
- double totalEnergyMilliJoule;
- } GnssPowerStatistics;
- /*
- * Callback with Power indication.
- */
- typedef void(*powerIndicationCb)(GnssPowerStatistics gnssPowerStatistics);
- /* Constructs for interaction with loc_net_iface library */
- typedef void (*LocAgpsOpenResultCb)(bool isSuccess, AGpsExtType agpsType, const char* apn,
- AGpsBearerType bearerType, void* userDataPtr);
- typedef void (*LocAgpsCloseResultCb)(bool isSuccess, AGpsExtType agpsType, void* userDataPtr);
- /* Shared resources of LocIpc */
- #define LOC_IPC_HAL "/dev/socket/location/socket_hal"
- #define LOC_IPC_XTRA "/dev/socket/location/xtra/socket_xtra"
- #define LOC_IPC_DGNSS "/dev/socket/location/dgnss/socket_dgnss"
- #define SOCKET_DIR_LOCATION "/dev/socket/location/"
- #define SOCKET_DIR_EHUB "/dev/socket/location/ehub/"
- #define SOCKET_TO_LOCATION_HAL_DAEMON "/dev/socket/loc_client/hal_daemon"
- #define SOCKET_LOC_CLIENT_DIR "/dev/socket/loc_client/"
- #define EAP_LOC_CLIENT_DIR "/data/vendor/location/extap_locclient/"
- #define LOC_CLIENT_NAME_PREFIX "toclient"
- // Please note that the socket name for all location hal daemon client need
- // to start with LOC_CLIENT_NAME_PREFIX so that upon hal daemon restarts,
- // every client can get the notification that hal daemon has restarted.
- #define LOC_INTAPI_NAME_PREFIX LOC_CLIENT_NAME_PREFIX "_intapi"
- typedef uint64_t NetworkHandle;
- #define NETWORK_HANDLE_UNKNOWN ~0
- #define MAX_NETWORK_HANDLES 10
- typedef enum {
- LOC_FEATURE_STATUS_UNKNOWN = 0,
- LOC_FEATURE_STATUS_NONE = 1,
- LOC_FEATURE_STATUS_OK = 2,
- LOC_FEATURE_STATUS_EXPIRED = 3
- } LocFeatureStatus;
- #ifdef __cplusplus
- }
- #endif /* __cplusplus */
- #endif /* GPS_EXTENDED_C_H */
|