SDCC伪指令详细说明及示例#

1
.area 段名 (属性1,属性2,...) [重定位类型]

1
; 代码段（程序存储器）
2
.area CSEG (CODE)       ; 常规代码段
3
.area HOME (CODE)       ; 起始段（0x0000-0x00FF）
4
.area GSINIT (CODE)     ; 全局变量初始化代码
5
.area GSFINAL (CODE)    ; 初始化后的代码
6

7
; 数据段
8
.area DSEG (DATA)       ; 内部可直接寻址数据（0x30-0x7F）
9
.area ISEG (DATA)       ; 内部间接寻址数据（0x80-0xFF）
10
.area OSEG (DATA)       ; 覆盖数据段
11
.area XSEG (XDATA)      ; 外部数据存储器
12
.area ESEG (EDATA)      ; 扩展数据存储器（STC8G特有）
13

14
; 其他
15
.area RSEG (ABS)        ; 绝对定位段
16
.area ASEG (ABS)        ; 绝对段（已过时）
17
.area BSEG (BIT)        ; 位寻址区（0x20-0x2F）

1
; 定义绝对地址中断向量表
2
.area VEC (ABS)
3
.org 0x0000
4
    ljmp   _main          ; 复位向量
5
.org 0x0003
6
    ljmp   _ext0_isr      ; 外部中断0
7
.org 0x000B
8
    ljmp   _timer0_isr    ; 定时器0中断
9

10
; 代码段
11
.area CSEG (CODE)
12
_main:
13
    mov    SP, #0x80      ; 设置堆栈指针
14

15
; 内部数据段
16
.area DSEG (DATA)
17
counter:
18
    .byte 0x00           ; 单字节变量
19
buffer:
20
    .ds   16             ; 16字节缓冲区
21

22
; 外部数据段
23
.area XSEG (XDATA)
24
large_buffer:
25
    .ds   1024           ; 1KB外部缓冲区
26

27
; 位寻址区
28
.area BSEG (BIT)
29
flag1:   .dbits 1        ; 定义1个位
30
flags:   .dbits 8        ; 定义8个位（1字节）

1
; 定义字节（8位）
2
.byte value1, value2, ...    ; 定义字节序列
3
.db   value1, value2, ...    ; 同.byte
4

5
; 示例
6
data1:  .byte 0x12           ; 单个字节
7
table:  .byte 0, 1, 2, 3, 4  ; 数组
8
str:    .byte 'H','e','l','l','o',0  ; 字符串

1
; 定义字（16位）
2
.word value1, value2, ...    ; 定义字序列（小端序）
3
.dw   value1, value2, ...    ; 同.word
4

5
; 示例
6
vectors: .word 0x0000, 0x1000, 0x2000  ; 地址表
7
const:   .dw   0x1234, 0x5678          ; 16位常量

1
; 定义双字（32位）
2
.long value1, value2, ...    ; 32位数据
3
.dl   value1, value2, ...    ; 同.long
4

5
; 示例
6
long_val: .long 0x12345678   ; 32位值
7
float_val: .long 0x4048F5C3  ; 浮点数（3.14的IEEE754表示）

1
; 定义浮点数
2
.float value1, value2, ...   ; 单精度浮点数
3

4
; 示例
5
pi:     .float 3.1415926
6
temp:   .float 25.5

1
; ASCII字符串
2
.ascii "string"              ; 无结束符
3
.asciz "string"             ; 以\0结尾
4

5
; 示例
6
msg1:   .ascii "Error"       ; 长度5
7
msg2:   .asciz "Hello"       ; 长度6（含\0）

1
.ds size                     ; 保留size字节空间
2
.blkb size                   ; 同.ds（块）
3

4
; 示例
5
buffer: .ds 100              ; 100字节缓冲区
6
stack:  .blkb 32             ; 32字节堆栈空间

1
; 位定义（仅用于BSEG段）
2
.dbits size                  ; 定义size个位
3

4
; 示例
5
.area BSEG (BIT)
6
flags:  .dbits 8             ; 8个标志位
7
status: .dbits 1             ; 单状态位

1
; 等值定义
2
.equ symbol, value           ; 定义符号常量
3
.set  symbol, value          ; 同.equ（可重复定义）
4
=      symbol = value        ; 另一种形式
5

6
; 示例
7
.equ BUFFER_SIZE, 256        ; 定义常量
8
.set  COUNTER_MAX, 1000
9
TIMEOUT = 5000               ; 使用等号

