Site Index
   Home
   File Upload
Google

Transfer Site
Main Site

EVM5502 Board Support Library

The BSL provides a C-language interface for configuring and controlling all on-board devices. The library consists of discrete modules that are built and archived into a library file. Each module represents an individual API and is referred to simply as an API module. The module granularity is structured so each device is implemented in an individual API module. The goal of the BSL is to provide a level of hardware abstraction and software standardization that improves development time and portability.

The BSL contains the following modules:

File Description
Board Setup Module General board initialization
Codec Module Access to the AIC23 codec
Dip Switch Module Read DIP switches
EEPROM Module I2C EEPROM
Flash Module Program and erase Flash
Keypad Module Read keypad
LCD Module LCD display
LED Module Manipulate LEDs
SROM Module Serial ROM
UART Module UART config and I/O

Using the BSL
To use the BSL:

  1. Link the BSL in with your code.

  2. Reference the appropriate include files for each module (see the API descriptions for each functionís requirements).

  3. Call the functions themselves, starting with EVM5502_init().

The libraries and include files reside in the include and lib directories of the EVM5502 example directory.

Libraries and include files
The version of Code Composer that comes with the EVM5502 automatically includes the lib and include paths above so you donít need to manually include them in the search paths. To include the evm5502bsl.lib file for example, select Project -> Build Options on the Linker tab type evm5502bsl.lib in the "Include Libraries" field.

If you choose to specify your search paths, the library search path is specified on the same tab as the library file and the include search path is specified by selecting Project -> Build Options, and setting the "Include Search Path" field in the preprocessor section of the compiler tab.

Customizing the BSL
The BSL source code is available in the lib directory along with the library itself. You may extend or modify the source code and build your own version of the library. You can also include the BSL source files directly into your application for greater control. One useful technique while debugging is to use Code Composerís ability to open multiple projects simultaneously to open both your application and the BSL at the same time. The debugger will treat the BSL almost as if the source code for both projects were actually part of the same project.

Project checklist
The following are things to check when creating your own project:

  • CDB File The CDB file contains all of the DSP/BIOS settings. The easiest thing to do is copy, rename and modify one of the BSL examples.

  • Linker Command File Included - Make sure the linker command file is included in your project. It ends in .cmd and is auto-generated when your CDB file is compiled.

  • Endian Mode is Consistent - The endian mode settings must be consistent in each place it is set. It is set in the project options by selecting Project -> Build Options and viewing the Advanced tab. It is also set in your CDB file under System -> Global Settings in the DSP Endian Mode selector. Typically, little endian mode should be used on the EVM.

  • BSL Library Included - Make sure the correct BSL library is included. The BSL library should be specified by selecting Project -> Build Options on the Linker tab and typing evm5502bsl.lib in the "Include Libraries" field.

  • Include Paths are Set - If you can™t see header (*.h) files that your program uses, make sure you have the paths set correctly in Project -> Build Options on the Preprocessor tab. If you can™t see header files in the same directory as your project, add a . to your search path. To include multiple paths, place a semicolon between paths, for example:

       .;c:\ti\boards\evm5502\include

    includes both the project directory and the BSL include directory.

  • Processor Options are Set - The code gen tools need to be aware of the processor type and silicon revision to fully optimize your code. The EVM5502 uses silicon version 2.2 of the 5502.

    The processor type is set under Project -> Build Options by typing 5502 in the Processor Version field of the Advanced tab. It is also used in your CDB file to select the matching version of the Chip Support Library. Look under System -> Global Settings in the CSL selector box. If your program does not use DSP/BIOS you must manually define the value CHIP_5502 under Project -> Build Options on the Define Symbols field of the Preprocessor tab. Use a semicolon to separate multiple values if something else is already defined.

©Copyright 2002-2011 Spectrum Digital, Inc. All Rights Reserved.