2802x C/C++ Header Files and Peripheral Examples Quick Start
Version 1.26
February 1, 2010
1
2802x 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 ................................................... 6
4 Peripheral Example Projects ....................................................................................................... 7
4.1 Getting Started ....................................................................................................................... 7
4.1.1 Getting Started in Code Composer Studio v3.x ........................................................... 7
4.1.2 Getting Started in Code Composer Studio v4............................................................ 12
4.2 Example Program Structure.................................................................................................. 18
4.2.1 Source Code............................................................................................................. 19
4.2.2 Linker Command Files .............................................................................................. 19
4.3 Example Program Flow......................................................................................................... 21
4.4 Included Examples: .............................................................................................................. 22
4.5 Executing the Examples From Flash..................................................................................... 24
5 Steps for Incorporating the Header Files and Sample Code ................................................... 28
5.1 Before you begin................................................................................................................... 28
5.2 Including the DSP2802x Peripheral Header Files ................................................................. 28
5.3 Including Common Example Code........................................................................................ 33
6 Troubleshooting Tips & Frequently Asked Questions............................................................. 37
6.1 Effects of read-modify-write instructions. .............................................................................. 39
6.1.1 Registers with multiple flag bits in which writing a 1 clears that flag........................... 40
6.1.2 Registers with Volatile Bits. ....................................................................................... 40
7 Migration Tips for moving from the TMS320x280x or TMS320x281x header files to the
TMS320x2802x header files ....................................................................................................... 41
8 Packet Contents: ........................................................................................................................ 42
8.1 Header File Support – DSP2802x_headers .......................................................................... 42
8.1.1 DSP2802x Header Files – Main Files........................................................................ 42
8.1.2 DSP2802x Header Files – Peripheral Bit-Field and Register Structure Definition
Files .......................................................................................................................... 43
8.1.3 Code Composer .gel Files......................................................................................... 44
8.1.4 Variable Names and Data Sections........................................................................... 44
8.2 Common Example Code – DSP2802x_common................................................................... 46
8.2.1 Peripheral Interrupt Expansion (PIE) Block Support .................................................. 46
8.2.2 Peripheral Specific Files............................................................................................ 47
8.2.3 Utility Function Source Files...................................................................................... 48
8.2.4 Example Linker .cmd files ......................................................................................... 48
8.2.5 Example Library .lib Files .......................................................................................... 49
9 Detailed Revision History: ......................................................................................................... 50