Skip to the content
PCBKitNew board
2 layers110 × 67 mmSmart keyboard, the printed circuit board in 3D

Smart keyboard

gwaves/smart-keyboard

ESP32-S3 detachable USB macro keyboard: firmware, macOS configurator, protocol, and KiCad hardware prototype

Size
110 × 67 mm
Copper layers
2
Thickness
1.6 mm
Parts
79
Nets
65
Pads
273
Tracks, vias
827, 65
Pours
2
Routed
Yes
KiCad
KiCad 10.0 (file 20260206)
Created
26 Jul 2026
Updated
15 Aug 2026

Overview

Smart keyboard is an open-source printed circuit board by gwaves, from the gwaves/smart-keyboard repository on GitHub. It is a 2-layer board of 110 × 67 mm with 79 parts on 65 nets, routed with 827 tracks and 65 vias.

It is built around the SN74AHCT1G125DBVR(UMW), 1N4148WS and CPG151101S11-16, with the SK6812MINI-E, M2.5 and EC11J1525402 among its other parts. Its parts include 24 diodes, 14 capacitors, 12 switches, 2 connectors and 1 resistor. It belongs with the keyboards and input boards and the ESP32 boards of this library.

Main components

7

README

README.md

Smart Keyboard

基于可拆卸 LCKFB ESP32S3R8N8 开发板的 macOS 优先 USB 宏键盘。MVP 包含 13 个 机械按键、EC11 编码器、四向数字摇杆、逐键 RGB、设备端 HID 宏和 USB 配置协议。 触摸接口仅预留,BLE 延后且只提供标准 HID。

工作区

路径内容
firmware/ESP-IDF 固件与固件侧测试
desktop/Tauri 2 macOS 配置应用
protocol/共享协议定义、Rust/C 编解码与 golden vectors
hardware/扩展板、BOM、KiCad 和结构资产
docs/开发、组装、使用和恢复文档

统一入口:

sh
make build
make test

开发环境见 docs/development/setup-macos.md。

项目状态

这是正在开发的开放硬件原型,不是已验证的消费产品。当前 KiCad 初版虽已通过 ERC/DRC,但插座、USB、按键定位板、外壳和 RGB 功耗仍需样板实测。请勿把 PRELIMINARY_DO_NOT_FABRICATE 目录中的文件直接用于批量生产。

本项目是独立社区项目,与 OpenAI、Codex、Work Louder 或立创开发板官方均无隶属、 授权或背书关系;产品名称仅用于说明兼容目标和参考来源。

许可证

项目当前公开供审查和协作,正式的软硬件许可证组合仍待项目所有者确认。在许可证 文件加入前,公开可见不等同于授予复制、修改或再发布权利。

Parts

79
QtyValueFootprintReferences
13100nF_16VCapacitor_SMD:C_0603_1608MetricC1, C2, C3, C4, C5, C6, C7, C8, C9, C10, C11, C12, C14
121N4148WSDiode_SMD:D_SOD-323D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12
12CPG151101S11-16SmartKeyboard:MX_Hotswap_CPG151101S11_16SW1, SW2, SW3, SW4, SW5, SW6, SW7, SW8, SW9, SW10, SW11, SW12
12SK6812MINI-ELED_SMD:LED_SK6812MINI-E_3.2x2.8mm_P1.5mm_ReverseMountLED1, LED2, LED3, LED4, LED5, LED6, LED7, LED8, LED9, LED10, LED11, LED12
3M2.5MountingHole_2.5mmH1, H2, H3
110uF_16VCapacitor_SMD:C_0805_2012MetricC13
11206L050_6NRFuse:Fuse_1206_3216MetricF1
133RResistor_SMD:R_0603_1608MetricR1
13V3_LOGICTestPoint:TestPoint_Pad_D1.0mmTP2
15V_LEDTestPoint:TestPoint_Pad_D1.0mmTP1
1COL0TestPoint:TestPoint_Pad_D1.0mmTP8
1COL1TestPoint:TestPoint_Pad_D1.0mmTP9
1COL2TestPoint:TestPoint_Pad_D1.0mmTP10
1COL3TestPoint:TestPoint_Pad_D1.0mmTP11
1EC11J1525402SmartKeyboard:Alps_EC11J1525402ENC1
1ENC_ATestPoint:TestPoint_Pad_D1.0mmTP12
1ENC_BTestPoint:TestPoint_Pad_D1.0mmTP13
1ENC_PRESSTestPoint:TestPoint_Pad_D1.0mmTP14
1GNDTestPoint:TestPoint_Pad_D1.0mmTP3
1JOY_DOWNTestPoint:TestPoint_Pad_D1.0mmTP16
1JOY_LEFTTestPoint:TestPoint_Pad_D1.0mmTP17
1JOY_RIGHTTestPoint:TestPoint_Pad_D1.0mmTP18
1JOY_UPTestPoint:TestPoint_Pad_D1.0mmTP15
1LCKFB_CASTELLATED_A_1x20SmartKeyboard:LCKFB_ESP32S3R8N8_Socket_AJ1
1LCKFB_CASTELLATED_B_1x20SmartKeyboard:LCKFB_ESP32S3R8N8_Socket_BJ2
1LED_D12TestPoint:TestPoint_Pad_D1.0mmTP19
1RGB_DATA_3V3TestPoint:TestPoint_Pad_D1.0mmTP4
1ROW0TestPoint:TestPoint_Pad_D1.0mmTP5
1ROW1TestPoint:TestPoint_Pad_D1.0mmTP6
1ROW2TestPoint:TestPoint_Pad_D1.0mmTP7
1SKRHACE010SmartKeyboard:Alps_SKRHACE010JOY1
1SN74AHCT1G125DBVRPackage_TO_SOT_SMD:SOT-23-5U1

