Main Content

Configure Radar Using a Configuration (.cfg) File for Reading Detections

To configure the TI mmWave radar board, you must send a sequence of commands to the board using the serial port. The sequence includes commands specifying the chirp profile, sampling rate, required outputs, and so on. For more information on the commands, see the Configuration (.cfg) File Format section in mmWave SDK user guide. Use the ConfigFile property of the mmWaveRadar object to send the sequence of commands to the board.

You can use a sample configuration file provided with the support package instead of generating a configuration file. The sample files are stored in the configfiles folder in TI Radar Support package install directory. To navigate to this directory, execute the following commands in MATALB command window. 

installDir = matlabshared.supportpkg.getSupportPackageRoot
tiradarCfgFileDir = fullfile(installDir,'toolbox','target', 'supportpackages', 'timmwaveradar', 'configfiles');
cd(tiradarCfgFileDir)

Once you identify the config file you need to use to configure the TI radar, specify this file name with full file path and extension as the value of the property ConfigFile of the mmWaveRadar object

For example, if tiradar is the name of the mmWaveRadar object that you created and you want to configure the radar using the file C:\Configs\ xwr68xx_2Tx_BestRange_UpdateRate_10.cfg, then specify the config file as shown below:

tiradar.ConfigFile = "C:\Configs\ xwr68xx_2Tx_BestRange_UpdateRate_10.cfg";

The mmWaveRadar object sets a few properties of the object based on the parameters in the configuration file.

Generate Configuration File for All Supported Boards Except IWRL6432BOOST

Instead of using the sample files, you can use your own Configuration (.cfg) file and specify the full path to the file while defining the ConfigFile property.

For all the supported boards except the IWRL6432BOOST board, use mmWave Demo visualizer application to generate the configuration file.

Use the Setup Details and Scene Selection sections in the application to specify the required configurations.

Select the appropriate platform for your TI board:

  • xwr68xx for TI IWR6843ISK or TI AWR6843ISK

  • xwr68xx_AOP for TI IWR6843AOPEVM or TI AWR6843AOPEVM

  • xwr18xx_AOP for TI IWR1843AOPEVM

  • xwr16xx for TI AWR1642BOOST

Use the check boxes in Plot Selection section to specify the required outputs:

  • Select Scatter plot for getting detections (point cloud) outputs.

  • Select Range Profile and Noise Profile for getting range profile and noise profile outputs respectively.

  • Select Range Doppler Heat Map and Range Azimuth Heat Map for getting range doppler and range angle responses in outputs respectively .

Once you have specified the required configurations, click SAVE CONFIG TO PC to generate the corresponding .cfg file. For more information about the outputs that you obtain in MATLAB, see mmWaveRadar object.

At the default baud rate of 921600, for getting heat map outputs, set the frame rate to less than or equal to 5 fps. For more information, see Performance Considerations for Using mmWave Radar Sensors for Reading Object Detections.

Generate Configuration (.cfg) File for IWRL6432BOOST

To generate the Configuration (.cfg) file for the IWRL6432BOOST, refer to Parameter Tuning and Customization Guide for the IWRL6432 Motion/Presence Detection Demo. You can find information about this guide at this link.