本键盘使用@zhaqian12适配国产芯片后的QMK固件：

固件链接：GitHub - zhaqian12/qmk_firmware at zhaqian

本键盘是在以下项目进行的功能拓展，因此有关使用的QMK固件、程序烧录及改键等内容请在以下项目中进行查看，此处不再赘述。

3键小键盘-快速上手版ZY-03S

1.成品效果展示

功能演示可查看B站视频：[DIY]三键+旋钮+OLED+RGB 多功能自定义小键盘

2.材料准备

自动生成的BOM表材料不全，要自己准备

烧录材料：ST-LINK V2、4Pin烧录排针、杜邦线

键盘材料：

名称	数量	图片
Air32F103开发板（含排针）	1
0603 100nF电容	4
WS2812B 3521反贴幻彩灯珠	5
WS2812B 4020侧面幻彩灯珠	20
热拔插底座	3
机械键盘轴体	3
键帽	1
ec11旋转编码器	1
ec11旋帽	1
0.96寸4针1306驱动OLED显示屏	1	（GND引脚位于最左侧）
2.54mm 20P排母	1
2.54mm4P排母	1
底/顶壳（模型见附件）	1
M3*8扁头螺丝钉	4
M3x10mm尼龙柱	2
PCB	1	厚度1.6mm

3.制作流程

3.1固件烧录

见该项目中说明：3键小键盘-快速上手版ZY-03S - 嘉立创EDA开源硬件平台 (oshwhub.com)

务必烧录bootloader 后再进行后续硬件制作，否则安装完成后无法进行固件烧录。

3.2硬件制作

（1）如下图所示焊接元器件（忽略飞线，因为不小心热插拔底座焊反了，重焊把焊盘整坏了），并安装尼龙柱

（2）按下图步骤安装PCB与顶壳

（3）安装底壳

（4）安装轴体、键帽、旋钮

（5）连接USB后即可使用，首次使用需要通过VIA来配置。

4.VIA配置

可以通过以下网页进行控制，当然也可在官网下载客户端，两者操作基本相同

网页链接：VIA (usevia.app)

（1）在上方设置菜单下打开Show Design tab 选项，此时会出现一个刷子图标

（2）在刷子菜单下，先取消下图1出的选项，然后点击上传按键，选择附件文件中的zy03.json文件

（3）选择ZY03键盘，点击确定

（3）在键盘图标界面下可以进行配置，灯光和改键可以查看ZY03S那个工程，这里就主要说明以下OLED配置

（4）OLED配置界面说明如下