MCSDK VIDEO 2.0 Getting Started Guide

MCSDK Video

(Multicore Video Infrastructure Demo Built on MCSDK)

Version 2.0.0

Getting Started Guide

Last updated: 07/28/2014

---

Introduction

The MCSDK Video (Multicore Video Infrastructure Demo Built on MCSDK) provides software development environment to implement real-time video applications on TI C66x multi-core DSPs. The MCSDK Video builds on MCSDK 2.0 [MCSDK Getting Started Guide, MCSDK User's Guide] to achieve platform abstraction, networking, and inter-core communication. Multiple Video codecs are integrated in the MCSDK Video for demonstrating video applications on single and multiple cores.

Specifically, this Getting Started Guide provides information on installing and rebuilding the MCSDK Video. By the end of this Getting Started Guide the user should have:

• Installed CCS
• Installed the MCSDK Software and its requiring tools
• Installed the MCSDK Video Software and its requiring tools
• Rebuilt the MCSDK Video application if needed

Useful Tip 1) After completing the material in this Getting Started Guide, it is recommended the user continue on to the MCSDK Video Demo Guide for additional information on running real-time video demos, and the MCSDK Video Codec Integration and Test User Guide for additional information on integrating and testing standalone Video/Audio/Image codecs. 2) Pre-built multi-core video demo builds have been included in the MCSDK Video component. To run the MCSDK video demo builds as is, the only steps needed include installation of MCSDK Video with only MCSDK Video component, and installation of Active Perl. After that, users can directly go to the Running the Demonstration Applications section below to run both Real-time Video Demonstrations and Codec Integration and Test Application. Links: MCSDK Video installation [1], Active Perl installation [2], and Running the Demonstration Applications section [3].

Supported Devices/Platforms

This release supports the following Texas Instrument devices/platforms:

Platform Development Kit	Supported Devices	Supported EVM
C6678	TMS320C6678, TMS320TCI6608	TMDXEVM6678L, TMDXEVM6678LE, TMDXEVM6678LXE

Getting Started

This section will walk you through installing the MCSDK Video. The overall steps are:

1. Install Code Composer Studio 5.0
2. Install the MCSDK 2.0
3. Install the MCSDK Video 2.0.0

---

Installing Code Composer Studio (as required by the BIOS-MCSDK 2.0)

The BIOS-MCSDK 2.0 (2.0.5) uses CCS 5.0 (v5.0.3.00028). To install CCS please refer to the instructions provided in the CCSv5 Getting Started Guide. If you choose to do a custom installation, the following components must be installed to support the MCSDK VIDEO:

• C6000 DSPs
• DSP/BIOS 6.X
• IPC and I/O
• XDCtools

It is recommended to keep the default installation paths for CCS and the other components, e.g., C:\Program Files\Texas Instruments, C:\Program Files\Texas Instruments\ccsv5.

Sample Custom Installation snap shot:

Select C6000 DSPs during Choose ISA option:

Select CCSv5 Components snap shot:

---

Installing the BIOS Multicore Software Development Kit and Dependent Tools

Visit BIOS-MCSDK 2.0.x to get BIOS-MCSDK 2.0 (v2.0.5). Some of the components installed by CCS may be updated by the BIOS-MCSDK installer. Make sure CCS is closed before invoking the BIOS-MCSDK installer.

The following components of BIOS-MCSDK must be installed to support the MCSDK VIDEO:

• PDK C6678
• EDMA3-LLD
• SYS/BIOS
• XDC tools
• IPC

Select MCSDK components snap shot:

Install MinGW as required by MCSDK 2.0.5

Install MinGW: When installing MinGW, must add the MSYS Basic System and MinGW Developer Toolkit.

---

Installing the MCSDK Video

After installing CCS and MCSDK, the next step is installing the MCSDK VIDEO package. The MCSDK video installer allows you to choose the installation directory. Once the installation is complete all the MCSDK video components will be installed in the specified installation directory. The MCSDK video includes the following components and please see Release notes for full details.

• MCSDK Video
• TI Framework Components (FC)
• TI Network Adaptation Layer (NWAL) Driver
• TI XDAIS
• TI Video Codecs
• TI Codegen Tools

On Windows OS

To install the MCSDK Video on your Windows PC run the MCSDK Video installer (mcsdk_video<version>_setupwin32.exe). It is recommended to keep the default installation paths for CCS and the other components (e.g., "C:\Program Files\Texas Instruments" and "C:\Program Files\Texas Instruments\ccsv5") or make sure that CCS and the other components are installed along the same path.

On Linux OS

After downloading the Linux installer, (mcsdk_video<version>_setuplinux.bin), please change the attribute of the installer to executable and run the installer as shown below. <syntaxhighlight lang='bash'> chmod +x mcsdk_video<version>_setuplinux.bin ./mcsdk_video<version>_setuplinux.bin </syntaxhighlight>

Major Steps of MCSDK Video Installation

