Detailed Description

Defines the Radar sensor methods.

Data Structures
struct	dwRadarScan
	Defines the structure for a complete radar scan. More...

Macros
#define	DW_RADARSCAN_MINIMUM_PAYLOAD_SIZE 1744
	The minimum payload size is larger than sizeof(dwRadarScan) to allow custom types to use a larger payload. More...

Typedefs
typedef struct _dwRadarScanSSI	dwRadarScanSSI
	Not available as of current release. Will be added in future release. More...

Functions
DW_API_PUBLIC dwStatus	dwSensorRadar_getProperties (dwRadarProperties *const radarProperties, dwSensorHandle_t const sensor)
	Gets information about the radar sensor. More...

DW_API_PUBLIC dwStatus	dwSensorRadar_processRawData (const dwRadarScan *const data, const uint8_t const rawData, size_t const size, dwSensorHandle_t const sensor)
	Decodes raw data previously read onto the application side structure. More...

DW_API_PUBLIC dwStatus	dwSensorRadar_readData (const dwRadarScan **const data, const dwRadarScanType type, const dwTime_t timeoutUs, dwSensorHandle_t const sensor)
	Reads a single packet, which might be an entire scan or a fraction of a scan, which is sensor dependent. More...

DW_API_PUBLIC dwStatus	dwSensorRadar_readScan (const dwRadarScan **const data, const dwTime_t timeoutUs, dwSensorHandle_t const sensor)
	Reads a one scan chunk. More...

DW_API_PUBLIC dwStatus	dwSensorRadar_returnData (const dwRadarScan *const scan, dwSensorHandle_t const sensor)
	Returns the data read to the internal pool. More...

DW_API_PUBLIC dwStatus	dwSensorRadar_returnScan (const dwRadarScan *const scan, dwSensorHandle_t const sensor)
	Returns the data covering an entire scan read to the internal pool. More...

DW_API_PUBLIC dwStatus	dwSensorRadar_setDataDecoding (bool const enable, dwSensorHandle_t const sensor)
	Enables/disables the decoding of the Radar packets, which incurs in additional CPU load. More...

DW_API_PUBLIC dwStatus	dwSensorRadar_setMountPosition (dwRadarMountPosition *const data, dwSensorHandle_t const sensor)
	Sends the radar mount position information to the radar. More...

DW_API_PUBLIC dwStatus	dwSensorRadar_setVehicleState (dwRadarVehicleState *const data, dwSensorHandle_t const sensor)
	Sends vehicle dynamics information to the radar. More...

DW_API_PUBLIC dwStatus	dwSensorRadar_toggleScanType (bool const enable, dwRadarScanType const scanType, dwSensorHandle_t const sensor)
	Enables/Disables a scan type for the radar sensor. More...

Data Structure Documentation

◆ dwRadarScan

struct dwRadarScan

Data Fields
void *	data	Pointer to the array of returns (to be casted based on return type) Size of this array is numReturns.
dwRadarDetectionFFTPatch const *	detectionFFTPatch	Pointer to the array of dwRadarDetectionFFTPatch, size of this array is numReturns.
dwRadarDetectionMisc const *	detectionMisc	Pointer to the array of dwRadarDetectionMisc, size of this array is numReturns.
dwRadarDetectionProbability const *	detectionProbability	Pointer to the array of dwRadarDetectionProbability, size of this array is numReturns.
dwRadarDetectionQuality const *	detectionQuality	Pointer to the array of dwRadarDetectionQuality, size of this array is numReturns.
dwRadarDetectionStdDev const *	detectionStdDev	Pointer to the array of dwRadarDetectionStdDev, size of this array is numReturns.
float32_t	dopplerAmbiguity	Doppler ambiguity free range.
dwTime_t	hostTimestamp	Host timestamp at reception of first packet belonging to this scan (us)
uint32_t	numReturns	Number of radar returns in this scan.
dwRadarScanAmbiguity	radarScanAmbiguity	Radar Scan ambiguity.
dwRadarScanMisc	radarScanMisc	Radar Scan miscellaneous fields.
dwRadarScanSSI const *	radarSSI	radar supplement status info such as calibration info, health signal, performance
uint32_t	scanIndex	Sensor-provided scan index.
dwRadarScanType	scanType	Type of scan.
dwRadarScanValidity	scanValidity	Radar Scan validity If the signal is unavailable or invalid, the value of the signal will be the maximum number of the data type.
dwTime_t	sensorTimestamp	Sensor timestamp at which the current measurement scan was started (us)

Macro Definition Documentation

◆ DW_RADARSCAN_MINIMUM_PAYLOAD_SIZE

#define DW_RADARSCAN_MINIMUM_PAYLOAD_SIZE 1744

The minimum payload size is larger than sizeof(dwRadarScan) to allow custom types to use a larger payload.

