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.
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:
- DSP/BIOS
Examples.
Some DSP/BIOS examples are now provided through the CCSv4.2 project
wizard (Requires CCSv4.2 or higher). For previous CCSv4
(v4.0,
v4.0.1, v4.0.2, v4.1, v4.1.1, v4.1.2 or v4.1.3) the source code and
configurations are provided with DSP/BIOS in the <install_dir>\packages\ti\bios\examples
directory. You can create your own CCSv4 projects and add the example
.c and .tcf files. The source code contains comments
about each example.
The
DSP/BIOS examples come preconfigured for a variety of platforms. If you
have a platform that is not included, you should use a text editor to
modify the .tcf file for the platform that is most closely
related
to
yours. In particular, you will likely need to modify the platform named
in the utils.loadPlatform() statement and the MEM module settings. See the DSP/BIOS Textual Configuration
(Tconf) User’s Guide(SPRU007) for more information about
platforms and .tcf files.
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:
- Create
a new CCS project. Open CCSv4 and select File --> New
--> CCS project.
- 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.
- An empty project will now show up named "hello_example"
under the "C/C++ Projects" tab in CCSv4.
- 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).
- To build the example, select from the CCS menu Project
--> Build Project.
To create an example in CCSv4.2 or higher
follow these steps:
- Create
a new CCS project. Open CCSv4 and select File --> New
--> CCS project.
- 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.
- A project will now show up named "hello_example" under
the "C/C++ Projects" tab in CCSv4.
- To build the example, select from the CCS menu Project
--> Build Project.
- Application
Notes. A
number of application notes have been provided about various
aspects of DSP/BIOS. Go to www.dspvillage.com
and choose Technical
Documents > Application Notes. Choose the "View by
Software" tab and select
the "Operating Systems (OS/RTOS)" item.
More
Information About DSP/BIOS
See the
following documents
available with this release and also on www.dspvillage.com
to
learn about DSP/BIOS:
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.