From Texas Instruments Embedded Processors Wiki

BIOS Multicore Software Development Kit

Version 2.0.x

Getting Started Guide

Last updated: 5/09/2012

Introduction

The BIOS Multicore Software Development Kit (MCSDK) provides the core foundational building blocks that facilitate application software development on TI's high performance and multicore DSPs. The foundational components include:

• SYS/BIOS which is a light-weight real-time embedded operating system for TI devices
• Chip support libraries, drivers, and basic platform utilities
• Interprocessor communication for communication across cores and devices
• Basic networking stack and protocols
• Optimized application-specific and application non-specific algorithm libraries
• Debug and instrumentation
• Bootloaders and boot utilities
• Demonstrations and examples

Specifically, this Getting Started Guide provides information on installing the BIOS Multicore Software Development Kit, loading the EVM out-of-box demonstration application via JTAG, and running the out-of-box demonstration application. It is expected the user has gone through the EVM Quick Start Guide provided with their EVM and have booted the out-of-box demonstration application flashed on the device.

By the end of this Getting Started Guide the user should have:

• Installed CCS
• Installed latest Emulation Package
• Installed the BIOS-MCSDK Software
• Connected to the EVM via CCS/JTAG
• Loaded the out-of-box demonstration application onto the device via JTAG
• Executed the out-of-box demonstration application

Useful Tip After completing the material in this Getting Started Guide, it is recommended the user continue on to the BIOS MCSDK User’s Guide for additional information on the MCSDK software elements and to get started with development using the BIOS-MCSDK.

Acronyms and Definitions

The following acronyms are used throughout this document.

Note: We use the abbreviation TMS when referring to a specific TI device (processor) and the abbreviation TMD when referring to a specific platform that the processor is on. For example, TMS320C6678 refers to the C6678 DSP processor and TMDSEVM6678L refers to the actual hardware EVM that the processor is on.

Supported Devices/Platforms

This release supports the following Texas Instrument devices/platforms:

What's in this Kit?

The kit contains:

• EVM Board: This board contains a Multicore System-on-Chip.
• Universal Power Supply: Both U.S. and European power specifications are supported.
• Cables: USB, Serial, and Ethernet cables are included to allow for host development.
• Software DVD: Software installers, documentation, factory images.
• EVM Quick Start Guide: Single page guide to get started run demos pre-flashed on board.

The Multicore EVM kit Software DVD includes:

• BIOS Multicore Software Development Kit installer
• Linux Multicore Software Development Kit tarball
• Code Composer Studio installer
• Factory image restoration process

The C6678, C6670, and TCI6618 EVMs will have the following content loaded in flash/EEPROM:

Getting Started

This section will walk you through installing and using the BIOS Multicore Software Development Kit, including how to flash and run the out-of-box demonstration application, HUA. It is expected that you have gone through the EVM Quick Start Guide for your EVM and have booted the demonstration application flashed on the device.

The overall steps are:

1. Make sure your EVM hardware is set up
2. Install Code Composer Studio v5
3. Install latest emulation package
4. Install the BIOS-MCSDK 2.0
5. Use JTAG to load the application
6. Run the application

Hardware Setup

Follow instructions in one of the links below that correspond to the EVM that you are using

• TMDSEVM6678L EVM Hardware Setup (use this link if you have a LE or LXE model)

• TMDSEVM6670L EVM Hardware Setup (use this link if you have a LE or LXE model)

• TMDSEVM6618LXE EVM Hardware Setup

Installing Code Composer Studio

The BIOS-MCSDK 2.0 uses CCS v5. To install CCS please refer to the instructions provided in the CCSv5 Getting Started Guide.

When installing Code Composer Studio you can choose to control what is installed. For example, you may not want support for particular devices and ISA's. If you choose to do a custom installation, the following components must be installed to support the MCSDK:

• SYS/BIOS 6
• IPC
• XDC
• All C6* DSP

Note: In Windows 7, install and run CCS/BIOS MCSDK in administrator mode, this will rule out issues with CCS start-up and RTSC component recognition

Sample Custom Installation snap shot:

Select C6000 DSPs during Choose ISA option

Installing Latest Emulation Package