• Step-1: Select Destination Folder
• Step-2: Select Components
• Step-3: Copy the Components selected in Step-2 to the Destination Folder specified in Step-1, then automatically install MCSDK Video, FC, NWAL, and XDAIS if they have been selected in Step-2
• Step-4: Install Codegen if it has been selected in Step-2
• Step-5: Install Video Codecs which have been selected in Step-2

Install MCSDK Video component only

To run the MCSDK video demo builds as is, the only component needed from MCSDK Video is MCSDK Video component. Then, proceed to install Active Perl and go to the Running the Demonstration Applications section below to run the video demos.

Install Active Perl for the MCSDK VIDEO

Active Perl (5.14.2.1402) can be downloaded from Active Perl 5.14.2.1402. Install it to the default installation directory C:\Perl.

Prepare MCSDK Video Demo Builds

To prepare MCSDK video demo builds, follow the two steps below to set up environment variables and then rebuild the sample builds. These steps are needed only when there are changes in the source code and therefore the sample builds needs to be recompiled.

Set up environment variables

Under the installation directory of the MCSDK Video, go to <MCSDK Video Install Dir>\dsp\mkrel, run batch file "setupenvMsys.bat bypass" in a command window. This will execute \dsp\mkrel\setupenvMsys.sh and enters shell.

"setupenvMsys.sh" will check if all the required components and tools are available at the specified locations. If not, please refer to the above steps to ensure all the components/tools are installed. If the installation in the above step(s) is not using the default directories, modify \dsp\mkrel\setupenvMsys.sh to point to the correct path

Make sample builds

Run dsp/mkrel/makefile to build DSP code. The following is the command to build the video application: make [build_name]. There are two major builds in the MCSDK Video release package: sv01 and sv04:

• sv01 is the build for demonstrating various real-time video applications on TI C66x multi-core DSPs, including decoding, encoding, transcoding for QCIF/CIF/D1/720p/1080p video streams on single and multiple cores.
• sv04 is the build for codec integration and testing. It facilitates the development and testing of stand-alone Codecs (including video, audio, and image codecs).

Using sv01 as one example, the build command make sv01 will produce directory: <MCSDK Video Install Dir>\dsp\mkrel\sv01 with the following files: sv01.out, sv01.map, readme_sv01.txt.

Useful Tip 1. If a source debugger requires all source files to be combined into a single directory, "FLAT=YES" may be added in the make command line, which will create the directory mkrel\sv01\flat containing all source and header files used for the build. 2. After making the first build, if there is no source file change in \components directory, "RTSCBYPASS=YES" may be added in the make command line, which will bypass compiling the components. If there is no source file change in dsp\ggcfg\build\hdg\sv01\bios directory, "BIOSCFGPKGBYPASS=YES" may be added in the make command line, which will bypass compiling the BIOS configuration package.

Running the Demonstration Applications

Please refer to the following links for running the demonstration applications

• MCSDK Video Real-time Video Demonstrations: http://processors.wiki.ti.com/index.php/MCSDK_VIDEO_2.0_Demo_Guide
• MCSDK Video Codec Integration and Test Application: http://processors.wiki.ti.com/index.php/MCSDK_VIDEO_2.0_CODEC_TEST_FW_User_Guide

Related Documents

• Release Notes: http://software-dl.ti.com/sdoemb/sdoemb_public_sw/mcsdk_video/latest/exports/mcsdk_video_release_notes_02_00_00.pdf
• Real-time Video Demonstrations: http://processors.wiki.ti.com/index.php/MCSDK_VIDEO_2.0_Demo_Guide
• Codec Integration and Test User Guide: http://processors.wiki.ti.com/index.php/MCSDK_VIDEO_2.0_CODEC_TEST_FW_User_Guide
• Functional Specifications: http://software-dl.ti.com/sdoemb/sdoemb_public_sw/mcsdk_video/latest/exports/mcsdk_video_functional_spec_02_00_00.pdf

Technical Support and Product Updates

For technical discussions and issues, please visit

• C66x Multicore forum: http://e2e.ti.com/support/dsp/c6000_multi-core_dsps/f/639.aspx
• BIOS Embedded Software forum: http://e2e.ti.com/support/embedded/f/355.aspx
• Code Composer Studio forum: http://e2e.ti.com/support/development_tools/code_composer_studio/f/81/t/3131.aspx
• TI C/C++ Compiler forum: http://e2e.ti.com/support/development_tools/compiler/f/343/t/34317.aspx
• Embedded Processors wiki: http://processors.wiki.ti.com

Note: When asking for help in the forum you should tag your posts in the Subject with “MCSDK VIDEO”, the part number (e.g. “C6678”) and additionally the component (e.g. “NWAL”).

For product updates,

• Visit MCSDK VIDEO (Multicore Video Infrastructure Demo Built on MCSDK): http://www.ti.com/tool/demovideo-multicore

For Video codec products,

• Visit C6678_Video_Codecs 01_00_001 Product Download Page: http://software-dl.ti.com/dsps/dsps_public_sw/codecs/C6678_Video_Codecs/01_00_001/index_FDS.html