Definition at line 56 of file Radar.h.

Typedef Documentation

◆ dwRadarScanSSI

typedef struct _dwRadarScanSSI dwRadarScanSSI

Not available as of current release. Will be added in future release.

Definition at line 62 of file Radar.h.

Function Documentation

◆ dwSensorRadar_getProperties()

DW_API_PUBLIC dwStatus dwSensorRadar_getProperties	(	dwRadarProperties *const	radarProperties,
		dwSensorHandle_t const	sensor
	)

Gets information about the radar sensor.

Parameters

[out]	radarProperties	A pointer to the struct containing the properties of the radar.
[in]	sensor	Sensor handle created with dwSAL_createSensor().

Return values

DW_INVALID_HANDLE	sensor handle is invalid.
DW_INVALID_ARGUMENT	input argurment invalid.
DW_SUCCESS	successful deal.

◆ dwSensorRadar_processRawData()

DW_API_PUBLIC dwStatus dwSensorRadar_processRawData	(	const dwRadarScan **const	data,
		const uint8_t *const	rawData,
		size_t const	size,
		dwSensorHandle_t const	sensor
	)

Decodes raw data previously read onto the application side structure.

This happens on the CPU thread where the function is called, incurring on additional load on that thread.

Parameters

[out]	data	A pointer to a container for the decoded data.
[in]	rawData	A pointer for the non-decoded Radar packet, as returned from 'dwSensor_readRawData()'.
[in]	size	Specifies the size in bytes of the raw data.
[in]	sensor	Specifies the sensor handle of the sensor previously created with 'dwSAL_createSensor()'.

Return values

DW_INVALID_HANDLE	sensor handle is invalid.
DW_INVALID_ARGUMENT	input argurment invalid.
DW_NOT_AVAILABLE	work stopped.
DW_SUCCESS	successful deal.
DW_TIME_OUT	time out.

Note: The returned dwRadarScan is only valid till the next 'dwSensorRadar_processRawData()' call.

◆ dwSensorRadar_readData()

DW_API_PUBLIC dwStatus dwSensorRadar_readData	(	const dwRadarScan **const	data,
		const dwRadarScanType	type,
		const dwTime_t	timeoutUs,
		dwSensorHandle_t const	sensor
	)

Reads a single packet, which might be an entire scan or a fraction of a scan, which is sensor dependent.

The pointer returned is to the internal data pool. DW guarantees that the data remains constant until returned by the application. The data must be explicitly returned by the application.

Parameters

[out]	data	A pointer to a pointer to the decoded data read from the sensor. The struct contains the numbers of points read, which depends on the sensor used.
[in]	type	Type of scan requested
[in]	timeoutUs	Specifies the timeout in microseconds. Special values: DW_TIMEOUT_INFINITE - to wait infinitly. Zero - means polling of internal queue.
[in]	sensor	Specifies the sensor handle of the sensor previously created with dwSAL_createSensor().

Return values

DW_INVALID_HANDLE	sensor handle is invalid.
DW_INVALID_ARGUMENT	input argurment invalid.
DW_NOT_AVAILABLE	work stopped.
DW_SUCCESS	successful deal.
DW_TIME_OUT	time out.

◆ dwSensorRadar_readScan()

DW_API_PUBLIC dwStatus dwSensorRadar_readScan	(	const dwRadarScan **const	data,
		const dwTime_t	timeoutUs,
		dwSensorHandle_t const	sensor
	)

Reads a one scan chunk.

The pointer returned is to the internal data pool. DW guarantees that the data remains constant until returned by the application. The data must be explicitly returned by the application.

Note: This method returns the oldest scan contained in the internal pool.

Parameters

[out]	data	A pointer to a pointer to a decoded scan from the sensor. The struct contains the numbers of points read, which depends on the sensor used.
[in]	timeoutUs	Specifies the timeout in microseconds. Special values: DW_TIMEOUT_INFINITE - to wait infinitly. Zero - means polling of internal queue.
[in]	sensor	Specifies the sensor handle of the sensor previously created with dwSAL_createSensor().

Return values

DW_INVALID_HANDLE	sensor handle is invalid.
DW_INVALID_ARGUMENT	input argurment invalid.
DW_NOT_AVAILABLE	work stopped.
DW_SUCCESS	successful deal.
DW_TIME_OUT	time out.

◆ dwSensorRadar_returnData()

DW_API_PUBLIC dwStatus dwSensorRadar_returnData	(	const dwRadarScan *const	scan,
		dwSensorHandle_t const	sensor
	)

Returns the data read to the internal pool.

At this point the pointer is still be valid, but data is changed based on newer readings of the sensor.

Parameters

[in]	scan	A pointer to the scan data previously read from the Radar using 'dwSensorRadar_readData()' to be returned to the pool.
[in]	sensor	Specifies the sensor handle of the sensor previously created with dwSAL_createSensor().

