Multicore Video Demonstration Guide

Content is no longer maintained and is being kept for reference only!

Multicore Video on BIOS MCSDK

Version 2.0.0

Real Time Video Demonstration Guide

Last updated: 08/13/2018

---

Introduction

Multicore video application demo build (named as sv01.out in the release package) is the main build for demonstrating various real-time video application on TI C66x multi-core DSPs, including decoding, encoding, transcoding for QCIF/CIF/D1/720p/1080p video streams on single and multiple cores. This Real Time Video Demonstration Guide provides high-level instructions on how to run video demos using the pre-built sv01.out included in the release package.

The major steps of running video demos include:

• Physical components and connection
• Preparing the PC
• Preparing the EVM
• Preparing Demo Image and Files
• Running the demo

Note: If running the demo with the pre-built sv01.out, user can simply install MCSDK Video Audio Applications with only MCSDK Video Audio component and then follow the instructions below. Running the demo has no dependency on either CCS, MCSDK, or the other components in MCSDK Video Audio Applications.

Physical Components and Connection

The Video Demo requires three physical components: a PC, a EVM6678l, and a Gigabit Ethernet switch. The PC is connected to the Ethernet switch with an Ethernet cable, and the EVM is also connected to the Ethernet switch with an Ethernet cable. The physical layout is as shown below.

Preparing the PC

The Video demo requires a TFTP server and the MPlayer application. The TFTP server installer can be downloaded from TFTP download, and MPlayer can be found from MPlayer Download. Please install both the TFTP server and MPlayer. Note that MPlayer should be installed at the default location (i.e., C:\Program Files\MPlayer for Windows). Also make sure the file of mplayer.exe exists at C:\Program Files\MPlayer for Windows\mplayer.

The Video demo also needs Active Perl and WinDump. Active Perl can be downloaded from Active Perl 5.14.2.1402. Install it to the default installation directory C:\Perl if this has not been done yet. WinDump can be download from [1].

To run the Video demo, the PC should be set up to be on a private network. The Ethernet adapter used for the demo needs to be disconnected from a DHCP network, and the Ethernet adapter needs to be configured to use the static IP address 192.168.0.102.

Below are the steps to configure the PC to use a static IP address.

• Go to the Control Panel on a Windows PC and open Network Connections.

• Right-click on the appropriate Ethernet device and select Properties.

• In the list of items, select Internet Protocol (TCP/IP) and click on Properties.

• In the Internet Protocol (TCP/IP) Properties window, select Use the following IP address: , and fill in 192.168.0.102 for the IP address, 255.255.255.0 for the Subnet mask, and 192.168.0.1 for the Default gateway. The DNS server addresses may be left blank.

• Click Ok in the Internet Protocol (TCP/IP) Properties window, and click Close in the Local Area Connection Properties window. The PC is now configure with the static IP.

To verify that the configuration succeeded, open a command prompt window and run the command “ipconfig /all”. Verify that the Ethernet adapter that was configured now has the IP address 192.168.0.102.

Preparing the EVM

Initial Boot Loder (IBL) flash

The EVM needs to be correctly flashed with IBL and IBL configuration. The flash needs to be done just once. Go to the <MCSDK Video/Audio Install Dir>\demos\demoutils\IBL_flash folder and follow the instructions in the document ~\IBL_flash\README.doc to do the flash. The included ~\IBL_flash\evm6678l_ibl_config\i2cConfig.gel has been created to provide the configuration required for running the video demo.

Verify IBL flash

Once the EVM has been flashed with IBL and the IBL configuration, this procedure can be verified by seeing the TFTP request on the PC. Perform the following steps to verify that the EVM was flashed correctly.

• Set the boot pins on the EVM to boot from IBL. The boot pin settings are shown in the image below.

• Set PC to use the static IP address 192.168.0.102 if this has not been done yet
• Confirm that the EVM and PC are connected to the switch.
• Start TFTP server on PC.
• Power on the EVM.

Useful Tip 1. If the TFTP server receives a request for the file sv01.out from the IP address 192.168.0.126, then the EVM has been correctly flashed. 2. Details of IBL and flash can be found from BIOS MCSDK 2.0 User Guide, the section of Booting and Flash

Preparing Demo Image and Files

Go to the <MCSDK Video/Audio Install Dir>\demos\demoroot folder, and follow the steps below to prepare the DSP image and PC utilities.

• Get MAC address and network device ID

Run the command "ipconfig /all" to get MAC address. Run "WinDump.exe -D" to get network device ID.

In the example below, the device configured with the static IP address (192.168.0.102) has a MAC address of 5C-26-0A-18-50-E2. Its network device ID is \Device\NPF_{D6473378-2A72-4CDF-8C92-405A7681E745}.

• Modify config.txt with MAC address and network device ID as obtained above

• Run genDemo.bat config.txt to generate demo image and stream files

Useful Tip 1.This batch script generates the files used to run the demos on the PC according to the network information provided in config.txt. First, it takes the factory pre-built DSP image at <MCSDK Video/Audio Install Dir>\demos\demoroot\Reference\sample_build and configures it for a specific demo running on a specific PC: <MCSDK Video/Audio Install Dir>\mcsdk_video_audio_2_0_0_8\demos\demoroot\customBuild\tftp\sv01.out. Second, it generates the files necessary for sending media streams to the DSP and for receiving and presenting the streams on the PC that are received from the EVM/DSP. 2. Note that the DSP image and streaming files need to be generated just once on a PC unless there is change in config.txt and the master DSP image at <MCSDK Video/Audio Install Dir>\demos\demoroot\Reference\sample_build.

Running the Demo

Now that the DSP image and PC utilites have been configured for the user’s environment, follow the steps below to run the Video IBL demo.

• Start the TFTP server on the PC.

• Change the Current Directory to the directory that contains the DSP image sv01.out. Click the Show Dir button to confirm that sv01.out is located in that directory.

• Change the Server Interface to the static IP address (192.168.0.102) that was configured above. If this IP address is not listed, then the static IP address will have to be configured again. Refer to the instructions above.

• Connect the PC and EVM to the switch if this has not been done yet.

• Power on the EVM. If the configuration has been successful, the EVM will download the DSP image via TFTP. Check the log viewer on the TFTP server to verify that the image has been downloaded.

• Start the demo

Go to the <MCSDK Video/Audio Install Dir>\demos\demoroot folder and open two command prompts.

1. Run sendPkts.bat in one command window, which will send the video clips to the EVM
2. Run startMplayers.bat in the second command window, which will display the clips sent from the EVM.

Command window for sending video clips to the EVM:

Command window for starting MPlayer to display the clips from the EVM:

Video displays for Demo 1:

• Cancel and re-run the demo

The streaming is pre-configured as 100 iterations as specified in the generated sendPkts.bat, which is highlighted below. Modify this number to run more or less iterations. To cancel the demo, first cancel sendPkts.bat with CTRL+C in the command window, then cancel startMplayers.bat in the second command window. To re-run the demo, simply start the two batch files again: run sendPkts.bat and then run startMplayers.bat.

Reference\utils\bin\sendPackets.exe customBuild\config\autogen_config4sendPkts.cfg \Device\NPF_{D6473378-2A72-4CDF-8C92-405A7681E745} 100 s

Related Links

• MCSDK Video Getting Started Guide: http://processors.wiki.ti.com/index.php/MCSDK_VIDEO_2.0_Getting_Started_Guide
• MCSDK Video Codec Integration and Test Framework: http://processors.wiki.ti.com/index.php/MCSDK_VIDEO_2.0_CODEC_TEST_FW_User_Guide