1
.globl symbol                ; 声明全局符号
2
.global symbol               ; 同.globl
3
.gblel symbol                ; 声明全局外部符号
4

5
; 示例
6
.globl _main                 ; C主函数
7
.globl _isr_timer0           ; 中断服务函数

1
.extern symbol               ; 声明外部符号
2
.external symbol             ; 同.extern
3

4
; 示例
5
.extern _printf              ; 外部C函数
6
.extern buffer               ; 外部变量

1
; 条件块
2
.if condition                ; 开始条件
3
.else                        ; 否则分支
4
.endif                       ; 结束条件
5

6
; 示例
7
.if DEBUG == 1
8
    mov   A, #0x55           ; 调试代码
9
.else
10
    mov   A, #0xAA           ; 发布代码
11
.endif

1
; 符号检查
2
.ifdef symbol                ; 如果符号已定义
3
.ifndef symbol               ; 如果符号未定义
4

5
; 示例
6
.ifdef USE_UART
7
    call  uart_init          ; 如果定义了USE_UART
8
.endif
9

10
.ifndef OPTIMIZE
11
    nop                      ; 如果没有优化
12
.endif

1
; 比较表达式
2
.ifeq expression             ; 如果等于
3
.ifne expression             ; 如果不等于
4
.ifgt expression             ; 如果大于
5
.ifge expression             ; 如果大于等于
6
.iflt expression             ; 如果小于
7
.ifle expression             ; 如果小于等于
8

9
; 示例
10
.ifeq VERSION-2
11
    ljmp  legacy_code        ; VERSION==2时
12
.else
13
    ljmp  new_code           ; 其他情况
14
.endif

1
; 宏定义
2
.macro macroname [param1, param2, ...]  ; 定义宏
3
    ; 宏体
4
.endm                                   ; 结束宏
5

6
; 示例：延时宏
7
.macro DELAY cycles
8
    mov   R7, #(\cycles & 0xFF)         ; 使用参数
9
    djnz  R7, $
10
.endm
11

12
; 使用宏
13
DELAY 100     ; 扩展为：mov R7, #100; djnz R7, $
14
DELAY 255     ; 扩展为：mov R7, #255; djnz R7, $

1
; 带多个参数的宏
2
.macro MOV16 src, dst
3
    mov   A, \src            ; 参数前加反斜杠
4
    mov   \dst, A
5
    mov   A, \src+1
6
    mov   \dst+1, A
7
.endm
8

9
; 使用
10
MOV16 #0x1234, R6    ; 将16位值传送到R6:R7

1
; 带局部标签的宏
2
.macro DELAY_MS ms
3
    mov   R5, #\ms
4
1$:                         ; 局部标签（数字+$）
5
    mov   R6, #200
6
2$:
7
    mov   R7, #250
8
    djnz  R7, $
9
    djnz  R6, 2$
10
    djnz  R5, 1$
11
.endm

1
; 条件判断宏
2
.macro BIT_SET reg, bit
3
    .if \bit < 8
4
        setb \reg.\bit      ; 使用位操作符
5
    .else
6
        .error "Bit out of range"
7
    .endif
8
.endm
9

10
; 使用
11
BIT_SET P1, 0        ; setb P1.0
12
BIT_SET ACC, 3       ; setb ACC.3

1
; 宏嵌套
2
.macro PUSH_REG reg
3
    push  \reg
4
.endm
5

6
.macro PUSH_REGS regs
7
    .irp reg, \regs        ; 迭代参数列表
8
        PUSH_REG \reg
9
    .endm
10
.endm
11

12
; 使用
13
PUSH_REGS ACC, B, PSW    ; 压栈多个寄存器

1
; 计算平方的宏函数
2
.macro SQUARE x, result
3
    mov   A, #\x
4
    mov   B, A
5
    mul   AB
6
    mov   \result, A       ; 低8位
7
    mov   \result+1, B     ; 高8位
8
.endm
9

10
; 使用
11
SQUARE 5, square_result
12

13
; 带返回值的宏
14
.macro ADD16 a, b
15
    mov   A, \a
16
    add   A, \b
17
    mov   R0, A
18
    mov   A, \a+1
19
    addc  A, \b+1
20
    mov   R1, A
21
    ; 结果在R0:R1中
22
.endm

1
.include "filename.inc"    ; 包含汇编文件
2
.include <stddef.h>       ; 包含C头文件（需要-i指定路径）
3

