Texas Instruments Vision SDK Linux User manual

Copyright © 2017 Texas Instruments Incorporated. All rights reserved.
Information in this document is subject to change without notice. Texas Instruments may have pending
patent applications, trademarks, copyrights, or other intellectual property rights covering matter in this
document. The furnishing of this documents is given for usage with Texas Instruments products only and
does not give you any license to the intellectual property that might be contained within this document.
Texas Instruments makes no implied or expressed warranties in this document and is not responsible for
the products based from this document.
Page 1 of 11
Vision SDK Linux
Cascade Radar Data Acquisition
Tool
User Guide

Page 2 of 11
IMPORTANT NOTICE
Texas Instruments and its subsidiaries (TI) reserve the right to make changes to their products or to
discontinue any product or service without notice, and advise customers to obtain the latest version of relevant
information to verify, before placing orders, that information being relied on is current and complete. All
products are sold subject to the terms and conditions of sale supplied at the time of order acknowledgment,
including those pertaining to warranty, patent infringement, and limitation of liability.
TI warrants performance of its products to the specifications applicable at the time of sale in accordance with
TI’s standard warranty. Testing and other quality control techniques are utilized to the extent TI deems
necessary to support this warranty. Specific testing of all parameters of each device is not necessarily
performed, except those mandated by government requirements.
Customers are responsible for their applications using TI components.
In order to minimize risks associated with the customer’s applications, adequate design and operating
safeguards ought to be provided by the customer so as to minimize inherent or procedural hazards.
TI assumes no liability for applications assistance or customer product design. TI does not warrant or represent
that any license, either express or implied, is granted under any patent right, copyright, mask work right, or
other intellectual property right of TI covering or relating to any combination, machine, or process in which such
products or services might be or are used. TI’s publication of information regarding any third party’s products or
services does not constitute TI’s approval, license, warranty or endorsement thereof.
Reproduction of information in TI data books or data sheets is permissible only if reproduction is without
alteration and is accompanied by all associated warranties, conditions, limitations and notices. Representation
or reproduction of this information with alteration voids all warranties provided for an associated TI product or
service, is an unfair and deceptive business practice, and TI is neither responsible nor liable for any such use.
Resale of TI’s products or services with statements different from or beyond the parameters stated by TI for
that product or service voids all express and any implied warranties for the associated TI product or service, is
an unfair and deceptive business practice, and TI is not responsible nor liable for any such use.
Also see: Standard Terms and Conditions of Sale for Semiconductor Products.
www.ti.com/sc/docs/stdterms.htm
Mailing Address:
Texas Instruments
Post Office Box 655303
Dallas, Texas 75265
Copyright © 2017, Texas Instruments Incorporated

Page 3 of 11
TABLE OF CONTENTS
1Introduction ................................................................................................. 4
1.1 Block Diagram .................................................................................................4
1.2 Program Flow ..................................................................................................5
1.3 Data Output Format .........................................................................................6
2Requirements for Running Data Acquisition Tool ......................................... 7
3Build Linux Vision SDK for Cascade Radar EVM ............................................ 7
4Build Linux Vision SDK for Cascade Radar EVM with Radar Studio ............... 7
5Data Acquisition Tool ................................................................................... 8
5.1 Run Data Acquisition using Radar Studio .............................................................8
5.2 Run Data Acquisition Tool..................................................................................8
5.3 Retrieve Data ................................................................................................ 10
6Revision History ......................................................................................... 11

Page 4 of 11
1Introduction
This user guide provides details on how to build and utilize the data acquisition tool
to capture raw data (ADC samples) from 4x AWR1243 Cascade Radar RF board with
TDA2x Digital board.
For 4x AWR1243 Cascade Radar, depending on the Radar configuration, the raw data
throughput could be up to ~6 Gbps. To save the raw data in real-time to a storage
device, it requires an interface with very high BW capability. On TDA2x, PCIe
interface can provide maximum 5Gbps BW per lane with total of 2 lanes. Using 2-
lane PCIe interface on TDA2x to connect to a SSD storage device, it is sufficient to
achieve real-time data acquisition for 4-chip cascade radar use case.
1.1 Block Diagram
The data acquisition tool implements the data scheme as shown in the following
block diagram.
4x
AWR1243
Cascade RF
Board
Eth
TDA2x
SPI
GPIO
PCIe
x2
CSI-2
SSD Hard Drive
Use SCP (Secure
Copy) to transfer
files from EVM to PC
over Ethernet

Page 5 of 11
1.2 Program Flow
The main component of Data acquisition Tool is DataCollect Link running on A15 in
TDA2x. DataCollect Link implemented the program flow as shown in the following
figure.
DataCollect Link
TaskMain
DataCollect Link
Create
CREATE
DiskBucket
Object
Create
DataCollect Link
Run
Run-time
Command
Received?
DataCollect Link
ProcessFrame
NEW DATA
DiskBucket
WriteData
Write Complete
Search for existing data
files under “/mnt/ssd”
folder
Set File name index AND
Copy Configuration Files
to “/mnt/ssd/” folder
Open New Data File with
the next Filename Index
Data File is
opened and not
full?
No
Copy Data to file until the
file size reaches 2GB
Yes
Update Index File
containing frame size and
number of frames in the
file
DataCollect Link
Delete
STOP
DiskBucket
Object
Delete

