MCSDK VIDEO 2.1 Rebuild Dsp Guide

MCSDK Video

Version 2.1.0 (Alpha Release)

Guide to Rebuild DSP Images

Last updated: 07/28/2014

---

Introduction

The MCSDK Video release provides factory pre-built DSP image to run the video demos out of the box. It also provides the required source code to rebuild the DSP application. When the source code is modified, the DSP application can be rebuilt using the instructions on this page.

Specifically, this DSP Rebuild Guide provides information on installing software packages which are required to rebuilding the DSP image, and how to rebuild the MCSDK Video DSP application if needed.

Install Software Required for Rebuilding DSP Images

This section will walk you through installing the required software packages for rebuilding MCSDK Video DSP application. The overall steps are:

1. Install the BIOS MCSDK 2.0.5
2. Install the MCSDK Video 2.1.0
3. Install Active Perl

---

Installing the BIOS Multicore Software Development Kit

Visit BIOS-MCSDK 2.0.x to get BIOS-MCSDK 2.0 (v2.0.5) Linux installer.

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>

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:

---

Installing the MCSDK Video

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: Welcome Screen and Click Next

• Step-2: Select Destination Folder and Click Next

• Step-3: Select Components and Click Next. Note that all the components are required to rebuild the DSP application.

• Step-4: Copy the Components selected in Step-2 to the Destination Folder specified in Step-1

• Step-5: Click Finish to complete installation

---

Install Active Perl

Active Perl (5.14.2.1402) can be downloaded from Active Perl 5.14.2.1402. Install it by following Active Perl installation instructions.

Build MCSDK Video DSP Application

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

Set up environment variables

Under the installation directory of the MCSDK Video, go to <MCSDK Video Install Dir>/dsp/mkrel and run the following command to set up environment variables. Before running this command, ensure all the components/tools described above are installed. Also modify dsp/mkrel/setupenvMsys.sh as needed to point to the correct path of the installed components/tools.

<syntaxhighlight lang="bash"> cd dsp/mkrel source setupenvMsys.sh </syntaxhighlight>

"setupenvMsys.sh" will check if all the required components and tools are available at the specified locations. If not, please double check if all the required components/tools are installed and if their path information in dsp/mkrel/setupenvMsys.sh is correct.

Make DSP Image

Run dsp/mkrel/makefile to build DSP code. The following is the command to build the video application: make [build_name]. sv04 is the only DSP build in this release.

<syntaxhighlight lang="bash"> cd dsp/mkrel make sv04 </syntaxhighlight>

The build command make sv04 will produce directory: dsp/mkrel/sv04 with the following files: sv04.out, sv04.map, readme_sv04.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\sv04\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\sv04\bios directory, "BIOSCFGPKGBYPASS=YES" may be added in the make command line, which will bypass compiling the BIOS configuration package.

Use Rebuild DSP Image to Run Video Demos

In order to use the rebuild DSP image for running video demos, copy the rebuilt dsp/mkrel/sv04/sv04.out to demos\demoC667x4\dsp_images folder. Then follow steps to run video demos on a Linux PC.

Software Installation and Rebuild DSP Application on Windows

MCSDK Video 2.1 release also provides a Windows installer (mcsdk_video<version>_setupwin32.exe) which can be used to recompile DSP application on a Windows PC. The major steps of installing the required software packages and rebuilding the DSP application are listed below. More details of this can be found from MCSDK Video 2.0 Getting Started Guide.

---

Software Installation on Windows

The major steps of Windows installation includes:

1. Install BIOS MCSDK 2.0.5 with the following Components:

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

2. Install MinGW  3. Install the MCSDK Video 2.1.0 (mcsdk_video<version>_setupwin32.exe) with all the components listed  4. Install Active Perl 5.14.2.1402

---

Rebuild DSP Application on Windows

The major steps of rebuilding DSP application on Windows includes:

1. Setup environment variables: go to <MCSDK Video Install Dir>\dsp\mkrel in a command window and run batch file "setupenvMsys.bat bypass". 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 ensure all the components/tools are installed and also modify setupenvMsys.sh as needed to use the correct path for the installed components/tools.

2. Go to dsp\mkrel and run command make sv04 to rebuild DSP application. This will produce dsp\mkrel\sv01 directory with files: sv04.out, sv04.map, readme_sv04.txt.

Related Documents

• Release Notes: TBD
• MCSDK Video 2.1 Getting Started Guide: http://processors.wiki.ti.com/index.php/MCSDK_VIDEO_2.1_Getting_Started_Guide
• MCSDK Video 2.1 Development Guide: http://processors.wiki.ti.com/index.php/MCSDK_VIDEO_2.1_Development_Guide

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): TBD

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