C2833x C/C++ Header Files and Peripheral Examples Quick Start
Version 1.01
September 26, 2007
1
C2833x 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)........................................................................3
3 Understanding The Peripheral Bit-Field Structure Approach ...................................................4
4 Peripheral Example Projects .......................................................................................................5
4.1 Getting Started........................................................................................................................5
4.2 Example Program Structure..................................................................................................10
4.2.1 Include Files..............................................................................................................10
4.2.2 Source Code .............................................................................................................11
4.2.3 Linker Command Files ..............................................................................................11
4.3 Example Program Flow.........................................................................................................13
4.4 Included Examples:...............................................................................................................14
4.5 Executing the Examples From Flash.....................................................................................16
4.6 Converting Floating-Point Compiled Examples to Fixed-Point and Vice Versa......................19
5 Steps for Incorporating the Header Files and Sample Code ...................................................22
5.1 Before you begin...................................................................................................................22
5.2 Including the DSP2833x Peripheral Header Files .................................................................22
5.3 Including Common Example Code........................................................................................ 26
6 Troubleshooting Tips & Frequently Asked Questions.............................................................28
6.1 Effects of read-modify-write instructions................................................................................30
6.1.1 Registers with multiple flag bits in which writing a 1 clears that flag...........................31
6.1.2 Registers with Volatile Bits. .......................................................................................31
7 Migration Tips for moving from the TMS320x280x or TMS320x281x header files to the
TMS320x2833x header files .......................................................................................................32
8 Packet Contents: ........................................................................................................................35
8.1 Header File Support – DSP2833x_headers ..........................................................................35
8.1.1 DSP2833x Header Files – Main Files........................................................................35
8.1.2 DSP2833x Header Files – Peripheral Bit-Field and Register Structure Definition
Files ..........................................................................................................................36
8.1.3 Code Composer .gel Files.........................................................................................37
8.1.4 Variable Names and Data Sections...........................................................................37
8.2 Common Example Code – DSP2833x_common...................................................................39
8.2.1 Peripheral Interrupt Expansion (PIE) Block Support ..................................................39
8.2.2 Peripheral Specific Files............................................................................................40
8.2.3 Utility Function Source Files...................................................................................... 41
8.2.4 Example Linker .cmd files..........................................................................................41
8.2.5 Example Library .lib Files ..........................................................................................42
9 Detailed Revision History: .........................................................................................................43