C281x C/C++ Header Files and Peripheral Examples Quick Start
Version 1.11
September 26, 2007
1
C281x 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 .......................................................................................................5
4.1 Getting Started........................................................................................................................5
4.2 Example Program Structure....................................................................................................8
4.2.1 Include Files................................................................................................................8
4.2.2 Source Code ...............................................................................................................9
4.2.3 Linker Command Files ................................................................................................9
4.3 Example Program Flow.........................................................................................................11
4.4 Included Examples:...............................................................................................................12
4.5 Executing the Examples From Flash.....................................................................................13
5 Steps for Incorporating the Header Files and Sample Code ...................................................16
5.1 Before you begin...................................................................................................................16
5.2 Including the DSP281x Peripheral Header Files ................................................................... 16
5.3 Including Common Example Code........................................................................................19
6 Troubleshooting Tips & Frequently Asked Questions.............................................................21
6.1 Effects of read-modify-write instructions................................................................................23
6.1.1 Registers with multiple flag bits in which writing a 1 clears that flag...........................23
6.1.2 Registers with Volatile Bits. .......................................................................................24
7 Migration Tips from V.58 to V1.00 and newer...........................................................................24
8 Packet Contents: ........................................................................................................................32
8.1 Header File Support – DSP281x_headers ............................................................................32
8.1.1 DSP281x Header Files – Main Files..........................................................................32
8.1.2 DSP281x 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 – DSP281x_common.....................................................................34
8.2.1 Peripheral Interrupt Expansion (PIE) Block Support ..................................................34
8.2.2 Peripheral Specific Files............................................................................................35
8.2.3 Utility Function Source Files...................................................................................... 36
8.2.4 Example Linker .cmd files..........................................................................................36
9 Detailed Revision History: .........................................................................................................37
10 Errata:..........................................................................................................................................39