User manual

Contents UM0036
4/385 Doc ID 7705 Rev 11
4.8.1 Raisonance C compiler tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
4.8.2 Raisonance Assembler tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
4.8.3 Raisonance C linker tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
4.9 Customizing build settings for Metrowerks C toolset . . . . . . . . . . . . . . . 131
4.9.1 Metrowerks C Compiler tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
4.9.2 Metrowerks Assembler tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
4.9.3 Metrowerks linker tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
4.10 Configuring folder and file settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
4.10.1 General settings for files and folders . . . . . . . . . . . . . . . . . . . . . . . . . . 156
4.10.2 Custom build tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
4.11 Specifying dependencies between projects . . . . . . . . . . . . . . . . . . . . . . 158
4.12 Build commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
5 Basic debugging features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
5.1 Selecting the debug instrument . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
5.1.1 Identify your debug instrument . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
5.1.2 Add communication ports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
5.2 Configuring your target MCU . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
5.2.1 Memory map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
5.2.2 On-chip peripherals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
5.3 Running an application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
5.3.1 Run commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
5.3.2 Stepping modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
5.3.3 Program and STVD status bar display . . . . . . . . . . . . . . . . . . . . . . . . . 169
5.3.4 Monitoring execution in source windows . . . . . . . . . . . . . . . . . . . . . . . 169
5.4 Editor debug actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
5.4.1 Editor debug margin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
5.4.2 QuickWatch window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
5.5 Disassembly window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
5.6 Online assembler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
5.7 Memory window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
5.7.1 Viewing memory contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
5.7.2 Viewing features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
5.8 Instruction breakpoints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
5.8.1 Setting an instruction breakpoint . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
5.8.2 Viewing the instruction breakpoints . . . . . . . . . . . . . . . . . . . . . . . . . . . 184