Functions
Device

Radar Device Management Module. More...

Functions

MMWL_EXPORT rlReturnVal_t rlDevicePowerOn (rlUInt8_t deviceMap, rlClientCbs_t clientCb)
 Bring mmwave Device Out of Reset. More...
 
MMWL_EXPORT rlReturnVal_t rlDeviceAddDevices (rlUInt8_t deviceMap)
 Bring mmwave Device Out of Reset. More...
 
MMWL_EXPORT rlReturnVal_t rlDeviceRemoveDevices (rlUInt8_t deviceMap)
 Removes connected mmwave devices. More...
 
MMWL_EXPORT rlReturnVal_t rlDevicePowerOff (void)
 Shutdown mmwave Device. More...
 
MMWL_EXPORT rlReturnVal_t rlDeviceRfStart (rlUInt8_t deviceMap)
 Enables mmwave RF/Analog Sub system. More...
 
MMWL_EXPORT rlReturnVal_t rlDeviceFileDownload (rlUInt8_t deviceMap, rlFileData_t *data, rlUInt16_t remChunks)
 Download mmwave Firmware/Patches over SPI. More...
 
MMWL_EXPORT rlReturnVal_t rlDeviceGetMssVersion (rlUInt8_t deviceMap, rlFwVersionParam_t *data)
 Get mmWave Master SS version. More...
 
MMWL_EXPORT rlReturnVal_t rlDeviceGetRfVersion (rlUInt8_t deviceMap, rlFwVersionParam_t *data)
 Get mmWave RF ROM and patch version. More...
 
MMWL_EXPORT rlReturnVal_t rlDeviceGetVersion (rlUInt8_t deviceMap, rlVersion_t *data)
 Get mmWave Hardware, Firmware/patch and mmWaveLink version. More...
 
MMWL_EXPORT rlReturnVal_t rlDeviceGetMmWaveLinkVersion (rlSwVersionParam_t *data)
 Get mmWaveLink Version. More...
 
MMWL_EXPORT rlReturnVal_t rlDeviceMcuClkConfig (rlUInt8_t deviceMap, rlMcuClkCfg_t *data)
 Sets the configurations to setup the desired frequency of the MCU Clock. More...
 
MMWL_EXPORT rlReturnVal_t rlDevicePmicClkConfig (rlUInt8_t deviceMap, rlPmicClkCfg_t *data)
 Sets the configurations for PMIC clock. More...
 
MMWL_EXPORT rlReturnVal_t rlDeviceLatentFaultTests (rlUInt8_t deviceMap, rllatentFault_t *data)
 Sets the configurations for latent fault test. More...
 
MMWL_EXPORT rlReturnVal_t rlDeviceEnablePeriodicTests (rlUInt8_t deviceMap, rlperiodicTest_t *data)
 Sets the configurations for periodic test. More...
 
MMWL_EXPORT rlReturnVal_t rlDeviceSetTestPatternConfig (rlUInt8_t deviceMap, rltestPattern_t *data)
 Setup for test pattern to be generated. More...
 
MMWL_EXPORT rlReturnVal_t rlDeviceConfigureCrc (rlCrcType_t crcType)
 Configures the CRC Type in mmWaveLink Driver. More...
 
MMWL_EXPORT rlReturnVal_t rlDeviceConfigureAckTimeout (rlUInt32_t ackTimeout)
 Configures the Acknowledgement timeout in mmWaveLink Driver. More...
 
MMWL_EXPORT rlReturnVal_t rlDeviceSetContStreamingModeConfig (rlUInt8_t deviceMap, rlDevContStreamingModeCfg_t *data)
 Sets Continous Streaming Mode Configuration. More...
 
MMWL_EXPORT rlReturnVal_t rlDeviceGetContStreamingModeConfig (rlUInt8_t deviceMap, rlDevContStreamingModeCfg_t *data)
 Gets continuous Streaming Mode Configuration. More...
 
MMWL_EXPORT rlReturnVal_t rlDeviceSetMiscConfig (rlUInt8_t deviceMap, rlDevMiscCfg_t *data)
 Setup misc. device configurations. More...
 

Detailed Description

Radar Device Management Module.

The Device module has interface for Enabling and controlling Radar device. Configures the callbacks(SPI, Interrupt, OS etc) for communication with device It also allows Firmware download over SPI.

Related Files

Function Documentation

rlReturnVal_t rlDeviceAddDevices ( rlUInt8_t  deviceMap)

Bring mmwave Device Out of Reset.

Parameters
[in]deviceMap- bitmap of devices to be connected
Returns
rlReturnVal_t Success - 0, Failure - Error Code

Bring mmwave Device Out of Reset. Application should wait for async event subBlock RL_DEV_AE_MSSPOWERUPDONE_SB before issuing any other APIs. This API is valid only for casecade mode of AWR1243 mmWave device when mmWaveLink instance is running on External Host Processor.

Definition at line 171 of file rl_device.c.

