Desktop-linux-sdk 01.00.00.03 DSP Rebuild Guide

Desktop Linux SDK


Version 1.0.0.3 Alpha Release

Guide to rebuild DSP images

Last updated: 08/30/2012

---

Introduction

The Desktop Linux SDK includes the DSP images to run the demo applications and the demos can work out of the box, The package also include the required sources to rebuild the DSP image. If required, the source code can be modified and dsp images can be rebuilt using the procedures on this page.

Required Compile Tools

To rebuild the DSP images, the following packages are needed.

1. CCS 5.1 or higher
2. TI MCSDK for TMS320C66x Processors V.2.0.3.15 or V.2.0.9.21 Refer to website: http://focus.ti.com/docs/toolsw/folders/print/bioslinuxmcsdk.html

The Desktop Linux SDK dsp builds use the platform part of MCSDK 2.0 [MCSDK Getting Started Guide, MCSDK User's Guide] to achieve platform abstraction.

Re-building of the image first requires patching the platform library which is part of the MCSDK package, for the Advantech platform.

Platform library patch and re-build instruction

[Note: This step is not required for the EVM Single C6678 card]
If you are using the Advantech Quad C6678 or Octal C6678 platform, the platform library in the MCSDK has to be patched to create library corresponding to the Advantech Card.

Steps to patch and build the platform library for are as follows (The instructions are for pdk_c6678_1_0_0_21. Similar procedure to be followed for other pdk releases, with the change in directory names)

1. Patch the platform files for DSPC8681 and DSCPC8682 in the PDK:
Copy the directory “desktop-linux-sdk\sdk\platform_patch\dspc8681” and paste to “<pdk_install_directory>/pdk_C6678_1_0_0_21/packages/ti/platform/”
Copy the directory “desktop-linux-sdk\sdk\platform_patch\dspc8682” and paste to “<pdk_install_directory>/pdk_C6678_1_0_0_21/packages/ti/platform/”
Copy the csl patch from “desktop-linux-sdk\sdk\platform_patch\csl_patch\packages” and paste to “<pdk_install_directory>/pdk_C6678_1_0_0_21/packages”
2. Import the CCS project from "<pdk_install_directory>pdk_C6678_1_0_0_21\packages\ti\platform\dspc8681\platform_lib" directory or
"<pdk_install_directory>pdk_C6678_1_0_0_21\packages\ti\platform\dspc8681\platform_lib" according to what library is needed.
(In CCSv5, Project->Import Existing CCS/CCE Eclipse Projects)

3. Select "Lite" as active configuration (in CCSv5, Project->Properties)

Choose "Lite" Click Set Active button. Click OK Set Configuration to Lite

4. Clean the platform_lib_evmc6678l project and re-build the project. After build is completed the ti.platform.<dspc8681|dspc8682>.lite.lib will be generated under the directory: "pdk_C6678_1_0_0_21\packages\ti\platform\<dspc8681|dspc8682>\platform_lib\lib\debug"
5. Repeat step 3 and step 4, select "Debug" as active configuration and re-build the project: ti.platform.<dspc8681|dspc8682>.ae66 will be generated under the same directory

Demo DSP test image build instruction

The DSP image used by the “filetestdemo” can be built by using the DSP projects under the directory: desktop-linux-sdk/filetestdemo/c66x/demo_loopback.

1. Go to directory: “\desktop-linux-sdk\demos\filetestdemo\c66x\demo_loopback/build” and open macros.ini.

2. Edit macros.ini to update the PDK_C6678_INSTALL directory to where the PDK package under MCSDK is installed in the system. And DESKTOP_LINUX_SDK_DIR to where the desktop Linux SDK is installed.

(For example :

- Windows:

PDK_C6678_INSTALL_DIR=”c:\Program Files\Texas Instruments\pdk_C6678_1_0_0_15”
DESKTOP_LINUX_SDK_DIR=”c:\desktop-linux-sdk”

- Linux:

PDK_C6678_INSTALL_DIR =/opt/ti/pdk_C6678_1_0_0_15
DESKTOP_LINUX_SDK_DIR=/opt/ti/desktop-linux-sdk

)

3. Import the demo_loopback CCS project from “desktop-linux-sdk\demos\filetestdemo\c66x\demo_loopback\build” directory. ( In CCSv5, Project -> Import Existing CCS/CCE Eclipse Projects)
and click finish

4. Clean the demo_loopback project and rebuild the project. After build is completed the build files: demo_loopback.out and demo_loopback.map will be generated under the directory: desktop-linux-sdk\demos\filetestdemo\c66x\demo_loopback\build\Debug

DSP init image build instruction

The init DSP image is used as a boot image to initialize the DDR and Ethernet switch. The DSP build can be built from the project directory: “desktop-linux-sdk_<versionno>\sdk\dsp_projects\dsp_init\build”.

1. Go to directory: “desktop-linux-sdk_<versionno>\sdk\dsp_projects\dsp_init\build”. and open macros.ini.

2. Edit macros.ini to update the TI_PDK_C6678_INSTALL directory to where the PDK package under MCSDK is installed in the system. And DESKTOP_LINUX_SDK_DIR to where the Desktop Linux SDK is installed.

(For example :

- Windows:

TI_PDK_C6678_INSTALL_DIR=c:\Program Files\Texas Instruments\pdk_C6678_1_0_0_15
DESKTOP_LINUX_SDK_DIR=c:\desktop-linux-sdk_01_00_00_01

- Linux:

TI_PDK_C6678_INSTALL_DIR =/opt/ti/pdk_C6678_1_0_0_15
DESKTOP_LINUX_SDK_DIR=/opt/ti/desktop-linux-sdk_01_00_00_01

)

3. Import the demo_loopback CCS project from “desktop-linux-sdk_<versionno>\sdk\dsp_projects\dsp_init\build” directory. ( In CCSv5, Project -> Import Existing CCS/CCE Eclipse Projects)

4. Choose the platform to be used for the compilation. ( In CCSv5: Click Project -> Properties. On the window that opens Select 'Build' and click on 'Variables' tab. Edit the following two variables: PLATFORM_NAME & PLATFORM_DIR_NAME to <dspc8682|dspc8682>
5. Clean the project and rebuild the project. After build is completed the build files: init.out and init.map will be generated under the directory: “desktop-linux-sdk_<versionno>\sdk\dsp_projects\dsp_init\build\Release”

Copy the built images into the appropriate folder dspc8681, dspc8681, evm6678 or evm6678 in the demos/dsp_images folder.

Related Documents

• Desktop Linux SDK: Release Notes: desktop-linux-sdk_01_00_00_02_releasenotes.pdf
• Desktop Linux SDK: Getting Started Guide: http://processors.wiki.ti.com/index.php/Desktop-linux-sdk_01.00.00_Getting_Started_Guide
• Desktop Linux SDK: Hardware Setup Guide: http://processors.wiki.ti.com/index.php/Desktop_Linux_SDK_Hardware_setup_guide
• Desktop Linux SDK: Development Guide: http://processors.wiki.ti.com/index.php/Desktop-linux-sdk_01.00.00_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 “DESKTOP-LINUX-SDK” and the part number (e.g. “C6678”)