quakkels/homebrew-lab

Source: https://github.com/quakkels/homebrew-lab

Homebrew Lab

一门自主的、以实验台实操为驱动的电子课程——通过在示波器上亲眼看来学习模拟电路。每个实验都以你亲自完成的测量收尾，得到一个与理论吻合（或让你意外）的数字。

⚠️ 本课程由 AI 生成。 它是在 AI 助手的协助下编写的，应被视为一张起点地图，而非权威。在依赖它之前，请对照可信参考资料（ARRL Handbook、数据手册、《电子学艺术》）核实元件数值、操作步骤，尤其是任何涉及市电或射频发射的内容。

适合谁

这门课程专为以下人群设计：

• 有软件开发背景 — 熟悉逻辑和代码，想了解底层硬件。
• 是业余无线电爱好者（hams） — 已经熟悉一些射频概念（频率、谐振、天线、传输线），并且想自制设备。

如果你正是这样的人，这门课程会发挥你的这些优势，同时针对常见的短板：模拟直觉 — 对元件的感知、在示波器上读取信号，以及介于“我能看懂原理图”和“我能设计原理图”之间的那些纽带（滤波器、阻抗、偏置）。

运作方式

每个实验遵循一个循环：

搭建 → 观察 → 解释 → 记录

搭建电路，在示波器上观察，理解你所看到的及其原因，然后将你的测量结果记录到实验的**记录（Log）**部分 — 这是你证明理论真实存在的证据。

结构

• syllabus.md — 总计划：目标、节奏、设备、完整的模块进阶路径，以及参考书库。
• experiments/ — 编号实验文件（00–14），每个主题一个，从 RC 时间常数一直到射频和嵌入式系统。
• projects/ — 两个从模块中延伸出的旗舰制作：一个从零开始的键盘和一个自制 QMX+ 收发信机。
• glossary.md — 用通俗语言解释每一个符号、单位、缩写和术语，以及如何阅读接线图。不假设你有任何电子学基础。

从 syllabus.md 开始，然后进入 experiments/00-bench-and-instrumentation.md。

打印一份实验台副本

为了在工作台上保留一份纸质副本，scripts/build_print.py 把整个课程合并成一份 Word/LibreOffice 文档 — 包含标题页、目录，以及每个文件作为一个章节，章节之间分页（syllabus → experiments → project briefs → glossary appendix）。

python3 scripts/build_print.py                # -> Homebrew-Lab.docx（默认）
python3 scripts/build_print.py my-copy.odt    # 原生 LibreOffice .odt

（在 Windows 上，使用 py scripts\build_print.py。）课程内容有任何变化时随时重新运行；实验文件会自动按数字顺序发现，因此新实验也会自动包含在内。.docx 可以在 Microsoft Word 和 LibreOffice 中打开并打印，这也是它作为默认格式的原因。生成的文档已被 git 忽略 — markdown 始终是唯一的事实来源。

依赖项：

• Python 3 — 必需；运行构建并执行文档后处理（页脚、页码、10pt）。仅使用标准库，无需 pip install。
• pandoc (https://pandoc.org) — 必需；负责 markdown → 文档的转换。以子进程方式调用，因此只需在 PATH 中。
• LibreOffice（soffice）— 仅在需要 .odt 输出时才需要；默认的 .docx 不使用它。

该脚本是纯 Python，因此可在 Windows、macOS 和 Linux 上运行。安装方式：Debian/Ubuntu sudo apt install pandoc python3；macOS brew install pandoc（Python 3 已自带）；Windows winget install JohnMacFarlane.Pandoc 以及从 python.org 安装 Python。只有当你需要 .odt 时才额外安装 LibreOffice。

正文字号为 10pt，页脚包含页码。打开文件时会自动填充目录 — Word 会自动更新；在 LibreOffice 中，如果看起来是空白，请选择工具 ▸ 更新 ▸ 全部更新（或全选后按 F9）。

安全

某些模块涉及市电相关电源和射频发射。测试时只能将发射送入假负载；只在你执照授权的频率和功率电平上辐射；在敏感元件周围遵守 ESD 防护措施。如有疑问，请查阅可信参考资料 — 参见上面的 AI 生成内容提示。