第三课:把接线图写成 HDL
将 NOT 和 AND 的接线翻译为可运行的硬件描述,分清部件端口与外部信号,并学会阅读测试结果。
本章目录CONTENTS ↓
上一课,我们用 NAND 的接线构造了 NOT 和 AND。这一课要做的是:把这些接线写成模拟器能读懂的文字,让它检查输出。
这里使用 Nand to Tetris 自己的 HDL(Hardware Description Language,硬件描述语言)。不需要先学另一门编程语言,也不需要购买电子元件。本课只涉及单比特逻辑门。
读完后,你应当能看懂 Not.hdl 和 And.hdl 这两份完整文件,解释每条连接,并知道如何判断测试是否符合预期。可以先完整阅读;模拟操作留到准备动手时再做。
1. HDL 写的是电路连接
先回忆 NOT 的构造:同一个输入接到 NAND 的两个输入端口。
┌──────────┐in ──┬──────→│ a │ │ │ Nand ├──→ out └──────→│ b │ └──────────┘本课把外部输入命名为 in,与官方 Not 芯片的接口一致;它仍然是上一课的输入信号 x。逻辑功能常写作 NAND、NOT,HDL 中的部件名则按官方拼写写成 Nand、Not,注意大小写。
将上图写成完整文件 Not.hdl:
CHIP Not { IN in; OUT out;
PARTS: Nand(a=in, b=in, out=out);}可以分成两层阅读:
| 写法 | 含义 |
|---|---|
CHIP Not |
这份文件定义的芯片名为 Not,与文件名 Not.hdl 对应 |
IN in; |
整个芯片对外提供一个名为 in 的输入端口 |
OUT out; |
整个芯片对外提供一个名为 out 的输出端口 |
PARTS: |
下面开始描述内部使用的部件和连接 |
Nand(...); |
放置一个 Nand 部件,并指定它各端口的连接 |
花括号包住芯片定义;输入、输出声明以及每个部件描述以分号结束。PARTS: 的结尾是冒号。这些符号让模拟器能区分文件中的各部分。
2. 等号左右,属于不同的层次
整份代码最值得仔细读的是这一行:
Nand(a=in, b=in, out=out);括号中的每项连接都遵循同一规则:左边是内部部件的端口名,右边是当前芯片里的连接对象。 在这个例子里,右边全部是当前 Not 芯片的外部端口。
| 连接 | 左边属于内部 Nand | 右边属于正在构造的 Not |
|---|---|---|
a=in |
输入端口 a | 外部输入 in |
b=in |
输入端口 b | 同一个外部输入 in |
out=out |
输出端口 out | 外部输出 out |
两个 out 拼写相同,但分别属于两个部件。out=out 表示把内部 Nand 的输出接到整个 Not 的输出。
这个等号表示接线;信号的流向要看端口是输入还是输出。不能统一理解成“右边的值赋给左边”:在 out=out 处,内部部件把输出送向外部。
同样,Nand(a=in, b=in, out=out) 不是调用一个函数后接收返回值。它描述了一个持续存在的 Nand 部件,以及三处连接。
现在送入 in=0:Nand 的两个输入都是 0,所以 out=1。送入 in=1:两个输入都是 1,所以 out=0。这与上一课的电路完全相同。
3. AND 的中间信号怎样表示
AND 需要两个 NAND。第一个输出中间信号 t,第二个把 t 取反。
完整文件 And.hdl 如下:
CHIP And { IN a, b; OUT out;
PARTS: Nand(a=a, b=b, out=t); Nand(a=t, b=t, out=out);}第一行部件描述中,a=a 左边是 Nand 的输入端口,右边是整个 And 的外部输入。b=b 同理。out=t 把这个 Nand 的输出接到内部信号 t。
第二行中,a=t 和 b=t 把同一条内部信号接到另一个 Nand 的两个输入,再通过 out=out 把结果送到整个 And 的输出。
t 不需要像外部端口那样写进 IN 或 OUT;它由内部连接引入。把它列为外部输入反而会改变芯片接口。它也不是保存历史数值的变量。
用门禁输入 a=1、b=0 走一遍:
| 位置 | 看到的输入 | 产生的输出 |
|---|---|---|
| 第一个 Nand | a=1,b=0 | t=1 |
| 第二个 Nand | a=t=1,b=t=1 | out=0 |
得到 0,表示不允许进入。四种输入的预期结果是:
| a | b | 内部 t | 最终 out |
|---|---|---|---|
| 0 | 0 | 1 | 0 |
| 0 | 1 | 1 | 0 |
| 1 | 0 | 1 | 0 |
| 1 | 1 | 0 | 1 |
这里按两行的顺序分析,是为了方便追踪信号。交换这两条部件描述的书写顺序,连接关系不变,逻辑功能也不变。 HDL 描述的是电路结构,不能用普通程序“先执行上一行,再执行下一行”的方式理解。
本例直接使用两个 Nand,方便逐一对照接线。以后复用已经完成的 Not 时,第二行也可以写成 Not(in=t, out=out);。注意 Not 的输入端口叫 in,而 Nand 的输入端口叫 a、b;左侧名称必须匹配所用部件的接口。
4. 测试文件分别负责什么
官方 Project 1 为芯片提供 HDL 骨架和测试材料。以 And 为例:
| 文件 | 负责的事 |
|---|---|
And.hdl |
描述你构造的电路 |
And.tst |
指示模拟器设置输入、求值并记录输出 |
And.cmp |
给出测试所期待的结果 |
And.out |
保存本次运行产生的输出 |
在在线 IDE 中,后三者对应测试区的 Test Script、Compare File、Output File;Diff Table 用于查看结果差异。
假设测试输入是 a=0、b=0:预期 out=0。如果实际得到 1,就应沿着这组输入检查内部连接。测试失败告诉我们有一处行为不符合规格;它不会自动替我们解释接线为什么错了。
还要分清两个结果:
- 语法正确:模拟器能读懂 HDL 的写法。
- 测试通过:本次测试所检查的输出与预期一致。
一份电路可以没有语法错误,却实现了错误的功能。测试通过也需要结合覆盖范围判断:单比特 Not 只有两种输入,And 只有四种,可以全部检查;以后更大的芯片不能仅凭几组样例就断言所有情况都正确。
5. 准备动手时,怎样完成第一次模拟
打开官方在线 IDE 的 Hardware Simulator。这是软件中的硬件模拟,在线版无需安装 Java;不要把网页版操作与旧桌面版菜单混用。工具说明见官方软件页面。
按下面的顺序做一次完整验证即可,不需要先熟悉所有按钮:
- 在 HDL 区选择
Project 1,再选择Not。 - 将 HDL 编辑区替换为本课完整的
Not.hdl内容,检查状态栏是否有语法错误。 - 查看 Test Script 和 Compare File,确认当前测试针对 Not。
- 在 Test 区运行完整测试,查看 Output File 或 Diff Table,确认两种输入的输出分别为 1、0。
- 切换到
And,使用本课完整的And.hdl,以同样方法检查四种输入的结果为 0、0、0、1。
Eval 用于对当前输入求值;它不等于运行完整测试。第一次可以先完整运行测试,再观察某一组输入。测试区的运行按钮使用图标,具体位置和外观可能随版本变化。
在线 IDE 会把编辑内容保存在浏览器本地,完成后可使用下载功能备份 HDL。阅读课文、复制示例和独立完成项目是不同的学习阶段;本课只涉及 Project 1 的 Not、And,后续还会逐步实现其余芯片。
6. 出错时,先回到端口和接线
不必一看到失败就重写全部代码。先检查当前选中的芯片和文件是否匹配,再看这些常见问题:
| 现象或写法 | 检查方向 |
|---|---|
Nand(in=a, ...) |
Nand 没有名为 in 的输入端口,应使用它的 a、b |
第一个门写 out=t,第二个门却接 a=temp |
t 与 temp 是不同名称,没有表达预期的同一条连接 |
| 语法没有报错,但输出不对 | 选一组失败输入,逐个门推导输出,与接线对照 |
| 修改后结果看起来没变化 | 确认测试对应当前芯片,并重新运行完整测试 |
调试的核心是把文字还原成接线:内部部件的哪个端口,接到了当前芯片的哪条信号?
本课小结
HDL 给上一课的接线图提供了文字形式:CHIP、IN、OUT 定义外部接口,PARTS 描述内部部件。连接项的左侧是部件端口;在本课的例子中,右侧是当前芯片中的端口或内部信号。
Not 用一个 Nand,把外部输入同时接到它的两个输入;And 用两个 Nand,通过内部信号 t 相连。接线说明电路结构,测试则检查这份结构产生的行为。
读完可以直接就不理解的代码或测试结果提问,无需先完成测验。下一步会继续扩充逻辑门,逐步完成官方 Project 1。
资料供核验和自愿查阅,不要求另看视频或教材。端口连接与声明顺序的说明可参考 Mark Armbrust 的 HDL Survival Guide(高校保存的原文副本);其中桌面版界面说明不用于本课的在线操作。
这一页,先记到这里。