【键盘特殊功能】电磁阀蜂鸣器各类编码器等

本工程主要包括键盘的一些特殊功能，方便做键盘的网友翻找元件、参考学习，
比如旋钮编码器、电磁阀、蜂鸣器、震动马达、小屏幕、摇杆、HUB拓展坞等功能。
使用前务必看仔细备注！有问题的可以评论区反馈。
本工程长期开源、不定期更新

一、附件

附件里有APM手册和bootloader文件

附件里有常用电容电阻表、特殊元件购买推荐表

附件里有对应的固件和源码可供参考

都是用QMK固件的键盘，支持VIA和Vial软件
KFC键盘的主控是STM32F103CBT6芯片
ZERO键盘的主控是微雪RP2040-ZERO开发板
可以用淘宝现成的开发板来烧录、测试

二、其他说明

摇杆部分没有验证，可能有问题，记得自己核对检查下，有问题的可以评论区反馈我修改。
其他部分均已验证通过（震动马达和屏幕部分代码写的很基础，没弄啥花样）

三、开源声明

本项目基于CC-BY-NC-SA 4.0协议开源，
转载时需要给出适当的署名（须包含本项目链接），
同时标明是否对原有所修改。
不得将本作品用于任何商业用途。
若您修改、转变或更改本作品，
仅在遵守与本作品相同的许可条款下，
您才能散布由本作品产生的派生作品。

①重点注意事项（附件有文字版）：

☆☆☆首先，新手入门、还看不懂原理图的时候，请直接复制粘贴！！！
知识储备不够的时候不要企图自创！不要自己瞎瘠薄改动！！！

☆☆☆其次，新手入门、照着开源工程学习画图的时候不要乱改！不要乱缝合！也不要乱删东西！
有的线路是不能乱改的！！！
比如C口只能接到主控的D+D-引脚，只能是DP接D+，DM接D-。
比如STM32的烧录接口——SWDIO、SWCLK，只能分别接在B13、B14接口上。
比如屏幕只能接到带有I2C功能的特定引脚，摇杆只能接到带有ADC功能的特定引脚。
比如HUB芯片能一拖四，但是右侧总线接口需要接电脑，键盘主控只能接到左侧的四组接口之一。
还有像烧录接口、RESET开关、BOOT开关、外部晶振等东西不能乱删。
留条后路很重要，不要出了问题被迫重新打板才追悔莫及！
☆☆☆F103系列主控需要烧录器，建议购买PW link V2，9.9包邮，还有视频教程和服务群。
☆☆☆不管选用什么主控，都推荐买个同款主控的开发板，对排查硬件问题、固件问题都很有用。

②画板注意事项：

1、关于键盘尺寸数据和轴体封装数据：
多看数据手册和规格书，这两个是厂家认证的标准文件
樱桃原版规格书是用的英制单位，不要被一些中文译本四舍五入后的毫米制数据误导

2、在PCB上摆放轴体时，栅格大小调整为【93.75mil】或者【187.5mil】
因为【1U键位=19.05毫米=750mil】，而正常键位的最小单位为0.25U=187.5mil
3、晶振尽量靠近主控摆放，不要离主控太远，
晶振旁边配的两个电容的容值大小要按计算公式来，不然主控可能不识别不工作
4、滤波电容应该分别放在芯片各个VCC引脚附近，不要排成一条线，
同时有多个电容时，容值小的电容应该更靠近芯片

5、走线时，尽量不要走直角，选择45度拐弯或者圆角拐弯，尤其一些重要的信号线
6、走线时，线与线之间的间距应当符合3W原则，不要太挤太密
7、走线时，电源线如+5V、3.3V等应该适当加粗，网上有计算公式，键盘的电源线一般设为15mil就够了
8、走线时，尽量保持横平竖直，正反两面一个竖着走线一个横着走线
9、走线时，电流应该先流过电容、再进入芯片
10、走线时，尽量顺着长条形焊盘的方向走线

