简介：一套面向STM32F103C8T6与WS2812B RGB灯蓝牙键盘的硬件设计参考文件，基于Altium Designer 09绘制，采用两层板结构，板卡尺寸139×97mm，属于中小尺寸紧凑型键盘方案。资源共14个文件，压缩包约9.08MB，包含原理图、PCB、原理图库、PCB封装库及工程文件，并附有预览文件，方便快速查看整体设计。目前已有770人学习下载。其中原理图与PCB文件展示了STM32F103C8T6最小系统、WS2812B RGB灯驱动电路及蓝牙通信模块的电路连接和PCB布局；原理图库和PCB封装库则提供可直接调用的元件封装，便于复用与二次修改。工程文件可由Altium Designer直接打开，方便按需调整板级设计。整体工程组织清晰，适合嵌入式入门者、键盘DIY玩家以及需要参考蓝牙键盘硬件方案的工程师，可用作课程设计、毕业设计或产品原型开发的学习样板。
1. 一套STM32F103C8T6（LQFP48）+WS2812B蓝牙键盘AD设计文件，先读懂器件的脾气
拿到“STM32F103C8T6（LQFP48）+WS2812B RGB灯蓝牙键盘AD设计硬件原理图+PCB+器件封装库文件”这类压缩包，很多人第一反应是打开Altium Designer，照着原理图抄一遍。我会反着来：先不碰AD，也不看封装库，先把三样东西在电路里的角色盘清楚。C8T6是主控，但对键盘这种外设来说它一点都不忙，真正决定这块板子成败的是灯、蓝牙和供电。WS2812B单颗全亮能达到60mA，几十颗灯串起来就是几安培，这是电源和地线布局的第一约束；蓝牙是走SPP还是HID，又直接决定了原理图上串口模块的选型。这篇就按“选型边界—AD建库与原理图—PCB布线—固件配合—发板前检查”这条链路往下走，适合已经画过最小系统板、但第一次把大电流灯串和无线模块塞进键盘布局的工程师。
2. 原理图上先定边界：C8T6管脚、WS2812B电流、蓝牙协议栈三条硬约束
原理图不是从MCU开始画的，而是从“谁最难伺候”开始画。在STM32F103C8T6（LQFP48）+WS2812B RGB灯的键盘里，最难伺候的显然是灯珠的电流和蓝牙的协议，主控反而是最好说话的那个。
2.1 主控用LQFP48而不是更大封装，管脚账要先算清
STM32F103C8T6是LQFP48封装，本体14x14mm，脚距0.5mm，去掉电源和地脚之后还能拿出37个GPIO。对一个以按键矩阵为主的外设，37个脚不算少，但要一层层扣着用：
- 84键键盘常用8行x13列矩阵，需要21个IO；
- WS2812B灯串数据脚1个；
- 蓝牙模块串口收发各1个；
- SWD调试固定占用PA13/PA14，复位和BOOT0再占2个；
- 想加轴灯、编码器或屏幕的话，IO立刻紧张。
把8行降到6行、列扩到14列，IO的腾挪空间会更大，但扫描间隔和消抖逻辑也要跟着改，这是原理图阶段就该定的trade-off。C8T6只有64KB Flash和20KB SRAM，做蓝牙键盘加灯效完全够，但别顺手把字库、大量音频采样塞进去，否则后面优化固件的时间比画板子还长。
注意：LQFP48脚距只有0.5mm，手工焊接建议先涂助焊剂再热风枪吹焊，再用拖焊清理桥连。封装库里焊盘长度建议做到1.4mm以上，留出足够的吃锡空间。
2.2 WS2812B的电流账与逻辑电平是PCB Layout的输入
WS2812B是单线协议，数据速率800kHz，每个灯珠24bit数据，发送顺序是G、R、B。单颗灯珠全白光时电流最大，接近60mA，这是灯串设计的天花板。
| 灯珠数量 | 按全白60mA估算总电流 | 按动态图案约1/3亮度估算 | 电源方案建议 |
|---|---|---|---|
| 16 | 0.96A | 0.32A | USB口直供要留意线阻 |
| 61 | 3.66A | 1.22A | 必须外接5V电源或升压电路 |
| 108 | 6.48A | 2.16A | 独立供电，PCB要开铜皮 |
实际动态图案平均电流没有全白那么高，但原理图和PCB必须按最坏情况设计。灯串的5V电源线不能和USB口的VBUS用同一根细走线，建议直接铺铜，并且让灯珠的GND就近打过孔回到主控地平面，避免大电流在地线上叠加出噪声，干扰后面的WS2812B数据信号。
另一个坑是逻辑电平。WS2812B的数据输入是按5V设计的，而STM32F103C8T6的GPIO输出是3.3V。短距离单颗灯珠时，3.3V高电平勉强能被识别，但灯串一长、走线一远，波形振铃和衰减就会造成偶发闪灯。稳妥做法是数据线上串一个33Ω到100Ω电阻，并在灯珠侧对5V加一个10kΩ上拉，或者直接加74HCT245做电平转换，这是入门设计里最值得花的几毛钱。
2.3 蓝牙键盘的“键盘”两个字，决定了必须走HID协议
这是整张原理图最容易走错的一步。很多人习惯性地选HC-05，因为资料多、串口透传简单、手机端装个APP就能收到数据。但HC-05这类模块做的是SPP串口透传，它只负责把串口数据搬到蓝牙链路上，电脑系统不会把它识别成键盘。你从串口发出去0x04，Windows收到的只是一个串口字节，不是键盘的按键码。
要做成真正的“蓝牙键盘”，选型上有三条路：一是带BLE HID功能的串口模块，这类模块在内部把串口收到的按键值包装成HID Report，电脑端直接识别为键盘；二是nRF52832这类BLE SoC自己写协议栈；三是经典蓝牙HID模块。对入门复刻来说，第一种最省事，原理图上就是UART接口加几个状态脚。
提示：最近常看到有人问“HC-05蓝牙模块连接不上”，其实问题不在波特率或AT指令，而是SPP模块本身不具备HID上报能力，连上手机也不会弹出键盘配对。选型时先看模块资料里有没有“BLE HID Keyboard”字样，比排查半天连线有用得多。
3. 从AD建库到最小系统原理图与PCB，四个环节决定能否交付
把边界条件定完，才可以打开Altium Designer。AD这个叫法行业里就是指Altium Designer，别和模数转换器的ADC搞混。这一章的思路是：封装库先验收，最小系统四件套按参数填，布线时把电流和净空当成硬约束。
3.1 器件封装库：LQFP48和WS2812B的封装不能只核对名字
压缩包里给的器件封装库文件，我一般不会直接拿来用，而是先做三个检查：单位是mil还是mm、引脚编号和原理图符号是否一致、封装本体尺寸是否和数据手册机械图对得上。
LQFP48的封装注意四点：本体边长14x14mm，脚距0.5mm，焊盘建议长1.4mm宽0.3mm，焊盘外侧留出0.3mm以上的丝印余量。手焊时第1脚和芯片圆点必须在丝印上有明确标识，极性反了整片板子都废。WS2812B是5.0x5.0mm的5050封装，6个引脚，底部还有一个大散热焊盘。底部焊盘必须开窗，方便过波峰焊时散热，也能帮助灯珠把热量导到PCB铜皮上；如果灯珠密度高，底部焊盘还应该通过多个过孔连接到背面覆铜。
还要留意WS2812B这类国产灯珠不同批次机械尺寸有细微差别。画封装时建议以你实际采购那批灯珠的数据手册为准，不要拿网上随便下的封装库盲用。封装验收通过之后再导入原理图库，配套的3D模型只用来检查干涉，不要影响电气规则。
3.2 原理图最小系统四件套，参数照着填也别填错
STM32F103C8T6的最小系统在原理图上就是复位、外部晶振、BOOT、SWD四块，但每一块都有常见的抄错点。
| 电路 | 常用参数 | 说明 |
|---|---|---|
| 复位电路 | 10kΩ上拉 + 100nF到GND | NRST内部已有上拉，电阻可省，但电容不能省 |
| 8MHz晶振 | 22pF负载电容x2 | 具体容值按晶振CL值调整，15~22pF常见 |
| BOOT0 | 10kΩ下拉 | 运行时保持低电平，进入ISP才拉高 |
| VDDA/VREF+ | 10Ω电阻 + 1uF和100nF电容 | 保证ADC和内部复位参考干净 |
| SWD接口 | 2x5排针引出PA13/PA14 | PA13/PA14线上不要接大电容，会影响调试时钟 |
外部晶振这里多说一句：C8T6内部有HSI振荡器，但精度对蓝牙键盘这种需要稳定串口通信的场景不够，WS2812B的时序和串口波特率都依赖HSE。原理图上晶振要靠近MCU摆放，两个负载电容的地端分别就近过孔到地平面，而不是绕远汇聚到一点。
画完最小系统后，把USART1留给蓝牙模块，把定时器通道引脚留给WS2812B数据线，矩阵扫描的行列引脚集中放在相邻引脚组，方便固件里用端口寄存器一次性读写。这一条决定了后面PCB布线的顺利程度。
3.3 PCB布线规则与层叠设置：电流决定线宽，无线决定净空
3.3.1 电源走线宽度对照
PCB上的走线宽度不是随意定的。信号线0.25mm够用，但灯串的5V电源线必须按电流选宽度，1oz铜厚、外层走线、温升控制在10°C以内时，可以参考下面这组经验值：
| 工作电流 | 最小线宽 | 布线做法 |
|---|---|---|
| 1A | 0.76mm（30mil） | 单独走线并加宽，过孔至少2个 |
| 2A | 1.27mm（50mil） | 建议整片铺铜或走线并联 |
| 3A以上 | 2mm以上 | 直接覆铜，过孔阵列连接 |
如果键盘有61颗灯，最坏情况接近3.7A，这时候靠一条走线根本扛不住。常见做法是在PCB上单独划出一块5V覆铜区域，灯珠的VDD直接通过过孔接到这片铜皮上，而不是一棵灯一棵灯串线。地线也一样，灯珠的GND过孔要密集，每颗灯至少一个，必要时用两个过孔并联降低回流阻抗。
注意：双层板建议顶层走信号，底层保持完整地平面。灯串的高频翻转会把噪声耦合到地平面，如果底层地被矩阵走线切碎，WS2812B的数据信号就很容易受干扰。
3.3.2 晶振、蓝牙天线和矩阵走线的避让顺序
C8T6的晶振要靠近MCU，走线短直，晶振底下不要走其他信号线，最好两侧包地。蓝牙模块的天线区域是另一条硬约束：天线正下方和周围3~5mm范围内不能有覆铜、不能有过孔、更不能走时钟线，否则天线辐射被地plane吸收，蓝牙距离直接缩水到两三米。
矩阵键盘的走线是长直线，行线和列线交叉处有寄生电容，线间距建议不小于0.3mm，避免高速扫描时串扰。WS2812B的数据线要和灯串5V电源线并行一小段没有关系，但不要和晶振、蓝牙天线靠太近，数据线上的振铃会干扰无线接收灵敏度。
AD20里跑PCB DRC时，除了默认的Short Circuit、Un-Routed Net、Clearance，还要额外检查丝印是否压在焊盘上，以及过孔是否落在灯珠底部散热焊盘的开窗区域内。
LED_COUNT = 61 current_per_led = 60e-3 # 全白单颗电流上限，单位A total_current = LED_COUNT * current_per_led print(f"最坏情况总电流 {total_current:.2f} A") print(f"建议5V铜皮宽度按2mm以上规划")逻辑说明：灯串电流按全白光上限计算，实际动态图案平均会低一些，但供电设计必须按这个最坏值预留。参数上60e-3是WS2812B全白光公版典型上限，如果你用的灯珠额定电流不同，直接替换这个值重新估算；算出来的电流决定前面表格里5V电源走线的档位。
4. WS2812B驱动与键盘扫描固件，硬件必须给固件留出的接口
这章从固件视角反推硬件，因为很多板子画出来能通电，但一到写WS2812B驱动就发现定时器通道选错了、串口复用冲突了。硬件原理图定稿前，至少要把下面这张GPIO分配表过一遍。
4.1 GPIO分配表先给硬件，别让矩阵和定时器抢脚位
| 功能 | 引脚 | 说明 |
|---|---|---|
| WS2812B数据 | PA8 | TIM1_CH1输出，可做PWM+DMA |
| 蓝牙模块UART_TX | PA9 | USART1发送 |
| 蓝牙模块UART_RX | PA10 | USART1接收 |
| 矩阵行0~7 | PB0~PB7 | 输出行选 |
| 矩阵列0~7 | PA0~PA7 | 输入列读 |
| SWDIO / SWCLK | PA13 / PA14 | 调试下载 |
这里WS2812B数据选PA8，因为PA8映射TIM1_CH1，可以用PWM+DMA方式产生精确时序，而不占用CPU。串口选USART1而不是USART2，是因为PA9/PA10和SWD的PA13/PA14不冲突，而且和蓝牙模块邮票孔放在同一边时走线最短。
矩阵用了8行x8列，只覆盖64键，做60%配列够用。如果你要84键，就把列扩展到13列，PA0~PA7不够用时可以把PB8~PB12加进来，但要注意PB12~PB15是SPI2的引脚，原理图上别和灯珠的SPI方案混用。
4.2 用TIM+PWM+DMA输出WS2812B时序
WS2812B要求800kHz的比特率，每个bit由一个高电平和低电平组成，高电平时长不同区分0和1。用定时器PWM+DMA的方式，是把每个bit的高电平宽度预计算成定时器比较值，放在DMA缓冲区里，由定时器逐个输出，不占用CPU。
#define WS_LED_NUM 61 #define WS_TIM_CLK 72000000UL #define WS_TIM_PERIOD 90 // 72MHz / 90 = 800kHz #define WS_T1H_CMP 50 // 约700ns高电平 #define WS_T0H_CMP 25 // 约350ns高电平 static uint16_t dma_buf[WS_LED_NUM * 24]; static uint32_t ws_grb[WS_LED_NUM]; // 用户层按0x00RRGGBB填充 void ws2812b_send(TIM_HandleTypeDef *htim) { for (int i = 0; i < WS_LED_NUM; i++) { uint32_t r = (ws_grb[i] >> 16) & 0xFF; uint32_t g = (ws_grb[i] >> 8) & 0xFF; uint32_t b = ws_grb[i] & 0xFF; uint32_t grb = (g << 16) | (r << 8) | b; // WS2812B发送顺序是GRB for (int bit = 0; bit < 24; bit++) { uint32_t mask = 1UL << (23 - bit); dma_buf[i * 24 + bit] = (grb & mask) ? WS_T1H_CMP : WS_T0H_CMP; } } HAL_TIM_PWM_Start_DMA(htim, TIM_CHANNEL_1, (uint32_t *)dma_buf, WS_LED_NUM * 24); }逻辑说明：外层循环把用户颜色拆成R、G、B三个字节，再重组成WS2812B要求的GRB顺序；内层循环从bit23往bit0发送，每个bit对应一个PWM比较值，比较值大就输出高电平时间长，形成1码，比较值小就形成0码。DMA把整块比较值数组按顺序搬运给定时器比较寄存器，一次调用就能刷完整串灯。
参数说明：WS_TIM_PERIOD设90，配合72MHz定时器时钟正好是800kHz，这是WS2812B的数据速率；WS_T1H_CMP=50对应约700ns高电平，WS_T0H_CMP=25对应约350ns高电平。不同型号灯珠的时序窗口略有差异，改这两个宏重新编译即可校准；如果你不用HAL库，寄存器写法同样是把ARR设成90，CCR按宏填入，DMA方向从内存到TIM的CCR寄存器。
还要注意一点：WS2812B是有复位时序的。数据线上低电平超过50us时，灯珠会认为一帧传输结束，所以灯串之间不要一直拉高数据线。DMA传输结束后建议把数据脚拉低至少80us，再开始下一帧刷新。
4.3 蓝牙HID上报：串口协议和状态引脚决定固件复杂度
蓝牙键盘的固件本质上比WS2812B驱动简单：扫描矩阵得到键码，加工成键盘报文，通过串口发给蓝牙模块，模块负责把它包装成HID Report上传给电脑。原理图上要把蓝牙模块的串口引脚、状态输出引脚和使能引脚都引出来，状态输出引脚可以接一个LED指示连接状态，固件层轮询这个引脚判断是否需要重新配对。
串口波特率按模块资料设置，常见的有9600和115200两种。这里有个经验：原理图上在串口线路上预留两个0Ω电阻位，方便固件调试时断开蓝牙、把USART1转给其他设备用，板子不用改版就能换调试方案。
矩阵扫描用定时器中断做2ms周期扫描，按键去抖判断放在主循环里，不要用阻塞延时，否则WS2812B的DMA刷新和蓝牙上报会被拖住。固件架构上，裸机状态机就够用，没必要为这个项目移植FreeRTOS，键盘逻辑简单，反而裸机更容易控制时序。
5. 打样前给原理图和PCB做的5个检查项，比DRC更先做
PCB文件发板厂之前，除了AD20里的电气规则检查，我还会按下面5个顺序过一遍。这5项都不依赖复杂仪器，但能拦住九成的基础错误。
电源对地打阻值。用万用表二极管档测5V对GND、3.3V对GND，正常应该在几百欧以上。接近0Ω说明有短路，重点查WS2812B的VDD和GND有没有在封装里连错，以及C8T6的VDDA和VSSA网络是否合并到正确的电源域。如果买的是二手拆机C8T6，还要注意芯片内部可能已有短路或加密锁死，SWD连不上时先查这个。
晶振电路单独验证。先焊主控、电阻电容和晶振，不焊灯珠不焊蓝牙，用示波器看晶振引脚有没有起振波形。没示波器的话，把PA8复用为MCO输出，配置PLL后测量PA8频率，能读到稳定方波就说明HSE和PLL链路正常。晶振不起振时重点查负载电容容值和接地。
SWD下载链路。原理图上PA13/PA14只接调试排针，不要并接大电容。板子回来后用ST-Link连接，能读到芯片ID就通过。C8T6如果之前被开过读保护，连接会失败，需要先用ST-Link的connect under reset模式尝试。
WS2812B数据线信号完整性。先只焊第一颗灯珠，把灯串其余部分断开，用逻辑分析仪抓数据脚波形，确认0码和1码的高电平宽度在参数窗口内。没有逻辑分析仪就刷一个单灯常亮固件，灯能亮且颜色正常也说明时序基本正确。
Gerber和钻孔文件检查。出Gerber时钻孔文件很容易漏选，板厂收到的文件缺钻会导致所有过孔丢失。AD20里跑完DRC后，在PCB编辑界面打开Manufacturing下的Gerber Setup，确认包含钻孔文件，再检查层叠设置里顶层和底层的铜厚是否和电源线宽计算一致。还要在3D视图里旋转检查一遍丝印有没有压在灯珠焊盘上，丝印压焊盘在打样时不会报错，但贴片时会影响定位。
本文还有配套的精品资源，点击获取
