1. 项目概述从想法到桌面利器最近桌面上的键盘越用越觉得不够“顺手”倒不是说键盘本身不好而是总有些高频操作需要反复移动鼠标或者组合好几个按键才能完成。比如在剪辑视频时频繁切换工具、在写代码时快速插入常用代码片段、或者干脆就是想在摸鱼时一键打开某个网页。这种时候一个独立的、可高度自定义的Macropad宏键盘就成了刚需。市面上的成品要么功能太固定要么价格不菲于是萌生了自己动手做一个的念头。正好看到Seeed Studio的Xiao系列开发板尤其是基于RP2040芯片的Xiao RP2040尺寸小巧、性能强劲、价格亲民简直是DIY Macropad的绝佳核心。这个“Xiao NAH Macropad”项目就是围绕它展开的一次从电路设计、PCB打样、固件编程到外壳制作的完整实践。NAH在这里不是什么缩写纯粹是做完后觉得它“小而美”随口起的名字。整个项目下来你会发现打造一个完全贴合自己工作流的专属输入设备其乐趣和成就感远超购买成品。这个项目适合所有对硬件DIY、嵌入式开发感兴趣的朋友无论你是想深入学习RP2040和CircuitPython/KMK还是想体验一次完整的从原理图到实物的电子制作流程亦或是单纯想要一个独一无二的桌面小工具它都是一个绝佳的练手项目。你不需要是电子工程科班出身只要有一颗爱折腾的心跟着步骤走就能收获一块属于你自己的、功能强大的Macropad。2. 核心设计思路与方案选型2.1 为什么选择Xiao RP2040作为主控主控芯片的选择是项目的基石。我最终锁定Seeed Studio的Xiao RP2040主要基于以下几点考量首先极致的尺寸与完整的接口。Xiao RP2040的板子只有21x17.5mm比一枚硬币还小这为设计紧凑的Macropad提供了可能。尽管体积小它却引出了RP2040芯片的大部分可用GPIO共11个并且自带USB Type-C接口无需额外的USB转串口芯片简化了设计和供电。对于Macropad来说我们通常需要连接多个按键开关和可能的状态指示灯如Caps Lock这些GPIO口基本够用。其次强大的RP2040芯片内核。RP2040是Raspberry Pi基金会推出的微控制器双核Arm Cortex-M0处理器运行频率最高133MHz性能对于处理键盘矩阵扫描和USB HID通信绰绰有余。其264KB的SRAM和丰富的Flash存储空间Xiao板载2MB足以运行复杂的键位映射逻辑和层切换功能。第三丰富的软件生态支持。RP2040官方支持MicroPython和CircuitPython而CircuitPython社区中有一个非常活跃且易用的键盘固件项目——KMK。KMK采用Python编写配置键盘键位、层、RGB灯光等就像写Python脚本一样简单极大地降低了开发门槛避免了传统键盘固件如QMK需要搭建编译环境、学习C语言的复杂性。最后良好的可扩展性。Xiao RP2040板载了可编程的RGB LED和用户按键本身就可以作为Macropad的一个状态指示灯和功能键使用。其小巧的尺寸也便于集成到各种自定义外壳中。注意Xiao系列还有ESP32C3、nRF52840等版本选择RP2040版本主要是看中其对于KMK固件的原生友好性和极高的性价比在键盘应用这个特定场景下是最均衡的选择。2.2 宏键盘的功能定义与结构规划在画原理图之前必须想清楚这个Macropad要做什么。我将其核心功能定义如下核心输入提供12个机械轴键位采用3x4矩阵布局每个键均可自定义为单键、组合键如CtrlC、多媒体键如播放/暂停或复杂的宏序列。视觉反馈集成一个128x64像素的OLED显示屏用于实时显示当前激活的键位层、系统状态如Caps Lock、自定义图标或动画。交互增强加入一个旋转编码器Encoder用于调节音量、滚动页面、切换标签页等无需精确点击的连续操作。状态指示利用Xiao板载的RGB LED和每个按键下的单色LED可选提供层切换、按键触发等视觉反馈。基于以上功能结构上规划为三层顶层为定位板固定机械轴和编码器中间层为PCB承载所有电子元件并实现电气连接底层为底壳用于封闭和支撑。PCB将成为连接一切的核心。2.3 开发工具链选择立创EDA专业版PCB设计工具我选择了立创EDA专业版。对于这个级别的项目它比Altium Designer或KiCad更友好。首先是完全免费且在线操作省去了安装和破解的麻烦。其次它的元件库与嘉立创的SMT贴片和PCB打样服务无缝集成在画图时就能直接使用嘉立创仓库里的元件并一键生成生产文件极大降低了从设计到生产的门槛。最后它的学习曲线相对平缓社区资源丰富遇到问题容易找到解决方案。3. 电路原理图设计与核心元件解析3.1 主控电路与电源设计原理图设计从核心——Xiao RP2040模块开始。在立创EDA中可以直接搜索并放置“Seeed Studio Xiao RP2040”的原理图符号。其连接非常简单USB接口模块自带我们只需在PCB上留出Type-C母座的位置确保其与模块的USB_D/-引脚连通即可。这里有一个关键细节USB数据线D/D-的走线应尽可能短、等长并做好差分对布线以减少信号完整性问题。虽然对于低速的USB HID设备要求不高但养成好习惯很重要。电源Xiao模块的3V3引脚输出3.3V稳压电源最大输出电流约300mA。我们的整个系统按键矩阵、OLED、编码器都将由它供电。需要在原理图中用一个大电容如10uF和一个小的去耦电容0.1uF并联在3V3和GND之间放置在靠近模块电源引脚的位置以滤除电源噪声确保系统稳定。Boot/ResetXiao的BOOT引脚拉低后上电可进入UF2烧录模式。我将其连接到一个轻触开关另一端接地方便固件更新。3.2 按键矩阵电路设计12个按键采用3行4列的矩阵扫描方式这只需要347个GPIO口比直接连接12个GPIO口节省了5个。矩阵的原理是将按键布置在行线和列线的交叉点上。微控制器依次将每一行线拉低输出低电平然后读取所有列线的状态输入模式内部上拉。如果某个交叉点的按键被按下对应的列线就会被拉低从而检测到按键。在原理图中行线ROW0, ROW1, ROW2连接至Xiao的GPIO配置为输出。列线COL0, COL1, COL2, COL3连接至Xiao的GPIO配置为输入并启用内部上拉电阻。每个交叉点放置一个机械键盘轴座的焊盘如热插拔轴座并在行列线之间连接一个开关二极管如1N4148。二极管是防止“鬼键”的关键。当多个按键同时按下时没有二极管的矩阵可能会产生错误的导通路径导致检测到并未按下的“幽灵”按键。二极管确保了电流只能单向流动从行到列从而消除了这种可能性。3.3 OLED显示屏与旋转编码器接口OLED显示屏SSD1306驱动我选择I2C接口的0.96寸OLED模块因为它只需要两根信号线SDA, SCL和电源线节省GPIO。在原理图中将模块的VCC接3V3GND接GNDSDA和SCL分别接至Xiao的GPIO6和GPIO7RP2040支持多个I2C通道可任意分配。别忘了在SDA和SCL线上各加一个4.7kΩ的上拉电阻到3V3这是I2C总线正常工作的必需条件。旋转编码器选择常见的EC11型带按键功能。它有5个引脚两个相位输出A, B、一个公共端C、以及独立按键的两个引脚。将A、B引脚接至Xiao的两个GPIO配置为输入内部上拉用于检测旋转方向和步数。公共端C接地。独立按键则可以像普通按键一样接入键盘矩阵或者单独占用一个GPIO。3.4 从原理图到PCB的导入与前期准备原理图绘制完毕并完成电气规则检查ERC后就可以进入PCB设计环节。在立创EDA中点击“设计”-“转换原理图到PCB”软件会自动生成一个包含所有元件的PCB文件并用“飞线”细的虚线显示元件之间的电气连接关系。在开始布局布线之前有几步准备工作板框绘制根据你设计的外壳尺寸在“板框层”绘制出PCB的实际形状和大小。我的设计是80mm x 60mm的矩形。固定孔放置在四个角放置螺丝孔如M2尺寸用于固定PCB和外壳。元件布局规划这是一个关键步骤。需要遵循“信号流”原则USB接口 - 主控 - 核心外设矩阵、OLED、编码器。大致规划好各个功能模块在板上的区域。4. PCB布局布线实战与技巧4.1 元件布局的黄金法则布局决定了布线的难易度和最终电路的性能。我的布局顺序和策略如下核心定位首先放置Xiao RP2040模块。将其放在PCB中央略偏USB接口一侧的位置因为它是所有连接的枢纽。接口固定放置USB Type-C接口在板子边缘并预留足够的空间方便插拔。放置OLED显示屏的排母接口在板子正面计划安装屏幕的位置。功能分区按键矩阵区按照3x4的网格整齐排列12个热插拔轴座。这是板子上面积最大的部分务必保持间距标准通常为19mmx19mm。编码器区将旋转编码器放在矩阵旁边方便拇指操作的位置。二极管阵列将12个二极管紧挨着对应的轴座放置例如放在轴座的正下方或侧面这样可以极大地缩短行/列线到二极管的走线距离使布线更清晰。我选择使用0805封装的二极管手工焊接也方便。去耦电容就近原则将那个0.1uF的去耦电容尽可能靠近Xiao模块的3V3和GND引脚放置。预留测试点在关键的电源3V3和信号线如I2C上放置一些裸露的焊盘作为测试点方便后期调试。实操心得布局时可以不断使用“3D预览”功能查看元件在空间上是否冲突特别是较高的元件如电解电容、USB座以及是否符合你的外壳设计。在立创EDA中切换视图检查元件是否都放在了顶层Top Layer除非你计划做双面贴片。4.2 布线规则与具体操作技巧布局完成后密密麻麻的飞线看起来吓人但按部就班就能理清。设置设计规则这是保证PCB可制造性的关键。在立创EDA的“设计规则”中设置线宽电源线如3V3主干建议12-20mil0.3-0.5mm普通信号线8-10mil0.2-0.25mm。我设置电源线15mil信号线10mil。线间距至少6mil0.15mm嘉立创的工艺能力可以做到6/6mil线宽/线距。过孔尺寸外径24mil内径12mil是一个通用且可靠的选择。布线优先级电源先行首先布置3V3和GND网络。3V3走一条相对粗的线像树干一样延伸到各个模块。地线的处理尤为重要。我采用“铺铜”的方式。在完成大部分信号线布线后在顶层和底层都进行地平面铺铜。这能为信号提供良好的回流路径减少噪声。铺铜后所有GND网络的焊盘会自动通过“十字花焊盘”或直接连接至铜皮。关键信号其次布USB D/D-差分对。使用立创EDA的“差分对布线”工具设置好线宽和间距后两条线会等长并行非常方便。尽量短且不要靠近高频或噪声源。I2C信号SDA和SCL线尽量平行走线长度相近。虽然速度不高但保持良好习惯。矩阵走线这是最繁琐但最有规律的部分。由于布局时二极管已靠近轴座现在只需将同一行的所有二极管的阴极有标记的一端用一根线连起来形成“行线”将同一列的所有轴座的一个引脚或二极管的阳极用一根线连起来形成“列线”。然后将这些行线和列线引到Xiao模块对应的GPIO上。走线时可以充分利用PCB的两面通过过孔进行换层。例如所有行线走在顶层所有列线走底层在交叉处通过过孔上下穿行避免直接交叉这样可以简化布线。使用过孔的艺术过孔是连接双面的桥梁。不要吝啬使用过孔但也要避免过度。当一条线在同一层无法绕过时果断打一个过孔换到另一层继续走。过孔应尽量靠近需要换线的元件引脚。丝印标注布线完成后在丝印层Top Silkscreen清晰标注元件位号如R1, C1、接口名称如USB,I2C、以及按键的默认功能如F1,CtrlC。这对于焊接、调试和日后使用至关重要。4.3 DRC检查与生产文件输出布线完成后必须运行设计规则检查。立创EDA的DRC工具会自动检查线宽、线距、焊盘间距等是否符合你设定的规则并报告所有错误和警告。必须逐一修正所有错误Error。对于警告Warning如“丝印上焊盘”需要判断是否影响焊接通常建议调整丝印位置避开焊盘。DRC通过后就可以生成生产文件了点击“制造”-“PCB制版文件”。通常选择“Gerber”格式。立创EDA会自动生成包含各层顶层、底层、丝印层、阻焊层、钻孔层等的Gerber文件和一个钻孔文件。在嘉立创下单时直接上传这个Gerber压缩包即可。系统会自动解析并显示PCB的预览图务必仔细核对预览图与你设计的一致性特别是钻孔位置和阻焊开窗。5. 固件开发使用CircuitPython与KMKPCB去打样了这段时间正好用来开发固件。这是让Macropad拥有灵魂的一步。5.1 搭建CircuitPython环境刷写CircuitPython固件从CircuitPython官网下载针对Seeed Studio XIAO RP2040的.uf2固件文件。按住Xiao板上的BOOT按钮或我们PCB上引出的复位键同时用USB线连接电脑电脑上会出现一个名为RPI-RP2的U盘。将下载的.uf2文件拖入该U盘完成后板子会自动重启并出现一个名为CIRCUITPY的U盘。安装代码编辑器推荐使用VS Code并安装CircuitPython扩展插件。该插件可以提供代码自动完成、串口监视器等功能非常方便。5.2 KMK键盘固件配置详解CIRCUITPY盘符下的code.py是主程序入口。我们将在这里配置KMK。import board import busio from kmk.kmk_keyboard import KMKKeyboard from kmk.keys import KC from kmk.matrix import DiodeOrientation from kmk.handlers.encoder import EncoderHandler from kmk.modules.layers import Layers from kmk.extensions.display import Display, TextEntry from kmk.extensions.display.ssd1306 import SSD1306 # 1. 初始化键盘对象 keyboard KMKKeyboard() # 2. 定义引脚 # 按键矩阵引脚 keyboard.col_pins (board.GP0, board.GP1, board.GP2, board.GP3) # 列 keyboard.row_pins (board.GP4, board.GP5, board.GP6) # 行 keyboard.diode_orientation DiodeOrientation.COL2ROW # 二极管方向列到行 # 编码器引脚 encoder_pin_a board.GP8 encoder_pin_b board.GP9 encoder_button_pin board.GP10 # I2C for OLED i2c busio.I2C(board.GP7, board.GP6) # SCL, SDA # 3. 初始化模块和扩展 layers Layers() keyboard.modules [layers] # 初始化编码器 encoder_handler EncoderHandler() encoder_handler.pins ((encoder_pin_a, encoder_pin_b, encoder_button_pin, False),) # False表示编码器不反转方向 encoder_handler.map [ ((KC.VOLD, KC.VOLU, KC.MUTE),) ] # 旋转音量减/加按下静音 keyboard.modules.append(encoder_handler) # 初始化OLED display Display(SSD1306(i2c, width128, height64), TextEntry()) keyboard.extensions [display] # 4. 定义键位层 # 层0基础层 keyboard.keymap [ # 3x4 键位矩阵 [ KC.F13, KC.F14, KC.F15, KC.F16, KC.F17, KC.F18, KC.F19, KC.F20, KC.F21, KC.F22, KC.F23, KC.F24, ], ] # 5. 启动键盘 if __name__ __main__: keyboard.go()代码关键点解析diode_orientation必须根据你PCB上二极管的实际方向设置。我们是列线接二极管阳极行线拉低扫描所以是COL2ROW。encoder_handler.map这里定义了编码器的行为。它是一个列表的列表允许你为不同的键盘层定义不同的编码器功能。这里只在层0定义了音量控制。keyboard.keymap这是键位映射的核心。每个子列表代表一个层。键位代码KC.F13等是KMK预定义的。你可以轻松改为KC.C、KC.LCTL(KC.C)复制、甚至复杂的宏。5.3 高级功能层切换与OLED显示KMK的强大之处在于其模块化。我们可以轻松添加层切换功能并让OLED显示当前层。# ... 上述初始化代码之后 ... from kmk.modules.layers import Layers from kmk.extensions.display import Display, TextEntry from kmk.extensions.display.ssd1306 import SSD1306 layers Layers() keyboard.modules.append(layers) # 定义一个切换层的键 TO_MEDIA KC.MO(1) # 按住时切换到层1松开回层0 # 更新键位映射将某个键比如右下角的键设为层切换键 keyboard.keymap [ # 层0功能键层 [ KC.F13, KC.F14, KC.F15, KC.F16, KC.F17, KC.F18, KC.F19, KC.F20, KC.F21, KC.F22, KC.F23, TO_MEDIA, # 最后一个键改为层切换 ], # 层1多媒体层 [ KC.MPRV, KC.MPLY, KC.MNXT, KC.MUTE, KC.VOLD, KC.VOLU, KC.BRIU, KC.BRID, KC.MAIL, KC.CALC, KC.MYCM, KC.TRNS, # KC.TRNS表示透传即该键在层1保持层0的功能仍是TO_MEDIA ], ] # 配置OLED显示层信息 class LayerDisplay(TextEntry): def __init__(self): super().__init__() def render(self, keyboard): self.text fLayer: {keyboard.active_layers[0]} # 显示当前层索引 super().render(keyboard) display_ext Display(SSD1306(i2c), LayerDisplay()) keyboard.extensions.append(display_ext)现在当你按下右下角的键时键盘会切换到多媒体层OLED屏幕也会显示“Layer: 1”释放按键则返回基础层。6. 焊接、组装与调试实录6.1 PCB焊接顺序与要点收到嘉立创打样回来的PCB后焊接顺序建议“从低到高从中心到外围”焊接贴片元件首先焊接最小的元件如电阻、电容、二极管。使用焊锡膏和热风枪或者精细的烙铁头。二极管的方向千万不能错PCB丝印上的竖线标记对应二极管的阴极通常元件本体上也有一条线或色环标记。焊接芯片与接口接着焊接Xiao RP2040模块、OLED排母、USB Type-C座、编码器。Xiao模块引脚间距小检查有无桥接。Type-C座子焊盘较多确保每个引脚都焊牢。焊接通孔元件最后焊接热插拔轴座。将轴座卡进PCB背面点焊固定。确保所有轴座平整否则安装键帽后会歪斜。焊接连接线如有如果OLED屏幕是分离模块需要焊接排线。避坑技巧焊接完成后先不要安装机械轴和键帽。用万用表的蜂鸣档仔细检查电源3V3和GND之间是否短路。这是防止通电烧毁芯片的最重要一步。6.2 硬件组装步骤安装机械轴将12个机械轴体如Gateron红轴按压进热插拔轴座。注意轴体的针脚要对准孔位。固定定位板与PCB如果设计了定位板将定位板套在轴体上然后用螺丝将定位板和PCB一起固定在底壳上。轴体被夹在中间非常稳固。安装编码器和OLED将编码器旋钮帽和OLED屏幕安装到位。连接与通电用USB-C线连接Macropad和电脑。6.3 上电调试与问题排查首次上电是紧张又兴奋的时刻。可能出现的情况及对策现象可能原因排查步骤电脑无任何反应未识别USB设备1. USB线或接口问题2. 电源短路3. 主控未正常工作1. 换线、换端口。2.立即断电用万用表复查3V3对GND电阻。3. 检查Xiao模块焊接特别是电源引脚。尝试短接BOOT引脚进入UF2模式看电脑是否识别。电脑识别为“未知USB设备”或“CIRCUITPY”盘符不出现1. CircuitPython固件未刷写或损坏2.code.py有语法错误导致崩溃1. 重新刷写CircuitPython UF2文件。2. 检查code.py代码尤其是引脚定义是否正确。可以通过串口监视器查看错误输出。按键无反应1. 矩阵二极管方向焊反2. 行列引脚定义错误3. KMK配置中二极管方向设置错误1. 检查二极管。2. 用万用表蜂鸣档依次短接每个轴座的两个焊盘同时在KMK的串口输出中观察键值打印验证矩阵扫描逻辑。3. 核对diode_orientation。个别按键失灵1. 该轴座虚焊或损坏2. 对应的二极管损坏3. PCB走线断裂1. 补焊轴座。2. 更换二极管。3. 用万用表追踪线路连通性。编码器旋转无反应1. A/B相引脚接反或接触不良2. KMK中编码器引脚定义错误3. 编码器内部接触不良1. 检查焊接。2. 交换encoder_pin_a和encoder_pin_b的引脚定义试试。3. 更换编码器。OLED不显示1. I2C地址错误通常SSD1306是0x3C2. SDA/SCL接反或未上拉3. 电源未接通1. 确认代码中I2C地址。可用I2C扫描程序检查。2. 检查上拉电阻焊接测量SDA/SCL电压不通信时应为高电平3.3V。3. 检查OLED模块的VCC和GND。一个真实的踩坑记录我第一次测试时所有按键列都串键。检查后发现原理图中二极管符号的阴极标记与PCB封装库中二极管的阴极标记方向画反了导致所有二极管在PCB上实际是反向安装的。解决方法是在KMK配置中将diode_orientation从COL2ROW改为ROW2COL让电流反向流动问题解决。这提醒我们原理图符号和PCB封装的对应关系必须仔细核对。7. 外壳设计与最终体验硬件和软件都调试通过后一个裸板放在桌面上既不美观也不实用。外壳设计可以很简单也可以很复杂。简易方案使用现成的亚克力堆叠外壳。在立创EDA或Fusion 360中根据PCB尺寸和螺丝孔位置画好几层亚克力板的图纸底板、支撑柱、定位板、顶框然后去淘宝找激光切割亚克力的商家定制。成本低速度快。进阶方案3D打印外壳。使用Fusion 360等软件建模设计一个带有倾角、底部走线槽的一体化外壳。可以打印PLA材质追求质感可以打印PETG或光敏树脂。我的“Xiao NAH Macropad”最终采用了一个3D打印的底壳搭配一个CNC切割的铝合金定位板作为顶盖呈现出一种“半裸露”的工业风格。将这块自己亲手打造的小键盘放在主力键盘旁边通过KMK配置文件我将它设置为我的“剪辑助手”层一键J/L切割、一键添加转场、编码器旋转缩放时间线、按下编码器播放/暂停。这种无缝融入个人工作流、效率提升的体验是任何成品外设都无法给予的。整个项目走下来最大的收获不是这块键盘本身而是完整经历了一个嵌入式产品从概念、设计、实现到调试的全过程。每一个环节的细节比如PCB上一根线的走向KMK配置里一个参数的调整都直接影响最终结果。当你按下自己设计的按键屏幕上的光标随之精确移动时那种对技术的掌控感和创造力的满足感正是DIY最大的魅力所在。如果你也心动了不妨就从画下第一个原理图符号开始吧。