11、走线时，一组重要信号线，它们所围住的面积应该尽可能小
12、走线时，重要信号线区域可以设置禁止铺铜，比如蓝牙天线和晶振部分
13、走线时，重要信号线应该尽量等长，比如D+/D-两条数据线、晶振数据线，
不过键盘嘛，USB2.0要求不高，两线长度差小于100mil足以
14、走线时，可以先不考虑GND线路，走完其他线后直接铺铜，铺铜解决不了的地方再手动走线
15、铺铜后，只要有空间的地方都可以打GND过孔，这样的叫缝合孔，可以保证板子接地良好

16、TYPE-C口那两个两个5.1K电阻是用来识别C to C线材的，不需要的话可以不焊接，
需要的话必须要分别接两个5.1K电阻，不可以偷工减料只用一个
17、STM32F103系列主控的话，PC13/PC14/PC15/PA0四个引脚因为供电能力较弱，尽量不要用
主要是不要用来驱动灯光或者电磁阀，接按键矩阵或旋钮倒是没啥问题
18、嘉立创工厂的工艺参数https://www.jlc.com/portal/vtechnology.html

③其他注意事项：

焊接时，优先焊接TYPE-C口和主控，万一焊废了就直接扔掉换一张板子
手艺实在不行可以找人帮忙焊接，不要为难自己，
焊接时注意元件的极性、方向，尤其是二极管和RGB灯珠。
RGB灯珠要用【自带IC】的、不要买错成【共阴共阳】的了

1.其他键盘教程推荐：
B站UP主 阿熊话太多 的教程https://space.bilibili.com/439415853

立创用户HiryKun的《APM/STM32F103CxT6最小系统板》等开源工程
B站还有办达达、浮灵、丈二等UP主做的视频教程
我主页还有其他键盘案例工程可以参考

2.其他常用元器件封装推荐：
立创用户 tianguaapple 的元件库
立创用户 LAN_23333   的元件库
特殊元件自己找立创元件库或者用户贡献库，记得拿数据手册比对下
注意元件的极性以及封装规格，确认无误再用

3.常用客制化网站分享：
①九尾网站：https://nine-fox.com/#/home

一条龙服务，做渲染图、做键帽设计、做三模PCB（三模要用文老板的主控）
可一键生成各种棉的图纸、定位板图纸和基本的外壳三维图纸以及PCB草稿文件（3元下载全套文件）
②AI03的定位板生成网站：https://kbplate.ai03.com/

这个网站的数据更准确，比键圈常用的那个老网站好用多了
③QMK官方文档：https://docs.qmk.fm/#/

④VIA官网：https://www.caniusevia.com/

⑤VIAL官网：https://get.vial.today/

⑥键盘布局编辑器网站：http://www.keyboard-layout-editor.com/

⑦32U4固件生成网站，不推荐：https://kbfirmware.com/
⑧老定位板生成网站，不推荐：http://builder.swillkb.com/

4.腾讯微云分享：
https://share.weiyun.com/TdqXRrSR

包括我的VIA环境包、VIAL环境包，VIAL的软件、VIAL的软件、MSYS软件、toolbox软件等等

新手做键盘的大致流程：
>>>看完B站的那几个视频教程（完整看完，再加个UP主的群）
>>>找几个靠谱的开源工程参考，绘制原理图、画PCB板，最好发给群里网友看看有没有问题
>>>下单打板，购买元器件，等待到货
>>>等待到货的这几天可以学习怎么安装QMK环境、怎么编译QMK固件
>>>板子到手后，焊接好主要元器件（轴座轴体什么的先不急）
>>>连接电脑，测试有没有短路、电涌或者无反应
>>>用烧录器烧录BootLoader文件（有的主控可能不需要）
>>>烧录好BootLoader后连接电脑，看看能不能正常识别到主控（STM32芯片的设备名是maple003）
>>>安装QMK环境、编译QMK固件
>>>用qmk_toolbox软件，烧录对应的键盘固件
（VIA和Vial两个软件不同，所对应的键盘固件也不同，个人推荐使用Vial，功能更强大也更便捷）
>>>测试键盘所有功能是否正常，
出了问题的话，可以用开发板烧录固件，来看到底是硬件问题还是固件写错了