Files
R8Forge/hardware
dsh a5dfd70499 docs: what a mechanical dp can actually mean when the memory is electronic
The question that exposes the gap in the previous note: if the ring lives in a
6116, what is a mechanical pointer pointing at?  The honest answer is that dp is
an address, so there are three coherent designs and they are different machines.

A. a mechanical address register.  The physical position of a 64 position device
(uniselector, or stepper plus ratchet) feeds A0..A5 of the SRAM through its
contact bank.  The position is genuinely part of the machine state and the panel
pointer does not lie, but it only selects which byte is addressed -- it is not
the byte.  Cheap (50-200 CNY) and two days of work, so it stays N1.

B. a drum.  Eight tracks by 64 cells rotating under fixed read and write heads:
then the memory itself is mechanical, dp becomes the phase of the rotation, >
waits for the next cell pulse, < waits almost a full turn, and + or - does a
read-modify-write between two heads one cell apart.  Expensive and months of
machining, but it is the 1950s machine.

C. a magnetostrictive delay line.  512 bits of sound circulating in a loop of
nickel wire with a transducer at each end: the ring is literally a loop, there
are no bearings and no heads to wear, > is free (wait for the next time slot), <
costs at most one revolution (0.5 ms at 1 Mbit/s).  An order of magnitude cheaper
than the drum and still electrically genuine, but it needs winding, biasing and
scope time.

Recommendation stays: A first because it is cheap and it is honest about being an
address register, then C if the wish is for the memory itself to be mechanical,
with B kept for when there must be a spinning drum.  The section now says all of
this, and the summary table no longer claims dp can simply "be mechanical".
2026-11-20 16:43:57 +08:00
..

ROT-8 硬件:这个目录里有什么

docs/hardware.md 的落地部分。三样东西都跑通了(Icarus Verilog 14.0):

文件 是什么 状态
rot8.v 机器的 RTL:8 条指令、3 bit 操作码、6 位 dp 的 64 格环、循环栈式括号跳转 ✅ 与软件逐字节一致
tb_rot8.v testbench:$readmemh 一张镜像,跑到停机,按 tape_run 的格式打印 OUT 流和步数 ✅
(工具)r8forge_tape_pack 文本纸带 → 3 bit 打包镜像 + --hex($readmemh 用) ✅ 在 tests/ 里

实测:RTL 与软件完全一致

8 位 / 64 格,tape_run --loop-stack --retest(板子实际采用的口径)对标 vvp:

纸带 指令数 步数 OUT 个数 结果
-+. 微测试 3 3 1 ✅ 打出 128
hello 577 417 10 ✅
term(输入 lhi) 16 414 17 643 11 ✅
calc(输入 12 34 + .) 51 378 166 741 19 ✅ 打出 > 12 34 + . / 046 / >
全家桶 asm/test.r8asm 43 676 100 142 93 ✅

自动化:ctest -R rtl_sim(在 8 位 / 64 格的构建里真跑,其它几何打印 SKIP)。 tests/rtl_sim.cmake 就是那一轮:汇编 → 打包 → 软件跑 → iverilog 编 → vvp 跑 → 比对 OUT 流和步数。

自己跑一遍

# 8 位 / 64 格的构建(RTL 就是这台机器)
cmake -S . -B build8 -DR8FORGE_CELL_SIZE=8 -DR8FORGE_MEMORY_CELLS=64
cmake --build build8 --config Release

# 1) 汇编 + 打包 + 出 hex
build8/Release/r8forge examples/hello.r8asm > hello.rot8
build8/Release/r8forge_tape_pack hello.rot8 -o hello.r8t --hex hello.hex --verify

# 2) 软件侧金标准(注意两个开关)
build8/Release/r8forge_tape_run hello.r8t --loop-stack --retest

# 3) RTL
iverilog -g2012 -o rot8_tb.vvp hardware/rot8.v hardware/tb_rot8.v
vvp rot8_tb.vvp +HEX=hello.hex +LEN=577

带输入的程序(calc、term):把输入写成一个文件(不要换行),用 +INFILE= 喂; 文件读完之后机器读到 0(和解释器的 EOF 语义一致):

printf '12 34 + .' > calc_in.txt
vvp rot8_tb.vvp +HEX=calc8.hex +LEN=51378 +INFILE=calc_in.txt
build8/Release/r8forge_tape_run calc8.r8t --loop-stack --retest -i '12 34 + .'

两个坑(都踩过)

  1. +HEX= / +INFILE= 的路径必须是纯 ASCII。Icarus 把 plusarg 原样传下去,路径里有 中文(这个仓库就在 …/文档/… 下)时 $readmemh 收到的是乱码,内存静默留空,机器 就把一整条"全是 0 号操作码"的纸带跑完、什么都不打。要么 cd 进 hex 所在目录用相对 路径(tests/rtl_sim.cmake 就是这么做的),要么把文件拷到 ASCII 路径。
  2. in_ready 不能加 !in_valid 的限定。第一版写成 in_ready = … && !in_valid, 于是生产者永远看不到"接受"的边沿、握手死锁 —— 只有 hello 这种不读输入的纸带能跑。

RTL 里几个"故意这么写"的地方

  1. 程序存储器读 16 位窗口(prog_addr0 / prog_addr1 两次字节读):3 bit 指令会跨字节, 取指必须看到相邻两个字节。真实板子上这对应"16 位宽 ROM"、"两片 ROM"或一个移位寄存器。
  2. 循环栈的进出账跟跳法绑定:跳回 [' 本身(retest)时 ] 必须弹栈([' 重跑会 再压一次);跳回 [' 之后一格时要留栈到循环退出。RTL 只实现前者(契约口径), 软件侧 --loop-stack --retest 与它对应;r8forge_tape_pack_test 盯着四种组合输出一致。
  3. biz 的前向跳过是独立状态(S_SCAN):每拍读一条、不算步数,跳到配对的 ] 之后 再多走一格。
  4. , 阻塞:in_ready 拉高、所有寄存器保持到 in_valid;读到 0 必须显式给 (in_valid + in_data=0)。
  5. 停机:ip >= prog_len → halted,并且这一拍不再执行(第一版漏了判断,会从纸带外 多取一条、步数多 1)。

还没做的

  • 上板(M1):RTL 已经能跑,缺的是引脚约束、时钟、串口和面板。
  • ROM 烧写格式:28C256 / 39SF010 吃裸二进制 —— tape pack -o x.bin 去掉 16 字节 trailer 即可(--hex 那份是给仿真用的)。
  • UART / 前面板 / 单步:RTL 已经留了 run / step / ip / dp / steps / halted。