rlReturnVal_t rlDeviceConfigureAckTimeout ( rlUInt32_t  ackTimeout)

Configures the Acknowledgement timeout in mmWaveLink Driver.

Parameters
[in]ackTimeout- ACK timeout, 0 - No ACK
Returns
rlReturnVal_t Success - 0, Failure - Error Code

Configures the Acknowledgement timeout in mmWaveLink Driver, 0 - Disable ACK

Definition at line 1702 of file rl_device.c.

rlReturnVal_t rlDeviceConfigureCrc ( rlCrcType_t  crcType)

Configures the CRC Type in mmWaveLink Driver.

Parameters
[in]crcType- CRC Types, 0 - No CRC
Returns
rlReturnVal_t Success - 0, Failure - Error Code

Configures the CRC Type in mmWaveLink Driver

Definition at line 1685 of file rl_device.c.

rlReturnVal_t rlDeviceEnablePeriodicTests ( rlUInt8_t  deviceMap,
rlperiodicTest_t data 
)

Sets the configurations for periodic test.

Parameters
[in]deviceMap- Bitmap of devices to send the message
[in]data- Container for periodic test Configuration
Returns
rlReturnVal_t Success - 0, Failure - Error Code

Sets the configurations for periodic test. This API is valid only for AWR1243 mmWave device when mmWaveLink instance is running on External Host Processor.

Definition at line 1547 of file rl_device.c.

rlReturnVal_t rlDeviceFileDownload ( rlUInt8_t  deviceMap,
rlFileData_t data,
rlUInt16_t  remChunks 
)

Download mmwave Firmware/Patches over SPI.

Parameters
[in]deviceMap- Bitmap of devices to send the message
[in]data- File Chunk
[in]remChunks- Number of remaining Chunks
Returns
rlReturnVal_t Success - 0, Failure - Error Code

Download mmwave Firmware/Patches over SPI. This API is valid only for AWR1243 mmWave device when mmWaveLink instance is running on External Host Processor.

Definition at line 361 of file rl_device.c.

rlReturnVal_t rlDeviceGetContStreamingModeConfig ( rlUInt8_t  deviceMap,
rlDevContStreamingModeCfg_t data 
)

Gets continuous Streaming Mode Configuration.

Parameters
[in]deviceMap- Bitmap of devices to send the message
[out]data- Container for continuous Streaming Mode Configuration
Returns
rlReturnVal_t Success - 0, Failure - Error Code

Gets continuous Streaming Mode Configuration. This API is valid only for AWR1243 mmWave device when mmWaveLink instance is running on External Host Processor

Definition at line 1125 of file rl_device.c.

rlReturnVal_t rlDeviceGetMmWaveLinkVersion ( rlSwVersionParam_t data)

Get mmWaveLink Version.

Parameters
[out]data- Container for Version Information
Returns
rlReturnVal_t Success - 0, Failure - Error Code

Get mmWaveLink Version

Definition at line 547 of file rl_device.c.

rlReturnVal_t rlDeviceGetMssVersion ( rlUInt8_t  deviceMap,
rlFwVersionParam_t data 
)

Get mmWave Master SS version.

Parameters
[in]deviceMap- Bitmap of devices to send the message
[out]data- Container for Version Information
Returns
rlReturnVal_t Success - 0, Failure - Error Code

Get mmWave Master SS version. This API is valid only for AWR1243 mmWave device when mmWaveLink instance is running on External Host Processor.

Definition at line 421 of file rl_device.c.

rlReturnVal_t rlDeviceGetRfVersion ( rlUInt8_t  deviceMap,
rlFwVersionParam_t data 
)

Get mmWave RF ROM and patch version.

Parameters
[in]deviceMap- Bitmap of devices to send the message
[out]data- Container for Version Information
Returns
rlReturnVal_t Success - 0, Failure - Error Code

Get mmWave RF ROM and patch version

Definition at line 458 of file rl_device.c.

rlReturnVal_t rlDeviceGetVersion ( rlUInt8_t  deviceMap,
rlVersion_t data 
)

Get mmWave Hardware, Firmware/patch and mmWaveLink version.

Parameters
[in]deviceMap- Bitmap of devices to send the message
[out]data- Container for Version Information
Returns
rlReturnVal_t Success - 0, Failure - Error Code

Get mmWave Hardware, Firmware/patch and mmWaveLink version

Definition at line 490 of file rl_device.c.

rlReturnVal_t rlDeviceLatentFaultTests ( rlUInt8_t  deviceMap,
rllatentFault_t data 
)

Sets the configurations for latent fault test.

Parameters
[in]deviceMap- Bitmap of devices to send the message
[in]data- Container for latent fault test Configuration
Returns
rlReturnVal_t Success - 0, Failure - Error Code

Sets the configurations for latent fault test. This API is valid only for AWR1243 mmWave device when mmWaveLink instance is running on External Host Processor.

Definition at line 1501 of file rl_device.c.

