ixx-kb基于nrfmicro和zmk的简单蓝牙分体键盘 - 嘉立创EDA开源硬件平台

# 0. 感谢 感谢放前边，大概从几个月前买的套件出问题开始，犹豫着要不要尝试一下Plank配列，最终找到了[夏天](https://oshwhub.com/iqirtryi)大佬的系列文章，从此打开了一扇新的大门，原来我想要的键盘是存在的，如果你还没有找到，没关系，好好学习，实现它！！！！ # 1. 前置学习 感谢[夏天](https://oshwhub.com/iqirtryi)大佬的系列文章，如果是没制作过键盘及pcb焊接的同学可以看一下这部分，有经验的同学可以直接看第二部分。 ## 1.1 引用一下大佬的系列，有需要的可以学习： * 一、20键模块（4行5列，可组成20、40键盘） Pro Micro模块主控详见：[https://oshwhub.com/iqirtryi/pbk40-rgb-keyboard-c](https://oshwhub.com/iqirtryi/pbk40-rgb-keyboard-c) Atmega32U4主控详见： [https://oshwhub.com/iqirtryi/iqp40u-r](https://oshwhub.com/iqirtryi/iqp40u-r) * 二、25键模块（5行5列，可组成25、50、75键键盘） Atmega32A主控详见： [https://oshwhub.com/iqirtryi/kb40-atmega32a](https://oshwhub.com/iqirtryi/kb40-atmega32a)。 * 三、15键模块（3行5列，可组成15、30、45键键盘） Atmega32A主控详见： [https://oshwhub.com/iqirtryi/IQP30A-atmega32a](https://oshwhub.com/iqirtryi/IQP30A-atmega32a) * 四、16键模块（4行4列，可组成16、32、48、64键键盘），20键模块（5行4列，可组成20、40、60、80键键盘） Atmega32A主控详见： [https://oshwhub.com/iqirtryi/pkb16x4-atmega32a](https://oshwhub.com/iqirtryi/pkb16x4-atmega32a) Atmega32U4主控详见： [https://oshwhub.com/iqirtryi/IQP48U-32u4](https://oshwhub.com/iqirtryi/IQP48U-32u4) Pro Micro模块主控详见： [https://oshwhub.com/iqirtryi/IQP48U-32u4](https://oshwhub.com/iqirtryi/iqp48-pro-micro) * 五、每种模块都同时提供对应的模块D，最下面一行可选用一个或多个2U键，方便灵活组成不同的键盘。 ## 1.2按需选择主控芯片： 1. ATmega32a【不再推荐】：价格低，体积稍大便于焊接，但需要烧录器烧录固件。可采用本文所附固件，也可采用群友提供的支持via的固件。 2. Atmega32U4【省事但贵，除非需在线生成固件，不做推荐】：自带USB界面，不需要烧录器烧录固件，QMK官方完美支持，可在线生成固件，无需自己深入编程即可制作一把全键可编程的键盘，但价格高，且MU封装焊接难度也大。 3. STM32F072CBT6【最便宜简单，强烈推荐】：无需晶振，电路简单更便宜，自带USB界面，无需烧录器烧录bootloader，直接通过USB口用QMK toolbox烧录固件即可，制作更方便，详见[X.Tips](https://oshwhub.com/joba)作品：[https://oshwhub.com/joba/IQP40S](https://oshwhub.com/joba/IQP40S)，该工程提供了5X4、5X5两种模块，同时有焊轴版和热插拔版供选择。 # 2. 键盘组件 > 这里假设你已经是一个有键盘制作经验的同学了。 ## 2.1 PCB 本工程PCB基于夏天的promicro键盘项目修改而来，调整了主控板朝向，直接对外部接usb-c数据库线，省略了转换头接线，取消了板载usb-c母座，添加了电池接线及拨动开关。  实物图：  涉及的元件不多，主要就是20个SOD123封装的二极管，加一个MSK-12C01-07的微动开关，接主控板使用的，2.54mm单排圆母插. ## 2.2 主控nrfmicro 主控使用的是可以1比1替换promicro的开源项目nrfmicro，项目地址:[nrfmicro wiki](https://github.com/joric/nrfmicro/wiki)  除了nrfmicro也可以使用nice!nano 他们针脚数量位置都一样（不过我没试过，不知道放我这里合不合适） nrfmicro的制作，参考：[https://github.com/joric/nrfmicro/wiki/Releases](https://github.com/joric/nrfmicro/wiki/Releases) 这里有制作pcb使用的gerbers文件，相关元件型号及数量说明，可以直接打板，购买，MCU使用的是基于nrf52840的E73-2G4M08S1C封装，焊接的话因为元件都很小我手残直接用的焊台，据说高手可以直接手焊。 > 1. 注意焊接E73的时候因为他背部有几个焊盘点锡膏的时候别太少，少了焊不住，不过也别整太多，这个位置连锡也看不到 > 2. E73的铁皮可以拿掉，后续安装的时候调度能稍微降低一点 如果不想自己做，可以直接买nrfmicro成品，就是价格高点 制作好的nrfmicro需要刷bootloader,可以参考这里：[https://github.com/joric/nrfmicro/wiki/Bootloader](https://github.com/joric/nrfmicro/wiki/Bootloader) 可以使用多种工具，可以看看自己手里有什么就用什么，比如我就是用的树莓派刷的，如果需要买的话建议直接买J-LINK,价格不贵使用也简单（树莓派其实还挺麻烦的）。 刷完bootloader后，重新连接电脑，快速短接两次GND和RST 进入刷机模式，如果电脑里出现U盘，表示刷机成功。 ## 2.3 电池及其它 电池就是简单的3.7v锂电池，容量看自己需要买，因为我想成品尽量薄一点，买的303450 容量800mAh，保守计算满电应该可以使用2个月（每天开机10小时） 电池不需要买带插头的，因为我的主板是留的焊盘，直接焊接线就行，买带插头的也要剪掉，或者有需要的自己改主板加个插座 螺丝的话使用m2\*4平头螺丝，钢柱的话我用的高特的半高轴（也有的地方写矮轴，但要注意，针脚要与标准轴相同，高特还有一款专门的矮轴，针脚与标准轴不通用，别买错了），刚好能用m2\*9的，如果用的是标准MX轴，保险点说铜柱最好买m2\*11的（也许m2\*10的也行，但我没试过。。。） # 3. 组装及固件 ## 3.1 组装 焊接就不细说了，pcb弄好后说一下2.54圆母插，为了能将高度尽量减小，nrimicro要尽可能的与排母贴在一起，我试了一下E73模块宽一点会卡住，让你不能完全按下去，如果想要完全按下去，只能把排母削去一点，我用的钢锯，效果大概这样  丑是丑了点，但这样就能完全按进去了，然后，为了高度nrimicro和排母连接就不能用排针了，那东西太高，用夏天教程里的思路，用元器件的针脚，最好粗一点的，如果太细了可以用两根（太细了后继插拨nirmicro主板的时候麻烦点，会歪）另外焊接的背面也不要留太多我是用钳子修过一遍，让他尽量平一点  渣焊功=_=!，大家明白意思就行。 底板的螺丝位需要做一个下沉（不做也行，脚垫用高点的也不会划到），pcb板还是挺硬的，我是用的美工刀，大家自己看情况，边弄边试，螺丝放里不划手就行  然后是主板，电池，完整图  固定就透明胶了。。。。电池下边的轴针脚我都剪过一遍，防止扎破电池，然后，最终的效果图     拍的不好，大家对付看吧[捂脸] ## 3.2 ZMK固件 键盘弄好了，就是固件了，其实固件可以在组装键盘之前，弄好nrfmicro刷完bootloader之后就可以编译了，这里先说个教程，如果没弄过zmk，可以先看一看大佬[全桥整活器](https://space.bilibili.com/2421963)的教程[环境搭建](https://www.bilibili.com/video/BV1HM4y1E7xB/?spm_id_from=333.999.0.0)，[固件编译](https://www.bilibili.com/video/BV16F411X7TG/?spm_id_from=333.999.0.0)，[固件烧录](https://www.bilibili.com/video/BV1hz4y1J7TT/?spm_id_from=333.999.0.0) 然后再说一下我这个键盘的配列代码已经放github上了地址：[https://github.com/iuv/ixx-kb](https://github.com/iuv/ixx-kb) 按教程把这个仓库放在`app/boards/shields`目录下`app/boards/shields/ixx-kb` 然后在app目录下执行编译命令： 左手：`west build -d build/left -b nrfmicro_13 -- -DSHIELD=ixx_left` 右手：`west build -d build/right -b nrfmicro_13 -- -DSHIELD=ixx_right` 编译出来的文件为`app/build/left/zephyr/zmk.uf2` 和 `app/build/right/zephyr/zmk.uf2` 下载到本地记得改名，分别刷到对应的左右手即可。 修改配置的话可以在这个网站[https://nickcoutsos.github.io/keymap-editor/](https://nickcoutsos.github.io/keymap-editor/)可视化修改，将ixx-kb目录里的ixx.keymap内容粘贴进来修改，修改完再把内容粘贴回ixx-kb目录下的ixx.keymap里 默认配列（个人习惯，大家自行修改）  zmk固件编写我也整理了点东西，放这里了，有需要的可以看看：[https://github.com/iuv/ixx-kb/wiki](https://github.com/iuv/ixx-kb/wiki)