Files
dsh f7ac81b06f asm: clb_puts and load -- printing a sentence, and the constant helper
clb_puts REG LEN prints LEN consecutive cells as characters (the low 7 bits, which
is what serial OUT sends).  LEN has to be an assembly time constant: .tp takes a
literal address here, so "print until the cell is zero" is not expressible -- the
walk would leave the data pointer somewhere else.  Each character costs two .tp
plus one out (three or four tape characters), uses no extra cell and leaves the
source cells alone.

load N V is the helper every driver was writing by hand (erase then .xor): .xor is
an exclusive or, so a second load without the erase would mix with the old value.

  drv/puts.r8asm      198 chars, in-family check: out 72 73 33 72 (HI! plus the
                      untouched source cell)
  examples/hello.r8asm 727 chars, out 72 69 76 76 79 44 32 82 56 33, and the
                      reference machine prints "HELLO, R8!"

Both are documented in SPEC 5.2; the macro count goes 48 -> 50 and the examples 16
-> 17.  The flagship tape is untouched (64513) because asm/test.r8asm still has its
own local load -- same body, and lib's definition comes first, so nothing changed.
2026-11-17 19:55:32 +08:00

219 lines
3.8 KiB
Plaintext

; Macro step
; %1: Count step_count
%macro step 1
%rep %1
stp
stp
%endrep
%endmacro
; Macro back
; %1: Count back_count
%macro back 1
%rep %1
btp
btp
%endrep
%endmacro
; Macro set_0
; %this: CellBit operand
%macro set_0 0
biz
flb
rnz
%endmacro
; Macro set_1
; %this: CellBit operand
%macro set_1 0
set_0
flb
%endmacro
; Macro erase
; %1: Cell operand
%macro erase 1
.anchor before_erase
.tp %1
%rep _CELL_SIZE
set_0
ror
%endrep
.tp before_erase
%endmacro
; Macro rol
; %this: Cell operand
%macro rol 0
%rep _CELL_SIZE - 1
ror
%endrep
%endmacro
; Macro clb_bit_mov
; %this: CellBit data
; %1: CellBit destination
%macro clb_bit_mov 1
.anchor before_clb_bit_mov
.tp %1
set_0
.tp before_clb_bit_mov
biz
.tp %1
flb
.tp before_clb_bit_mov
flb
rnz
.tp before_clb_bit_mov
%endmacro
; Macro bit_copy
; %this: CellBit data
; %1: CellBit destination
; %2: CellBit buffer
%macro bit_copy 2
.anchor before_bit_copy
.tp %1
set_0
.tp %2
set_0
.tp before_bit_copy
biz
.tp %1
flb
.tp %2
flb
.tp before_bit_copy
flb
rnz
.tp %2
clb_bit_mov before_bit_copy
.tp before_bit_copy
%endmacro
; Macro copy
; %this: CellBit data
; %1: CellBit destination
; %2: CellBit buffer
%macro copy 2
.anchor before_copy
%rep _CELL_SIZE
bit_copy %1 %2
ror
.tp %1
ror
.tp %2
ror
.tp before_copy
%endrep
%endmacro
; Macro bit_copy_to_buffer
; %this: UnitBit operand
; %1: CellBit tmp
%macro bit_copy_to_buffer 1
stp
.anchor bit_copy_to_buffer_buf_1
btp
bit_copy bit_copy_to_buffer_buf_1 %1
%endmacro
; Macro copy_to_buffer
; %this: Unit operand
; %1: Cell tmp
%macro copy_to_buffer 1
stp
.anchor copy_to_buffer_buf_1
btp
copy copy_to_buffer_buf_1 %1
%endmacro
; Macro output
; %1: Cell operand
%macro output 1
.anchor before_output
.tp %1
out
.tp before_output
%endmacro
; Macro loop
; %1: Cell C
;
; 动态循环的开口:按 C 里 1 的个数跑,每轮吃掉最低位的一个 1。
; C 一般由 clb_ones 从"次数"算出来 —— 这样循环次数就是**运行期**的值,
; 不再是汇编期的常数:
;
; clb_ones N C T F ; C = N 个 1,N 被吃成 0
; loop C
; ... body ...
; endloop C
;
; 两条约定:
; * 不开 anchor(所以能嵌套),`endloop` 之后 dp 停在 C 上;
; * 循环体不许碰 C。循环跑完 C 是 0 —— "配额"正好用完。
;
; 为什么循环体不能省掉那个 set_0: `biz`/`rnz` 判的是最低位,body 里不把它吃掉,
; `rnz` 看到还是 1 就跳回去,循环永远不结束。吃掉一格 = 用掉一轮配额。
%macro loop 1
.tp %1
biz
set_0
ror
%endmacro
; Macro endloop
; %1: Cell C
;
; loop 的收口。`rnz` 判的还是 C 的最低位,所以先把 dp 指回 C。
%macro endloop 1
.tp %1
rnz
%endmacro
; Macro load
; %1: Cell N
; %2: Count V
;
; 把一个汇编期常数装进一格:先 `erase` 再 `.xor`。两步都要有 —— `.xor` 是异或,不清格
; 就是"和旧值异或",同一格连着 load 两次会得到两个常数的异或。
%macro load 2
.tp %1
erase %1
.xor %2
%endmacro
; Macro clb_puts
; %1: Cell REG
; %2: Count LEN
;
; 把 REG 起 LEN 个连续 cell 的低 7 位当字符依次打出来(串行 I/O 下就是一行字)。
; LEN 必须是**汇编期常数**:这台机器没有间接寻址,`.tp` 只能写死地址,所以"遇到 0 就停"
; 那种运行期长度做不到(会拐进别的格子)。每个字符的代价是两条 `.tp` 加一条 `out`
; (三四个字符纸带),不占额外 cell,源格也原样保留。
;
; load MSG 72 ; "H"
; load MSG+1 73 ; "I"
; load MSG+2 33 ; "!"
; clb_puts MSG 3 ; 打印 H I !
%macro clb_puts 2
%for k %2
output %1+k
%endfor
%endmacro