Return values

DW_INVALID_HANDLE	sensor handle is invalid.
DW_INVALID_ARGUMENT	input argurment invalid.
DW_NOT_AVAILABLE	work stopped.
DW_SUCCESS	successful deal.
DW_TIME_OUT	time out.

◆ dwSensorRadar_returnScan()

DW_API_PUBLIC dwStatus dwSensorRadar_returnScan	(	const dwRadarScan *const	scan,
		dwSensorHandle_t const	sensor
	)

Returns the data covering an entire scan read to the internal pool.

At this point the pointer is still be valid, but data is changed based on newer readings of the sensor.

Parameters

[in]	scan	A pointer to an entire scan's data previously read from the Radar using 'dwSensorRadar_readScan()' to be returned to the pool.
[in]	sensor	Specifies the sensor handle of the sensor previously created with dwSAL_createSensor().

Return values

DW_INVALID_HANDLE	sensor handle is invalid.
DW_INVALID_ARGUMENT	input argurment invalid.
DW_NOT_AVAILABLE	work stopped.
DW_SUCCESS	successful deal.
DW_TIME_OUT	time out.

◆ dwSensorRadar_setDataDecoding()

DW_API_PUBLIC dwStatus dwSensorRadar_setDataDecoding	(	bool const	enable,
		dwSensorHandle_t const	sensor
	)

Enables/disables the decoding of the Radar packets, which incurs in additional CPU load.

Method fails if the sensor has been started and is capturing data. Stop the sensor first.

Parameters

[in]	enable	Specifies TRUE when decoding, false if RAW data.
[in]	sensor	Specifies the sensor handle of the sensor previously created with dwSAL_createSensor()

Return values

DW_INVALID_HANDLE	sensor handle is invalid.
DW_CALL_NOT_ALLOWED	operation is not allowed now.
DW_SUCCESS	successful deal.

◆ dwSensorRadar_setMountPosition()

DW_API_PUBLIC dwStatus dwSensorRadar_setMountPosition	(	dwRadarMountPosition *const	data,
		dwSensorHandle_t const	sensor
	)

Sends the radar mount position information to the radar.

Parameters

[in]	data	A pointer to the struct containing the radar mount position information to send.
[in]	sensor	Sensor handle created with dwSAL_createSensor().

Return values

DW_INVALID_HANDLE	sensor handle is invalid.
DW_INVALID_ARGUMENT	input argurment invalid.
DW_SUCCESS	successful deal.

◆ dwSensorRadar_setVehicleState()

DW_API_PUBLIC dwStatus dwSensorRadar_setVehicleState	(	dwRadarVehicleState *const	data,
		dwSensorHandle_t const	sensor
	)

Sends vehicle dynamics information to the radar.

Parameters

[in]	data	A pointer to the struct containing the vehicle dynamics information to send
[in]	sensor	Sensor handle created with dwSAL_createSensor().

Return values

DW_INVALID_HANDLE	sensor handle is invalid.
DW_INVALID_ARGUMENT	input argurment invalid.
DW_SUCCESS	successful deal.

◆ dwSensorRadar_toggleScanType()

DW_API_PUBLIC dwStatus dwSensorRadar_toggleScanType	(	bool const	enable,
		dwRadarScanType const	scanType,
		dwSensorHandle_t const	sensor
	)

Enables/Disables a scan type for the radar sensor.

Method fails if the sensor does not support the specified scan type OR the sensor has been started and is capturing data.

Parameters

[in]	enable	Specifies if the scan should be enabled or disabled
[in]	scanType	Specifies the scan type to enable
[in]	sensor	Specifies the sensor handle of the sensor previously created with dwSAL_createSensor().

Return values

DW_INVALID_HANDLE	sensor handle is invalid.
DW_INVALID_ARGUMENT	input argurment invalid.
DW_CALL_NOT_ALLOWED	operation is not allowed now.
DW_SUCCESS	successful deal.

Detailed Description

Data Structures

Macros

Typedefs

Functions

Data Structure Documentation

◆ dwRadarScan

Macro Definition Documentation

◆ DW_RADARSCAN_MINIMUM_PAYLOAD_SIZE

Typedef Documentation

◆ dwRadarScanSSI

Function Documentation

◆ dwSensorRadar_getProperties()

◆ dwSensorRadar_processRawData()

◆ dwSensorRadar_readData()

◆ dwSensorRadar_readScan()

◆ dwSensorRadar_returnData()

◆ dwSensorRadar_returnScan()

◆ dwSensorRadar_setDataDecoding()

◆ dwSensorRadar_setMountPosition()

◆ dwSensorRadar_setVehicleState()

◆ dwSensorRadar_toggleScanType()