C2833x/C2823x C/C++ Header Files and Peripheral Examples Quick Start
Version 1.31
August 4, 2009
1
C2833x/C2823x C/C++ Header Files and Peripheral
Examples Quick Start
1 Device Support:............................................................................................................................ 2
2 Introduction: ................................................................................................................................. 2
2.1 Revision History...................................................................................................................... 3
2.2 Where Files are Located (Directory Structure) ........................................................................ 4
3 Understanding The Peripheral Bit-Field Structure Approach ................................................... 5
4 Peripheral Example Projects ....................................................................................................... 6
4.1 Getting Started ....................................................................................................................... 6
4.1.1 Getting Started in Code Composer Studio v3.x ........................................................... 6
4.1.2 Getting Started in Code Composer Studio v4............................................................ 10
4.2 Example Program Structure.................................................................................................. 15
4.2.1 Source Code ............................................................................................................. 16
4.2.2 Linker Command Files .............................................................................................. 16
4.3 Example Program Flow......................................................................................................... 18
4.4 Included Examples: .............................................................................................................. 19
4.5 Executing the Examples From Flash..................................................................................... 21
4.6 Converting Floating-Point Compiled Examples to Fixed-Point and Vice Versa ..................... 24
5 Steps for Incorporating the Header Files and Sample Code ................................................... 31
5.1 Before you begin................................................................................................................... 31
5.2 Including the DSP2833x Peripheral Header Files ................................................................. 31
5.3 Including Common Example Code........................................................................................ 36
6 Troubleshooting Tips & Frequently Asked Questions............................................................. 39
6.1 Effects of read-modify-write instructions. .............................................................................. 41
6.1.1 Registers with multiple flag bits in which writing a 1 clears that flag........................... 42
6.1.2 Registers with Volatile Bits. ....................................................................................... 42
7 Migration Tips for moving from the TMS320x280x or TMS320x281x header files to the
TMS320x2833x/TMS320x2823x header files ............................................................................. 43
8 Packet Contents: ........................................................................................................................ 46
8.1 Header File Support – DSP2833x_headers .......................................................................... 46
8.1.1 DSP2833x Header Files – Main Files........................................................................ 46
8.1.2 DSP2833x Header Files – Peripheral Bit-Field and Register Structure Definition
Files .......................................................................................................................... 47
8.1.3 Code Composer .gel Files......................................................................................... 48
8.1.4 Variable Names and Data Sections........................................................................... 48
8.2 Common Example Code – DSP2833x_common................................................................... 50
8.2.1 Peripheral Interrupt Expansion (PIE) Block Support .................................................. 50
8.2.2 Peripheral Specific Files............................................................................................ 51
8.2.3 Utility Function Source Files...................................................................................... 52
8.2.4 Example Linker .cmd files ......................................................................................... 52
8.2.5 Example Library .lib Files .......................................................................................... 53
9 Migrating Projects from Code Composer Studio v3.x to Code Composer Studio 4.0........... 53
10 Detailed Revision History: ......................................................................................................... 54