.BASE

    .BASE 文件起始位置

• 设置生成文件地址，**默认为 .BASE 0 **，这里不等同与 .ORG。
• 例如：若 .BASE $10 ，则生成的文件编译内容从 $10 开始写入，之前的 $F 个地址为 0。

注意

1. 编译自上而下，一些第一次编译需要赋值的变量如果第一次编译未知则编译不成功。
2. 如果使用.BASE命令，则在.ORG之后，否则编译错误。

.ORG

    .ORG 编译起始位置

• 设置开始编译地址，例如：.ORG $8000，则编译将从$8000开始。
• 也可以使用.ORG *，表示从当前地址开始编译。不过要知道当前地址，否则编译器报错。
• 注意：如果使用 .BASE 命令，则在 .ORG 之后，否则编译错误。

.DEF

    .DEF 标签, 表达式

• 定义一个常量，例如：.DEF idefined, $12。

注意：temp = $12 虽然也能定义，用等号可重复定义。

.ENUM .ENDE

    .ENUM 起始地址
    标签, 字节长度
    ...
    .ENDE

• 定义一系列连续的地址，通常用于定义一系列内存地址
• 例如：

   .ENUM $300
   music.counter,  1    ; 类似 .DEF music.counter,  $300
   music.addrHigh, 2    ; 类似 .DEF music.addrHigh, $301 (music.counter + 1)
   music.addrLow,  3    ; 类似 .DEF music.addrLow,  $303 (music.addrHigh + 2)
   .ENDE

.DB .DW .DL

    .DB 数据1 [, 数据2, 数据3...]    ;1字节
    .DW 数据1 [, 数据2, 数据3...]    ;2字节
    .DL 数据1 [, 数据2, 数据3...]    ;4字节

• 一系列数据。

.DBG .DWG .DLG .ENDD

• 数据组，用于定位数据位置。

    .DWG 标签

    .data1, .data2, .data3, .data1

    .ENDD

    LDA data:.data1     ;0
    LDA data:.data3     ;2
    LDA data:.data1:1   ;3

.HEX

    .HEX 16进制字符串
    .HEX 12 34567 89    ;12 34 56 07 89

• 一段16进制数据，可以用空格隔开。

注意：之后只能输入16进制数据，否则编译器会报错。

.IF .ELSEIF .ELSE .ENDIF

• 这里是一套判断条件，根据条件是否成立是否编译相应内容。

注意：必须要在使用这些之前知道参数的信息，否则编译报错

    .IF a == 5
     .....
    .ELSEIF b >= 5
     .....
    .ELSEIF c != 3
     .....
    .ELSE
     .....
    .ENDIF

.IFDEF .IFNDEF .ELSE .ENDIF

    .IFDEF 标签或自定义函数
     .....
    .ELSE
     .....
    .ENDIF

• 这里是一套判断条件，根据条件是否成立是否编译相应内容。
• 用法同 .IF 的命令类似，后面可以用 .ELSE .ENDIF
• 这里是判断变量或自定义函数是否存在，.IFDEF为判断变量或自定义函数存在，.IFNDEF为判断变量或自定义函数不存在。

注：必须要在使用这些之前知道参数的信息，否则编译报错

.INCBIN

    .INCBIN 文件相对路径[, 读取文件起始位置, 读取长度]

• 可以读取引用文件的二进制内容，后面双引号内请填写本文件的相对路径。

例如:

    .INCBIN "文件夹\文件.bin", 0, 100

.INCLUDE

    .INCLUDE 文件相对路径

• 可以引用文件，后面双引号内请填写本文件的相对路径。
• 如果引用文件内也有引用文件，请相对于主编译文件路径填写。

例如：

    .INCLUDE "文件夹\文件.asm"。

.MACRO .ENDM

    .MACRO 自定义函数名称[, 参数1, 参数2...]
     .....
    .ENDM

注意：用这里的指令可以自定义函数，所要使用的函数要在编译之前定义好，否则编译器会报错。

注意：所有自定义函数内的 标签 属于 局部变量，请勿在函数外部使用。

注意：所有自定义函数内定义的 变量 均为 全局变量。

实例1：

    .MACRO TXY
    TXA
    TAY
    .ENDM

    TXY

• 编译之后结果为：8A A8

实例2：

    .MACRO test, a, b
    .IF 3 == a
    LDA 3
    .ELSEIF 4 == a
    LDX 4
    .ELSEIF 5 == a && 5 == b
    LDY 5
    .ELSE
    LDA 6
    STA 6
    .ENDIF
    .ENDM

    test 3,3
    test 4,3
    test 5,4
    test 5,5

• 编译之后结果为：A5 03 A6 04 A5 06 85 06 A4 05

.REPEAT .ENDR

    .REPEAT 重复次数
     .....
    .ENDR

• 可以重复某个指令多次，在 .REPEAT 后输入表达式即可。

注意：每个 .REPEAT 和 .ENDR 必须成对出现，可以嵌套。

    .REPEAT 2
    NOP
    .REPEAT 3
    ASL
    .ENDR
    .ENDR

• 对应编译的结果相当于：NOP ASL ASL ASL NOP ASL ASL ASL

.MSG .ERROR

    .MSG 输出信息[, 参数1, 参数2...]
    .ERROR 输出信息[, 参数1, 参数2...]

• MSG为可输出一条信息
• ERROR为输出一条信息并停止编译

    .ORG $8000
    .DEF test1, 10
    .DEF test2, 11
    .MSG "测试案例 {0}, ${1}, @{0}", test1, test2

    .IF test1 == 10
    .ERROR "这里的 test1: {0}", test1
    .ENDIF

• 这里输出的信息是：

测试案例 10, $B, @0000 1010

这里的 test1: 10