Swru 529 C
Swru 529 C
Swru 529 C
This user's guide presents the TI Gallery app – mmWave Demo Visualizer – for configuring mmWave
sensors and visualizing point cloud objects generated by the mmWave SDK demo. The mmWave Demo
Visualizer app is meant to be used in conjunction with the mmWave SDK demo running on the TI EVM for
mmWave devices. The app can also be reached at the TI Gallery website – search for
mmWave_Demo_Visualizer. The mmWave Demo Visualizer app is browser-based and can be run on any
PC operating system (Windows®, Linux®, or macOS®), and TI recommends running the app using the
Chrome® browser for the best plotting performance.
Contents
1 Setup Instructions ............................................................................................................ 3
1.1 Browser Setup (First Time Only).................................................................................. 3
1.2 mmWave Device Setup ............................................................................................ 3
1.3 Serial Port Setup .................................................................................................... 3
2 CONFIGURE Tab ............................................................................................................ 5
2.1 Platform .............................................................................................................. 5
2.2 SDK Version ......................................................................................................... 5
2.3 Antenna Config (Azimuth Resolution - Degrees) ............................................................... 5
2.4 Desirable Configuration ............................................................................................ 5
2.5 Frequency Band (GHz) ............................................................................................ 5
2.6 Scene Selection – Best Range Resolution ...................................................................... 6
2.7 Scene Selection – Best Velocity Resolution .................................................................... 7
2.8 Scene Selection – Best Range ................................................................................... 8
2.9 Plot Selection ........................................................................................................ 9
2.10 User Selected Configuration ..................................................................................... 10
3 PLOTS Tab ................................................................................................................. 12
3.1 X-Y Scatter Plot ................................................................................................... 12
3.2 Doppler Range Plot ............................................................................................... 13
3.3 Range Profile ...................................................................................................... 14
3.4 CPU Load .......................................................................................................... 15
3.5 Range-Doppler Heatmap ......................................................................................... 16
3.6 Range-Azimuth Heatmap ........................................................................................ 17
3.7 3-D Scatter Plot .................................................................................................... 18
3.8 Display Parameters ............................................................................................... 18
3.9 Real-Time Tuning ................................................................................................. 20
3.10 Advanced Commands ........................................................................................... 21
3.11 Plot Settings ....................................................................................................... 22
4 Advanced Options .......................................................................................................... 22
4.1 Load Configuration From PC .................................................................................... 22
4.2 Getting the Version................................................................................................ 22
4.3 RCS ................................................................................................................. 23
4.4 Concurrent Recording of Processed Stream From mmWave Device ...................................... 23
5 Troubleshooting ............................................................................................................ 24
5.1 Console Message: Errors Returned by Device ................................................................ 24
5.2 Serial Port Status Message: Not Switching to Hardware Connected or Both Ports Are Not
Showing Up ........................................................................................................ 24
5.3 Console Message: sensorStart Message Not Sent to Host ................................................. 24
5.4 Warning for Plots and Frame Rate.............................................................................. 25
List of Figures
1 TI Cloud Agent Installation (First Time Setup) ........................................................................... 3
2 Device Manager Ports ...................................................................................................... 3
3 Serial Port Configuration in App ........................................................................................... 4
4 COM Port Status When Correct Ports Are Configured ................................................................. 4
5 COM Port Status When Ports Are Not Connected ...................................................................... 4
6 Valid Configuration ......................................................................................................... 11
7 X-Y Scatter Plot for Detected Objects ................................................................................... 12
8 Doppler Range Plot for Detected Objects .............................................................................. 13
9 Range Profile in Linear Scale............................................................................................. 14
10 Range Profile in Log Scale ............................................................................................... 14
11 Range and Noise Profile in Log Scale .................................................................................. 15
12 CPU Load for Frame Rate = 30 fps (Example) ........................................................................ 15
13 Doppler Range Heatmap .................................................................................................. 16
14 Azimuth-Range Heatmap (Example) .................................................................................... 17
15 3-D Scatter Plot............................................................................................................. 18
16 Display Parameters – Profiling ........................................................................................... 19
17 Display Parameters – Scene ............................................................................................. 19
18 Display Parameters - Chirp/Frame....................................................................................... 20
19 Range Peak Grouping Disabled (Left) and Enabled (Right).......................................................... 21
20 Download Icon .............................................................................................................. 26
21 Screen Pop-Up for Download Options .................................................................................. 26
Trademarks
Code Composer Studio is a trademark of Texas Instruments.
macOS is a registered trademark of Apple, Inc.
Cortex is a registered trademark of Arm Limited.
Chrome is a registered trademark of Google, Inc.
Linux is a registered trademark of Linus Torvalds.
Windows is a registered trademark of Microsoft Corporation.
All other trademarks are the property of their respective owners.
1 Setup Instructions
2. In the browser app, navigate to Menu → Options → Serial Port and set up the COM ports in the pop-
up window as follows (see Figure 3).
a. CFG_port: Use the COM port number for XDS110 Class Application/User UART and set Baud:
115200
b. Data_port: Use the COM port XDS110 Class Auxiliary Data Port and set Baud: 921600. User can
leverage higher baud rates than 921600 by selecting "custom" in the Baud Rates drop down and
setting the desired value (max: 3125000). Recommended values are: 1834000 or 3125000. Note
that the sensor should be in stopped or rebooted state for the changes to take effect. Visualizer
communicates with the sensor over CLI port to configure it to the user provided baud rate in this
dialog box.
3. Click the CONFIGURE button and the control should go back to the main browser window.
4. At this point, the app automatically tries to connect to the target (mmWave Sensor), see Figure 4.
5. If the app does not connect to the CFG_port or the connection fails, try to connect to the target by
clicking in the bottom-left corner of the app (see Figure 5). For mmWave SDK 3.3 and earlier,
DATA_port will show connected only after the sensor is configured and sending detected objects. For
mmWave SDK 3.4 and later, both CFG_port and DATA_port will show connected if the ports are valid .
2 CONFIGURE Tab
This tab allows users select the parameters for configuring the mmWave device. In this document, the
subsection numbers dictate a certain sequence of programming so that precedent parameters are set first
followed by dependent parameters. Users can follow any sequence in configuring the settings, but note
that certain knobs, sliders, and drop-downs influence the values of other dependent parameters, and you
may have to readjust dependent parameters to obtain the desired selection.
2.1 Platform
This is a drop-down menu that prompts users to select the correct mmWave device to which the app is
connected to through the serial port. If you are trying to just save config to PC, then select the mmWave
device for which the desired configuration must generate.
NOTE: Users must reboot the mmWave device when switching between options in this menu.
CLI command details: Range Resolution and Max Unambiguous Range define the number of ADC
samples, frequency slope constant, Ramp end time in µs, idle time in µs, and ADC sampling frequency in
ksps in the profileCfg command.
CLI command details: defines the number of ADC samples, Ramp end time in µs, and ADC sampling
frequency in ksps in the profileCfg command.
2.9.6 Statistics
This lets users enable the statistics information to be sent out by the target (mmWave sensor) device and
to show the CPU load plot on the plots tab.
CLI command details: defines the statistics parameter in the guiMonitor command.
Another indication of successful connectivity to the target device is the black status bar on the bottom of
the page shows two valid COM ports and the status says Hardware Connected (see Figure 6). After
successful execution, users can switch to the Plots tab to view the requested plots.
If the last two lines in the console messages contain any other lines than these, it means either the device
generated an error, the device stopped responding, or the commands did not go through completely and
the user must try again. For more details, see Section 5.
3 PLOTS Tab
When users have successfully configured the device using either the Send Config to mmWave Device or
Load Config from PC and Send button, they can begin to see data being plotted on the requested plots. If
no data is shown on the plots. For more details, see Section 5.
NOTE: Select Scatter Plot in the configure tab and configure the device accordingly to view this plot.
The X- and Y-axis can be controlled using the Range Width and Range Depth text boxes. Use the stop
button to stop plotting and then you can change these settings. When the settings are changed, resume
plotting using the start button. The maximum value users can select is limited by the Maximum
Unambiguous Range achievable by the current configuration.
NOTE: Select Scatter Plot in the Configure tab and configure the device accordingly to view this
plot.
The X-axis can be controlled using the Range Width and Range Depth text boxes. Use the stop button to
stop plotting and then you can change these settings. When changed, resume the plotting using the start
button. The maximum value users can select is limited by the Maximum Unambiguous Range achievable
by the current configuration.
NOTE: Select Range Profile and Noise Profile in the Configure tab and configure the device
accordingly to view this plot.
The linear scale for the Y-axis can be selected by unchecking the Range Profile Log Scale checkbox. The
maximum limit for the Y-axis in the linear domain can be selected by the user with the Range Profile Y-
max text box. Use the stop button to stop plotting and then you can change these settings. Once the
settings are changed, resume plotting using the start button.
NOTE: Select Statistics in the Configure tab and configure the device accordingly to view this plot.
NOTE: Select Range Doppler Heat Map in the Configure tab and configure the device accordingly to
view this plot.
NOTE: Select Range Azimuth Heat Map in the Configure tab and configure the device accordingly
to view this plot.
NOTE: Select Scatter Plot,any Antenna config that has non-zero Elevationresolution in the
Configure tab and configure the device accordingly to view this plot.
0 Z
-1
0 -5
5 0
Y in meters 10 5 X in meters
• Temperature Report: This section displays the device temperature report from various temperature
sensors. The time shown is number of days/hours/minutes/seconds/milliseconds since the device was
powered up.
NOTE: With these controls moving to PLOTS tab, the CONFIGURE tab now carries the default for
these commands for the initial configuration of the sensor.
Figure 19. Range Peak Grouping Disabled (Left) and Enabled (Right)
3.10.1 Special Note About Range and Angle Bias Compensation Configuration
This tab lets users enter the command for the range and angle bias compensation as well. For more
information on how to obtain the values for this field, see the mmWave SDK User's Guide. On receiving
this command, the mmWave device corrects the x and y values with the user-supplied bias, but rangeIdx
(which is the FFT index) is not corrected. In our case, the visualizer GUI handles adjusting the value when
rangeIdx is converted into the corresponding value in meters for the range profile plot and other
heatmaps. If this functionality is not desired, then the command must be given with Range Bias = 0, Rx
phase bias set with Real = 0, and Imaginary = 1, for all the applicable virtual antennas (this is also the
default from the CONFIGURE tab).
4 Advanced Options
NOTE: The advanced frame configuration or the range/angle bias measurement procedure can be
initiated only by using this button. The configure tab does not provide these capabilities.
The SDK version is shown only when the mmWave sensor device is properly connected to this app using
the serial/COM port and a functional demo is running on the target. Checking the version is a good
troubleshooting mechanism to determine whether the mmWave device is up and running (see below).
******************************
Connected device
******************************
Retreiving version information ...
Please connect hardware
**********************
4.3 RCS
This is the small section in the CONFIGURE tab used for calculations and informative purposes.
NOTE: This feature requires the browser version to be at least as mentioned here:
ti-widget-streamsaver.
5 Troubleshooting
5.2 Serial Port Status Message: Not Switching to Hardware Connected or Both Ports Are
Not Showing Up
A successful connection results in two COM ports displaying in the bottom status bar, and a Hardware
Connected (mmWave SDK 3.4 or later) or "Waiting for Data.." message for the DATA_port (mmWave
SDK 3.3 or earlier) .
If
the user does not see the previous message, then the following common errors could be the root cause:
• The mmWave device is not powered on and running the demo
• Incorrect COM port numbers were selected in Options → Serial port.
• Another application (for example, Tera Term) has those COM ports open and the app is unable access
to these ports.
• The device was just rebooted while the app was running.
Once previously mentioned errors are corrected, use the small icon (a broken link or exclamation icon) at
the bottom of the screen to disconnect and connect the ports again.
When run on the PC, this installer connects to the internet to fetch the compatible GC runtime engine. If
users do not have internet connectivity during the installation process (for example, installer was copied
from an internet-connected machine to a remote PC), then users must also download the GC runtime
engine from the same link (see Figure 21).
Revision History
NOTE: Page numbers for previous revisions may differ from page numbers in the current version.
Mailing Address: Texas Instruments, Post Office Box 655303, Dallas, Texas 75265
Copyright © 2022, Texas Instruments Incorporated