NOTICE: The Processors Wiki will End-of-Life on January 15, 2021. It is recommended to download any files or other content you may need that are hosted on processors.wiki.ti.com. The site is now set to read only.
MCSDK VIDEO 2.0 Getting Started Guide
(Multicore Video Infrastructure Demo Built on MCSDK)
Getting Started Guide
Last updated: 07/28/2014
- 1 Introduction
- 2 Getting Started
- 2.1 Installing Code Composer Studio (as required by the BIOS-MCSDK 2.0)
- 2.2 Installing the BIOS Multicore Software Development Kit and Dependent Tools
- 2.3 Installing the MCSDK Video
- 2.4 Install Active Perl for the MCSDK VIDEO
- 2.5 Prepare MCSDK Video Demo Builds
- 3 Running the Demonstration Applications
- 4 Related Documents
- 5 Technical Support and Product Updates
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
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 , Active Perl installation , and Running the Demonstration Applications section .
This release supports the following Texas Instrument devices/platforms:
|Platform Development Kit||Supported Devices||Supported EVM|
|C6678||TMS320C6678, TMS320TCI6608||TMDXEVM6678L, TMDXEVM6678LE, TMDXEVM6678LXE|
This section will walk you through installing the MCSDK Video. The overall steps are:
- Install Code Composer Studio 5.0
- Install the MCSDK 2.0
- 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
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
- XDC tools
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 (126.96.36.1992) can be downloaded from Active Perl 188.8.131.522. 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.
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.
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
- 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