4
; 示例
5
.include "stc8g.h"
6
.include "macros.inc"
7
.include "config.inc"

1
; 主文件 main.asm
2
.module main
3
.globl _main
4

5
.include "uart.inc"
6
.include "timer.inc"
7

8
_main:
9
    call  uart_init
10
    call  timer_init
11
    ; ...
12

13
; 子模块 uart.inc
14
.module uart
15
.globl uart_init, uart_send
16

17
uart_init:
18
    ; ...
19
    ret
20

21
uart_send:
22
    ; ...
23
    ret

1
.org address               ; 设置当前位置
2
.radix base                ; 设置数字基数（2,8,10,16）
3

4
; 示例
5
.radix 16                  ; 设置为16进制
6
.org   1000H               ; 从1000H开始
7
    .byte 1,2,3,4
8
.org   2000H               ; 跳转到2000H
9
    .word 1234H

1
.even                      ; 对齐到偶数地址
2
.odd                       ; 对齐到奇数地址
3
.align power               ; 对齐到2^power边界
4

5
; 示例
6
.align 4                   ; 对齐到16字节边界
7
data: .ds 10
8

9
.even                      ; 确保下面代码在偶地址
10
code: mov A, #0

1
.list                      ; 开启列表
2
.nolist                    ; 关闭列表
3
.lst                       ; 生成列表文件
4
.nolst                     ; 不生成列表文件
5

6
; 示例
7
.nolist                    ; 不列出包含文件内容
8
.include "macros.inc"
9
.list                      ; 恢复列表

1
.title "标题"              ; 设置标题
2
.sbttl "子标题"            ; 设置子标题
3
.page                      ; 分页
4
.width columns             ; 设置列宽

1
; 局部标签（默认）
2
label1:                    ; 局部标签，文件内可见
3
    nop
4

5
; 示例
6
loop:                      ; 局部循环标签
7
    djnz R7, loop          ; 可访问
8

9
func1:
10
    call subfunc
11
    ret
12

13
subfunc:                   ; 另一个局部标签
14
    nop
15
    ret

1
; 全局标签
2
label2::                   ; 全局标签，外部可访问
3

4
; 示例
5
.globl _main               ; 需要配合.globl声明
6
_main::                    ; C入口函数（全局）
7
    mov SP, #0x80
8

9
; 中断服务函数（全局）
10
_ext0_isr::
11
    push PSW
12
    ; ... 中断处理
13
    pop PSW
14
    reti
15

16
; 在另一个文件中可这样引用
17
.extern _main              ; 声明外部全局符号
18
.extern _ext0_isr

1
; 文件: module1.asm
2
.local_label:              ; 仅本文件可见
3
    nop
4

5
global_label::             ; 全局可见（自动.globl）
6
    nop
7

8
.globl exported_label      ; 需要显式声明
9
exported_label:            ; 全局可见（需.globl）
10
    nop
11

12
; 文件: module2.asm
13
.extern global_label       ; 引用全局标签
14
.extern exported_label
15

16
call global_label          ; 可调用
17
call exported_label        ; 可调用
18
; call local_label        ; 错误！不可访问

1
; 数字标签（自动局部）
2
1:                         ; 数字标签，可重复定义
3
    nop
4
    jb   P1.0, 1b          ; 向后跳转到最近的1:
5

6
2:                         ; 另一个数字标签
7
    nop
8
    jnb  P1.1, 2f          ; 向前跳转到下一个2:
9

10
; 示例：循环中使用
11
    mov  R7, #10
12
1$:                        ; 带$的数字标签（推荐）
13
    djnz R7, 1$            ; 向后跳转
14

15
; 嵌套循环
16
    mov  R6, #5
17
2$:
18
    mov  R7, #10
19
1$:
20
    djnz R7, 1$
21
    djnz R6, 2$

1
TARGET = example
2
SRCS = main.asm uart.asm timer.asm
3
OBJS = $(SRCS:.asm=.rel)
4

5
CC = sdcc
6
CFLAGS = -mmcs51 --model-small --opt-code-size
7

8
all: $(TARGET).hex
9

10
$(TARGET).hex: $(OBJS)
11
  $(CC) $(CFLAGS) $(OBJS) -o $(TARGET).ihx
12
  packihx $(TARGET).ihx > $(TARGET).hex
13

14
%.rel: %.asm
15
  $(CC) -c $(CFLAGS) $<
16

17
clean:
18
  rm -f *.rel *.asm *.lst *.sym *.ihx *.hex *.map