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.1 Windows Getting Started Guide
MCSDK Video
(Multicore Video Infrastructure Demo Built on MCSDK)
Version 2.x
Getting Started Guide for Windows
Last updated: 11/18/2013
Contents
Introduction[edit]
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.x [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 for Windows provides information on installing and rebuilding the MCSDK Video on Windows PCs. 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 After completing the material in this Getting Started Guide, it is recommended the user continue on to the Overview of MCSDK Video Demos for additional information on running various video demos. |
Supported Devices/Platforms[edit]
This release supports the following Texas Instrument devices/platforms:
Platform Development Kit | Supported Devices | Supported EVM |
C6678 | TMS320C6678, TMS320TCI6608 | TMDXEVM6678LXE |
Supported Demos[edit]
Please refer to MCSDK Video 2.x Demo Guide for the list of demos supported.
Hardware/OS Requirement[edit]
The Ethernet based MCSDK Video demos run on Windows XP or Windows 7 PCs.
Software Installation[edit]
This section will walk you through installing the MCSDK Video. The overall steps are:
- Install Code Composer Studio 5.x
- Install the MCSDK 2.x
- Install the MCSDK Video 2.x
Installing Code Composer Studio (as required by the BIOS-MCSDK 2.x)[edit]
The BIOS-MCSDK 2.x uses CCS 5.x. Please refer to MCSDK Video product download page MCSDK Video download for the version of BIOS-MCSDK 2.x and its corresponding CCS version to be installed. To install CCS please refer to the instructions provided in the CCSv5 Getting Started Guide. It is recommended to keep the default installation paths for CCS and the other components.
If you choose to do a custom installation, the following components must be installed to support the MCSDK VIDEO:
- C6000 DSPs
Sample Custom Installation snap shot:
Select C6000 DSPs during Choose ISA option:
Installing the BIOS Multicore Software Development Kit and Dependent Tools[edit]
Please refer to MCSDK Video product download page MCSDK Video download for the version of BIOS-MCSDK 2.x. Make sure CCS is closed before invoking the BIOS-MCSDK installer.
For running the out of box MCSDK Video demos, please select just a single component: MCSDK 2.x.x.x.
To rebuild MCSDK VIDEO builds, the following components of BIOS-MCSDK must be installed.
- PDK C6678
- EDMA3-LLD
- SYS/BIOS
- XDC tools
- IPC
- Install MinGW as required by MCSDK 2.x for rebuilding MCSDK VIDEO builds
For running demos with pre-built DSP builds, this step is not needed. For building MCSDK VIDEO builds, install MinGW: When installing MinGW, must add the MSYS Basic System and MinGW Developer Toolkit.
Installing the MCSDK Video[edit]
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 selected MCSDK video components will be installed in the specified installation directory.
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 or make sure that CCS and the other components are installed along the same path.
- Major Steps of MCSDK Video Installation
- Step-1: Select Destination Folder
- Step-2: Select Components
To run the MCSDK video demos with pre-built dsp images, MCSDK Video component is the only component needed as shown below:
To rebuild DSP builds, all the components are required as shown below:
- Step-3: Click Next button and that would 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: Click Next button to install Codegen if it has been selected in Step-2
- Step-5: Click Next button to install Codecs which have been selected in Step-2
Install Active Perl for the MCSDK VIDEO[edit]
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.
Running the Demonstration Applications[edit]
Please refer to the following links for running the demonstration applications
- Ethernet Based Demos in MCSDK Video: http://processors.wiki.ti.com/index.php/MCSDK_VIDEO_2.1_Demo_Guide#Ethernet_Based_Demos
Congratulations! At this time, you already should have finished running out of box demos. The following section is for recompiling DSP builds (sv01.out and sv04.out files).
Rebuild MCSDK Video Demo Builds[edit]
The installed package contains pre-built DSP binaries. These binaries are sufficient for running all the demos listed in MCSDK Video Demo Overview. The following steps are needed only when there are changes in the source code and therefore the sample builds need to be recompiled. To rebuild MCSDK video demo builds, follow the two steps below to set up environment variables and then rebuild the sample builds.
Set up environment variables[edit]
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[edit]
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 dsp\mkrel\sv01\flat containing all source and header files used for the build.
|
Useful Resources and Links[edit]
Product Download and Updates[edit]
For product download and updates, please visit the links listed in the table below.
Product Download Link | |
MCSDK Video (2.1 GA) Download | http://software-dl.ti.com/sdoemb/sdoemb_public_sw/mcsdk_video/latest/index_FDS.html |
MCSDK Video (2.2 Alpha) Download |
http://software-dl.ti.com/sdoemb/sdoemb_public_sw/mcsdk_video/02_02_00_23/index_FDS.html |
BIOS MCSDK Download | http://software-dl.ti.com/sdoemb/sdoemb_public_sw/bios_mcsdk/02_01_02_05/index_FDS.html |
Desktop Linux SDK Download | http://software-dl.ti.com/sdoemb/sdoemb_public_sw/desktop_linux_sdk/01_00_00_07/index_FDS.html |
C6678 Codec Download | http://software-dl.ti.com/dsps/dsps_public_sw/codecs/C6678/index.html |
MCSDK Video Instructions[edit]
Please visit the links below to install MCSDK Video, run the video demos, and get the details on how the MCSDK Video demos are developed.
Technical Support[edit]
For technical discussions and issues, please visit the links listed in the table below.
Forum/Wiki Link | |
C66x Multicore forum | http://e2e.ti.com/support/dsp/c6000_multi-core_dsps/f/639.aspx |
Multimedia Software Codecs forum | http://e2e.ti.com/support/embedded/multimedia_software_codecs/default.aspx |
TI-RTOS 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”).