C280x/C2801X C/C++ Header Files and Peripheral Examples Quick Start
Version 1.60
December 3, 2007
1
C280x/C2801x 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.2 Example Program Structure.................................................................................................. 11
4.2.1 Include Files..............................................................................................................11
4.2.2 Source Code.............................................................................................................12
4.2.3 Linker Command Files ..............................................................................................12
4.3 Example Program Flow.........................................................................................................14
4.4 Included Examples:...............................................................................................................15
4.5 Executing the Examples From Flash.....................................................................................17
5 Steps for Incorporating the Header Files and Sample Code ...................................................20
5.1 Before you begin...................................................................................................................20
5.2 Including the DSP280x Peripheral Header Files ...................................................................20
5.3 Including Common Example Code........................................................................................23
6 Troubleshooting Tips & Frequently Asked Questions.............................................................26
6.1 Effects of read-modify-write instructions................................................................................28
6.1.1 Registers with multiple flag bits in which writing a 1 clears that flag...........................28
6.1.2 Registers with Volatile Bits. .......................................................................................29
7 Migration Tips for moving from the TMS320x281x header files to the TMS320x280x header
files..............................................................................................................................................30
8 Packet Contents: ........................................................................................................................32
8.1 Header File Support – DSP280x_headers ............................................................................32
8.1.1 DSP280x Header Files – Main Files..........................................................................32
8.1.2 DSP280x Header Files – Peripheral Bit-Field and Register Structure Definition Files 33
8.1.3 Code Composer .gel Files......................................................................................... 33
8.1.4 Variable Names and Data Sections...........................................................................34
8.2 Common Example Code – DSP280x_common.....................................................................36
8.2.1 Peripheral Interrupt Expansion (PIE) Block Support ..................................................36
8.2.2 Peripheral Specific Files............................................................................................37
8.2.3 Utility Function Source Files ......................................................................................37
8.2.4 Example Linker .cmd files..........................................................................................38
8.2.5 Example Library .lib Files ..........................................................................................39
9 Detailed Revision History: .........................................................................................................40
10 Errata...........................................................................................................................................47