Questions

How big is the Smart keyboard PCB?

It measures 110 × 67 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Smart keyboard use?

79 parts, built around the SN74AHCT1G125DBVR(UMW), 1N4148WS, CPG151101S11-16 and SK6812MINI-E. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.

Where can I download the Smart keyboard KiCad files?

From the gwaves/smart-keyboard repository on GitHub, at the commit this page was made from: the board is hardware/kicad/smart_keyboard.kicad_pcb and its schematic hardware/kicad/manufacturing/REV_A_FA1_2026-07-31/source/smart_keyboard.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Smart keyboard design in my own project?

Its repository states no licence, so its author keeps all rights: ask gwaves before reusing the design.

Similar boards

  • 2 layers90 × 90 mmPocketPSU elec main, the printed circuit board in 3D

    PocketPSU elec main

    jarrod89/pocketPSU

    Input1: - Output1 can be used to supply pocketPSU via a battery - Optional battery charging capability (addon board with BMS)

    97 parts2
  • 2 layers430 × 118.4 mmV2, the printed circuit board in 3D

    V2

    Jaydosu/V2

    try

    265 parts
  • 4 layers38 × 70 mmSolar controller, the printed circuit board in 3D

    Solar controller

    lzptr/solar-controller

    ESP32 Based PCB for Controlling a Solar System Light Chain

    53 parts
  • 2 layers249.7 × 99.4 mmKicadproj, the printed circuit board in 3D

    Kicadproj

    steven-na/saria

    An rp2040 based, wired, split-ergo, mechanical keyboard. Running on QMK firmware

    148 parts
  • 2 layers42 × 54 mmClick counter Q5, the printed circuit board in 3D

    Click counter Q5

    dudgeon/count-fidget

    A lightweight, rechargeable two-key fidget that counts clicks, resets with a second key, and remembers its count while asleep or unpowered. Designed for a home-printed enclosure and professionally assembled electronics.

    96 parts
  • 2 layersErgonomicGamepad, the printed circuit board in 3D

    ErgonomicGamepad

    vemcg/ErgonomicGamepad

    Custom ergonomic gaming keypad PCB project (KiCad) with a 4x6 key matrix, hot-swap sockets, and USB-C.

    86 partsGPL-3.0
  • 4 layers149.9 × 152.5 mmTMR2615F osu pad, the printed circuit board in 3D

    TMR2615F osu pad

    dubnubdubnub/Giris

    open source 32 key/half (64 total) analog TMR split ortholinear keyboard w/ 8kHz USB HS

    168 parts4Apache-2.0
  • 4 layers96 × 96 mmOpen micro top, the printed circuit board in 3D

    Open micro top

    TomBonness/open-micro

    Open-source USB/BLE desktop programming controller with RGB status integration

    52 parts