用途:为微控制器及外设项目生成清晰、适合课堂和初学者的接线图,覆盖 Pico、NeoPixel 灯带/灯环、按钮、编码器、电位器、传感器、电池组等。核心思路是“图即代码”,每个图是一个小 Python 程序,调用 schemdraw 输出 PNG 与 SVG,便于复现、版本控制和修改。
主要能力与风格:白底;顶部红色电源轨、底部黑色接地轨;微控制器为浅蓝色块置于中左,信号脚朝外设、电源脚朝左;外设置于右侧,信号脚对齐 MCU 对应 GPIO,保持直线水平接线;电源输入以左侧竖列表示;统一接地;颜色区分含义(红=电源,琥珀/橙=数据与信号,黑=地);左上角图例与顶部标题;点表示真实连接。目标是让初学者能用手指标着看,优先可读性而非正式电路图规范。
使用前检查:确认可导入 schemdraw,例如运行 python3 -c "import schemdraw; print(schemdraw.version)",期望 0.20+;若缺失应提示用户安装,不要静默 pip 安装。
工作流程:先读取 kit 的 config.py 与 src/kits/<kit>/ 下源码,确定各 GPIO 引脚与电气接法,不要猜测;注意内部上拉的按钮/编码器另一脚直接接 GND,无需外部电阻或 VCC。接着复制 scripts/circuit_diagram_template.py 到 src/kits/<kit>/circuit-diagram.py,修改元件块、信号接线与电源/接地三处;OUT_DIR 设为 docs/kits/<kit>/img/。运行 cd src/kits/<kit> && python3 circuit-diagram.py 后必须打开 PNG 目视检查重叠、标签碰撞、斜线、裁切和穿块问题并迭代。最后在 kit 页面引用 PNG,配描述性 alt 文本、文字颜色说明与连接列表;学生页可加“如何读图”说明并遵循 CONTENT-GENERATION-GUIDE.md,教师页使用专业语气。
限制:引脚图不可得时应询问用户而非编造;schemdraw 需单独安装;具体 API 细节需参考 references/schemdraw-cookbook.md;资料未提供收费、价格或平台信息。