The Emulation Package provides GEL files and XML files that are used to manually configure the EVM. It is needed if you are planning to use CCS to load an application. Ultimately, this configuration should come from the application itself.

The way to move to the latest version of the emulation package depends on the version of CCS that you are using:

• CCS 5.0.3 users:
  • Download the emupack zip file from the BIOS-MCSDK download page
  • Unzip to a temp directory (say c:\temp for windows OR ~/temp for Linux)
  • Please follow the instructions as per README.txt provided in the zip file.

Note: Please note that for CCS 5.0.3, there are no updates for the XML files needed.

• CCS 5.1 users:
  • Please install the emupack installer following the sequences as requested by the installer. This would update the necessary GEL files and the XML files needed to configure the EVM.

Installing the BIOS Multicore Software Development Kit

• After installing CCS, the next step is to install the BIOS-MCSDK. Please make sure CCS is closed before the installation of BIOS MCSDK. Some of the components installed by CCS may be updated by the BIOS-MCSDK installer; see the Release Notes for full details of components included in the installer. The development environment can be either Windows or Linux. The MCSDK installer allows you to choose the installation directory. The MCSDK install may include several sub-components as indicated in the Release Notes; all of the components will be installed in the same location.

Each software component comes as an eclipse plug-in. After installing BIOS-MCSDK, CCSv5 should recognize each of the plug-ins when it starts up. In CCSv5 window, Help->Help Contents will list all the available docs and user can browse the docs from the help window.

Useful Tip For CCS to discover the BIOS-MCSDK installation, install the BIOS-MCSDK package into one of the folders that CCS will be search by default. If any other directory outside these paths are selected for the installation, manually add that path into the tool discovery path in CCS, by using Window->Preferences menu in CCS. By default, CCS RTSC tool discovery paths are: C:/Program Files/Texas Instruments C:/[CCSv5_install_dir] (e.g.; c:/TI, if CCS is installed under c:/TI directory)

Getting the BIOS MCSDK

Please refer to Technical_Support_and_Product_Updates link for getting the BIOS MCSDK software.

Note: Make sure CCS is closed before invoking the BIOS-MCSDK installer.

Run the Installer & Provide the installation path

On Windows OS

