C680X0NT User Guide
INTRODUCTION
C COMPILER
Running the Compiler from the Command Line
Compiler command line options
Compile Only (/c)
Generate Assembler Code (/Fa)
Generate Assembler Code Listing (/Fc)
Generate Debug Information (/DEBUG)
Define Identifier (/D)
Warning as Errors (/WX)
Warning Level 0 (/W0)
Warning Level 1 (/W1)
Warning Level 2 (/W2)
Warning Level 3 (/W3)
Warning Level 4 (/W4)
Use Register Keywords (/Or)
Global Register Allocation (/Og)
No 68881 Maths Co-processor (/NO68881)
Generate CPU32 Code (/CPU32)
Interrupt Vector Offset (/VO:)
C Language Definition
ANSI C Support
1999 ANSI C Support
Additional Features
Data Sizes
Arithmetic Conversions
Pragmas
#pragma version
#pragma date
#pragma time
#pragma message
#pragma code_seg
#pragma const_seg
#pragma bss_seg
#pragma data_seg
#pragma optimize
Interrupt Functions
Manual Coding of Interrupt Vector
Automatic Coding of Interrupt Vector
Runtime Modification of Interrupt Vectors
In-Line Assembler Code
Introducing In-Line Assembler Code
Accessing Global Variables
Accessing Static Variables
Accessing Automatic Variables and Function Parameters
Function Return Value
Predefined Macros
ANSI Predefined Macros
Compiler Specific Predefined Macros
Compiler Support Files
Introducing compiler support files
Startup Module
CROSS ASSEMBLER
Assembler Source Code Format
Introducing Assembler Source Code Format
Label Field
Operation Field
Opcode Extensions
Operand Field
Comment Field
Assembler Expressions
Assembler Expressions
Integer Numbers
Literals
Symbols
Examples
Assembly List Format
Introducing Assembly List Format
Page Header
Source and Object Code List
Field 1 Line Number or Sequence Number
Field 2 Program Counter Value or Value of Expression
Field 3 Program Code
Field 4 Label Field
Field 5 Operation Field
Field 6 Operand Field
Field 7 Comment Field
Page Width
Error Line
Symbol Table
Conditional Assembly
Assembler Macros
Introduction to Assembler Macros
Dummy Arguments
Dummy Labels
NARG Symbol
Structured Assembly
Introduction
FOR/ENDF
IF/THEN/ELSE/ENDI
REPEAT/UNTIL
WHILE/DO/ENDW
LINKER
Running the Linker from the Command Line
Default Filenames
Linker Response File
Linker Command Line Options
Generate S Record Output (/SREC)
Generate S19 Record Output (/S19)
Generate S28 Record Output (/S28)
Generate S37 Record Output (/S37)
Generate S29 Record Output (/S29)
Generate S39 Record Output (/S39)
Generate Intel Hex Output (/HEX)
Generate IEEE Binary Output (/IEEE)
Generate IEEE ASCII Output (/IEEEA)
Generate Plain Binary Output (/BIN)
Generate Relocatable Binary Output (/RBIN)
Generate Error File (/Fe)
Specify Object Code Filename (/Fo)
Specify Ram Limits (/RAM)
Specify ROM Limits (/ROM:)
Place Program Code in RAM (/NOROM)
Specify Segment Addresses and Order (/CODE /MIXED /RDATA /DATA)
COMPILER LIBRARY FUNCTIONS
Introduction to Compiler Library Functions
Detailed Descriptions
Introducing Detailed Descriptions
abs() absl()
acos() acosl()
asin() asinl()
atan() atanl()
atoi() atol() atof()atolf()
ceil() ceill()
clearerr()
cos() cosl()
cosh() coshl()
_ecvt() _ecvtl
exit()
exp() expl()
fabs() fabsl()
_fcvt() _fcvtl
ferror()
fgetc()
fgets()
fileno()
floor() floorl()
fprintf()
fputs()
free()
frexp() frexpl()
fscanf()
getc()
getch()
getchar()
getche()
gets()
_getvect()
isalnum()
isalpha()
isascii()
iscntrl()
isdigit()
isgraph()
islower()
isprint()
ispunct()
isspace()
isupper()
isxdigit()
itoa()
ldexp() ldexpl()
log() logl()
log10() log10l()
ltoa()
malloc()
memchr()
pow() powl()
memcmp()
memcpy()
memmove()
memset()
printf()
putc()
putch()
putchar()
puts()
rand()
realloc()
sbrk()
scanf()
_setvect()
sprintf()
sin() sinl()
sinh() sinhl()
sqrt() sqrtl()
srand()
sscanf()
strcspn()
strcat()
strchr()
strcmp()
strcpy()
strlen()
strncat()
strncmp()
strncpy()
strpbrk()
strrchr()
strspn()
strstr()
tan() tanl()
tanh() tanhl()
time()
toascii()
tolower()
toupper()
ultoa()
ungetc()
ungetch()
vprintf()
vsprintf()
vfprintf()
ASSEMBLER DIRECTIVES
Introducing Assembler Directives
Assembly Options
Introducing Assembly Options
68000
68010
68020
CPU32
68881
NO68881
CLIST/NOCLIST
LIST/NOLIST
LISTF
MC/NOMC
MD/NOMD
MEX/NOMEX
OBJ/NOOBJ
PAGE/NOPAGE
SYM
UNA/NOUNA
Other Assembler Directives
Introducing Other Assembler Directives
COMMON Specify Common Section
DC Define Constant Data
DS Define Storage
END Specifies End of Source Code
ENDC Specifies the End of Conditional Assembly
ENDM Specifies the End of a Macro Definition
EQU Define Symbol Value (Invariable)
FAIL Generate Assembly Warning
FIELDS Set Object Listing Field Widths
IFC IFNC IFIC IFINC Conditional Assembly with String Comparison
IFcc Conditional Assembly with Numerical Comparison
INCLUDE Include Another Source Code File
INCLUDELIB Search Specified Library
MACR Macro Definition
NAM Program Name
OPT Assembly Options
ORG Specifies Absolute Code Section
PAGE Paging Control
PAGEWIDTH Adjust Page Width of Assembly Listing
SECTION Define Relocatable Section (or Segment)
SET Define Symbol Value (Variable)
SPC Output Blank Lines
TTL Specify Title
XDEF Define External Symbols
XREF Reference External Symbols
MICROPROCESSOR INSTRUCTION REFERENCE
ABCD
ADD
ADDA
ADDI
ADDQ
ADDX
AND
ANDI
ASL
ASR
BCC
BCHG
BCLR
BCS
BEQ
BFCHG
BFCLR
BFEXTS
BFEXTU
BFFFO
BFINS
BFSET
BFTST
BGE
BGND
BGT
BHI
BKPT
BLE
BLS
BLT
BMI
BNE
BPL
BRA
BSET
BSR
BTST
BVC
BVS
CALLM
CAS
CAS2
CHK
CHK2
CLR
CMP
CMPA
CMPI
CMPM
CMP2
DBCC
DBCS
DBEQ
DBF
DBRA
DBGE
DBGT
DBHI
DBLE
DBLS
DBLT
DBMI
DBNE
DBPL
DBT
DBVC
DBVS
DIVS
DIVSL
DIVU
DIVUL
EOR
EORI
EXG
EXT
EXTB
ILLEGAL
JMP
JSR
LEA
LINK
LPSTOP
LSL
LSR
MOVE
MOVEA
MOVE from CCR
MOVE to CCR
MOVE from SR
MOVE to SR
MOVE USP
MOVEC
MOVEM
MOVEP
MOVEQ
MOVES
MULS
MULU
NBCD
NEG
NEGX
NOP
NOT
OR
ORI
ORI to CCR
ORI to SR
PACK
PEA
RESET
ROL
ROR
ROXL
ROXR
RTD
RTE
RTM
RTR
RTS
SBCD
SCC
SCS
SEQ
SF
SGE
SGT
SHI
SLE
SLS
SLT
SMI
SNE
SPL
ST
SVC
SVS
STOP
SUB
SUBA
SUBI
SUBQ
SUBX
SWAP
TAS
TBLS
TBLSN
TBLU
TBLUN
TRAP
TRAPCC
TRAPCS
TRAPEQ
TRAPF
TRAPGE
TRAPGT
TRAPHI
TRAPLE
TRAPLS
TRAPLT
TRAPMI
TRAPNE
TRAPPL
TRAPT
TRAPVC
TRAPVS
TRAPV
TST
UNLK
UNPK
MATHS CO-PROCESSOR REFERENCE
FABS
FACOS
FADD
FASIN
FATAN
FATANH
FBEQ
FBF
FBGE
FBGL
FBGLE
FBGT
FBLE
FBLT
FBNE
FBNGE
FBNGL
FBNGLE
FBNGT
FBNLE
FBNLT
FBOGE
FBOGL
FBOGLE
FBOGT
FBOLE
FBOLT
FBSEQ
FBSF
FBSNE
FBST
FBT
FBUGE
FBUGL
FBUGLE
FBUGT
FBULE
FBULT
FCMP
FCOS
FCOSH
FDBEQ
FDBF
FDBGE
FDBGL
FDBGLE
FDBGT
FDBLE
FDBLT
FDBNE
FDBNGE
FDBNGL
FDBNGLE
FDBNGT
FDBNLE
FDBNLT
FDBOGE
FDBOGL
FDBOGLE
FDBOGT
FDBOLE
FDBOLT
FDBSEQ
FDBSF
FDBSNE
FDBST
FDBT
FDBUGE
FDBUGL
FDBUGLE
FDBUGT
FDBULE
FDBULT
FDIV
FETOX
FETOXM1
FGETEXP
FGETMAN
FINT
FINTRZ
FLOG10
FLOG2
FLOGN
FLOGNP1
FMOD
FMOVE
FMOVE FPCR
FMOVECR
FMOVEM
FMUL
FNEG
FNOP
FREM
FRESTORE
FSAVE
FSCALE
FSEQ
FSF
FSGE
FSGL
FSGLE
FSGT
FSLE
FSLT
FSNE
FSNGE
FSNGL
FSNGLE
FSNGT
FSNLE
FSNLT
FSOGE
FSOGL
FSOGLE
FSOGT
FSOLE
FSOLT
FSSEQ
FSSF
FSSNE
FSST
FST
FSUGE
FSUGL
FSUGLE
FSUGT
FSULE
FSULT
FSGLDIV
FSGLMUL
FSIN
FSINCOS
FSINH
FSQRT
FSUB
FTAN
FTANH
FTENTOX
FTRAPEQ
FTRAPF
FTRAPGE
FTRAPGL
FTRAPGLE
FTRAPGT
FTRAPLE
FTRAPOGE
FTRAPLT
FTRAPNE
FTRAPNGE
FTRAPNGL
FTRAPNGLE
FTRAPNGT
FTRAPNLE
FTRAPNLT
FTRAPOGL
FTRAPOGLE
FTRAPOGT
FTRAPOLE
FTRAPOLT
FTRAPSEQ
FTRAPSF
FTRAPSNE
FTRAPST
FTRAPT
FTRAPUGE
FTRAPUGL
FTRAPUGLE
FTRAPUGT
FTRAPULE
FTRAPULT
FTST
FTWOTOX