rlReturnVal_t rlDeviceMcuClkConfig ( rlUInt8_t  deviceMap,
rlMcuClkCfg_t data 
)

Sets the configurations to setup the desired frequency of the MCU Clock.

Parameters
[in]deviceMap- Bitmap of devices to send the message
[in]data- Container for MCU clock Configuration
Returns
rlReturnVal_t Success - 0, Failure - Error Code

Sets the configurations to setup the desired frequency of the MCU Clock. This API is valid only for AWR1243 mmWave device when mmWaveLink instance is running on External Host Processor.

Definition at line 1409 of file rl_device.c.

rlReturnVal_t rlDevicePmicClkConfig ( rlUInt8_t  deviceMap,
rlPmicClkCfg_t data 
)

Sets the configurations for PMIC clock.

Parameters
[in]deviceMap- Bitmap of devices to send the message
[in]data- Container for PMIC clock Configuration
Returns
rlReturnVal_t Success - 0, Failure - Error Code

Sets the configurations for PMIC clock. This API is valid only for AWR1243 mmWave device when mmWaveLink instance is running on External Host Processor.

Definition at line 1455 of file rl_device.c.

rlReturnVal_t rlDevicePowerOff ( void  )

Shutdown mmwave Device.

Returns
rlReturnVal_t Success - 0, Failure - Error Code

Stops mmwave operations and also shuts down mmwave device

Definition at line 258 of file rl_device.c.

rlReturnVal_t rlDevicePowerOn ( rlUInt8_t  deviceMap,
rlClientCbs_t  clientCb 
)

Bring mmwave Device Out of Reset.

Parameters
[in]deviceMap- bitmap of all the connected Device
[in]clientCb- Client Callbacks for OS/SPI/Interrupts etc
Returns
rlReturnVal_t Success - 0, Failure - Error Code

Bring mmwave Device Out of Reset. Application should wait for async event of subBlock RL_DEV_AE_MSSPOWERUPDONE_SB (in case of AWR1243) before issuing any other APIs

Definition at line 96 of file rl_device.c.

rlReturnVal_t rlDeviceRemoveDevices ( rlUInt8_t  deviceMap)

Removes connected mmwave devices.

Parameters
[in]deviceMap- Bitmap of mmwave devices to be disconnected
Returns
rlReturnVal_t Success - 0, Failure - Error Code

Removes mmwave devices and also shuts down the devices. This API is valid only for casecade mode of AWR1243 mmWave device when mmWaveLink instance is running on External Host Processor.

Definition at line 198 of file rl_device.c.

rlReturnVal_t rlDeviceRfStart ( rlUInt8_t  deviceMap)

Enables mmwave RF/Analog Sub system.

Parameters
[in]deviceMap- Bitmap of devices to send the message
Returns
rlReturnVal_t Success - 0, Failure - Error Code

It enables RF/Analog Subsystem.

Definition at line 321 of file rl_device.c.

rlReturnVal_t rlDeviceSetContStreamingModeConfig ( rlUInt8_t  deviceMap,
rlDevContStreamingModeCfg_t data 
)

Sets Continous Streaming Mode Configuration.

Parameters
[in]deviceMap- Bitmap of devices to send the message
[in]data- Container for Continous Streaming Mode Configuration
Returns
rlReturnVal_t Success - 0, Failure - Error Code

This function configures the transfer of captured ADC samples continuously without missing any sample to an external host. This API is valid only for AWR1243 mmWave device when mmWaveLink instance is running on External Host Processor.

Note
: Continuous streaming mode is useful for RF lab characterization and debug. In this mode, the device is configured to transmit a single continuous wave tone at a specific RF frequency continuously

Definition at line 1073 of file rl_device.c.

rlReturnVal_t rlDeviceSetMiscConfig ( rlUInt8_t  deviceMap,
rlDevMiscCfg_t *  data 
)

Setup misc. device configurations.

Parameters
[in]data- Container for device Configuration
[in]deviceMap- Bitmap of devices to send the message
Returns
rlReturnVal_t Success - 0, Failure - Error Code

Set misc. device configurations of MasterMSS, where currently it set CRC type for async event message sent by MSS to Host. This API is valid only for AWR1243 mmWave device when mmWaveLink instance is running on External Host Processor.

Definition at line 1641 of file rl_device.c.

rlReturnVal_t rlDeviceSetTestPatternConfig ( rlUInt8_t  deviceMap,
rltestPattern_t data 
)

Setup for test pattern to be generated.

Parameters
[in]deviceMap- Bitmap of devices to send the message
[in]data- Container for periodic test Configuration
Returns
rlReturnVal_t Success - 0, Failure - Error Code

Set the configurations to setup the test pattern to be generated and transferred over the selected high speed interface (LVDS/CSI2). This API is valid only for AWR1243 mmWave device when mmWaveLink instance is running on External Host Processor.

Definition at line 1594 of file rl_device.c.


Copyright 2018, Texas Instruments Incorporated