NVIDIA DriveOS Linux NSR SDK API Reference

7.0.3.0 Release
GPSFrame.h
Go to the documentation of this file.
1 /*
2  * SPDX-FileCopyrightText: Copyright (c) 2016-2024 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
3  * SPDX-License-Identifier: LicenseRef-NvidiaProprietary
4  *
5  * NVIDIA CORPORATION, its affiliates and licensors retain all intellectual
6  * property and proprietary rights in and to this material, related
7  * documentation and any modifications thereto. Any use, reproduction,
8  * disclosure or distribution of this material and related documentation
9  * without an express license agreement from NVIDIA CORPORATION or
10  * its affiliates is strictly prohibited.
11  */
12 #ifndef DW_SENSORS_GPS_GPSFRAME_H_
13 #define DW_SENSORS_GPS_GPSFRAME_H_
14 // Generated by dwProto from gps_frame.proto DO NOT EDIT BY HAND!
15 // See //3rdparty/shared/dwproto/README.md for more information
16 
17 #include <dw/pbwire/BasicTypes.h>
18 
19 #include <dw/core/base/Exports.h>
20 
21 #include <dw/core/signal/SignalStatus.h>
22 
23 #ifdef __cplusplus
24 extern "C" {
25 #endif
26 
28 // coverity[misra_c_2012_rule_2_4_violation] Deviation Record: AV-NDAS-DWPROTO-SWSADR-006
29 // coverity[misra_c_2012_rule_2_3_violation] Deviation Record: AV-NDAS-DWPROTO-SWSADR-006
30 typedef enum dwGPSTimestampFormat {
33 
36 
39 
44 
46 // coverity[misra_c_2012_rule_2_4_violation] Deviation Record: AV-NDAS-DWPROTO-SWSADR-006
47 // coverity[misra_c_2012_rule_2_3_violation] Deviation Record: AV-NDAS-DWPROTO-SWSADR-006
48 typedef enum dwGPSFlags {
50  DW_GPS_LAT DW_DEPRECATED_ENUM("Use dwGPSFrame.validityInfo.latitude instead") = 1 << 0,
51 
53  DW_GPS_LON DW_DEPRECATED_ENUM("Use dwGPSFrame.validityInfo.longitude instead") = 1 << 1,
54 
56  DW_GPS_ALT DW_DEPRECATED_ENUM("Use dwGPSFrame.validityInfo.altitude instead") = 1 << 2,
57 
59  DW_GPS_COURSE DW_DEPRECATED_ENUM("Use dwGPSFrame.validityInfo.course instead") = 1 << 3,
60 
62  DW_GPS_SPEED DW_DEPRECATED_ENUM("Use dwGPSFrame.validityInfo.speed instead") = 1 << 4,
63 
65  DW_GPS_CLIMB DW_DEPRECATED_ENUM("Use dwGPSFrame.validityInfo.climb instead") = 1 << 5,
66 
68  DW_GPS_HDOP DW_DEPRECATED_ENUM("Use dwGPSFrame.validityInfo.hdop instead") = 1 << 6,
69 
71  DW_GPS_VDOP DW_DEPRECATED_ENUM("Use dwGPSFrame.validityInfo.vdop instead") = 1 << 7,
72 
74  DW_GPS_HACC DW_DEPRECATED_ENUM("Use dwGPSFrame.validityInfo.hacc instead") = 1 << 8,
75 
77  DW_GPS_VACC DW_DEPRECATED_ENUM("Use dwGPSFrame.validityInfo.vacc instead") = 1 << 9,
78 
80  DW_GPS_MODE DW_DEPRECATED_ENUM("Use dwGPSFrame.validityInfo.mode instead") = 1 << 10,
81  DW_GPS_FLAGS_FORCE32 = 0x7fffffff,
82 } dwGPSFlags;
83 
85 // coverity[misra_c_2012_rule_2_4_violation] Deviation Record: AV-NDAS-DWPROTO-SWSADR-006
86 // coverity[misra_c_2012_rule_2_3_violation] Deviation Record: AV-NDAS-DWPROTO-SWSADR-006
87 typedef enum dwGPSJamState {
90 
93 
96 
99 
103 } dwGPSJamState;
104 
106 // coverity[misra_c_2012_rule_2_4_violation] Deviation Record: AV-NDAS-DWPROTO-SWSADR-006
107 // coverity[misra_c_2012_rule_2_3_violation] Deviation Record: AV-NDAS-DWPROTO-SWSADR-006
108 typedef enum dwGPSSpoofState {
111 
114 
117 
120 
125 
128 // coverity[misra_c_2012_rule_2_4_violation] Deviation Record: AV-NDAS-DWPROTO-SWSADR-006
129 // coverity[misra_c_2012_rule_2_3_violation] Deviation Record: AV-NDAS-DWPROTO-SWSADR-006
130 typedef enum dwGPSMode {
133 
136 
139 
142 
145 
148 
151 
154 
157 
160  DW_GPS_MODE_FORCE32 = 0x7fffffff,
161 } dwGPSMode;
162 
164 // coverity[misra_c_2012_rule_2_4_violation] Deviation Record: AV-NDAS-DWPROTO-SWSADR-006
165 // coverity[misra_c_2012_rule_2_3_violation] Deviation Record: AV-NDAS-DWPROTO-SWSADR-006
166 typedef enum dwGPSFixStatus {
169 
172 
177 
179 // coverity[misra_c_2012_rule_2_4_violation] Deviation Record: AV-NDAS-DWPROTO-SWSADR-006
180 // coverity[misra_c_2012_rule_2_3_violation] Deviation Record: AV-NDAS-DWPROTO-SWSADR-006
181 typedef enum dwGPSTimestampQuality {
184 
187 
192 
195 // coverity[misra_c_2012_rule_2_4_violation] Deviation Record: AV-NDAS-SWSADR-003
196 // coverity[misra_c_2012_rule_2_3_violation] Deviation Record: AV-NDAS-DWPROTO-SWSADR-006
198 {
201 
204 
207 
210 
213 
216 
219 
222 
225 
228 
231 
234 
237 
240 
243 
246 
249 
252 
255 
258 
261 
264 
267 
270 
274 
277  // coverity[misra_c_2012_rule_2_3_violation] Deviation Record: AV-NDAS-DWPROTO-SWSADR-006
279 
282 // coverity[misra_c_2012_rule_2_4_violation] Deviation Record: AV-NDAS-SWSADR-003
283 // coverity[misra_c_2012_rule_2_3_violation] Deviation Record: AV-NDAS-DWPROTO-SWSADR-006
284 typedef struct dwGPSFrame
285 {
286 
289 
298 
304 
310 
316 
322 
328 
334 
340 
346 
352 
358 
364 
370 
376  uint8_t satelliteCount;
377 
388 
400 
419 
422  DW_DEPRECATED("utcTime is deprecated and will be removed soon. Please use utcTimeUs instead")
424 
427  DW_DEPRECATED("utcDate is deprecated and will be removed soon. Please use utcTimeUs instead")
429 
432  DW_DEPRECATED("flags is deprecated and will be removed soon. Please use struct validityInfo and APIs introduced in GPSGetterSetter.h instead")
433  uint32_t flags;
434 
437  DW_DEPRECATED("gpsMode is deprecated and will be removed soon. Please use mode instead")
439 
441  uint64_t errors;
442 
449 
456 
470 
484 
490 
495 
504 
506  uint8_t reserved[416];
507  // coverity[misra_c_2012_rule_2_3_violation] Deviation Record: AV-NDAS-DWPROTO-SWSADR-006
508 } dwGPSFrame;
509 
510 #ifdef __cplusplus
511 }
512 #endif
513 
514 #endif // DW_SENSORS_GPS_GPSFRAME_H_
DW_GPS_SPOOF_STATE_UNSPECIFIED
@ DW_GPS_SPOOF_STATE_UNSPECIFIED
GPS spoof state unspecified.
Definition: GPSFrame.h:110
dwGPSFrame::courseAccuracy
float64_t courseAccuracy
Definition: GPSFrame.h:448
dwGPSSignalValidityInfo::climb
dwSignalValidity climb
Validity of climb signal.
Definition: GPSFrame.h:218
dwGPSFrame
A GPS packet containing localization information.
Definition: GPSFrame.h:284
dwGPSSignalValidityInfo::courseAccuracy
dwSignalValidity courseAccuracy
Validity of GPS course accuracy signal.
Definition: GPSFrame.h:254
dwGPSFrame::pdop
float64_t pdop
Definition: GPSFrame.h:351
DW_GPS_JAM_STATE_WARN
@ DW_GPS_JAM_STATE_WARN
GPS jam state warn.
Definition: GPSFrame.h:95
dwGPSSignalValidityInfo::spoofState
dwSignalValidity spoofState
Validity of GPS spoof state signal.
Definition: GPSFrame.h:263
DW_GPS_MODE_RTK_FIXED
@ DW_GPS_MODE_RTK_FIXED
GPS mode RTK fixed. This is the highest accuracy mode.
Definition: GPSFrame.h:153
dwGPSFrame::vacc
float64_t vacc
Definition: GPSFrame.h:363
dwGPSFrame::errors
uint64_t errors
GPS Error IDs. It's internally used by SAL sensors. VAL and partners are not intended to use this fie...
Definition: GPSFrame.h:441
dwGPSSignalValidityInfo::errors
dwSignalValidity errors
Validity of detected errors. It should be always invalid for now.
Definition: GPSFrame.h:251
DW_GPS_MODE_FORCE32
@ DW_GPS_MODE_FORCE32
Definition: GPSFrame.h:160
dwGPSFrame::reserved
uint8_t reserved[416]
Reserved space.
Definition: GPSFrame.h:506
DW_GPS_TIMESTAMP_FORMAT_UNSPECIFIED
@ DW_GPS_TIMESTAMP_FORMAT_UNSPECIFIED
Timestamp format not specified.
Definition: GPSFrame.h:32
dwGPSFrame::course
float64_t course
Definition: GPSFrame.h:321
dwGPSFrame::altitude
float64_t altitude
Definition: GPSFrame.h:315
dwGPSSignalValidityInfo::timestamp_us
dwSignalValidity timestamp_us
Validity of timestamp signal.
Definition: GPSFrame.h:200
dwGPSSignalValidityInfo::sensorTimestampFormat
dwSignalValidity sensorTimestampFormat
Reserved space Validity of GPS sensorTimestamp format.
Definition: GPSFrame.h:273
DW_GPS_FIX_STATUS_2D_FIX
@ DW_GPS_FIX_STATUS_2D_FIX
2D fix
Definition: GPSFrame.h:171
dwGPSTimestampFormat
dwGPSTimestampFormat
Timestamp format of the GPS sensor, should be identical to dwVioTimestampFormat(i....
Definition: GPSFrame.h:30
dwGPSSignalValidityInfo::vdop
dwSignalValidity vdop
Validity of vertical dilusion of precision signal.
Definition: GPSFrame.h:224
DW_GPS_MODE_PPP_CONVERGED
@ DW_GPS_MODE_PPP_CONVERGED
GPS mode PPP converged. Most accurate mode for using PPP.
Definition: GPSFrame.h:159
dwGPSFrame::hacc
float64_t hacc
Definition: GPSFrame.h:357
dwGPSFixStatus
dwGPSFixStatus
GPS satellite fix status.
Definition: GPSFrame.h:166
dwGPSFrame::speedAccuracy
float64_t speedAccuracy
Definition: GPSFrame.h:455
DW_GPS_TIMESTAMP_QUALITY_FORCE32
@ DW_GPS_TIMESTAMP_QUALITY_FORCE32
Definition: GPSFrame.h:190
dwGPSFrame::gpsMode
dwGPSMode gpsMode
GPS mode.
Definition: GPSFrame.h:438
DW_GPS_MODE_PPP_CONVERGING
@ DW_GPS_MODE_PPP_CONVERGING
GPS mode PPP converging. Using PPP, but solution has not finished converging, so the data is not yet ...
Definition: GPSFrame.h:156
DW_GPS_TIMESTAMP_QUALITY_NOT_INIT
@ DW_GPS_TIMESTAMP_QUALITY_NOT_INIT
Not Initialized. still initializing.
Definition: GPSFrame.h:183
dwGPSSignalValidityInfo::sensorTimestamp
dwSignalValidity sensorTimestamp
Validity of sensor timestamp signal.
Definition: GPSFrame.h:266
DW_GPS_MODE_RTK_FLOAT
@ DW_GPS_MODE_RTK_FLOAT
GPS mode RTK float.
Definition: GPSFrame.h:150
dwGPSFrame::fixStatus
dwGPSFixStatus fixStatus
Definition: GPSFrame.h:387
DW_DEPRECATED_ENUM
@ DW_DEPRECATED_ENUM
Value of dwGPSFrame.latitude is valid.
Definition: GPSFrame.h:50
dwGPSFrame::speed
float64_t speed
Definition: GPSFrame.h:327
dwGPSFrame::longitude
float64_t longitude
Definition: GPSFrame.h:309
dwGPSSignalValidityInfo::longitude
dwSignalValidity longitude
Validity of longitude signal.
Definition: GPSFrame.h:206
DW_GPS_JAM_STATE_INIT
@ DW_GPS_JAM_STATE_INIT
GPS jam state init.
Definition: GPSFrame.h:101
dwGPSSignalValidityInfo
struct dwGPSSignalValidityInfo dwGPSSignalValidityInfo
This structure contains validity of each signal provided by GPS sensors.
DW_GPS_SPOOF_STATE_MULTI
@ DW_GPS_SPOOF_STATE_MULTI
GPS spoof state multi.
Definition: GPSFrame.h:119
dwGPSSpoofState
dwGPSSpoofState
The GPS spoof state gives spoofing-state detected by the GNSS-receiver.
Definition: GPSFrame.h:108
dwGPSSignalValidityInfo::fixStatus
dwSignalValidity fixStatus
Validity of 2D or 3D fix status signal.
Definition: GPSFrame.h:242
DW_GPS_SPOOF_STATE_NO
@ DW_GPS_SPOOF_STATE_NO
GPS spoof state no.
Definition: GPSFrame.h:113
dwGPSTimestampQuality
dwGPSTimestampQuality
GPS timestamp quality.
Definition: GPSFrame.h:181
dwGPSFrame::utcTime
char8_t utcTime[16]
UTC time as provided in the GPS package [hhmmss.sss] (null terminated).
Definition: GPSFrame.h:423
dwGPSMode
dwGPSMode
The GPS mode gives the status of the GNSS data.
Definition: GPSFrame.h:130
DW_GPS_MODE_UNKNOWN
@ DW_GPS_MODE_UNKNOWN
GPS mode unknown. The device cannot or has not reported the mode.
Definition: GPSFrame.h:132
dwGPSFrame::hdop
float64_t hdop
Definition: GPSFrame.h:339
DW_GPS_TIMESTAMP_QUALITY_OK
@ DW_GPS_TIMESTAMP_QUALITY_OK
Normal Operation. Functional and Electrical Checks Passed.
Definition: GPSFrame.h:186
dwGPSFrame::utcTimeUs
dwTime_t utcTimeUs
Definition: GPSFrame.h:369
dwGPSSignalValidityInfo::vacc
dwSignalValidity vacc
Validity of vertical accuracy of solution signal.
Definition: GPSFrame.h:233
dwTime_t
int64_t dwTime_t
Specifies a timestamp unit, in microseconds.
Definition: BasicTypes.h:54
dwGPSSignalValidityInfo::timestampQuality
dwSignalValidity timestampQuality
Validity of timestamp quality signal.
Definition: GPSFrame.h:245
dwGPSSignalValidityInfo::mode
dwSignalValidity mode
Validity of GPS mode signal.
Definition: GPSFrame.h:248
dwGPSSignalValidityInfo::satelliteCount
dwSignalValidity satelliteCount
Validity of satellite count signal.
Definition: GPSFrame.h:239
dwGPSFrame::timestampQuality
dwGPSTimestampQuality timestampQuality
Definition: GPSFrame.h:399
dwGPSFrame::mode
dwGPSMode mode
Definition: GPSFrame.h:418
dwGPSSignalValidityInfo::altitude
dwSignalValidity altitude
Validity of altitude signal.
Definition: GPSFrame.h:209
dwGPSFrame::climb
float64_t climb
Definition: GPSFrame.h:333
DW_GPS_JAM_STATE_OK
@ DW_GPS_JAM_STATE_OK
GPS jam state ok.
Definition: GPSFrame.h:92
dwGPSSignalValidityInfo::jamState
dwSignalValidity jamState
Validity of GPS jam state signal.
Definition: GPSFrame.h:260
dwGPSFrame::hostTimestamp
dwTime_t hostTimestamp
Definition: GPSFrame.h:494
char8_t
char char8_t
Definition: BasicTypes.h:47
DW_GPS_MODE_PRECISE_POINT
@ DW_GPS_MODE_PRECISE_POINT
GPS mode precise point. No RTK or PPP correction.
Definition: GPSFrame.h:144
dwGPSSignalValidityInfo::speedAccuracy
dwSignalValidity speedAccuracy
Validity of GPS speed accuracy signal.
Definition: GPSFrame.h:257
DW_GPS_TIMESTAMP_FORMAT_FORCE32
@ DW_GPS_TIMESTAMP_FORMAT_FORCE32
Definition: GPSFrame.h:42
dwGPSFrame::vdop
float64_t vdop
Definition: GPSFrame.h:345
dwGPSSignalValidityInfo::hdop
dwSignalValidity hdop
Validity of horizontal dilusion of precision signal.
Definition: GPSFrame.h:221
DW_GPS_FIX_STATUS_NO_FIX
@ DW_GPS_FIX_STATUS_NO_FIX
No fix.
Definition: GPSFrame.h:168
DW_DEPRECATED
#define DW_DEPRECATED(msg)
Definition: Exports.h:50
DW_GPS_JAM_STATE_CRITICAL
@ DW_GPS_JAM_STATE_CRITICAL
GPS jam state critical.
Definition: GPSFrame.h:98
DW_GPS_SPOOF_STATE_YES
@ DW_GPS_SPOOF_STATE_YES
GPS spoof state yes.
Definition: GPSFrame.h:116
dwGPSFrame::flags
uint32_t flags
The flags to show which values are valid in this GPS frame.
Definition: GPSFrame.h:433
DW_GPS_MODE_CODE_DIFFERENTIAL
@ DW_GPS_MODE_CODE_DIFFERENTIAL
GPS mode code differential. No RTK or PPP correction.
Definition: GPSFrame.h:147
dwGPSJamState
dwGPSJamState
The GPS jam state gives jamming state detected by the GNSS-receiver.
Definition: GPSFrame.h:87
dwGPSFrame::spoofState
dwGPSSpoofState spoofState
Definition: GPSFrame.h:483
dwGPSSignalValidityInfo::latitude
dwSignalValidity latitude
Validity of latitude signal.
Definition: GPSFrame.h:203
float64_t
double float64_t
Definition: BasicTypes.h:42
DW_GPS_MODE_DEAD_RECKONING
@ DW_GPS_MODE_DEAD_RECKONING
GPS mode dead reckoning. Device relying on IMU alone for updates.
Definition: GPSFrame.h:138
dwGPSSignalValidityInfo::course
dwSignalValidity course
Validity of course signal.
Definition: GPSFrame.h:212
dwGPSSignalValidityInfo::pdop
dwSignalValidity pdop
Validity of positional dilusion of precision signal.
Definition: GPSFrame.h:227
dwSignalValidity
uint8_t dwSignalValidity
Signal validity status.
Definition: SignalStatus.h:52
DW_GPS_TIMESTAMP_FORMAT_CCPLEX_TSC
@ DW_GPS_TIMESTAMP_FORMAT_CCPLEX_TSC
CCPLEX TSC timestamp format.
Definition: GPSFrame.h:41
DW_GPS_TIMESTAMP_QUALITY_SYNC_LOST
@ DW_GPS_TIMESTAMP_QUALITY_SYNC_LOST
Synchronization lost.
Definition: GPSFrame.h:189
dwGPSSignalValidityInfo::hacc
dwSignalValidity hacc
Validity of horizontal accuracy of solution signal.
Definition: GPSFrame.h:230
dwGPSFrame::utcDate
char8_t utcDate[16]
UTC date as provided in the GPS package [ddmmyy] (null terminated).
Definition: GPSFrame.h:428
DW_GPS_SPOOF_STATE_INIT
@ DW_GPS_SPOOF_STATE_INIT
GPS spoof state init.
Definition: GPSFrame.h:122
DW_GPS_FIX_STATUS_FORCE32
@ DW_GPS_FIX_STATUS_FORCE32
Definition: GPSFrame.h:175
DW_GPS_MODE_STAND_ALONE
@ DW_GPS_MODE_STAND_ALONE
GPS mode stand alone. No RTK or PPP correction.
Definition: GPSFrame.h:141
dwGPSFrame::latitude
float64_t latitude
Definition: GPSFrame.h:303
DW_GPS_SPOOF_STATE_FORCE32
@ DW_GPS_SPOOF_STATE_FORCE32
Definition: GPSFrame.h:123
dwGPSFlags
dwGPSFlags
Each flag shows if that value is valid in this GPS frame.
Definition: GPSFrame.h:48
dwGPSSignalValidityInfo::speed
dwSignalValidity speed
Validity of speed signal.
Definition: GPSFrame.h:215
dwGPSFrame::timestamp_us
dwTime_t timestamp_us
Definition: GPSFrame.h:297
dwGPSSignalValidityInfo::utcTimeUs
dwSignalValidity utcTimeUs
Validity of UTC time signal.
Definition: GPSFrame.h:236
dwGPSFrame::sensorTimestampFormat
dwGPSTimestampFormat sensorTimestampFormat
Definition: GPSFrame.h:503
dwGPSSignalValidityInfo
This structure contains validity of each signal provided by GPS sensors.
Definition: GPSFrame.h:197
dwGPSFrame::jamState
dwGPSJamState jamState
Definition: GPSFrame.h:469
dwGPSSignalValidityInfo::hostTimestamp
dwSignalValidity hostTimestamp
Validity of host timestamp signal.
Definition: GPSFrame.h:269
DW_GPS_FLAGS_FORCE32
@ DW_GPS_FLAGS_FORCE32
Definition: GPSFrame.h:81
DW_GPS_FIX_STATUS_3D_FIX
@ DW_GPS_FIX_STATUS_3D_FIX
3D fix
Definition: GPSFrame.h:174
DW_GPS_JAM_STATE_UNSPECIFIED
@ DW_GPS_JAM_STATE_UNSPECIFIED
GPS jam state unspecified.
Definition: GPSFrame.h:89
dwGPSFrame::validityInfo
dwGPSSignalValidityInfo validityInfo
Signal validity information.
Definition: GPSFrame.h:288
DW_GPS_JAM_STATE_FORCE32
@ DW_GPS_JAM_STATE_FORCE32
Definition: GPSFrame.h:102
dwGPSFrame::sensorTimestamp
dwTime_t sensorTimestamp
Definition: GPSFrame.h:489
DW_GPS_TIMESTAMP_FORMAT_PTP16
@ DW_GPS_TIMESTAMP_FORMAT_PTP16
16-bit fragment from PTP timer with resolution of 100us. Obtained by the following computation ((PTP_...
Definition: GPSFrame.h:38
DW_GPS_TIMESTAMP_FORMAT_PTP64
@ DW_GPS_TIMESTAMP_FORMAT_PTP64
64-bit PTP timestamp format. This format is assumed in case the validityInfo field does not indicate ...
Definition: GPSFrame.h:35
dwGPSFrame::satelliteCount
uint8_t satelliteCount
Definition: GPSFrame.h:376
DW_GPS_MODE_INVALID_GPS
@ DW_GPS_MODE_INVALID_GPS
GPS mode invalid. This GPS data cannot be used.
Definition: GPSFrame.h:135
dwGPSSignalValidityInfo::reserved
dwSignalValidity reserved[55]
Reserved space.
Definition: GPSFrame.h:276