CF.book Page 215 Friday, July 8, 2005 8:59 AM
Index
Symbols
. (location counter) linker command 90
A
Abatron
BDI connection 143
,
144
remote connections 134
–
136
ADDR linker command 90
,
91
ALIGN linker command 91
ALIGNALL linker command 92
alignment, LCF 82
,
83
allocation, variable 66
application development diagram 20
application tutorial 25
–
37
arguments, inline assembly 111
–
113
arithmetic operators, LCF 81
,
82
assembler options (command line) 183
assembly, inline 109
–
118
B
batchrunner postlinker settings panel 43 batchrunner prelinker settings panel 43
BDM debugging 142
,
144
board-independent code 168
build settings panel 144
building 22
,
23
building a project 30
,
32
bus_dump simulator configuration command 155
C
cache_size simulator configuration
command 156
calling conventions 65
,
66
CF
debugger settings panel 32
,
121
–
124
exceptions panel 128
–
131
interrupt panel 133
checksum panel 174
closure segments, LCF 78
,
79
code
board-independent 168 position-independent 168
codeColdFire pragma 69
CodeWarrior
development process 19
–
23
IDE 18
ColdFire
assembler panel 44
–
47
linker notes 105
–
107
linker panel 55
–
59
processor panel 51
–
54
settings panels 40
–
60
target panel 44
command-line tools 179
–
201
assembler options 183
compiler options 184
–
194
data auto-alignment 200
,
201
debugging operations 181
–
183
environment variables 179
,
180
executables 179
linker options 194
–
199
commands
debug initialization files 206
–
210
linker 77
–
104
memory configuration files 212
–
214
simulator configuration 154
–
160
comment operators, LCF 81
,
82
compiler documentation 61
,
62
compiler options (command line) 184
–
194
compilers 61
–
76
compiling 22
,
23
configuration files, memory 211
–
214
configuration panel 175
connections
Abatron BDI 143
,
144
remote 126
–
128
wiggler 142
console window 37
const_multiply pragma 69
conventions, calling 65
,
66
creating a project 25
–
29
ColdFire Architectures v6.0 - Targeting Manual 215
CF.book Page 216 Friday, July 8, 2005 8:59 AM
D
data auto-alignment (command line) 200
,
201
dc inline assembly directive 114
deadstripping, linker 106
debug initialization files 203
–
210
commands 206
–
210
Delay 206
,
207
ResetHalt 207
ResetRun 207
Stop 207 writeaddressreg 207
writecontrolreg 208 writedatareg 208
writemem.b 209 writemem.l 209
writemem.w 210
syntax 205
uses 203
–
205
debugger PIC settings 59
debugger settings panel 131
,
132
debugger window 33
debugging 23
,
119
–
150
Abatron remote connections 134
–
136
an application 32
–
37
BDM debugging 142
,
144
connecting a wiggler 142
connecting Abatron BDI 143
,
144
ELF files 144
–
147
customizing XML file 145
,
146
IDE preferences 144
,
145
ISS remote connection 139
–
141
operations (command line) 181
–
183
P&E Micro remote connections 136
–
139
remote connections 134
–
141
simple profiler 149
,
150
special features 147
–
150
target settings 119
–
133
CF debugger settings panel 121
–
124
CF exceptions panel 128
–
131
CF interrupt panel 133
debugger settings panel 131
,
132
remote connections 126
–
128
remote debugging panel 124
–
126
declaration specifiers 63
216
define_section pragma 69
–
71
Delay debug initialization command 206
,
207
development process, CodeWarrior 19
–
23
dialog boxes
new 27
new connection 127
new project 28
directives
inline assembly 113
–
118
linker 77
–
104
disassembling 23
documentation 14
,
15
compiler, linker 61
,
62
ds inline assembly directive 114
,
115
E
editing 22
editions 12
,
13
editor window 22
ELF
disassembler panel 47
–
50
files
customizing XML file 145
,
146
debugging 144
–
147
IDE preferences 144
,
145
linker, command language 77
–
104
emac pragma 71
entry inline assembly directive 115
,
116
erase/blank check flash panel 172
EXCEPTION linker command 92
,
93
exception tables, LCF 85
executable files, linker 107
explicit_zero_data pragma 72
EXPORTSTRTAB linker command 93
EXPORTSYMTAB linker command 94
expressions, LCF 80
,
81
extensions, language 62
,
63
F
features 11
,
12
features, simulator 151
–
153
file specification, LCF 83
,
84
files
debug initialization 203
–
210
ColdFire Architectures v6.0 - Targeting Manual
CF.book Page 217 Friday, July 8, 2005 8:59 AM
memory configuration 211
–
214
project 21
flash device configuration panel 171
flash programmer 169
–
174
flash programmer window 170
–
174
FORCE_ACTIVE linker command 95
formats, integer 64
,
65
fralloc inline assembly directive 116 frfree inline assembly directive 116
function specification, LCF 83
,
84
G
getting started 17
–
23
global settings panel 145
H
hardware diagnostics 174
–
177
hardware diagnostics window 175
–
177
hardware tools 169
–
177
flash programmer 169
–
174 hardware diagnostics 174
–
177
heap, LCF 84
I
IDE
CodeWarrior 18
preferences, updating 144
,
145
IDE preferences window 127
IMPORTSTRTAB linker command 95
IMPORTSYMTAB linker command 96
INCLUDE linker command 97
inline assembly 109
–
118
directives 113
–
118
dc 114 ds 114
,
115 entry 115
,
116 fralloc 116 frfree 116
machine 117 naked 117
opword 118 return 118
local variables, arguments 111
–
113
ColdFire Architectures v6.0 - Targeting Manual
returning from routine 113
syntax 109
–
111
inline_intrinsics pragma 72
instruction set simulator 151
–
161 limitations 161
sample configuration file 160
integer formats 64
,
65
integrals, LCF 80
,
81
interrupt pragma 73
introduction 11
–
15
ipsbar simulator configuration command 156
ISS
configuration commands 154
–
160
bus_dump 155
cache_size 156 ipsbar 156
kram_size 157 krom_size 157
,
158 krom_valid 158 mbar 158
,
159 mbus_multiplier 159 memory 159
,
160 sdram 160
features 151
–
153
remote connection 139
–
141
K
KEEP_SECTION linker command 97
keywords, linker 77
–
104
kram_size simulator configuration command 157
krom_size simulator configuration
command 157
,
158
krom_valid simulator configuration
command 158
L
language extensions 62
,
63 declaration specifiers 63
pc-relative strings 62
,
63
language, ELF linker and command 77
–
104
LCF
alignment 82
,
83
arithmetic, comment operators 81
,
82
closure segments 78
,
79
217
CF.book Page 218 Friday, July 8, 2005 8:59 AM
exception tables 85
expressions 80
,
81
file specification 83
,
84
function specification 83
,
84 heap, stack 84
integrals 80
,
81
memory segment 77
,
78
position-independent code, data 85
ROM-RAM copying 86
–
88
sections segment 79
specifying files, functions 83
,
84 stack, heap 84
static initializers 85
structure 77
–
79
syntax 80
–
89
variables 80
,
81
writing to memory 88
,
89
libraries 163
–
168
heaps 166 memory 166
Metrowerks standard 163
–
167 runtime 167
,
168
serial I/O 166
UART 166
limitations, simulator 161
link order, linker 107
linker
and command language, ELF 77
–
104
commands
ADDR 90
,
91
ALIGN 91
ALIGNALL 92
EXCEPTION 92
,
93
EXPORTSTRTAB 93
EXPORTSYMTAB 94
FORCE_ACTIVE 95
IMPORTSTRTAB 95
IMPORTSYMTAB 96
INCLUDE 97
KEEP_SECTION 97
location counter 90
MEMORY 97
–
99
OBJECT 99
REF_INCLUDE 99
218
SECTIONS 100
,
101
SIZEOF 101
SIZEOF_ROM 101
WRITE0COMMENT 103
WRITEB 102
WRITEH 102
WRITEW 102
ZERO_FILLED_UNINITIALIZED 10
3
commands, directives, keywords 77
–
104
deadstripping 106
documentation 61
,
62
executable files 107 link order 107
notes, ColdFire 105
–
107
options (command line) 194
–
199
program sections 105
S-record comments 107
linking 22
,
23
local variables, inline assembly 111
–
113
location counter linker command 90
M
machine inline assembly directive 117
main window 26
mbar simulator configuration command 158
,
159
mbus_multiplier simulator configuration
command 159
memory configuration files 211
–
214
commands 212
–
214
range 212
reserved 213 reservedchar 213
,
214
syntax 211
MEMORY linker command 97
–
99
memory read/write test panel 176
memory segment, LCF 77
,
78
memory simulator configuration command 159
,
160
memory tests panel 177
Metrowerks standard libraries 163
–
167
MSL 163
–
167
ColdFire Architectures v6.0 - Targeting Manual
CF.book Page 219 Friday, July 8, 2005 8:59 AM
N
naked inline assembly directive 117
new connection dialog box 127
new dialog box 27
new project dialog box 28
O
OBJECT linker command 99
operators, LCF 81
,
82
opt_unroll_count pragma 73 opt_unroll_instr_count pragma 73
opword inline assembly directive 118
overview, target settings 39
,
40
P
P&E Micro remote connections 136
–
139
panels
batchrunner postlinker 43 batchrunner prelinker 43
build settings 144
CF debugger settings 32
,
121
–
124
CF exceptions 128
–
131
CF interrupt 133
checksum 174
ColdFire assembler 44
–
47
ColdFire linker 55
–
59
ColdFire processor 51
–
54
ColdFire settings 40
–
60
ColdFire target 44
configuration 175
debugger settings 131
,
132
ELF disassembler 47
–
50
erase/blank check flash 172
flash device configuration 171
global settings 145
memory read/write test 176
memory tests 177
program/verify flash 173
remote connections 127
remote debugging 31
,
124
–
126
scope loop tests 176
target configuration 170
target setting 41
–
42
ColdFire Architectures v6.0 - Targeting Manual
target settings 30
pc-relative strings 62
,
63
PIC 76
LCF 85
settings 59
PID, LCF 85
position-independent code 76
,
168
pragmas 67
–
75
codeColdFire 69 const_multiply 69 define_section 69
–
71 emac 71
explicit_zero_data 72 inline_intrinsics 72
interrupt 73 opt_unroll_count 73 opt_unroll_instr_count 73
profile 74 readonly_strings 74
SDS_debug_support 74 section 74
,
75 predefined symbols 75
profile pragma 74
profiler 149
,
150
program sections, linker 105
program/verify flash panel 173
project
building 30
,
32
creating 25
–
29
debugging 32
–
37
files 21 window 21
project window 29
R
range memory configuration command 212
readonly_strings pragma 74
REF_INCLUDE linker command 99
register variables 67
registers window 35
,
154
remote connections 126
–
128
debugging 134
–
141
panel 127
remote debugging panel 31
,
124
–
126
219
CF.book Page 220 Friday, July 8, 2005 8:59 AM
requirements, system 17
,
18
reserved memory configuration command 213
reservedchar memory configuration
command 213
,
214
ResetHalt debug initialization command 207
ResetRun debug initialization command 207
return inline assembly directive 118
returning from a routine, inline assembly 113
ROM-RAM copying, LCF 86
–
88
runtime code 163
–
168
runtime libraries 167
,
168
S
sample code
transitive closure 58
,
59
sample ISS configuration file 160
scope loop tests panel 176
sdram simulator configuration command 160
SDS_debug_support pragma 74 section pragma 74
,
75
SECTIONS linker command 100
,
101
sections segment, LCF 79
serial I/O libraries 166
settings
panels 40
–
60
target 39
–
60
target, debugging 119
–
133
simple profiler 149
,
150
simulator 151
–
161
simulator configuration commands 154
–
160
simulator, using 153
,
154
SIZEOF linker command 101
SIZEOF_ROM linker command 101
software editions 12
,
13
special features, debugging 147
–
150
S-record comments, linker 107
stack, LCF 84
starting 17
–
23
static initializers, LCF 85
Stop debug initialization command 207
structure, LCF 77
–
79
symbols, predefined 75
syntax
debug initialization files 205
220
inline assembly 109
–
111
LCF 80
–
89
memory configuration files 211
system requirements 17
,
18
T
target configuration panel 170
target settings 39
–
60
debugging 119
–
133
overview 39
,
40
panel 41
–
42
window 40
,
120
target settings panel 30 target settings window 30
,
31
tools
command line 179
–
201
flash programmer 169
–
174
hardware 169
–
177
hardware diagnostics 174
–
177
transitive closure sample code 58
,
59
tutorial 25
–
37
U
UART libraries 166
uses for debug initialization files 203
–
205
using the simulator 153
,
154
V
variables
allocation 66
LCF 80
,
81
register 67
view memory window 36
W
wiggler connection 142
windows
console 37
debugger 33
editor 22
flash programmer 170
–
174
hardware diagnostics 175
–
177
IDE preferences 127
ColdFire Architectures v6.0 - Targeting Manual
CF.book Page 221 Friday, July 8, 2005 8:59 AM
main 26
project 21
,
29
register 35
,
154
target settings 30
,
31
,
40
,
120
view memory 36
WRITE0COMMENT linker command 103
writeaddressreg debug initialization
command 207
WRITEB linker command 102
writecontrolreg debug initialization
command 208 writedatareg debug initialization command 208
WRITEH linker command 102
writemem.b debug initialization command 209 writemem.l debug initialization command 209
writemem.w debug initialization command 210
WRITEW linker command 102
writing to memory, LCF 88
,
89
X
XML file, customizing 145
,
146
Z
ZERO_FILLED_UNINITIALIZED linker
command 103
ColdFire Architectures v6.0 - Targeting Manual 221
CF.book Page 222 Friday, July 8, 2005 8:59 AM
222 ColdFire Architectures v6.0 - Targeting Manual
