最近我用STM32F103C8T6做了一把完整的DIY机械键盘从画原理图、设计PCB、等打样、手工焊接再到编译固件、烧录调试前后折腾了两周。把这个过程完整整理出来希望能帮想动手做键盘的朋友一次成功。STM32F103C8T6这块芯片在键盘DIY圈子里不算新鲜但网上资料分散要么只讲固件要么只给电路很少有人把从零到一的全流程串起来讲。这篇文章就用一个真实项目为主线把电路设计、PCB布局、固件烧录、常见坑全部讲透。适合有基础单片机知识、想从零做一把客制化键盘的嵌入式爱好者也适合学生做课程设计时参考内容足够具体照着做基本能复现。1. 项目整体设计与方案选型思路1.1 为什么选STM32F103C8T6而不是传统键盘主控很多人一听DIY键盘第一反应是用Pro MicroATmega32U4、RP2040或者nRF52840因为QMK官方支持列表里这些芯片非常成熟。我前期也纠结过这个问题最后选了STM32F103C8T6理由很实际。首先是成本。STM32F103C8T6最小系统板在电商平台的价格常年稳定在几块钱到十几块钱区间比Pro Micro的几十块便宜不少。即便你想自己画板子、只买芯片这颗料单价也不高而且货源非常充足市面上有大量兼容芯片可以平替买的时候稍微留意下丝印和批次就行。对于做一把键盘来说用最小系统板改装的方案甚至不需要专门打PCB直接飞线都能跑起来上手门槛比想象中低很多。其次是性能冗余。F103C8T6主频72MHzFlash 64KBRAM 20KB。键盘扫描和USB HID上报这点负载对这颗芯片来说绰绰有余。最典型的就是用PA8引脚输出PWM驱动WS2812灯珠配合DMA传输跑灯效的时候几乎不占用CPU。这在传统AVR主控上是一种奢侈在F103上却是日常工作。再一个是生态。STM32的开发资料铺天盖地CubeMX图形化配置工具对新手极度友好HAL库也比寄存器操作容易上手。QMK虽然官方没有直接支持F103C8T6但社区里有很成熟的移植分支后面固件部分我会详细说。如果你不想用QMK自己写矩阵扫描和USB上报也不是难事STM32的USB外设库经过多年沉淀坑基本都被踩平了。1.2 整体方案架构最小系统板方案与自制核心板方案做键盘之前需要先想清楚硬件走哪条路线。我见过三种主流做法各有优劣。第一种是直接用现成的STM32F103C8T6最小系统板把板子背面贴到键盘PCB上或者干脆放在壳子里用杜邦线连接到矩阵。这种方案胜在省事不用考虑USB座子、LDO、晶振这些外围电路插上Type-C线就能用。缺点也很明显高度不可控占空间而且最低系统板上的AMS1117静态功耗大如果是无线方案就不太合适。纯有线键盘、桌面放着不动这种场景第一方案完全OK。第二种是自研核心板把F103最小系统、USB接口、矩阵接口都画在同一块PCB上。这样键盘内部非常整洁整机厚度可以压得很低还能在板子上集成RGB灯、蜂鸣器、旋转编码器等外设。缺点是需要自己设计电源、时钟、复位电路对PCB布局有一定要求。我这次做的键盘最终选的就是这条路线因为想要一个干净利落的成品而且把最小系统电路亲手画一遍对芯片的理解会深很多。第三种是折中路线在键盘PCB上预留一个邮票孔或者排针模块位把最小系统板插上去。相当于你自己画了矩阵底板但核心板还是现成的。这个方案适合第一版打样验证如果板子有Bug核心板还能拆下来复用损失最小。如果你完全没画过板子我建议先走第三种等验证了矩阵扫描、固件逻辑都OK之后第二版再集成核心电路。我认识不少朋友第一版就直接上集成方案结果USB识别不了排查半天发现是LDO虚焊或者晶振没起振调试难度直接翻倍。计划好迭代节奏能省掉大量无意义的折腾。1.3 功能需求梳理键位数、灯效与后续扩展任何项目动手前都要把需求写清楚键盘也一样。做多少键需不需要独立方向键要不要RGB灯要不要多媒体旋钮这些决策直接影响矩阵设计和芯片引脚分配。以我这次做的84键75%配列键盘为例矩阵是14行x6列总共84个开关。这里要特别强调一点矩阵扫描本身只用按键引脚但每个键还涉及二极管方向。矩阵设计时行线和列线会分别接按键的两端二极管要插在行方向上防止鬼键——鬼键就是多键同时按下时出现错误触发的现象。没有二极管的矩阵三键同按就会产生电流倒灌输出的组合完全错误。哪怕用现成的轴体热插拔PCB也要先确认二极管极性方向。灯效方面我计划每键一颗WS2812这意味着不仅矩阵需要引脚灯带数据线还要单独占用一个引脚。我选了PA8配合定时器PWM DMA方式驱动这也是热词里提到的典型玩法。如果你不做灯可以省掉这一路但引脚规划时建议预留谁知道过几天想不想加呢。扩展方面还预留了旋转编码器接口后续想调音量旋钮只需要在固件里加几行代码。一个IO就能实现非常划算。所以最终的引脚分配表里除了矩阵的20个引脚还要空出PA8、PB5等几个自定义引脚别把芯片所有IO都塞进固定功能里。2. 电路设计的核心细节与PCB布局要点2.1 最小系统电路设计电源、晶振、复位、BOOT既然决定自研核心板最小系统电路是第一个要攻克的关卡。STM32F103C8T6的最小系统不算复杂但每个部分都有讲究。电源部分F103的VDD范围是2.0V到3.6V典型值是3.3V。USB供电进来是5V所以要加一级LDO把电压降到3.3V。我选用的是XC6206P332MR功耗低、静态电流只有1uA左右非常适合键盘这种长期插着USB但又经常处于待机状态的设备。AMS1117不是不能用但它的静态电流高达5mA做在键盘上有点浪费。LDO输入侧放一个10uF钽电容和0.1uF陶瓷电容并联输出侧放一个4.7uF陶瓷电容这种组合在负载突变时能有效抑制纹波。另外每个VDD引脚旁边都要就近放一个0.1uF去耦电容这是PCB布局最基本的规矩别图省事跳过去。晶振电路F103的HSE引脚接8MHz无源晶振两个负载电容取20pF并联一个1M欧的反馈电阻。注意晶振下面不要走任何信号线晶振的两根走线尽量短且远离高速信号。这个点我在PCB布局部分会再展开。因为F103内部有PLL外部8MHz经过倍频后可以稳定跑到72MHz系统时钟。这里有个容易踩的坑如果用ST-Link烧录仿真器提供的是SWD接口跟外部晶振没直接关系但如果你的板子没焊接晶振或者晶振没起振Keil下载后程序一跑就死串口打印乱码都是这类问题。复位电路NRST引脚接一个0.1uF电容到GND再通过10K电阻上拉到3.3V。这个RC电路实现上电自动复位电容充电瞬间NRST为低电平等充满后再拉高芯片完成复位。原理简单但布局时电容和电阻要尽量靠近芯片减少噪声耦合。BOOT0引脚直接通过10K下拉电阻接地让芯片从Flash启动。BOOT1PB2正常使用时也接地不管它也行因为BOOT1只有在系统存储器启动模式下才有意义。这个细节很多教程不提如果你发现芯片怎么都进不了用户程序检查一下BOOT引脚状态十有八九是悬空导致电平抖动。相信大家在淘宝上买的1块钱一个的最小系统板原理也就是上面这些看着简单但自己亲手画一遍才能真正理解为什么那个1M电阻要去并上去。另外VBAT引脚如果不接外部电池直接接到3.3V上让内部备份寄存器保持供电这样RTC和备份域才能正常工作。2.2 键盘矩阵电路与二极管方向矩阵扫描的原理是行线输出高电平或者由输入模式切换列线读取状态按键按下时分某一行和某一列短接MCU通过分时驱动行线、轮询列线来判断哪个键被按下。这样14行加6列只需要20个GPIO就能覆盖84个按键极大节省引脚资源。二极管在这里的作用是防逆向导通。键盘矩阵常见的做法是每颗按键串联一枚1N4148小信号二极管方向统一从行到列排列。如果用热插拔轴座二极管一般焊在PCB正面轴座旁边丝印上有极性标记方向别搞反了。如果方向反了最典型的异常是单键按下能触发但组合键按下时会随机触发其他键或者两个键同时按会完全没有反应。还有更隐蔽的就是键盘用一段时间后某个键失灵换轴也没用最后排查发现是二极管被击穿短路了。所以布局阶段就把二极管方向标清楚焊接时也集中注意力。矩阵的引脚分配还讲究一点行线和列线尽量不要在GPIO上交叉相邻防止PCB上走线时互相干扰。我习惯把行线分配给 PA0-PA7、PB0-PB5 这类连续的IO组列线分配给PB12-PB15、PA15等方便固件里用位操作批量读取。另外还要避开一些特殊引脚PA13/PA14是SWD调试口如果你打算用ST-Link调试就别把这两个引脚分配给矩阵PA11/PA12是USB的D-/D更不能占BOOT0虽然可以复用为PB2但通常不建议动它。矩阵扫描频率不需要很高一般每秒扫几十遍就够了。由于F103跑72MHz一次扫描几个微秒加上软件消抖处理不会出现按键延迟问题。QMK固件里扫描周期是1ms远超过人手的操作速度实际体验跟任何量产键盘没有区别。2.3 USB接口电路与ESD防护键盘通过USB跟电脑通信USB接口电路是整个键盘的最关键通道。F103的PA11和PA12内部就是USB D-/D引脚外部不需要额外加PHY芯片省了很多事。USB座子我选择Type-C母座因为现在新电脑几乎全是Type-C口老电脑也能用转接头兼容性最好。Type-C母座有16个引脚实际键盘做USB 2.0设备只需要用到VBUS、GND、D、D-和CC引脚。CC引脚要用5.1K电阻下拉到地这个电阻至关重要Type-C的供电方电脑靠检测CC引脚电平来判断有没有设备插入如果没接下拉电阻或者阻值不对电脑根本不会识别出设备表现为插上去没反应、枚举不到USB设备。过往很多人USB枚举失败排查了各种电源问题最后发现就是因为CC下拉没接或者接错位置。ESD防护方面USB口是裸露在外的插拔时静电放电很容易通过线缆打到主控芯片上。建议在D和D-线上各加一颗ESD保护二极管比如ESDA6V1L、PESD5V0S1UB把它们放在USB座子附近静电能量会优先泄放到地保护后级MCU。有些便宜方案直接在D/D-上串22欧姆电阻可以抑制信号边沿反射对电磁兼容也有帮助。实测下来加了ESD防护后整机稳定性提升非常明显尤其在北方干燥季节插拔USB的时候很少再出现死机或设备掉线的问题。VBUS输入侧要放一个100uF的电解电容或者钽电容用来吸收热插拔瞬间的浪涌电流。还有这个电容放在USB座子的电源入口而不是放在LDO后面。LDO本身就具备一定的输入瞬态抑制能力但USB热插拔时的浪涌主要发生在VBUS总线侧所以输入大电容不能省。2.4 PCB布局要点电源噪声、地平面与信号完整性这是全文真正的干货也是网上很少有人认真讲的部分。STM32F103C8T6虽然主频不高但USB信号速率是12Mbps加上WS2812的PWM信号在几MHz级别PCB布局如果太随意轻则信号质量差重则设备不稳定。这里我提炼三个关键原则。第一电源走线先经过电容再进芯片。LDO输出端的4.7uF和每个VDD引脚的0.1uF去耦电容位置尽量靠近对应的VDD和GND引脚。实际布局时去耦电容和主控之间的距离不要超过3mm走线宽度不小于0.3mm。这个距离越短电容的寄生电感和等效串联电阻越小滤波效果越好。很多新手的板子功能正常但偶尔死机、按键偶尔失灵说玄学一点就是电源噪声没滤干净具体一点就是去耦电容摆位太远。第二地平面尽量完整。双面板的话第二层整层铺地把电源和信号都放在顶层。底面铺地后所有GND过孔就近连接到底层地平面。USB座的GND引脚和主控的GND焊盘之间用多个过孔并联降低接地阻抗。地平面还有个好处是给D/D-信号提供干净的参考回流路径避免环流噪声。如果实在没法铺完整地平面也要保证关键信号线USB D/D-、晶振线的下方是连续的地铜皮不要有任何缝隙。第三USB差分线要等长、短、远离干扰源。D和D-这对差分线最好走线长度差控制在5mm以内线宽保持一致线间距尽量固定最好两条线贴在一起并行走。这一点很多人忽略觉得USB也不是高速信号随便拉两条线就行。实际上如果D/D-长度差太大或者中间穿过电源噪声区USB枚举偶尔会失败而且这类问题用万用表测不出来只能靠改板子解决。还有一个细节D和D-下方不要走任何数字信号线尤其不要跟PWM灯效线平行走很长距离否则高频噪声会串进USB信号里导致整个键盘卡顿或者随机断连。至于PD协议或者快充键盘作为USB 2.0从设备完全不需要把它当作普通供电设备处理就对了。如果做的是不支持USB HOST的平板电脑可能还需要OTG线但那跟电路设计无关属于使用场景外的问题了。2.5 供电电路设计为什么默认用LDO而不是DCDC键盘电路看着简单供电方案却值得多说两句。很多人拿到5V供电第一反应是加个AMS1117降到3.3V完事但LDO和DC-DC的取舍是有讲究的。LDO的特点是电路简单、纹波极低、静态功耗低缺点是输入输出压差越大自身发热越严重。键盘这种设备电流通常在几十毫安到几百毫安之间5V降到3.3V压差1.7V如果电流200mALDO上消耗的功率就是0.34W温升可以接受完全没问题。但如果做的是带大量RGB灯珠的键盘总电流可能到1A甚至更高这时候用LDO就会发烫效率也低。这种情况下建议改用降压开关电源也就是DC-DC buck电路效率能到90%以上。代价是DC-DC外围元件多要用电感、续流二极管布局不好还会带出开关噪声反而干扰USB信号。我这次键盘加了几十颗WS2812但WS2812是通过5V直供的主控和逻辑电路仍然在3.3V下工作两者电源域分开。也就是说5V给灯珠3.3V给MCU各走各的路LDO只负责逻辑电路的供电电流不大发热问题不存在。如果你的灯珠数特别多建议在PCB布局上把灯珠供电走线做宽至少1mm以上否则灯珠全亮时压降会让最后一排灯的颜色发暗RGB色彩也会失真。如果你用淘宝上的最小系统板板上LDO可能用的是ME6211这种低压差芯片效果也不错。自研核心板时X01626或XC6206系列都是成熟选择。这里还要提一个热词里专门提到的“国产替代”问题STM32F103C8T6这颗芯片市场上有很多兼容料比如GD32F103C8T6、HK32F103C8T6、MM32F103等。从引脚定义到指令集基本兼容直接烧写STM32的固件一般也能跑。但注意个别芯片的TIM和ADC外设存在细微差异比如延时参数或者校准偏置用在这些场景需要实测。键盘这种对时序要求不高的应用替代料随便选我甚至遇到过一块和原厂芯片完全一致但价格便宜一半的批次用起来没有任何区别。买芯片的时候注意从正规渠道拿货防止买到翻新片或打磨片。3. 实操过程原理图绘制到PCB打样3.1 原理图设计工具与建库原理图工具我用的是立创EDA专业版库丰富、上手快、可以直接对接嘉立创打样而且完全免费。如果你更习惯Altium Designer或者KiCad流程也一样核心是把原理图每个焊盘对应到正确的封装。建库的时候STM32F103C8T6属于LQFP48封装一共48个引脚侧面都有引脚号丝印。键盘矩阵的二极管用SOD-323封装或者SOD-123都可以我选了SOD-323体积小不占空间适合高密度按键布局。WS2812灯珠选5050封装兼容性最好热量也好散。Type-C座的封装建议用16Pin带壳的母座立创EDA库里有现成的注意带不带PCB定位孔定位孔可以直接接GND这样外壳接地静电防护效果更好。画原理图时建议把电路拆成几个模块USB输入模块、LDO电源模块、STM32最小系统模块、矩阵接口模块、RGB灯串联模块、调试接口模块。每个模块用网络标签连接不要画成一根长线跨过整张图。这样做的好处是后续检查原理图一目了然万一哪块出问题定位速度也快。网络标签命名要有规律比如VBUS、3V3、USB_D、USB_D-、ROW0-ROW13、COL0-COL5、RGB_DIN一眼就能看出信号既连通了哪个功能块。不夸张地说规范命名能省掉一半的找Bug时间。3.2 布线实操从矩阵走线到RGB信号线原理图完成后开始画PCB这步我踩过不少坑现在把经验完整写下来。板子尺寸尽量控制在键盘外壳的容纳范围内。75%配列键盘壳体内部空间比较充足PCB尺寸大约是320mm x 100mm4层板没必要双层板足够了。布置器件时先放主控、USB座、LDO、晶振这些核心器件再放矩阵的二极管和轴座。注意USB座放在顶部边缘主控靠近USB座这样USB差分线短。晶振再靠近主控的PH0/PH1引脚优先走线短通道。矩阵走线可以直接在顶层和底层交叉走出。顶层走行线、底层走列线可以减少过孔数量。每一排矩阵的二极管和轴座在PCB Layout上建议成组布置焊接时也好找位置。另外双面板底层的矩阵布线与底面地铜皮冲突时我通常会优先保证地平面完整用小段走线替代大面积铺铜必要的地方多打过孔。RGB灯珠的数据线是串联的从主控PA8引脚出发经过第一颗灯珠的DI端进去从DO端出来进第二颗灯珠的DI依次类推。这条线对噪声有一定容忍度但依然建议尽量靠边或者走信号层不要贴着灯珠电源的5V大电流线并行走否则会出现灯珠亮度不均、闪色的问题。还有一个细节WS2812灯的供电每个电源引脚旁边也要放0.1uF去耦电容灯多了之后如果电容缺失会出现后级灯珠供电跌落整条灯带亮度由前到后递减这在RGB键盘里非常影响观感。3.3 打样下单与元器件采购清单PCB画完导出Gerber文件直接在嘉立创下单打样5片双层板价格大约在二十块钱左右几天就能收到。如果你的是单面布线也可以考虑在赤兔打样价格更便宜但个人经验是双面板交期和价格差距很小直接双面板就好。元器件采购这里列一份清单供参考STM32F103C8T6主控1片LQFP488MHz无源晶振1颗负载电容2颗20pFXC6206P332MR或ME6211 LDO 1颗电容若干10uF钽电容、4.7uF陶瓷电容、0.1uF陶瓷电容电阻若干10K复位上拉电阻、1MHz晶振反馈电阻、22Ω USB串联电阻、5.1K Type-C CC下拉电阻、10K BOOT0下拉电阻ESD防护二极管2颗Type-C母座1个1N4148二极管84颗对应按键数WS2812灯珠84颗如果做RGB版机械轴体、键帽、定位板、外壳实际采购时电阻电容优先选贴片封装0603/0805都能焊。二极管我推荐SOD-123焊接比SOD-323好操作按键密度不高时用大一点的封装没错。LDO别买太偏门的型号选立创商城库存量大的方便补料。注意电阻/电容的耐压值至少要25V开关电源的噪声尖峰叠加上去才安全。3.4 焊接顺序与检查技巧焊接是DIY过程中最容易翻车的环节。我的焊接顺序和技巧如下。先用镊子把LQFP48芯片对准PCB焊盘芯片上有一个小圆点标记表示一号脚位置PCB丝印上也有对应标记两者对齐后先固定对角的两只引脚用烙铁加锡固定。然后从一端开始用拖焊手法把一列引脚全部焊上烙铁头蘸适量焊锡沿着引脚方向缓慢拖动焊锡会自然覆盖所有引脚。拖焊完检查有没有相邻引脚的焊锡粘连如果有就加一点助焊剂用烙铁头划开拖走多余焊锡。焊完MCU后先别急着焊其他器件直接焊电源部分焊好后用万用表测量3V3对地阻抗防止发生短路。注意这时不要插USB线先裸板通电测电压。如果你用可调电源或者USB-TTL模块供电设置3.3V输入看电流是否正常。正常待机电流应该只有几毫安如果电流特别大说明有短路或者接反要立刻断电排查。我有一个习惯先用万用表二极管档测VBUS到GND的压降如果读数低于0.2V甚至接近0肯定有焊锡桥连或者元件贴错不要贸然通电。再按顺序焊晶振和复位电路然后用示波器测量OSC_OUT引脚有没有8MHz波形。没有示波器的话可以直接下载一个最小程序跑起来如果程序正常跳转说明晶振起振了。USB的D/D-焊完测量一下对地阻抗一般几百欧姆左右的阻值是正常的但不能是0或者无穷大。等所有模块焊完再通过ST-Link连接SWD接口连接Keil进行下载和调试。4. 固件烧录与配置详解4.1 STM32CubeMX配置思路与工程生成固件烧录前要先把工程搭起来。如果你打算用HAL库自己写推荐直接用STM32CubeMX生成初始化代码。打开CubeMX芯片选择STM32F103C8Tx然后按下面配置。时钟树部分HSE选择外部晶振LSE可跳过PLL倍频后系统时钟设为72MHz。USB外设打开选择Device (FS)模式这样USB作为一个全速设备工作。如果用了WS2812把PA8配置为TIM1_CH1复用功能然后在定时器设置里开启PWM和DMA请求。注意DMA通道选择要与定时器事件对应F103的TIM1是高级定时器DMA请求映射到ADC1_CH0等通道细节查阅参考手册新手最容易在这里卡住。GPIO配置上矩阵行线设置为推挽输出列线设置为浮空输入或者反过来根据需要配置。如果某一行线和列线复用了还没用到的功能引脚在CubeMX里要把它从非复用状态改过来比如禁用JTAG保留PB3/PB4两个引脚作为普通GPIO否则矩阵扫描会少两根线导致某些按键完全没响应。这是F103系列特有的问题PA15、PB3、PB4默认被JTAG占用需要把调试接口改为SWD模式或者完全关闭调试口。工程生成时选择Toolchain为MDK-ARM然后直接用Keil打开。修改按键扫描逻辑、USB上报逻辑就可以烧录验证了。4.2 自己写固件还是用QMK这是很多新手纠结的问题。QMK固件的优势是生态成熟支持大量配列定义、多层按键映射、宏录制、RGB灯效控制改个键位像改配置文件一样方便。缺点是需要熟悉它的目录结构和编译流程并且官方的STM32F103支持是通过ChibiOS实现的配置起来比AVR稍显复杂。社区分支里像STM32F103_QMK和qmk_firmware里非官方支持的板型可以找一些bootloader和键盘模板参考。实际上常见做法是把F103C8T6当做一个自定义键盘在QMK的keyboards/目录下新建一个文件夹写好config.h、keymap.c、rules.mk配置矩阵引脚、二极管方向、按键行列数然后编译生成hex或bin文件。QMK对COL2ROW、ROW2COL的配置非常清晰定义好之后就能直接烧录。如果你只是想要一把能打字、能切换层、带简单RGB灯效的键盘QMK完全够用不建议自己造轮子。但如果你对轮询机制、USB HID描述符、矩阵扫描原理感兴趣或者想实现QMK不支持的定制功能自己写固件也是个相当值得做的练习。我自己是先写了HAL库版本认识了STM32的USB寄存器后来为了灯效和宏定义方便又切回QMK。两个方向各有取舍关键是搞清楚你的目标。4.3 Bootloader与DFU烧录流程固件编译好之后烧录方式和最终使用的烧录器有关系。如果直接用ST-LinkKeil里所见即所得点一下Download就完事但这只适用于开发阶段。键盘做完了用户不可能拿着ST-Link到处跑所以量产或日常使用需要进入DFU模式通过USB口烧录固件。很多QMK板子出厂会预烧一个bootloader比如stm32duino bootloader。有了bootloader之后按一下键盘上的特定按键组合或者短接某个触点芯片进入DFU模式电脑上会出现一个DFU设备然后用QMK Toolbox或者dfu-util把固件烧进去。需要特别注意的是STM32F103C8T6的Bootloader留出的Flash空间一般是从0x08000000开始的16KB区域内固件烧录的起始地址要偏移到0x08004000否则会直接覆盖掉Bootloader下次再想进DFU模式就没戏了。这个坑我踩过一次用ST-Link全片擦除并写了Flash结果Bootloader也没了只能再拿ST-Link重新烧一遍Bootloader折腾了半天。如果你不走QMK用自制固件也可以直接用ST-Link烧录只是每次升级要拆开键盘接SWD线确实麻烦。所以正式成品最好还是加个bootloader。STM32官方也有对应的USB DFU bootloader可以从ST官网下载预编译文件烧录到0x08000000起始地址。这样哪怕不按任何组合键芯片在无应用程序时也会自动进入DFU模式非常方便。4.4 固件烧录后的USB枚举验证固件烧录完成后插上USB线电脑应该会识别到一个HID键盘设备。如果识别不到按下面顺序排查。先看USB口电压是否正常。VBUS应该有5V3V3电源引脚有3.3V。如果电压正常再看D/D-的波形。全速USB设备在传输时D线上会有一个1.5K上拉电阻让主机知道这是一台全速设备。F103芯片内部这个上拉是由USB外设控制的如果你软件没正确配置USB外设上拉不使能电脑就不会识别。QMK固件或HAL库生成的工程一般都会自动处理但自制固件极容易漏掉这一步。如果枚举正常可以用dmesgLinux或者设备管理器Windows看到键盘设备键入测试如果能正常输出字符基本说明硬件和固件都没问题。这里还要提一个玄学问题如果你把键盘插到USB 3.0接口上指示灯亮但电脑不识别换一个USB 2.0口又能正常。这类问题通常是USB信号质量不够好。最简单粗暴的解决办法是D/D-走线上的串联电阻调到27Ω或者33Ω稍微增加一点阻抗匹配信号边沿变缓反而提升兼容性。这个技巧在我调试SPI到USB转接板时同样适用。5. 常见问题与排查技巧实录5.1 上电无反应、电流异常大上电后如果无任何反应先不要急着怀疑芯片烧了大概率是电源问题。用万用表逐点测量3V3对地电压VBUS电压LDO的输出电压。如果LDO输出电压为0排查输入是否有5V GND是否连通LDO有没有焊反或者虚焊。XC6206这类LDO的引脚顺序跟普通三极管类似常见是第1脚GND、第2脚VIN、第3脚VOUT焊接前一定要看数据手册光靠丝印容易被坑。如果电压正常但电流异常大超过100mA大概率存在短路或芯片损坏。可以从电源引脚断开测量各个模块的电流用“分割排查法”逐块排查。还有个低级错误USB座子的外壳焊盘和GND焊盘弄反或者Type-C座焊接时里面的针脚歪斜导致相邻引脚短路。用放大镜或者手机微距镜头仔细检查多花两分钟能省掉一整晚的排查时间。5.2 USB不识别 或 识别后频繁掉线USB不识别要分情况。如果插上去电脑毫无反应设备管理器里没有新设备出现优先检查D/D-是否接反。D和D-接反是最低级也是最常见的错误万用表测不到示波器看才能发现。如果线序没问题再检查CC引脚的下拉电阻Type-C座子必须有5.1K下拉到地。这个电阻如果焊错或者漏焊电脑端永远不会认为有设备插入。如果识别后频繁掉线重点查电源纹波和USB信号质量。使用示波器观察D/D-数据线波形正常情况下传输时信号边沿干净如果看起来方波变成圆波或者出现毛刺说明地回路噪声大或者差分线过长。尝试在VBUS和GND之间并联一个100uF电容效果经常立竿见影。如果问题依旧检查USB线本身劣质USB线内部只有电源线而数据线接触不良也会表现为掉线闪断排除这种可能性后再去改板子。5.3 矩阵扫描异常串键、鬼键、无响应矩阵问题多数集中在硬件或固件配置上。串键按了一个键另外某个键也触发很可能是矩阵二极管方向不一致。检查每颗二极管的丝印方向是否统一尤其焊接时如果有几颗贴反了电流倒灌就会导致串键。鬼键按三个键时报出第四个键通常是矩阵扫描逻辑里行线和列线的输入输出模式没有正确切换。QMK里COL2ROW和ROW2COL配置颠倒也是常见原因把它对调一下就能解决。某一行或某一列完全无响应通常是行线或列线断线。用万用表二极管档测从MCU引脚到这一行第一个按键焊盘的走线通断。如果通断没问题也可能是引脚配置成了默认复用功能比如PB3/PB4被JTAG占用、PB2被BOOT1占用这些引脚如果不强制改寄存器配置会被外设占用导致扫描不到。CubeMX工程的用户代码里加一行__HAL_AFIO_REMAP_SWJ_DISABLE();就能解决。这些排查手段都在网上反复出现过但真到自己的板子上很多人第一反应还是怀疑MCU坏了实际上MCU没那么脆弱按部就班排查才有效。5.4 WS2812灯珠颜色不对、闪烁、灯带前半段亮后半段暗WS2812的问题主要是供电和数据线质量。先检查5V供电的走线宽度和电源电容。如果整条灯带前半段亮后半段暗说明供电走线在灯带中段压降太大。把5V供电在灯带末端和首端同时接入双端供电或者加粗供电走线到1.5mm以上亮度就均匀了。如果某颗灯珠颜色变红变暗大概率是该灯珠供电不足或数据信号衰减。数据线串联时建议在每隔32颗灯位置加一个74HC245缓冲器或者简单就是加几百欧姆的串联电阻提高信号驱动能力。闪烁或者颜色随机变化一般是数据信号被干扰。检查PWMDMA配置是否正确定时器的更新事件有没有正确触发DMA搬运也要检查WS2812的数据线是不是太靠近电源大电流走线。在数据线上串联一个220Ω到470Ω的电阻既能减小信号反射也能降低对GPIO驱动能力的压力是业内很常用的小技巧。还有一个轻型方案在每颗灯珠的VDD和GND之间加0.1uF电容能有效抑制电源毛刺导致的数据判断错误这个在量产键盘方案里几乎是标配。5.5 按键双击、断触等手感问题硬件电路和固件看起来都没问题了但手感上出现双击或断触。这种情况要换思路不是板子的问题是轴体或热插拔座的问题。先用万用表短接轴座的焊盘两端看系统是否触发正常按键。如果短接没问题换一颗新轴体试试。有货期的小批轴体尤其是低价入门轴针脚氧化或者弹片疲劳频繁会导致触点抖动增加表现为偶尔双击或者无响应。也可以通过固件里的debounce时间调整解决比如QMK的DEBOUNCE值从默认5改成10手感会稳一些。但别调得太大会让按键反应变肉。6. 实际使用体验与扩展方向6.1 成品表现与稳定性整把键盘装好之后我目前使用了大约三周期间一直插在Type-C口上没有掉过设备按键响应速度和灯效流畅度都令我满意。用HID测试工具看扫描回报率稳定在1000Hz左右这数据远超绝大多数量产键盘普遍是125Hz到250Hz。STM32F103C8T6的USB全速接口配合精简的扫描循环回报率高一点并不意外但实际体验确实能感觉到按键跟手尤其在高速打字和游戏场景中非常跟手。72MHz的F103做键盘确实是大炮打蚊子级别的性能冗余。没开RGB灯时CPU占用几乎为0。开满灯效WS2812的DMA搬运完全不占内核系统还是从容得很。整个项目从硬件到固件综合下来稳定性、手感、性能三大块都让我满意完全可以作为日常主力键盘使用。6.2 项目后续扩展小屏幕、无线化与宏键盘做完一把键盘手头的电路和固件基础完全可以继续扩展。如果你想加一块0.96寸OLED小屏幕F103还剩余I2C外设和几个GPIO用SSD1306驱动显示键盘状态、电量或者当前层都是现成方案。QMK里也支持OLED插件基本拿来就能用。如果对按键宏感兴趣可以在键盘上定义一个宏触发层配合QMK的process_record_user回调函数一键发送一串组合命令对游戏玩家或设计师来说非常实用。如果是想要无线方案需要把主控换成带蓝牙的低功耗芯片比如nRF52840、ESP32-C3或者给F103加一块HC-05蓝牙串口模块。但注意F103本身没有BLE控制器加模块只是把键盘当成串口设备通过蓝牙透传需要配合电脑端软件转换成键鼠协议体验打折扣。真想做无线键盘建议直接原生BLE方案比如nRF52840或者带BLE功能的STM32WB系列。F103这把键盘就老老实实当有线主力无线场景另外开一个坑。6.3 对入门者的建议与个人体会最后聊聊对这整个项目的复盘。如果你从没画过PCB也没写过STM32代码直接上手做键盘确实有门槛。我建议把项目拆成两个阶段第一个阶段用现成的最小系统板和面包板搭矩阵通过跳线验证固件逻辑这个阶段不需要任何PCB知识而且能让你快速感受到键盘 DIY 的乐趣。第二个阶段再自研核心板把最小系统、电源、矩阵、USB整体画到一张板子上让电路布局更熟练后再考虑灯光和无线等复杂功能。我在实际项目中最深的一个体会是设计环节多花的时间会在调试环节十倍找回来。比如原理图网络标签命名规范、PCB布局时地平面完整、晶振位置离主控足够近、矩阵引脚分配刻意避开JTAG等特殊引脚这些决策做好之后后面几乎不会再回头改板子。而偷懒省掉这些步骤往往后面就是无穷无尽地排查。做键盘这件事表面上是一次硬件DIY实际上把STM32的最小系统设计、USB协议、矩阵扫描算法、bootloader烧录、PCB布局规范全给串起来了。一把键盘做完单片机功底和硬件调试能力都会有一个非常大的提升。如果你正准备动手做第一个STM32项目键盘是真不错的选择——实用、好看、技术含量全做出来能放桌上天天用成就感拉满。
STM32F103C8T6 DIY机械键盘全流程：电路设计、PCB布局到固件烧录
最近我用STM32F103C8T6做了一把完整的DIY机械键盘从画原理图、设计PCB、等打样、手工焊接再到编译固件、烧录调试前后折腾了两周。把这个过程完整整理出来希望能帮想动手做键盘的朋友一次成功。STM32F103C8T6这块芯片在键盘DIY圈子里不算新鲜但网上资料分散要么只讲固件要么只给电路很少有人把从零到一的全流程串起来讲。这篇文章就用一个真实项目为主线把电路设计、PCB布局、固件烧录、常见坑全部讲透。适合有基础单片机知识、想从零做一把客制化键盘的嵌入式爱好者也适合学生做课程设计时参考内容足够具体照着做基本能复现。1. 项目整体设计与方案选型思路1.1 为什么选STM32F103C8T6而不是传统键盘主控很多人一听DIY键盘第一反应是用Pro MicroATmega32U4、RP2040或者nRF52840因为QMK官方支持列表里这些芯片非常成熟。我前期也纠结过这个问题最后选了STM32F103C8T6理由很实际。首先是成本。STM32F103C8T6最小系统板在电商平台的价格常年稳定在几块钱到十几块钱区间比Pro Micro的几十块便宜不少。即便你想自己画板子、只买芯片这颗料单价也不高而且货源非常充足市面上有大量兼容芯片可以平替买的时候稍微留意下丝印和批次就行。对于做一把键盘来说用最小系统板改装的方案甚至不需要专门打PCB直接飞线都能跑起来上手门槛比想象中低很多。其次是性能冗余。F103C8T6主频72MHzFlash 64KBRAM 20KB。键盘扫描和USB HID上报这点负载对这颗芯片来说绰绰有余。最典型的就是用PA8引脚输出PWM驱动WS2812灯珠配合DMA传输跑灯效的时候几乎不占用CPU。这在传统AVR主控上是一种奢侈在F103上却是日常工作。再一个是生态。STM32的开发资料铺天盖地CubeMX图形化配置工具对新手极度友好HAL库也比寄存器操作容易上手。QMK虽然官方没有直接支持F103C8T6但社区里有很成熟的移植分支后面固件部分我会详细说。如果你不想用QMK自己写矩阵扫描和USB上报也不是难事STM32的USB外设库经过多年沉淀坑基本都被踩平了。1.2 整体方案架构最小系统板方案与自制核心板方案做键盘之前需要先想清楚硬件走哪条路线。我见过三种主流做法各有优劣。第一种是直接用现成的STM32F103C8T6最小系统板把板子背面贴到键盘PCB上或者干脆放在壳子里用杜邦线连接到矩阵。这种方案胜在省事不用考虑USB座子、LDO、晶振这些外围电路插上Type-C线就能用。缺点也很明显高度不可控占空间而且最低系统板上的AMS1117静态功耗大如果是无线方案就不太合适。纯有线键盘、桌面放着不动这种场景第一方案完全OK。第二种是自研核心板把F103最小系统、USB接口、矩阵接口都画在同一块PCB上。这样键盘内部非常整洁整机厚度可以压得很低还能在板子上集成RGB灯、蜂鸣器、旋转编码器等外设。缺点是需要自己设计电源、时钟、复位电路对PCB布局有一定要求。我这次做的键盘最终选的就是这条路线因为想要一个干净利落的成品而且把最小系统电路亲手画一遍对芯片的理解会深很多。第三种是折中路线在键盘PCB上预留一个邮票孔或者排针模块位把最小系统板插上去。相当于你自己画了矩阵底板但核心板还是现成的。这个方案适合第一版打样验证如果板子有Bug核心板还能拆下来复用损失最小。如果你完全没画过板子我建议先走第三种等验证了矩阵扫描、固件逻辑都OK之后第二版再集成核心电路。我认识不少朋友第一版就直接上集成方案结果USB识别不了排查半天发现是LDO虚焊或者晶振没起振调试难度直接翻倍。计划好迭代节奏能省掉大量无意义的折腾。1.3 功能需求梳理键位数、灯效与后续扩展任何项目动手前都要把需求写清楚键盘也一样。做多少键需不需要独立方向键要不要RGB灯要不要多媒体旋钮这些决策直接影响矩阵设计和芯片引脚分配。以我这次做的84键75%配列键盘为例矩阵是14行x6列总共84个开关。这里要特别强调一点矩阵扫描本身只用按键引脚但每个键还涉及二极管方向。矩阵设计时行线和列线会分别接按键的两端二极管要插在行方向上防止鬼键——鬼键就是多键同时按下时出现错误触发的现象。没有二极管的矩阵三键同按就会产生电流倒灌输出的组合完全错误。哪怕用现成的轴体热插拔PCB也要先确认二极管极性方向。灯效方面我计划每键一颗WS2812这意味着不仅矩阵需要引脚灯带数据线还要单独占用一个引脚。我选了PA8配合定时器PWM DMA方式驱动这也是热词里提到的典型玩法。如果你不做灯可以省掉这一路但引脚规划时建议预留谁知道过几天想不想加呢。扩展方面还预留了旋转编码器接口后续想调音量旋钮只需要在固件里加几行代码。一个IO就能实现非常划算。所以最终的引脚分配表里除了矩阵的20个引脚还要空出PA8、PB5等几个自定义引脚别把芯片所有IO都塞进固定功能里。2. 电路设计的核心细节与PCB布局要点2.1 最小系统电路设计电源、晶振、复位、BOOT既然决定自研核心板最小系统电路是第一个要攻克的关卡。STM32F103C8T6的最小系统不算复杂但每个部分都有讲究。电源部分F103的VDD范围是2.0V到3.6V典型值是3.3V。USB供电进来是5V所以要加一级LDO把电压降到3.3V。我选用的是XC6206P332MR功耗低、静态电流只有1uA左右非常适合键盘这种长期插着USB但又经常处于待机状态的设备。AMS1117不是不能用但它的静态电流高达5mA做在键盘上有点浪费。LDO输入侧放一个10uF钽电容和0.1uF陶瓷电容并联输出侧放一个4.7uF陶瓷电容这种组合在负载突变时能有效抑制纹波。另外每个VDD引脚旁边都要就近放一个0.1uF去耦电容这是PCB布局最基本的规矩别图省事跳过去。晶振电路F103的HSE引脚接8MHz无源晶振两个负载电容取20pF并联一个1M欧的反馈电阻。注意晶振下面不要走任何信号线晶振的两根走线尽量短且远离高速信号。这个点我在PCB布局部分会再展开。因为F103内部有PLL外部8MHz经过倍频后可以稳定跑到72MHz系统时钟。这里有个容易踩的坑如果用ST-Link烧录仿真器提供的是SWD接口跟外部晶振没直接关系但如果你的板子没焊接晶振或者晶振没起振Keil下载后程序一跑就死串口打印乱码都是这类问题。复位电路NRST引脚接一个0.1uF电容到GND再通过10K电阻上拉到3.3V。这个RC电路实现上电自动复位电容充电瞬间NRST为低电平等充满后再拉高芯片完成复位。原理简单但布局时电容和电阻要尽量靠近芯片减少噪声耦合。BOOT0引脚直接通过10K下拉电阻接地让芯片从Flash启动。BOOT1PB2正常使用时也接地不管它也行因为BOOT1只有在系统存储器启动模式下才有意义。这个细节很多教程不提如果你发现芯片怎么都进不了用户程序检查一下BOOT引脚状态十有八九是悬空导致电平抖动。相信大家在淘宝上买的1块钱一个的最小系统板原理也就是上面这些看着简单但自己亲手画一遍才能真正理解为什么那个1M电阻要去并上去。另外VBAT引脚如果不接外部电池直接接到3.3V上让内部备份寄存器保持供电这样RTC和备份域才能正常工作。2.2 键盘矩阵电路与二极管方向矩阵扫描的原理是行线输出高电平或者由输入模式切换列线读取状态按键按下时分某一行和某一列短接MCU通过分时驱动行线、轮询列线来判断哪个键被按下。这样14行加6列只需要20个GPIO就能覆盖84个按键极大节省引脚资源。二极管在这里的作用是防逆向导通。键盘矩阵常见的做法是每颗按键串联一枚1N4148小信号二极管方向统一从行到列排列。如果用热插拔轴座二极管一般焊在PCB正面轴座旁边丝印上有极性标记方向别搞反了。如果方向反了最典型的异常是单键按下能触发但组合键按下时会随机触发其他键或者两个键同时按会完全没有反应。还有更隐蔽的就是键盘用一段时间后某个键失灵换轴也没用最后排查发现是二极管被击穿短路了。所以布局阶段就把二极管方向标清楚焊接时也集中注意力。矩阵的引脚分配还讲究一点行线和列线尽量不要在GPIO上交叉相邻防止PCB上走线时互相干扰。我习惯把行线分配给 PA0-PA7、PB0-PB5 这类连续的IO组列线分配给PB12-PB15、PA15等方便固件里用位操作批量读取。另外还要避开一些特殊引脚PA13/PA14是SWD调试口如果你打算用ST-Link调试就别把这两个引脚分配给矩阵PA11/PA12是USB的D-/D更不能占BOOT0虽然可以复用为PB2但通常不建议动它。矩阵扫描频率不需要很高一般每秒扫几十遍就够了。由于F103跑72MHz一次扫描几个微秒加上软件消抖处理不会出现按键延迟问题。QMK固件里扫描周期是1ms远超过人手的操作速度实际体验跟任何量产键盘没有区别。2.3 USB接口电路与ESD防护键盘通过USB跟电脑通信USB接口电路是整个键盘的最关键通道。F103的PA11和PA12内部就是USB D-/D引脚外部不需要额外加PHY芯片省了很多事。USB座子我选择Type-C母座因为现在新电脑几乎全是Type-C口老电脑也能用转接头兼容性最好。Type-C母座有16个引脚实际键盘做USB 2.0设备只需要用到VBUS、GND、D、D-和CC引脚。CC引脚要用5.1K电阻下拉到地这个电阻至关重要Type-C的供电方电脑靠检测CC引脚电平来判断有没有设备插入如果没接下拉电阻或者阻值不对电脑根本不会识别出设备表现为插上去没反应、枚举不到USB设备。过往很多人USB枚举失败排查了各种电源问题最后发现就是因为CC下拉没接或者接错位置。ESD防护方面USB口是裸露在外的插拔时静电放电很容易通过线缆打到主控芯片上。建议在D和D-线上各加一颗ESD保护二极管比如ESDA6V1L、PESD5V0S1UB把它们放在USB座子附近静电能量会优先泄放到地保护后级MCU。有些便宜方案直接在D/D-上串22欧姆电阻可以抑制信号边沿反射对电磁兼容也有帮助。实测下来加了ESD防护后整机稳定性提升非常明显尤其在北方干燥季节插拔USB的时候很少再出现死机或设备掉线的问题。VBUS输入侧要放一个100uF的电解电容或者钽电容用来吸收热插拔瞬间的浪涌电流。还有这个电容放在USB座子的电源入口而不是放在LDO后面。LDO本身就具备一定的输入瞬态抑制能力但USB热插拔时的浪涌主要发生在VBUS总线侧所以输入大电容不能省。2.4 PCB布局要点电源噪声、地平面与信号完整性这是全文真正的干货也是网上很少有人认真讲的部分。STM32F103C8T6虽然主频不高但USB信号速率是12Mbps加上WS2812的PWM信号在几MHz级别PCB布局如果太随意轻则信号质量差重则设备不稳定。这里我提炼三个关键原则。第一电源走线先经过电容再进芯片。LDO输出端的4.7uF和每个VDD引脚的0.1uF去耦电容位置尽量靠近对应的VDD和GND引脚。实际布局时去耦电容和主控之间的距离不要超过3mm走线宽度不小于0.3mm。这个距离越短电容的寄生电感和等效串联电阻越小滤波效果越好。很多新手的板子功能正常但偶尔死机、按键偶尔失灵说玄学一点就是电源噪声没滤干净具体一点就是去耦电容摆位太远。第二地平面尽量完整。双面板的话第二层整层铺地把电源和信号都放在顶层。底面铺地后所有GND过孔就近连接到底层地平面。USB座的GND引脚和主控的GND焊盘之间用多个过孔并联降低接地阻抗。地平面还有个好处是给D/D-信号提供干净的参考回流路径避免环流噪声。如果实在没法铺完整地平面也要保证关键信号线USB D/D-、晶振线的下方是连续的地铜皮不要有任何缝隙。第三USB差分线要等长、短、远离干扰源。D和D-这对差分线最好走线长度差控制在5mm以内线宽保持一致线间距尽量固定最好两条线贴在一起并行走。这一点很多人忽略觉得USB也不是高速信号随便拉两条线就行。实际上如果D/D-长度差太大或者中间穿过电源噪声区USB枚举偶尔会失败而且这类问题用万用表测不出来只能靠改板子解决。还有一个细节D和D-下方不要走任何数字信号线尤其不要跟PWM灯效线平行走很长距离否则高频噪声会串进USB信号里导致整个键盘卡顿或者随机断连。至于PD协议或者快充键盘作为USB 2.0从设备完全不需要把它当作普通供电设备处理就对了。如果做的是不支持USB HOST的平板电脑可能还需要OTG线但那跟电路设计无关属于使用场景外的问题了。2.5 供电电路设计为什么默认用LDO而不是DCDC键盘电路看着简单供电方案却值得多说两句。很多人拿到5V供电第一反应是加个AMS1117降到3.3V完事但LDO和DC-DC的取舍是有讲究的。LDO的特点是电路简单、纹波极低、静态功耗低缺点是输入输出压差越大自身发热越严重。键盘这种设备电流通常在几十毫安到几百毫安之间5V降到3.3V压差1.7V如果电流200mALDO上消耗的功率就是0.34W温升可以接受完全没问题。但如果做的是带大量RGB灯珠的键盘总电流可能到1A甚至更高这时候用LDO就会发烫效率也低。这种情况下建议改用降压开关电源也就是DC-DC buck电路效率能到90%以上。代价是DC-DC外围元件多要用电感、续流二极管布局不好还会带出开关噪声反而干扰USB信号。我这次键盘加了几十颗WS2812但WS2812是通过5V直供的主控和逻辑电路仍然在3.3V下工作两者电源域分开。也就是说5V给灯珠3.3V给MCU各走各的路LDO只负责逻辑电路的供电电流不大发热问题不存在。如果你的灯珠数特别多建议在PCB布局上把灯珠供电走线做宽至少1mm以上否则灯珠全亮时压降会让最后一排灯的颜色发暗RGB色彩也会失真。如果你用淘宝上的最小系统板板上LDO可能用的是ME6211这种低压差芯片效果也不错。自研核心板时X01626或XC6206系列都是成熟选择。这里还要提一个热词里专门提到的“国产替代”问题STM32F103C8T6这颗芯片市场上有很多兼容料比如GD32F103C8T6、HK32F103C8T6、MM32F103等。从引脚定义到指令集基本兼容直接烧写STM32的固件一般也能跑。但注意个别芯片的TIM和ADC外设存在细微差异比如延时参数或者校准偏置用在这些场景需要实测。键盘这种对时序要求不高的应用替代料随便选我甚至遇到过一块和原厂芯片完全一致但价格便宜一半的批次用起来没有任何区别。买芯片的时候注意从正规渠道拿货防止买到翻新片或打磨片。3. 实操过程原理图绘制到PCB打样3.1 原理图设计工具与建库原理图工具我用的是立创EDA专业版库丰富、上手快、可以直接对接嘉立创打样而且完全免费。如果你更习惯Altium Designer或者KiCad流程也一样核心是把原理图每个焊盘对应到正确的封装。建库的时候STM32F103C8T6属于LQFP48封装一共48个引脚侧面都有引脚号丝印。键盘矩阵的二极管用SOD-323封装或者SOD-123都可以我选了SOD-323体积小不占空间适合高密度按键布局。WS2812灯珠选5050封装兼容性最好热量也好散。Type-C座的封装建议用16Pin带壳的母座立创EDA库里有现成的注意带不带PCB定位孔定位孔可以直接接GND这样外壳接地静电防护效果更好。画原理图时建议把电路拆成几个模块USB输入模块、LDO电源模块、STM32最小系统模块、矩阵接口模块、RGB灯串联模块、调试接口模块。每个模块用网络标签连接不要画成一根长线跨过整张图。这样做的好处是后续检查原理图一目了然万一哪块出问题定位速度也快。网络标签命名要有规律比如VBUS、3V3、USB_D、USB_D-、ROW0-ROW13、COL0-COL5、RGB_DIN一眼就能看出信号既连通了哪个功能块。不夸张地说规范命名能省掉一半的找Bug时间。3.2 布线实操从矩阵走线到RGB信号线原理图完成后开始画PCB这步我踩过不少坑现在把经验完整写下来。板子尺寸尽量控制在键盘外壳的容纳范围内。75%配列键盘壳体内部空间比较充足PCB尺寸大约是320mm x 100mm4层板没必要双层板足够了。布置器件时先放主控、USB座、LDO、晶振这些核心器件再放矩阵的二极管和轴座。注意USB座放在顶部边缘主控靠近USB座这样USB差分线短。晶振再靠近主控的PH0/PH1引脚优先走线短通道。矩阵走线可以直接在顶层和底层交叉走出。顶层走行线、底层走列线可以减少过孔数量。每一排矩阵的二极管和轴座在PCB Layout上建议成组布置焊接时也好找位置。另外双面板底层的矩阵布线与底面地铜皮冲突时我通常会优先保证地平面完整用小段走线替代大面积铺铜必要的地方多打过孔。RGB灯珠的数据线是串联的从主控PA8引脚出发经过第一颗灯珠的DI端进去从DO端出来进第二颗灯珠的DI依次类推。这条线对噪声有一定容忍度但依然建议尽量靠边或者走信号层不要贴着灯珠电源的5V大电流线并行走否则会出现灯珠亮度不均、闪色的问题。还有一个细节WS2812灯的供电每个电源引脚旁边也要放0.1uF去耦电容灯多了之后如果电容缺失会出现后级灯珠供电跌落整条灯带亮度由前到后递减这在RGB键盘里非常影响观感。3.3 打样下单与元器件采购清单PCB画完导出Gerber文件直接在嘉立创下单打样5片双层板价格大约在二十块钱左右几天就能收到。如果你的是单面布线也可以考虑在赤兔打样价格更便宜但个人经验是双面板交期和价格差距很小直接双面板就好。元器件采购这里列一份清单供参考STM32F103C8T6主控1片LQFP488MHz无源晶振1颗负载电容2颗20pFXC6206P332MR或ME6211 LDO 1颗电容若干10uF钽电容、4.7uF陶瓷电容、0.1uF陶瓷电容电阻若干10K复位上拉电阻、1MHz晶振反馈电阻、22Ω USB串联电阻、5.1K Type-C CC下拉电阻、10K BOOT0下拉电阻ESD防护二极管2颗Type-C母座1个1N4148二极管84颗对应按键数WS2812灯珠84颗如果做RGB版机械轴体、键帽、定位板、外壳实际采购时电阻电容优先选贴片封装0603/0805都能焊。二极管我推荐SOD-123焊接比SOD-323好操作按键密度不高时用大一点的封装没错。LDO别买太偏门的型号选立创商城库存量大的方便补料。注意电阻/电容的耐压值至少要25V开关电源的噪声尖峰叠加上去才安全。3.4 焊接顺序与检查技巧焊接是DIY过程中最容易翻车的环节。我的焊接顺序和技巧如下。先用镊子把LQFP48芯片对准PCB焊盘芯片上有一个小圆点标记表示一号脚位置PCB丝印上也有对应标记两者对齐后先固定对角的两只引脚用烙铁加锡固定。然后从一端开始用拖焊手法把一列引脚全部焊上烙铁头蘸适量焊锡沿着引脚方向缓慢拖动焊锡会自然覆盖所有引脚。拖焊完检查有没有相邻引脚的焊锡粘连如果有就加一点助焊剂用烙铁头划开拖走多余焊锡。焊完MCU后先别急着焊其他器件直接焊电源部分焊好后用万用表测量3V3对地阻抗防止发生短路。注意这时不要插USB线先裸板通电测电压。如果你用可调电源或者USB-TTL模块供电设置3.3V输入看电流是否正常。正常待机电流应该只有几毫安如果电流特别大说明有短路或者接反要立刻断电排查。我有一个习惯先用万用表二极管档测VBUS到GND的压降如果读数低于0.2V甚至接近0肯定有焊锡桥连或者元件贴错不要贸然通电。再按顺序焊晶振和复位电路然后用示波器测量OSC_OUT引脚有没有8MHz波形。没有示波器的话可以直接下载一个最小程序跑起来如果程序正常跳转说明晶振起振了。USB的D/D-焊完测量一下对地阻抗一般几百欧姆左右的阻值是正常的但不能是0或者无穷大。等所有模块焊完再通过ST-Link连接SWD接口连接Keil进行下载和调试。4. 固件烧录与配置详解4.1 STM32CubeMX配置思路与工程生成固件烧录前要先把工程搭起来。如果你打算用HAL库自己写推荐直接用STM32CubeMX生成初始化代码。打开CubeMX芯片选择STM32F103C8Tx然后按下面配置。时钟树部分HSE选择外部晶振LSE可跳过PLL倍频后系统时钟设为72MHz。USB外设打开选择Device (FS)模式这样USB作为一个全速设备工作。如果用了WS2812把PA8配置为TIM1_CH1复用功能然后在定时器设置里开启PWM和DMA请求。注意DMA通道选择要与定时器事件对应F103的TIM1是高级定时器DMA请求映射到ADC1_CH0等通道细节查阅参考手册新手最容易在这里卡住。GPIO配置上矩阵行线设置为推挽输出列线设置为浮空输入或者反过来根据需要配置。如果某一行线和列线复用了还没用到的功能引脚在CubeMX里要把它从非复用状态改过来比如禁用JTAG保留PB3/PB4两个引脚作为普通GPIO否则矩阵扫描会少两根线导致某些按键完全没响应。这是F103系列特有的问题PA15、PB3、PB4默认被JTAG占用需要把调试接口改为SWD模式或者完全关闭调试口。工程生成时选择Toolchain为MDK-ARM然后直接用Keil打开。修改按键扫描逻辑、USB上报逻辑就可以烧录验证了。4.2 自己写固件还是用QMK这是很多新手纠结的问题。QMK固件的优势是生态成熟支持大量配列定义、多层按键映射、宏录制、RGB灯效控制改个键位像改配置文件一样方便。缺点是需要熟悉它的目录结构和编译流程并且官方的STM32F103支持是通过ChibiOS实现的配置起来比AVR稍显复杂。社区分支里像STM32F103_QMK和qmk_firmware里非官方支持的板型可以找一些bootloader和键盘模板参考。实际上常见做法是把F103C8T6当做一个自定义键盘在QMK的keyboards/目录下新建一个文件夹写好config.h、keymap.c、rules.mk配置矩阵引脚、二极管方向、按键行列数然后编译生成hex或bin文件。QMK对COL2ROW、ROW2COL的配置非常清晰定义好之后就能直接烧录。如果你只是想要一把能打字、能切换层、带简单RGB灯效的键盘QMK完全够用不建议自己造轮子。但如果你对轮询机制、USB HID描述符、矩阵扫描原理感兴趣或者想实现QMK不支持的定制功能自己写固件也是个相当值得做的练习。我自己是先写了HAL库版本认识了STM32的USB寄存器后来为了灯效和宏定义方便又切回QMK。两个方向各有取舍关键是搞清楚你的目标。4.3 Bootloader与DFU烧录流程固件编译好之后烧录方式和最终使用的烧录器有关系。如果直接用ST-LinkKeil里所见即所得点一下Download就完事但这只适用于开发阶段。键盘做完了用户不可能拿着ST-Link到处跑所以量产或日常使用需要进入DFU模式通过USB口烧录固件。很多QMK板子出厂会预烧一个bootloader比如stm32duino bootloader。有了bootloader之后按一下键盘上的特定按键组合或者短接某个触点芯片进入DFU模式电脑上会出现一个DFU设备然后用QMK Toolbox或者dfu-util把固件烧进去。需要特别注意的是STM32F103C8T6的Bootloader留出的Flash空间一般是从0x08000000开始的16KB区域内固件烧录的起始地址要偏移到0x08004000否则会直接覆盖掉Bootloader下次再想进DFU模式就没戏了。这个坑我踩过一次用ST-Link全片擦除并写了Flash结果Bootloader也没了只能再拿ST-Link重新烧一遍Bootloader折腾了半天。如果你不走QMK用自制固件也可以直接用ST-Link烧录只是每次升级要拆开键盘接SWD线确实麻烦。所以正式成品最好还是加个bootloader。STM32官方也有对应的USB DFU bootloader可以从ST官网下载预编译文件烧录到0x08000000起始地址。这样哪怕不按任何组合键芯片在无应用程序时也会自动进入DFU模式非常方便。4.4 固件烧录后的USB枚举验证固件烧录完成后插上USB线电脑应该会识别到一个HID键盘设备。如果识别不到按下面顺序排查。先看USB口电压是否正常。VBUS应该有5V3V3电源引脚有3.3V。如果电压正常再看D/D-的波形。全速USB设备在传输时D线上会有一个1.5K上拉电阻让主机知道这是一台全速设备。F103芯片内部这个上拉是由USB外设控制的如果你软件没正确配置USB外设上拉不使能电脑就不会识别。QMK固件或HAL库生成的工程一般都会自动处理但自制固件极容易漏掉这一步。如果枚举正常可以用dmesgLinux或者设备管理器Windows看到键盘设备键入测试如果能正常输出字符基本说明硬件和固件都没问题。这里还要提一个玄学问题如果你把键盘插到USB 3.0接口上指示灯亮但电脑不识别换一个USB 2.0口又能正常。这类问题通常是USB信号质量不够好。最简单粗暴的解决办法是D/D-走线上的串联电阻调到27Ω或者33Ω稍微增加一点阻抗匹配信号边沿变缓反而提升兼容性。这个技巧在我调试SPI到USB转接板时同样适用。5. 常见问题与排查技巧实录5.1 上电无反应、电流异常大上电后如果无任何反应先不要急着怀疑芯片烧了大概率是电源问题。用万用表逐点测量3V3对地电压VBUS电压LDO的输出电压。如果LDO输出电压为0排查输入是否有5V GND是否连通LDO有没有焊反或者虚焊。XC6206这类LDO的引脚顺序跟普通三极管类似常见是第1脚GND、第2脚VIN、第3脚VOUT焊接前一定要看数据手册光靠丝印容易被坑。如果电压正常但电流异常大超过100mA大概率存在短路或芯片损坏。可以从电源引脚断开测量各个模块的电流用“分割排查法”逐块排查。还有个低级错误USB座子的外壳焊盘和GND焊盘弄反或者Type-C座焊接时里面的针脚歪斜导致相邻引脚短路。用放大镜或者手机微距镜头仔细检查多花两分钟能省掉一整晚的排查时间。5.2 USB不识别 或 识别后频繁掉线USB不识别要分情况。如果插上去电脑毫无反应设备管理器里没有新设备出现优先检查D/D-是否接反。D和D-接反是最低级也是最常见的错误万用表测不到示波器看才能发现。如果线序没问题再检查CC引脚的下拉电阻Type-C座子必须有5.1K下拉到地。这个电阻如果焊错或者漏焊电脑端永远不会认为有设备插入。如果识别后频繁掉线重点查电源纹波和USB信号质量。使用示波器观察D/D-数据线波形正常情况下传输时信号边沿干净如果看起来方波变成圆波或者出现毛刺说明地回路噪声大或者差分线过长。尝试在VBUS和GND之间并联一个100uF电容效果经常立竿见影。如果问题依旧检查USB线本身劣质USB线内部只有电源线而数据线接触不良也会表现为掉线闪断排除这种可能性后再去改板子。5.3 矩阵扫描异常串键、鬼键、无响应矩阵问题多数集中在硬件或固件配置上。串键按了一个键另外某个键也触发很可能是矩阵二极管方向不一致。检查每颗二极管的丝印方向是否统一尤其焊接时如果有几颗贴反了电流倒灌就会导致串键。鬼键按三个键时报出第四个键通常是矩阵扫描逻辑里行线和列线的输入输出模式没有正确切换。QMK里COL2ROW和ROW2COL配置颠倒也是常见原因把它对调一下就能解决。某一行或某一列完全无响应通常是行线或列线断线。用万用表二极管档测从MCU引脚到这一行第一个按键焊盘的走线通断。如果通断没问题也可能是引脚配置成了默认复用功能比如PB3/PB4被JTAG占用、PB2被BOOT1占用这些引脚如果不强制改寄存器配置会被外设占用导致扫描不到。CubeMX工程的用户代码里加一行__HAL_AFIO_REMAP_SWJ_DISABLE();就能解决。这些排查手段都在网上反复出现过但真到自己的板子上很多人第一反应还是怀疑MCU坏了实际上MCU没那么脆弱按部就班排查才有效。5.4 WS2812灯珠颜色不对、闪烁、灯带前半段亮后半段暗WS2812的问题主要是供电和数据线质量。先检查5V供电的走线宽度和电源电容。如果整条灯带前半段亮后半段暗说明供电走线在灯带中段压降太大。把5V供电在灯带末端和首端同时接入双端供电或者加粗供电走线到1.5mm以上亮度就均匀了。如果某颗灯珠颜色变红变暗大概率是该灯珠供电不足或数据信号衰减。数据线串联时建议在每隔32颗灯位置加一个74HC245缓冲器或者简单就是加几百欧姆的串联电阻提高信号驱动能力。闪烁或者颜色随机变化一般是数据信号被干扰。检查PWMDMA配置是否正确定时器的更新事件有没有正确触发DMA搬运也要检查WS2812的数据线是不是太靠近电源大电流走线。在数据线上串联一个220Ω到470Ω的电阻既能减小信号反射也能降低对GPIO驱动能力的压力是业内很常用的小技巧。还有一个轻型方案在每颗灯珠的VDD和GND之间加0.1uF电容能有效抑制电源毛刺导致的数据判断错误这个在量产键盘方案里几乎是标配。5.5 按键双击、断触等手感问题硬件电路和固件看起来都没问题了但手感上出现双击或断触。这种情况要换思路不是板子的问题是轴体或热插拔座的问题。先用万用表短接轴座的焊盘两端看系统是否触发正常按键。如果短接没问题换一颗新轴体试试。有货期的小批轴体尤其是低价入门轴针脚氧化或者弹片疲劳频繁会导致触点抖动增加表现为偶尔双击或者无响应。也可以通过固件里的debounce时间调整解决比如QMK的DEBOUNCE值从默认5改成10手感会稳一些。但别调得太大会让按键反应变肉。6. 实际使用体验与扩展方向6.1 成品表现与稳定性整把键盘装好之后我目前使用了大约三周期间一直插在Type-C口上没有掉过设备按键响应速度和灯效流畅度都令我满意。用HID测试工具看扫描回报率稳定在1000Hz左右这数据远超绝大多数量产键盘普遍是125Hz到250Hz。STM32F103C8T6的USB全速接口配合精简的扫描循环回报率高一点并不意外但实际体验确实能感觉到按键跟手尤其在高速打字和游戏场景中非常跟手。72MHz的F103做键盘确实是大炮打蚊子级别的性能冗余。没开RGB灯时CPU占用几乎为0。开满灯效WS2812的DMA搬运完全不占内核系统还是从容得很。整个项目从硬件到固件综合下来稳定性、手感、性能三大块都让我满意完全可以作为日常主力键盘使用。6.2 项目后续扩展小屏幕、无线化与宏键盘做完一把键盘手头的电路和固件基础完全可以继续扩展。如果你想加一块0.96寸OLED小屏幕F103还剩余I2C外设和几个GPIO用SSD1306驱动显示键盘状态、电量或者当前层都是现成方案。QMK里也支持OLED插件基本拿来就能用。如果对按键宏感兴趣可以在键盘上定义一个宏触发层配合QMK的process_record_user回调函数一键发送一串组合命令对游戏玩家或设计师来说非常实用。如果是想要无线方案需要把主控换成带蓝牙的低功耗芯片比如nRF52840、ESP32-C3或者给F103加一块HC-05蓝牙串口模块。但注意F103本身没有BLE控制器加模块只是把键盘当成串口设备通过蓝牙透传需要配合电脑端软件转换成键鼠协议体验打折扣。真想做无线键盘建议直接原生BLE方案比如nRF52840或者带BLE功能的STM32WB系列。F103这把键盘就老老实实当有线主力无线场景另外开一个坑。6.3 对入门者的建议与个人体会最后聊聊对这整个项目的复盘。如果你从没画过PCB也没写过STM32代码直接上手做键盘确实有门槛。我建议把项目拆成两个阶段第一个阶段用现成的最小系统板和面包板搭矩阵通过跳线验证固件逻辑这个阶段不需要任何PCB知识而且能让你快速感受到键盘 DIY 的乐趣。第二个阶段再自研核心板把最小系统、电源、矩阵、USB整体画到一张板子上让电路布局更熟练后再考虑灯光和无线等复杂功能。我在实际项目中最深的一个体会是设计环节多花的时间会在调试环节十倍找回来。比如原理图网络标签命名规范、PCB布局时地平面完整、晶振位置离主控足够近、矩阵引脚分配刻意避开JTAG等特殊引脚这些决策做好之后后面几乎不会再回头改板子。而偷懒省掉这些步骤往往后面就是无穷无尽地排查。做键盘这件事表面上是一次硬件DIY实际上把STM32的最小系统设计、USB协议、矩阵扫描算法、bootloader烧录、PCB布局规范全给串起来了。一把键盘做完单片机功底和硬件调试能力都会有一个非常大的提升。如果你正准备动手做第一个STM32项目键盘是真不错的选择——实用、好看、技术含量全做出来能放桌上天天用成就感拉满。
)