Page 6 of 11
1.3 Data Output Format
Data Acquisition Tool will save 3 types of files to the SSD card.
Radar Configuration Files
Radar Configuration files used for the acquiring data set will be copied to SSD
as “bxxxx_cfg_00.txt” ~ “bxxx_cfg_03.txt”.
Data Files
Data will be saved to a new file every 2GB as “bxxxx_data.bin”.
Index Files
Each data file has an index file, “bxxxx_idx.bin” to provide the frame size and
numbers of total frames stored in the file.
The following screenshot shows an example of the files saved to SSD by Data
Acquisition Tool.

Page 7 of 11
2Requirements for Running Data Acquisition Tool
It is important to make sure the required components are available before trying to
use the data acquisition tool.
Hardware Requirements:
o4-Chips AWR1243 Cascade Radar Board and TDA2xx Processing board
oNvme M.2 PCIe SSD card (ex. Link)
oWindows or Ubuntu PC
Processor SDK Vision 3.6 release or later (Linux version)
Please Refer to VisionSDK_Linux_UserGuide.pdf for SDK requirements
3Build Linux Vision SDK for Cascade Radar EVM
1. Follow the instructions in the Chapter 2 of VisionSDK_Linux_UserGuide.pdf to
install Linux Vision SDK and set up the build environment.
2. Apply kernel patch. Patch can be found under the following location.
[SDK_INSTALL]/ti_components/os_tools/linux/kernel/linux-kernel-
addon/kernel-patches/
3. Apply u-boot patches. Patch can be found under the following location.
[SDK_INSTALL]/ti_components/os_tools/linux/kernel/linux-kernel-addon/u-
boot-patches/
4. Follow the build instructions in Chapter 3 of the SDK User Guide. Set
MAKECONFIG=tda2xx_cascade_linux_radar in Rules.make.
5. Follow the instructions in SDK User guide to prepare the SD card.
6. Place the radar configuration files under “/opt/vision” folder in file system on
SD card. The example configuration files can be found under
~\vision_sdk\apps\src\rtos\radar\src\usecases\cascade_radar_object_detect\
radar_test_vector. Please refer to ProcessorSDKRadar_UserGuide.pdf for the
details regarding the configuration files.
4Build Linux Vision SDK for Cascade Radar EVM with Radar Studio
1. Follow the instructions in the Chapter 2 of VisionSDK_Linux_UserGuide.pdf to
install Linux Vision SDK and set up the build environment.
2. Apply kernel patch. Patch can be found under the following location.
[SDK_INSTALL]/ti_components/os_tools/linux/kernel/linux-kernel-
addon/kernel-patches/
3. Apply u-boot patches. Patch can be found under the following location.
[SDK_INSTALL]/ti_components/os_tools/linux/kernel/linux-kernel-addon/u-
boot-patches/
4. Make RADAR_STUDIO=yes in
[SDK_INSTALL]/vision_sdk/apps/configs/tda2xx_cascade_linux_radar/cfg.mk
5. Follow the build instructions in Chapter 3 of the SDK User Guide. Set
MAKECONFIG=tda2xx_cascade_linux_radar in Rules.make.
6. Follow the instructions in SDK User guide to prepare the SD card.

Page 8 of 11
5Data Acquisition Tool
Before running data acquisition tool, the NVMe M.2 SSD card should be installed on
the EVM as shown in the following figure. Remove the Cascade RF board first to have
access to the SSD card slot on the TDA2x processing board. After installing SSD
card, secure the RF board back to the connectors on the TDA2x processing board.
Before powering up the board, make sure the S4 Dip Switch, as shown in the
following figure, is set to [1:6] = [111001] to boot from SD card.
After powering up the board and booting to Linux kernel prompt, please make sure the SSD card
is detected. If the SSD is detected correctly, the device will be “/dev/nvme0”.
5.1 Run Data Acquisition using Radar Studio
Follow the Radar studio 2.1.0 release userguide.
5.2 Run Data Acquisition Tool
1. Format the partition on SSD card as needed. Use “fdisk” and “mkfs” tools.
Please refer to the manual of “fdisk” and “mkfs” for details.

Page 9 of 11
2. Create “/mnt/ssd” folder and mount the partition on SSD for data storage to
this folder.
3. Start Vision SDK Demo Application.
$> cd /opt/vision_sdk
$> source ./vision_sdk_load.sh
$> ./apps.out
4. Select ‘6’ for Radar Usecases.
5. Select ‘2’ for Cascade Radar Capture + Data Acquisition.
6. Once the use case starts, the tool will search the existing files under /mnt/ssd
folder. If there are already data files from prior runs, it will create the new file
with incrementing index for file name.

Page 10 of 11
5.3 Retrieve Data
3 ways to retrieve the radar data collected in SSD card as the followings.
Use Linux PC (Ubuntu) –Preferred
From EVM prompt, run “ifconfig” to obtain EVM IP address. Use SCP to
transfer file to PC.
Use Windows PC
Download “WinSCP” for Windows and use it to transfer file from EVM to PC.
Remove SSD card from EVM
Use M.2 SSD-to-USB adapter/enclosure to read SSD card on PC.