To install BIOS-MCSDK on your Windows PC run the MCSDK installer (bios_mcsdk_<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. This allows CCS to auto discover the components and generally makes things simpler.

On Linux OS

The instalation is tested on Ubuntu Linux distribution, but it expected to work on other Linux distributions as well. After downloading the Linux installer, (bios_mcsdk_<version>_setuplinux.bin), please change the attribute of the installer to executable and run the installer as shown below.

chmod +x bios_mcsdk_<version>_setuplinux.bin
./bios_mcsdk_<version>_setuplinux.bin

Note: If you are installing on a Windows 7 machine, modify the default path to "C:\Program Files\Texas Instruments". Otherwise, some of the CCS projects in the release may not build properly.

Note: MCSA (Multicore System Analyzer) which includes UIA + DVT will be installed under ccsv5 directory (for non CCSv5.1+ users only).

Note: The BIOS MCSDK installer might default to C:\Program Files(x86)\Texas Instruments for 64 bit machines. There are some projects in the BIOS MCSDK which assumes the default MCSDK installation directory to be C:\Program Files\Texas Instruments. The workaround would be to install BIOS MCSDK in C:\Program Files\Texas Instruments folder, then all the projects will re-compile without any change. If it is installed in C:\Program Files(x86)\Texas Instruments then minor tweaks might be required for few projects to re-compile.

The installer setup window would pop.

A sample setup window screen shot is shown as below.

. Please notice that there are two paths are asked to be entered.

1. CCSv5 installation path : Is Not Applicable for those who are using CCSv5.1+
2. Bios-MCSDK Destination folder: Bios MCSDK install location. Please provide the install path to the PARENT ccsv5 directory to avoid manual RTSC discovery tool setup in CCSv5.

Check/Uncheck MCSA depending on the CCS Version

Due to a compatibility issue with CCS 5.1, the MCSA component is not selected by default in the installer. If using CCS 5.0.3, please select this component to install it; starting from CCS 5.1, MCSA is included in the CCS installer.

Completing the installation

After the installation of BIOS MCSDK, please invoke the CCSv5 and notice the new components that are installed by BIOS MCSDK are discovered by CCSv5. Please check all the new discovered products and restart the CCSv5.

A sample screen shot in CCSv5 discovering the new products is shown as below.

Sample Directory Structure after the installation

The BIOS-MCSDK install includes several sub-components, all of which (except for MCSA) will be installed in the same location. This location can be choosen using "Destination Folder". The BIOS-MCSDK installer also requires the location of an already installed CCSv5.0. This location is specified in "Code Composer Studio v5.0 Installation Directory" (this is the location to the "ccsv5" folder).

Once the installation is complete all the BIOS-MCSDK components will be installed in the specified installation directory. Each of the directories will be of the format <component_name>_<component version>. Please refer to individual components release notes for detailed information on the components or package.

A sample directory structure after a typical BIOS MCSDK default installation is shown below

+---bios_6_32_04_49
+---ccsv5
+---cg_xml
+---edma3_lld_02_11_02_04
+---imglib_c66x_3_0_1_0
+---ipc_1_23_01_26
+---mathlib_c66x_3_0_0_0
+---mcsdk_2_00_02_14
+---ndk_2_20_04_26
+---pdk_C6670_1_0_0_14
+---pdk_C6678_1_0_0_14
\---xdctools_3_22_01_21

Use JTAG to Load the Application

The following steps will guide you through connecting the JTAG to the EVM. These instructions are for the on-board XDS100 emulator on the TMDSEVMxxxxL EVM. For LE or LXE models, the procedure is similar except as noted. For more information on the emulators, see the respective page for XDS100 or XDS560. A Target Configuration File tells CCS how to connect to the EVM (they reference device specific files which have been supplied and contain information about the EVM, SoC and interface being used). Without one, you will not be able to load or debug applications over JTAG using CCS.

1. Set the EVM Boot Mode to "No Boot" and power on the EVM. See the respective EVM Hardware Setup page listed above for the Boot Mode table.
2. First time CCSv5 users needs to follow the steps described in CCSv5_Running_for_the_first_time page.
3. The above procedure will open up the CCSv5 GUI.
4. Create a New Target Configuration, by selecting the tab File->New and clicking Target Configuration File.
5. Enter a configuration file name (say "evmc6678l_xds100v1.ccxml") in the file name field and hit finish button (the procedure assumes you are using On-board XDS100-class USB emulation).
6. Select the connection type as "Texas Instruments XDS100v1 USB emulator" for XDS100 or "Blackhawk XDS560v2-USB Mezzanine Emulator" for XDS560 in the drop down list and enter device number in the Device search filed. Select the EVM device as specified in the Target Config figure and save the file by clicking Save button.
   

   

   Target Config EVMC6678L
7. Click View->Target configurations to list the available target configurations. The configuration file (evmc6678l_xds100v1.ccxml) created above will be under "User Defined" section
8. Right click on the configuration file and select Launch Selected Configuration. This will launch the configuration and open the debug view.
9. Right click on core0 and select Connect Target to connect to the target CPU. This step will require the board is powered up and the PC is connected to the board using USB.
10. Most of the development and debugging will require CCSv5. For more information on CCSv5 see the CCSv5 Getting Started Guide page.
    

Loading and Setting up the EVM with the Gel file

Note: The same target GEL file is used for all different EVM models of the same processor (L, LE, LXE).

After the target configuration is launched, the GEL file can be set for each core. Before executing any application it is recommended to execute the GEL script Global_Default_Setup for the evmc66##l. The example below shows how to load and execute the GEL script from the GEL file for TMDSEVM6678xxx EVM.

1. Click on the core on which the GEL file needs to be loaded and select Tools->GEL Files from the Tools Menu. This is captured in the GEL Menu under CCSv5
   

   

   GEL Menu under CCSv5
2. Right-click on the first row of the empty list to get a Load GEL command
   

   

   Load GEL Command
   .
3. Execute the Load GEL command.
4. Browse & Open the GEL file. The evmc66xxl.gel GEL file is located under <CCS Installation Directory>\ccs_base_5.#.#.####\emulation\boards\evmc66xxl\gel directory.
   

   

   Browsing the GEL File
5. Run Global_Default_Setup from the Scripts Menu.
   

   

   Scripts->Global_Default_Setup

Running the Demonstration Application

Demonstrations are pre-loaded on the EVM flash as indicated above. The "out of box" demonstration is the High Performance DSP Utility Application (HUA). The following instructions use CCS to load the application via JTAG.

From a Windows PC

1. Enter the CCS debug view, select Run->Load->Load Program. The Program File field browse to C:\Program Files\Texas Instruments\mcsdk_2_##_##_##\demos\hua\evmc66##l\Debug and select hua_evmc66##l.out (this is the default location). It will load the program in the selected core.
2. Click on Run->Resume to run the demo on the target. In CCS 5.0, click on Target->Run.

From a Linux PC

1. Enter the CCS debug view, select Run->Load->Load Program. The Program File field browse to $HOME/ti/mcsdk_2_##_##_##/demos/hua/evmc66##l/Debug and select hua_evmc66##l.out (this is the default location). It will load the program in the selected core.
2. Click on Run->Resume to run the demo on the target. In CCS 5.0, click on Target->Run.

Note: The HUA demo runs in Static IP or DHCP mode depending on the User Switch 2. Please see the Hardware Setup section for information on switch settings and HUA Demonstration Guide for information on static IP configuration.

Note: The application will write messages simultaneously to the CCS console and the UART. Therefore you can use either the CCS Console or a serial port program to see them. When using DHCP this is the only way to get the IP address that was assigned to the unit (it will be displayed as Network Added: If-1 someip).

Settings for the serial port are

After the application starts up you should see text similar to the following in the CCSv5 console and/or UART program window:

[C66xx_0] Start BIOS 6
[C66xx_0] HPDSPUA version 2.00.00.11
[C66xx_0] Configuring DHCP client
[C66xx_0] QMSS successfully initialized 
[C66xx_0] CPPI successfully initialized 
[C66xx_0] PASS successfully initialized 
[C66xx_0] Ethernet subsystem successfully initialized 
[C66xx_0] eventId : 48 and vectId : 7 
[C66xx_0] Registration of the EMAC Successful, waiting for link up ..
[C66xx_0] Service Status: DHCPC    : Enabled  :          : 000
[C66xx_0] Service Status: THTTP    : Enabled  :          : 000
[C66xx_0] Service Status: DHCPC    : Enabled  : Running  : 000
[C66xx_0] Network Added: If-1:10.218.112.167
[C66xx_0] Service Status: DHCPC: Enabled: Running: 017 

The IP address received through DHCP in this case is 10.218.112.167. You can now open a web browser and in the address bar enter the IP address obtained. It will open up the HUA demo page.

For more information on HUA, see the HUA Demonstration 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

For local support in China, please visit

• China Support forum: http://www.deyisupport.com

Note: When asking for help in the forum you should tag your posts in the Subject with “MCSDK”, the part number (e.g. “C6678”) and additionally the component (e.g. “NDK”).

For product updates,

• Visit Multicore Software Development Kits: http://focus.ti.com/docs/toolsw/folders/print/bioslinuxmcsdk.html
• Use the CCS/Eclipse Update Manager (see the User's Guide for more information)

Note: The EVM comes with disks containing the MCSDK software and CCS. You can start with these or go to the MCSDK software download site listed above to check for the latest updates and version. The BIOS-MCSDK release download will also have pointers to applicable CCS and compiler release versions as well. Please review the release notes and software manifest before downloading and/or installing the software.

For technical support on MultiCore devices, please post your questions in the C6000 MultiCore Forum For questions related to the BIOS MultiCore SDK (MCSDK), please use the BIOS Forum Please post only comments related to the article BIOS MCSDK 2.0 Getting Started Guide here.

	Links
	ARM Microcontroller MCU ARM Processor Digital Media Processor Digital Signal Processing Microcontroller MCU Multi Core Processor Ultra Low Power DSP 8 bit Microcontroller MCU 16 bit Microcontroller MCU 32 bit Microcontroller MCU

Comments

Comments on BIOS MCSDK 2.0 Getting Started Guide

Gautamsridhar said ...

AravindBatni said ...