Next Previous Contents

ca65 Users Guide

Ullrich von Bassewitz, uz@cc65.org

2000-07-19, 2000-11-29, 2001-10-02, 2005-09-08

ca65 is a powerful macro assembler for the 6502, 65C02 and 65816 CPUs. It is used as a companion assembler for the cc65 crosscompiler, but it may also be used as a standalone product.

1. Overview

1.1 Design criteria

2. Usage

2.1 Command line option overview
2.2 Command line options in detail

3. Search paths

4. Input format

4.1 Assembler syntax
4.2 65816 mode
4.3 6502X mode
4.4 sweet16 mode
4.5 Number format
4.6 Conditional assembly

5. Expressions

5.1 Expression evaluation
5.2 Size of an expression result
5.3 Boolean expressions
5.4 Constant expressions
5.5 Available operators

6. Symbols and labels

6.1 Numeric constants
6.2 Numeric variables
6.3 Standard labels
6.4 Local labels and symbols
6.5 Cheap local labels
6.6 Unnamed labels
6.7 Using macros to define labels and constants
6.8 Symbols and .DEBUGINFO

7. Scopes

7.1 Global scope
7.2 Cheap locals
7.3 Generic nested scopes
7.4 Nested procedures
7.5 Structs, unions and enums
7.6 Explicit scope specification
7.7 Scope search order

8. Address sizes and memory models

8.1 Address sizes
8.2 Address sizes of segments
8.3 Address sizes of symbols
8.4 Memory models

9. Pseudo variables

9.1 *
9.2 .CPU
9.3 .PARAMCOUNT
9.4 .TIME
9.5 .VERSION

10. Pseudo functions

10.1 .BANK
10.2 .BANKBYTE
10.3 .BLANK
10.4 .CONCAT
10.5 .CONST
10.6 .HIBYTE
10.7 .HIWORD
10.8 .IDENT
10.9 .LEFT
10.10 .LOBYTE
10.11 .LOWORD
10.12 .MATCH
10.13 .MAX
10.14 .MID
10.15 .MIN
10.16 .REF, .REFERENCED
10.17 .RIGHT
10.18 .SIZEOF
10.19 .STRAT
10.20 .SPRINTF
10.21 .STRING
10.22 .STRLEN
10.23 .TCOUNT
10.24 .XMATCH

11. Control commands

11.1 .A16
11.2 .A8
11.3 .ADDR
11.4 .ALIGN
11.5 .ASCIIZ
11.6 .ASSERT
11.7 .AUTOIMPORT
11.8 .BANKBYTES
11.9 .BSS
11.10 .BYT, .BYTE
11.11 .CASE
11.12 .CHARMAP
11.13 .CODE
11.14 .CONDES
11.15 .CONSTRUCTOR
11.16 .DATA
11.17 .DBYT
11.18 .DEBUGINFO
11.19 .DEFINE
11.20 .DELMAC, .DELMACRO
11.21 .DEF, .DEFINED
11.22 .DESTRUCTOR
11.23 .DWORD
11.24 .ELSE
11.25 .ELSEIF
11.26 .END
11.27 .ENDENUM
11.28 .ENDIF
11.29 .ENDMAC, .ENDMACRO
11.30 .ENDPROC
11.31 .ENDREP, .ENDREPEAT
11.32 .ENDSCOPE
11.33 .ENDSTRUCT
11.34 .ENDUNION
11.35 .ENUM
11.36 .ERROR
11.37 .EXITMAC, .EXITMACRO
11.38 .EXPORT
11.39 .EXPORTZP
11.40 .FARADDR
11.41 .FATAL
11.42 .FEATURE
11.43 .FILEOPT, .FOPT
11.44 .FORCEIMPORT
11.45 .GLOBAL
11.46 .GLOBALZP
11.47 .HIBYTES
11.48 .I16
11.49 .I8
11.50 .IF
11.51 .IFBLANK
11.52 .IFCONST
11.53 .IFDEF
11.54 .IFNBLANK
11.55 .IFNDEF
11.56 .IFNREF
11.57 .IFP02
11.58 .IFP816
11.59 .IFPC02
11.60 .IFPSC02
11.61 .IFREF
11.62 .IMPORT
11.63 .IMPORTZP
11.64 .INCBIN
11.65 .INCLUDE
11.66 .INTERRUPTOR
11.67 .LINECONT
11.68 .LIST
11.69 .LISTBYTES
11.70 .LOBYTES
11.71 .LOCAL
11.72 .LOCALCHAR
11.73 .MACPACK
11.74 .MAC, .MACRO
11.75 .ORG
11.76 .OUT
11.77 .P02
11.78 .P816
11.79 .PAGELEN, .PAGELENGTH
11.80 .PC02
11.81 .POPCPU
11.82 .POPSEG
11.83 .PROC
11.84 .PSC02
11.85 .PUSHCPU
11.86 .PUSHSEG
11.87 .RELOC
11.88 .REPEAT
11.89 .RES
11.90 .RODATA
11.91 .SCOPE
11.92 .SEGMENT
11.93 .SET
11.94 .SETCPU
11.95 .SMART
11.96 .STRUCT
11.97 .SUNPLUS
11.98 .TAG
11.99 .UNDEF, .UNDEFINE
11.100 .UNION
11.101 .WARNING
11.102 .WORD
11.103 .ZEROPAGE

12. Macros

12.1 Introduction
12.2 Macros without parameters
12.3 Parametrized macros
12.4 Detecting parameter types
12.5 Recursive macros
12.6 Local symbols inside macros
12.7 C style macros
12.8 Characters in macros
12.9 Deleting macros

13. Macro packages

13.1 .MACPACK generic
13.2 .MACPACK longbranch
13.3 .MACPACK atari
13.4 .MACPACK cbm
13.5 .MACPACK cpu