DriveWorks SDK Reference
5.8.83 Release
For Test and Development only

Sensors.h
Go to the documentation of this file.
1
2//
3// Notice
4// ALL NVIDIA DESIGN SPECIFICATIONS AND CODE ("MATERIALS") ARE PROVIDED "AS IS" NVIDIA MAKES
5// NO REPRESENTATIONS, WARRANTIES, EXPRESSED, IMPLIED, STATUTORY, OR OTHERWISE WITH RESPECT TO
6// THE MATERIALS, AND EXPRESSLY DISCLAIMS ANY IMPLIED WARRANTIES OF NONINFRINGEMENT,
7// MERCHANTABILITY, OR FITNESS FOR A PARTICULAR PURPOSE.
8//
9// NVIDIA CORPORATION & AFFILIATES assumes no responsibility for the consequences of use of such
10// information or for any infringement of patents or other rights of third parties that may
11// result from its use. No license is granted by implication or otherwise under any patent
12// or patent rights of NVIDIA CORPORATION & AFFILIATES. No third party distribution is allowed unless
13// expressly authorized by NVIDIA. Details are subject to change without notice.
14// This code supersedes and replaces all information previously supplied.
15// NVIDIA CORPORATION & AFFILIATES products are not authorized for use as critical
16// components in life support devices or systems without express written approval of
17// NVIDIA CORPORATION & AFFILIATES.
18//
19// SPDX-FileCopyrightText: Copyright (c) 2016-2022 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
20// SPDX-License-Identifier: LicenseRef-NvidiaProprietary
21//
22// NVIDIA CORPORATION, its affiliates and licensors retain all intellectual
23// property and proprietary rights in and to this material, related
24// documentation and any modifications thereto. Any use, reproduction,
25// disclosure or distribution of this material and related documentation
26// without an express license agreement from NVIDIA CORPORATION or
27// its affiliates is strictly prohibited.
28//
30
54#ifndef DW_SENSORS_SENSORS_H_
55#define DW_SENSORS_SENSORS_H_
56
58#include <dw/core/base/Types.h>
62
63#ifdef __cplusplus
64extern "C" {
65#endif
66
68typedef enum dwPlatformOS {
71
74
77
81
83typedef struct dwSALObject* dwSALHandle_t;
84
86typedef struct dwSensorObject* dwSensorHandle_t;
87
89#define DW_SENSOR_MAX_PROTOCOL_NAME_LENGTH 32
91#define DW_SENSOR_MAX_PARAMETER_STRING_LENGTH 512
92
94typedef struct dwSensorParams
95{
99 const char8_t* protocol;
100
106 const char8_t* parameters;
107
113 const void* auxiliarydata;
114
116
121
124
127
130
133
135typedef struct dwSensorStats
136{
138 uint64_t events;
139
141 uint64_t errors;
142
144 uint64_t drops;
145
149
153
157
161
165
169
173
177
181
186
188typedef enum dwSensorType {
200
203{
206
208 uint64_t event;
209
211 uint64_t offset;
212
214 uint64_t size;
215
217
218//Holds the available seek table entries for the sensor
219typedef struct dwSensorSeekTable
220{
222 uint64_t* timestamp;
223 uint64_t* offset;
224 uint64_t* frameNum;
225 size_t* frameSize;
227
228typedef struct dwSensorTsAndID
229{
230 uint64_t sensorId;
233
245
250{
252 struct
253 {
261
264
267
270
274
276#define DW_SENSOR_ERROR_ID_OFFSET_BIT 24U
278#define DW_SENSOR_ERROR_ID_OFFSET (1U << DW_SENSOR_ERROR_ID_OFFSET_BIT)
279
284typedef enum dwSensorErrorID {
290
304
317
332
353
371
387
400
413dwStatus dwSAL_getPlatformInfo(char8_t const** const osName, dwPlatformOS const os, dwSALHandle_t const sal);
414
430dwStatus dwSAL_getNumSensors(uint32_t* const num, dwPlatformOS const os, dwSALHandle_t const sal);
431
445dwStatus dwSAL_getSensorProtocol(const char** const name, uint32_t const idx, dwPlatformOS const os, dwSALHandle_t const sal);
446
463dwStatus dwSAL_getSensorParameterString(const char** const parameters, uint32_t const idx,
464 dwPlatformOS const os, dwSALHandle_t const sal);
465
479
501
514
529
553dwStatus dwSensor_readRawData(const uint8_t** const data, size_t* const size,
554 dwTime_t const timeoutUs,
555 dwSensorHandle_t const sensor);
556
571dwStatus dwSensor_returnRawData(const uint8_t* const data, dwSensorHandle_t const sensor);
572
589dwStatus dwSensor_getSeekRange(size_t* const eventCount,
590 dwTime_t* const startTimestampUs, dwTime_t* const endTimestampUs,
591 dwSensorHandle_t const sensor);
592
608
609/*
610 * Returns a pointer to the shared buffer with the contents of the sensor header and bufferSize
611 * will contain the number of valid bytes in the buffer.
612 *
613 * @param[out] - buffer A pointer to the buffer owned by sensor which holds the header information.
614 * @param[out] - bufferSize A pointer to variable indicating number of valid bytes in the buffer
615 * @param[in] - sensor Handle to the sensor to which the header info is requested
616 *
617 * @return DW_INVALID_HANDLE - if given sensor handle is invalid
618 * DW_INVALID_ARGUMENTS - if given arguments are invalid
619 * DW_SUCCESS
620 */
621dwStatus dwSensor_getHeader(uint8_t const** const buffer, size_t* bufferSize, dwSensorHandle_t const sensor);
622
640dwStatus dwSensor_seekToTime(dwTime_t const timestampUs, dwSensorHandle_t const sensor);
641
658dwStatus dwSensor_seekToEvent(size_t const event, dwSensorHandle_t const sensor);
659
679
694
711dwStatus dwSensor_getSeekTableEntries(dwSensorSeekTableEntry* const entries, size_t const numEntries, dwSensorHandle_t const sensor);
712
737dwStatus dwSensor_saveSeekTable(const char* const fileName, dwSensorHandle_t const sensor);
738
760dwStatus dwSensor_setThreadPriority(int32_t const priority, dwSensorHandle_t const sensor);
761
782dwStatus dwSensor_setThreadAffinity(uint32_t const affinityMask, dwSensorHandle_t const sensor);
783
797
798#ifdef __cplusplus
799}
800#endif
801
803#endif // DW_SENSORS_SENSORS_H_
DriveWorks API: Signal Status Library
NVIDIA DriveWorks API: Core Types
NVIDIA DriveWorks API: Core Methods
NVIDIA DriveWorks API: Core Exports
struct dwContextObject * dwContextHandle_t
Context handle.
Definition: Context.h:82
#define DW_API_PUBLIC
Definition: Exports.h:54
uint8_t dwSignalValidity
The type of the encoded status field.
Definition: SignalStatus.h:57
dwStatus
Status definition.
Definition: Status.h:171
float float32_t
Specifies POD types.
Definition: Types.h:70
int64_t dwTime_t
Specifies a timestamp unit, in microseconds.
Definition: Types.h:82
double float64_t
Definition: Types.h:71
dwTime_t timeDeltaMax
Maximum observed host timestamp difference between two consecutive packets.
Definition: Sensors.h:156
float64_t standardDeviationDelta[DW_SENSOR_STATE_SENSOR_STAT_COUNT]
Array of Variance of all the deltas between consecutive timestamps as per the dwSensorStatTimeDiffere...
Definition: Sensors.h:180
uint64_t event
counter of this event
Definition: Sensors.h:208
uint64_t offset
offset into a file of this event
Definition: Sensors.h:211
const void * auxiliarydata
Additional data to pass to sensor creation function.
Definition: Sensors.h:113
dwTime_t minDelta[DW_SENSOR_STATE_SENSOR_STAT_COUNT]
Array of Minimum observed time difference between two consecutive packets as per the dwSensorStatTime...
Definition: Sensors.h:172
uint64_t * offset
Definition: Sensors.h:223
struct dwSensorVehicleState::@2 validityInfo
Validity info.
uint64_t sensorId
Definition: Sensors.h:230
uint64_t errors
Number of encountered errors.
Definition: Sensors.h:141
uint64_t drops
Number of events dropped.
Definition: Sensors.h:144
size_t * frameSize
Definition: Sensors.h:225
uint64_t events
Number of normal events (excluding errors and drops).
Definition: Sensors.h:138
float64_t meanDelta[DW_SENSOR_STATE_SENSOR_STAT_COUNT]
Array of Mean of all the deltas between consecutive timestamps as per the dwSensorStatTimeDifference.
Definition: Sensors.h:184
dwTime_t timestamp_us
Timestamp for the current message.
Definition: Sensors.h:263
uint64_t * timestamp
Definition: Sensors.h:222
dwTime_t timeDeltaMin
Minimum observed host timestamp difference between two consecutive packets.
Definition: Sensors.h:152
float64_t timeDeltaStandardDeviation
Variance of all the deltas between consecutive host timestamps.
Definition: Sensors.h:160
size_t numEntries
Definition: Sensors.h:221
dwTime_t currentDelta[DW_SENSOR_STATE_SENSOR_STAT_COUNT]
Array of Current time difference between two consecutive packets as per the dwSensorStatTimeDifferenc...
Definition: Sensors.h:168
dwSensorDrivingDirection direction
driving direction
Definition: Sensors.h:272
float32_t speed
vehicle velocity (m/s)
Definition: Sensors.h:266
dwTime_t maxDelta[DW_SENSOR_STATE_SENSOR_STAT_COUNT]
Array of Maximum observed time difference between two consecutive packets as per the dwSensorStatTime...
Definition: Sensors.h:176
float64_t timeDeltaMean
Mean of all the deltas between consecutive host timestamps.
Definition: Sensors.h:164
const char8_t * parameters
Array to additional parameters provided to sensor creation.
Definition: Sensors.h:106
dwTime_t timeDeltaCur
Current host timestamp difference between two consecutive packets.
Definition: Sensors.h:148
dwTime_t timestamp
Definition: Sensors.h:231
uint64_t size
size of the event present in the virtual data file, in bytes
Definition: Sensors.h:214
const char8_t * protocol
Name of the protocol.
Definition: Sensors.h:99
dwTime_t timestamp
timestamp of this entry
Definition: Sensors.h:205
float32_t temperature
ambient temperature (C)
Definition: Sensors.h:269
uint64_t * frameNum
Definition: Sensors.h:224
DW_API_PUBLIC dwStatus dwSensor_getNumSeekTableEntries(size_t *const size, dwSensorHandle_t const hsensor)
Get the number of entries in the seek Table.
DW_API_PUBLIC dwStatus dwSensor_createSeekTable(dwSensorHandle_t const sensor)
Forces recreation of the seek table, for sensors that support seeking.
DW_API_PUBLIC dwStatus dwSensor_getStats(dwSensorStats *const stats, dwSensorHandle_t const sensor)
Gets sensor statistics (if available).
dwSensorStatTimeDifference
Defines the various delta used in statistics.
Definition: Sensors.h:118
DW_API_PUBLIC dwStatus dwSensor_reset(dwSensorHandle_t const sensor)
Resets the sensor.
DW_API_PUBLIC dwStatus dwSAL_getPlatform(dwPlatformOS *const os, dwSALHandle_t sal)
Gets current platform the SDK is running on.
DW_API_PUBLIC dwStatus dwSensor_setThreadPriority(int32_t const priority, dwSensorHandle_t const sensor)
Sets the priority of the internal thread, for sensors that use an internal thread to communicate to t...
DW_API_PUBLIC dwStatus dwSensor_saveSeekTable(const char *const fileName, dwSensorHandle_t const sensor)
Saves the seek table for the sensor to a file, for sensors that support seek tables.
DW_API_PUBLIC dwStatus dwSAL_setVehicleState(dwSensorVehicleState *const vehicleState, dwSALHandle_t const sal)
Pass vehicle state to all sensors.
dwStatus dwSensor_getHeader(uint8_t const **const buffer, size_t *bufferSize, dwSensorHandle_t const sensor)
DW_API_PUBLIC dwStatus dwSAL_createSensor(dwSensorHandle_t *const sensor, dwSensorParams const params, dwSALHandle_t const sal)
Creates a new sensor managed by the SAL module with the given parameters.
DW_API_PUBLIC dwStatus dwSensor_start(dwSensorHandle_t const sensor)
Starts the sensor previously successfully created with 'dwSAL_createSensor()'.
DW_API_PUBLIC dwStatus dwSAL_start(dwSALHandle_t const sal)
Bootstraps all sensors managed by the SAL module.
struct dwSALObject * dwSALHandle_t
Handle representing the Sensor Abstraction Layer interface.
Definition: Sensors.h:83
DW_API_PUBLIC dwStatus dwSensor_getSeekRange(size_t *const eventCount, dwTime_t *const startTimestampUs, dwTime_t *const endTimestampUs, dwSensorHandle_t const sensor)
Retrieves the valid range of seek parameters, for sensors that support seeking.
DW_API_PUBLIC dwStatus dwSAL_release(dwSALHandle_t const sal)
Releases the SAL (sensor abstraction layer) module.
DW_API_PUBLIC dwStatus dwSensor_seekToEvent(size_t const event, dwSensorHandle_t const sensor)
Seeks the sensor to an event, for sensors that support seeking.
DW_API_PUBLIC dwStatus dwSAL_getNumSensors(uint32_t *const num, dwPlatformOS const os, dwSALHandle_t const sal)
Gets number of available sensors for a platform.
DW_API_PUBLIC dwStatus dwSensor_stop(dwSensorHandle_t const sensor)
Stops the sensor.
DW_API_PUBLIC dwStatus dwSAL_initialize(dwSALHandle_t *const sal, dwContextHandle_t const context)
Creates and initializes a SAL (sensor abstraction layer) module.
dwSensorDrivingDirection
Driving Direction options.
Definition: Sensors.h:237
DW_API_PUBLIC dwStatus dwSensor_readRawData(const uint8_t **const data, size_t *const size, dwTime_t const timeoutUs, dwSensorHandle_t const sensor)
Reads RAW data from sensor as byte array.
DW_API_PUBLIC dwStatus dwSensor_returnRawData(const uint8_t *const data, dwSensorHandle_t const sensor)
Returns RAW data to sensor as a byte array.
DW_API_PUBLIC dwStatus dwSAL_getPlatformInfo(char8_t const **const osName, dwPlatformOS const os, dwSALHandle_t const sal)
Gets detailed information about the running hardware platform and operating system.
DW_API_PUBLIC dwStatus dwSAL_getSensorProtocol(const char **const name, uint32_t const idx, dwPlatformOS const os, dwSALHandle_t const sal)
Gets protocol name of a sensor for a given index, e.g., 'camera.gmsl' or 'can.file'.
DW_API_PUBLIC dwStatus dwSAL_releaseSensor(dwSensorHandle_t const sensor)
Releases a sensor managed by the SAL module.
dwSensorType
Defines the type of sensors that are available in DriveWorks.
Definition: Sensors.h:188
dwPlatformOS
Defines the operating system in use.
Definition: Sensors.h:68
DW_API_PUBLIC dwStatus dwSensor_setThreadAffinity(uint32_t const affinityMask, dwSensorHandle_t const sensor)
Sets the affinity of the internal thread, for sensors that use an internal thread to communicate to t...
DW_API_PUBLIC dwStatus dwSAL_getSensorParameterString(const char **const parameters, uint32_t const idx, dwPlatformOS const os, dwSALHandle_t const sal)
Gets the parameter string acceptable by a sensor.
DW_API_PUBLIC dwStatus dwSensor_getSeekTableEntries(dwSensorSeekTableEntry *const entries, size_t const numEntries, dwSensorHandle_t const sensor)
Fill in the pre-allocated dwSensorSeekTableEntry array.
dwSensorErrorID
Sensor Error ID to be used in, e.g., dwErrorSignal.errorID[31:24] when DW_SENSOR_ERROR_CODE_OFFSET_BI...
Definition: Sensors.h:284
struct dwSensorObject * dwSensorHandle_t
Handle representing a sensor.
Definition: Sensors.h:86
DW_API_PUBLIC dwStatus dwSensor_getCurrentSeekPosition(size_t *const event, dwSensorHandle_t const sensor)
Gets the current seek position of the sensor.
DW_API_PUBLIC dwStatus dwSensor_seekToTime(dwTime_t const timestampUs, dwSensorHandle_t const sensor)
Seeks the sensor to a specific timestamp, for sensors that support seeking.
DW_API_PUBLIC dwStatus dwSAL_reset(dwSALHandle_t const sal)
Resets the SAL (sensor abstraction layer) module.
@ DW_SENSOR_STATE_DELTA_HOST_AND_SENSOR_TIME
Difference between host timestamp and sensor timestamp.
Definition: Sensors.h:126
@ DW_SENSOR_STATE_DELTA_HOST_AND_HOST_TIME
Difference between two consecutive host timestamp.
Definition: Sensors.h:120
@ DW_SENSOR_STATE_SENSOR_STAT_COUNT
Definition: Sensors.h:131
@ DW_SENSOR_STATE_DELTA_SENSOR_AND_SENSOR_TIME
Difference between two consecutive sensor timestamp.
Definition: Sensors.h:123
@ DW_SENSOR_STATE_DELTA_CURRENT_AND_HOST_TIME
Difference between current time and the last host timestamp when sensor data was received.
Definition: Sensors.h:129
@ DW_SENSOR_DRIVING_DIRECTION_UNKNOWN
Driving direction is unknown or no moving.
Definition: Sensors.h:239
@ DW_SENSOR_DRIVING_DIRECTION_FORWARD
Driving direction is fowarding.
Definition: Sensors.h:241
@ DW_SENSOR_DRIVING_DIRECTION_BACKWARD
Driving direction is backwarding.
Definition: Sensors.h:243
@ DW_SENSOR_LIDAR
Definition: Sensors.h:190
@ DW_SENSOR_ULTRASONIC
Definition: Sensors.h:197
@ DW_SENSOR_COUNT
Definition: Sensors.h:198
@ DW_SENSOR_CAN
Definition: Sensors.h:193
@ DW_SENSOR_IMU
Definition: Sensors.h:192
@ DW_SENSOR_RADAR
Definition: Sensors.h:194
@ DW_SENSOR_CAMERA
Definition: Sensors.h:189
@ DW_SENSOR_GPS
Definition: Sensors.h:191
@ DW_SENSOR_TIME
Definition: Sensors.h:195
@ DW_SENSOR_DATA
Definition: Sensors.h:196
@ DW_PLATFORM_OS_V5Q
aarch64 based Drive 5 QNX.
Definition: Sensors.h:76
@ DW_PLATFORM_OS_V5L
aarch64 based Drive 5 Linux.
Definition: Sensors.h:73
@ DW_PLATFORM_OS_LINUX
Default Linux based platform.
Definition: Sensors.h:70
@ DW_PLATFORM_NUM
Number of available platforms.
Definition: Sensors.h:79
@ DW_SENSOR_ERROR_CODE_NO_NEW_DATA
no new data received
Definition: Sensors.h:288
@ DW_SENSOR_ERROR_CODE_INVALID
sensor ok
Definition: Sensors.h:286
Holds sets of parameters for sensor creation.
Definition: Sensors.h:95
A seek structure is made of memory offset, eventcount and timestamp.
Definition: Sensors.h:203
Holds the available statistics for a sensor.
Definition: Sensors.h:136
Vehicle State inputs.
Definition: Sensors.h:250
NVIDIA DriveWorks API: Health Signal Methods