2.2.1.1. J721E Out of the Box Demos¶
Note
As of this release, all out of box demos are from vision_apps on Linux. For QNX HLOS, or Gateway Demos, one must download and build the source package.
2.2.1.1.1. Step 1: Download Prebuilt PSDK RTOS¶
Download and Untar the prebuilt files tar ball ti-processor-sdk-rtos-j721e-evm-<version>-prebuilt.tar.gz
cd {path/to/file}
tar xf ti-processor-sdk-rtos-j721e-evm-<version>-prebuilt.tar.gz
Note
This contains the prebuilt linux filesystem & linux boot file tarballs, scripts to format SD card & to install the file system to sd card.
This also contains all prebuilt demo executables, their configuration files, and enough input test images to run tiovx tests. Most camera-based demos can run with everything in this package, as-is.
If you would like to run PTK demos, stereo demos, or TIDL demos (all of which are dependent on reading input data from the sd card), then you will need to download extra packages in the next step.
2.2.1.1.2. Step 2: Download Demo Data Sets (Optional)¶
For running stereo demos or TIDL demos you will need to also download the following data set:
psdk_rtos_ti_data_set_xx_xx_xx.tar.gz
For running PTK demos you will need to also download the following data set:
psdk_rtos_ti_data_set_ptk_xx_xx_xx.tar.gz
Note
There is no need to extract these tar balls, as the prebuilt package comes with a script which can load them on the SD card (mentioned in later step).
2.2.1.1.3. Step 3: Prepare SD card¶
Warning
ALL contents of SD card will be lost when doing these steps.
Insert SD card onto your PC SD card slot and format SD card in two partitions,
FAT32 partition: for boot loader, 64MB size recommended
ext4 partition: for root filesystem, rest of SD card, atleast 16GB SD card recommended.
You can use one of two options to format your SD card
Option 1: You can use the utility script mk-linux-card.sh to make the partitions
Use the command “df -h” to identify the device used by SD card
Unmount the SD card before running the script
-Example, if your SD card is on device /dev/sdb having two partitions, do below to unmount them
umount /dev/sdb1 umount /dev/sdb2
Run the script as below to partition it, answer “y” to all questions asked when running the script
Warning
Make sure to give the correct device name to the following script, example /dev/sda is typically local harddisk, if you give this by mistake, your whole hard disk will be wiped off !!!
sudo ./mk-linux-card.sh /dev/sdb
Option 2: You can use “gparted” utility (sudo apt install gparted) to use a GUI based interface to create the partitions.
Make sure you set the FAT32 partition flags as “boot”, “lba”
Name the FAT32 partition as “BOOT” and the ext4 partition as “rootfs”
After formatting, remove and insert the SD card for the freshly formatted partitions to get auto mounted on the host PC.
2.2.1.1.4. Step 4: Install Filesystem and Boot Files¶
Copy/untar filesystem, boot files, and patches to SD card by executing the script install_to_sd_card.sh from within the extracted prebuilt folder, as shown below
./install_to_sd_card.sh
If you have downloaded the extra data sets, you can load them one-by-one by executing the script install_data_set_to_sd_card.sh, as shown below
./install_data_set_to_sd_card.sh <path/to/psdk_rtos_ti_data_set_xx_xx_xx.tar.gz> # only needed for TIDL, DOF, Stereo demos
./install_data_set_to_sd_card.sh <path/to/psdk_rtos_ti_data_set_ptk_xx_xx_xx.tar.gz> # only needed for PTK demos
Eject and remove SD card from PC and insert in EVM
2.2.1.1.5. Step 5: Run on EVM¶
Setup the EVM as shown on this page EVM Setup for J721E
Connect UART/USB cable and setup UART terminal
Connect daughter card for camera, display as required
Connect power supply
Connect DP display
Select SD card boot mode on EVM
Insert SD card
Power on the EVM
First time only: The uboot environment may need to be cleared prior to running with the prebuilt filesystem. The uboot environment can be cleared by first pressing enter to stop the boot process at uboot and come to uboot prompt. The below commands can be entered to clear the uboot environment to default and save the changes.
env default –a –f
saveenv
Power cycle the EVM
You should see bootloader prints on the UART terminal and then bootloader will boot linux kernel and you should see login prompt as below
j7-evm login:
On the EVM, Login using below user id, no password
root
On the EVM, do below steps to init the environment for the demos
cd /opt/vision_apps
source ./vision_apps_init.sh
Now run one of the below scripts/applications to run the demos
./run_app_tidl.sh - Image classification demo (needs display)
./run_app_tidl_cam.sh - Camera based Image classification demo (needs display, Fusion1 board, 1x IMX390 camera)
./run_app_tidl_seg.sh - Semantic segmentation demo (needs display)
./run_app_tidl_od.sh - Object Detection demo (needs display)
./run_app_tidl_avp.sh - Auto valet parking demo (needs display)
./run_app_tidl_avp2.sh - Auto valet parking demo (needs display)
./run_app_tidl_avp3.sh - Auto valet parking demo (needs display)
./run_app_tidl_avp4.sh - Auto valet parking demo (needs display, Fusion1 board, 4x IMX390 camera)
./run_app_dof.sh - Dense optical flow demo (needs display)
./run_app_stereo.sh - Stereo disparity demo (needs display)
./run_app_c7x.sh - C7x sample kernel demo
./run_app_srv.sh - 3D SRV 4 camera demo (needs display, Fusion1 board, 4x IMX390 camera)
./run_app_single_cam.sh - Single camera + VISS + Display demo (needs display, Fusion1 board, 1x IMX390 or compatible cameras)
./run_app_multi_cam.sh - Multi (upto 8x) camera + VISS + Display demo (needs display, Fusion1 board, IMX390 or compatible cameras)
./vx_app_arm_opengl_mosaic.out - OpenGL + OpenVX test
./vx_app_arm_ipc.out - inter processor communication test
./vx_app_arm_mem.out - memory allocation test
./vx_app_tutorial.out - TI OpenVX tutorial
./vx_app_conformance.out - TI OpenVX conformance tests
Once the demo runs, you should see output on the display
Note
Display will be eDP.
Type ‘x’ to exit the demo and run another demo.