MCSDK VIDEO AUDIO 2.0 Getting Started Guide

Video and Audio Applications on BIOS MCSDK

Version 2.0.0

Getting Started Guide

Last updated: 07/28/2014

---

Introduction

The MCSDK Video/Audio provides software development environment to implement real-time video applications on TI C66x multi-core DSPs. The MCSDK Video builds on BIOS MCSDK 2.0 to achieve platform abstraction, networking, and inter-core communication. Multiple Video codecs are integrated for demonstrating video applications on single and multiple cores.

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

• Installed CCS
• Installed the BIOS-MCSDK Software and its requiring tools
• Installed the MCSDK Video/Audio Software and its requiring tools
• Rebuilt the MCSDK Video/Audio application if needed

Foundational Components

The foundational components of the MCSDK Video/Audio include:

• System Framework and Video/Audio Components and Demos
• Framework Components for managing EDMA resource use and data transfer
• Network Adaptation Layer (NWAL) Driver
• eXpressDsp Algorithm Interoperability Standard (XDAIS)
• Video Codecs

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 and Audio Application. The overall steps are:

1. Install Code Composer Studio 5.0
2. Install the BIOS-MCSDK 2.0
3. Install the BIOS-MCSDK Video and Audio 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-AUDIO:

• 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 MCSDK-VIDEO-AUDIO:

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

Select BIOS-MCSDK components snap shot:

Install tools required by MCSDK 2.0.5

1. Install Codegen tools 7.2.4: Codegen 7.2.4
2. Install MinGW: MinGW When installing MinGW, must add the MSYS Basic System and MinGW Developer Toolkit.

---

Installing the MCSDK Video and Audio Applications

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

• MCSDK Video Audio
• TI Framework Components
• TI Network Adaptation Layer (NWAL) Driver
• TI XDAIS
• Video Codecs

On Windows OS

To install MCSDK Video Audio Applications on your Windows PC run the MCSDK Video Audio installer (mcsdk_video_audio<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_audio<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_audio<version>_setuplinux.bin ./bios_mcsdk_<version>_setuplinux.bin </syntaxhighlight>

Install Active Perl for BIOS-MCSDK VIDEO/AUDIO

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.

Useful Tip Pre-built multi-core video/audio demo builds have been included in the MCSDK Video Audio component. To run the multi-core video/audio demo builds as is, the only steps needed include installation of MCSDK Video Audio Applications with only MCSDK Video Audio 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 Framework.

---

Prepare MCSDK Video and Audio Demo Builds

To prepare MCSDK video/audio 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

On Windows OS

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

On Linux OS

Under the installation directory of MCSDK Video/Audio, go to <MCSDK Video/Audio Install Dir>\dsp\mkrel, run command ". setupenvMsys.sh bypass".

"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/audio application: make [build_name]. There are two major builds in the MCSDK Video/Audio 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/Audio 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

• Real-time Video Demonstrations: http://processors.wiki.ti.com/index.php/Multicore_Video_Demonstration_Guide
• Codec Integration and Test Framework: http://processors.wiki.ti.com/index.php/MCSDK_VIDEO_AUDIO_2.0_CODEC_TEST_FW_User_Guide

Related Documents

• Release Notes: Link TBD
• Real-time Video Demonstrations: http://processors.wiki.ti.com/index.php/Multicore_Video_Demonstration_Guide
• Codec Integration and Test Framework User Guide: http://processors.wiki.ti.com/index.php/MCSDK_VIDEO_AUDIO_2.0_CODEC_TEST_FW_User_Guide
• Functional Specifications: Link TBD

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/AUDIO Applications: Link TBD