Texas Instruments Technology for Innovators

Installation and Setup for DSP/BIOS 5.41

 

This version of DSP/BIOS is delivered as a component of Code Composer Studio v4 (CCStudio). It is available for Microsoft Windows. It includes support for all DSP families supported by DSP/BIOS: C28x, C55x, and C6x.

 

For the latest information about what’s new in this release and any known issues, see the release notes (which, in turn, has links to other documents).

 

This document describes how to perform the following tasks:

Installing DSP/BIOS

DSP/BIOS 5.41 is installed as part of the CCSv4 installation process. 


If you ever need to uninstall DSP/BIOS, an uninstaller is provided for Windows (Control Panel -> Add/Remove Programs).

Setting System Variables

If you want to build with DSP/BIOS 5.41 outside the CCSv4 environment, follow these steps:

1.     Create the BIOS_INSTALL_DIR system environment variable, and set it to <install_dir>/bios_5_41.

2.     Insert the location of the XDCtools 3.15 installation at the beginning of your PATH system environment variable. (Remove any DSP/BIOS or XDCtools locations that were put in for earlier DSP/BIOS or XDCtools installations.) For Windows use back slashes (“\”) and a semicolon (;) between each system environment variable you add to the PATH. For example:

C:\Program Files\Texas Instruments\xdctools_3_15

Coordinating with CCStudio v4

In order to correctly build DSP/BIOS 5.41 applications, you need to enable DSP/BIOS support when creating a DSP/BIOS project. To watch a demo that creates a CCSv4 project that uses DSP/BIOS, see the Hello World DSP/BIOS 5 demo. See Section 2.1 of the TMS320 DSP/BIOS v5.41 User’s Guide (SPRU423) for descriptions of the steps in this demo. You can perform this demo yourself to test your installation.

   

When you are creating a CCSv4 project, the key step is to select the "Use DSP/BIOS v5.xx" option in the Target Content area of the "CCS Project Settings" page. 

   

Target content options

     

If you want to modify the version of DSP/BIOS used to build an existing project, right-click on the project name in the CCSv4 list of projects and choose Build Properties. In the CCS Build Settings category, go to the General tab and choose the DSP/BIOS version you want to use.


Converting CCSv3.3 Projects to CCSv4 Projects

To import a CCSv3.3 project, choose Project > Import Legacy CCSv3.3 Project in CCSv4. Follow the instructions in the import wizard. For more information about converting CCSv3.3 projects to CCSv4 projects, go to the Code Composer Studio Mediawiki and read the "Migration" section of the page.

If you are importing a project that uses DSP/BIOS, the import wizard asks you to select the version of DSP/BIOS you want the imported project to use. It is recommended that you select DSP/BIOS 5.41. This version of DSP/BIOS is compatible with previous 5.x versions. If you select a DSP/BIOS 6.x version, you will need to make changes to your source code and configuration. If you select a DSP/BIOS version prior to 5.41, you will not have access to the ROV tool and Real-time Analysis debugging features.

DSP/BIOS Examples

You can use the following sources for example DSP/BIOS applications:


When building the examples for 28x or 55x it is sometimes necessary to open the project build properties and set the appropriate values. For instance, if using 28x or 55x and large model is set for the example it may be neccessary to set the same model option for the compiler.  If you would like to run huge model for evm5505 and evm5515 examples then --ptrdiff_size would need to be set from 16 to 32. These and other runtime options can be found under the Build Properties --> C/C++ Build --> C5500 Compiler --> Runtime Model Options.  
See the release notes for known issues.
        To create an example in CCSv4.0 or CCSv4.1 versions follow these steps:
    1. Create a new CCS project.  Open CCSv4 and select File --> New --> CCS project.
    2. This will start the project wizard.  Step through each window pane and answer the questions to create your project for your device. 
      • In the first pane, give the project a name.  For example, hello_example.
      • Next, select the project type from the dropdown menu
      • Additional project settings pane, for your first project select "next" for this pane.
      • CCS project settings pane.  Select your device variant. If you do not find your device listed in the drop down menu, you may use the generic device for your target device.  For the "Target Content" section on this pane select the radio button to "Use DSP/BIOS v5.xx".  
      • Click the "finish" button at the bottom of the window pane.
    3. An empty project will now show up named "hello_example" under the "C/C++ Projects" tab in CCSv4.
    4. Right click on the project name and select "Add Files to Project...".  Navigate to the  <install_dir>\packages\ti\bios\examples and select the example hello.c file to add to your project.  Repeat this process and under the examples folder select your device folder and add the hello.tcf file to the project  (Additional changes may be needed in the build properties for specific devices, see note in preceding paragraph). 
    5. To build the example, select from the CCS menu Project --> Build Project.
       
        To create an example in CCSv4.2 or higher follow these steps:
    1. Create a new CCS project.  Open CCSv4 and select File --> New --> CCS project.
    2. This will start the project wizard.  Step through each window pane and answer the questions to create your project for your device. 
      • In the first pane, give the project a name.  For example, hello_example.
      • Next, select the project type from the dropdown menu
      • Additional project settings pane, for your first project select "next" for this pane.
      • CCS project settings pane.  Select your device variant. If you do not find your device listed in the drop down menu, you may use the generic device for your target device.  Select "Next".
      • Expand the "+ DSP/BIOS v5.xx Examples" tree.  Select the folder for your device and expand.  Select the hello Example.  
        • There are more examples in <install_dir>\packages\ti\bios\examples that are not listed in the project wizard.  It possible to create these other examples by selecting "Empty Project" at this point and add the .c and .tcf files to your project manually via the steps listed above for CCSv4/CCSv4.1 projects.
      • After the example is selected, click the "Finish" pane at the bottom of the pane. 
    3. A project will now show up named "hello_example" under the "C/C++ Projects" tab in CCSv4.  
    4. To build the example, select from the CCS menu Project --> Build Project.

 

If you do not use CCStudio to build your application, you can build from the command line using gmake and makefiles.

 

The best way to create build files for your application is to copy and revise the makefile shipped with this product. The relevant files for the examples shipped with DSP/BIOS 5.41 are:

  

IMPORTANT: Only use forward slashes (“/”) in all makefiles and files included by makefiles regardless of the OS you are using.


Typical things you might need to change in config.mak are:

            Typical things you might need to change in cNNrules.mak are:
            Typical things you might need to change in makefile are:

 

In order to use gmake to build using the supplied makefiles you may have to add the XDCtools install directory to your PATH.  Once this is setup, you can build the hello example using the following syntax from the command line "gmake -f makefile_hello". 

 

Windows: 

Open the Environment Variables setting and add the XDCtools directory to the PATH 

            Right click on "My Computer" and select properties --> Advanced --> Environment Variables

            Under "System Variables" scroll down to Path and double click on it

            Scroll to the beginning of the line for "Variable Value" and add the XDCtools install dir followed by a semi-colon. 

              

Linux:

If you are using bash on Linux, change the PATH with teh following command:

export PATH=<XDCtools_install_dir>:$PATH

             If you are using bash on Linux, change the PATH with the following command:

Set PATH =(<XDCtools_install_dir> $PATH)


More Information About DSP/BIOS

See the following documents available with this release and also on www.dspvillage.com to learn about DSP/BIOS:

 

 

Texas Instruments: The World Leader in DSP and Analog

Copyright © 2010, Texas Instruments Incorporated

 

Code Composer Studio, DSP/BIOS, eXpressDSP, and TMS320 are among the trademarks of Texas Instruments. See www.ti.com for a list of trademarks and registered trademarks belonging to Texas Instruments.