Skip to the content
2 layers134.2 × 100 mmFirst left, the printed circuit board in 3D

片側 22 キー(メイン 3行×6列 + 親指 4キー)、Kailh Choc v2 ホットスワップ、 Seeed XIAO nRF52840 Plus の分割無線キーボード。config.yaml から Ergogen で 左右 2 枚の KiCad PCB を自動生成し、Freerouting による自動配線・DRC・ガーバー生成まで済んでいます。

Size
134.2 × 100 mm
Copper layers
2
Thickness
1.6 mm
Parts
51
Nets
38
Pads
251
Tracks, vias
345, 20
Routed
Yes
KiCad
KiCad 10.0 (file 20260206)
Created
25 Aug 2026
Updated
4 Oct 2026

Overview

First left is an open-source printed circuit board by sunda-eimami, from the sunda-eimami/ULTRA_KEYBOARDS repository on GitHub. It is a 2-layer board of 134.2 × 100 mm with 51 parts on 38 nets, routed with 345 tracks and 20 vias.

Its parts include 22 diodes and 22 switches.

README

README.md

first — 44キー分割無線キーボード (Ergogen → KiCad)

片側 22 キー(メイン 3行×6列 + 親指 4キー)、Kailh Choc v2 ホットスワップ、 Seeed XIAO nRF52840 Plus の分割無線キーボード。config.yaml から Ergogen で 左右 2 枚の KiCad PCB を自動生成し、Freerouting による自動配線・DRC・ガーバー生成まで済んでいます。

全 44 キー配置配線済み PCB (左/右)
layoutrouted

状態 (2026-09-02)

  • kicad/first_left.kicad_pcb / kicad/first_right.kicad_pcb — 配線済み・DRC 違反 0・未配線 0
  • gerbers/first_left.zip / gerbers/first_right.zip — 発注用ガーバー(JLCPCB 等にそのままアップロード可)

使い方

sh
npm install          # ergogen をローカルにインストール
npm run build        # = ergogen . --clean   → output/ に未配線 PCB を再生成
npm run build:svg    # 外形 SVG も出力

注意: output/ はビルドのたびに完全に上書きされます。配線済みデータは kicad/、 発注データは gerbers/ にあり、これらはビルドでは消えません。config を変更したら 「npm run build → output/pcbs/*.kicad_pcb を kicad/ にコピー → 再ルーティング」が必要です。

ディレクトリ構成

text
.
├── config.yaml              Ergogen 設定 = 回路の一次ソース (キー配置・外形・ネット定義)
├── footprints/
│   ├── ceoloide/            ceoloide/ergogen-footprints (Choc, ダイオード, JST, 電源SW 等) ※CC BY-NC-SA 4.0
│   └── local/mcu_xiao_nrf52840_plus.js   XIAO nRF52840 Plus (Seeed 公式 KiCad データの座標から作成)
├── output/                  Ergogen 生成物 (未配線。ビルドごとに上書き)
├── kicad/                   配線済み PCB (Freerouting + 手修正、DRC クリーン)
├── gerbers/                 発注用ガーバー zip
└── docs/                    プレビュー画像

設計メモ

  • 配列: 列は外側から outer, pinky, ring, middle, index, inner、行は下から bottom, home, top。 Columnar stagger は pinky 基準で ring +6.3 / middle +8.8 / index +4.3 / inner +2.3 mm。 親指 4 キーは rotate: -90、半径 140mm の円弧上に 8° ピッチで扇状配置。
  • 左右別基板: XIAO は USB・リセットボタンが上面にあるためリバーシブル化できず、 左手用 (first_left) と右手用 (first_right) を別々に生成・配線しています。
  • 実装面: スイッチソケット・ダイオード = 裏面 / XIAO・JST・電源スイッチ = 表面。 XIAO は castellated パッドで表面に直付け。バッテリー (502030) は MCU 下の「ベイ」裏面。
  • ピン割当 (ZMK: &xiao_d n)
    用途ピン
    列 outer→innerD0 D1 D2 D3 D4 D5
    親指 t1→t4D2 D3 D4 D5 (列を流用)
    行 top / home / bottom / thumbD9 / D8 / D7 / D6
    電源JST(BAT_P) → 電源SW → VBAT (モジュール裏パッド、基板のスルーホール経由で半田付け)
    リセットXIAO 本体ボタン (1回=リセット、素早く2回=ブートローダ)
    空きD10 (+ Plus 裏面の D11〜D19)
  • ダイオード: 1N4148W (SOD-123)、col2row。帯マーク (カソード) が行ネット側。
  • マウントホール: M2 NPTH ×4/枚。

発注 (JLCPCB の例)

  1. jlcpcb.com で gerbers/first_left.zip をアップロード → 2層 / 1.6mm / 1oz / HASL でそのまま注文 (最低5枚)
  2. first_right.zip も同様に注文 (別設計扱い)
  3. 部品: Choc v2 スイッチ×44、Choc ソケット×44、1N4148W×44+予備、XIAO nRF52840 Plus×2、 JST PH 2P×2、電源SW (Alps SSSS811101)×2、502030 LiPo×2

メンテナンスの流れ

回路図ファイル (.kicad_sch) は存在しません。config.yaml が回路図に相当する一次ソースで、 接続定義 (from/to) はすべてそこに書かれています。回路を変更するときは config を編集して再生成し、 Freerouting で再ルーティングします (このリポジトリの履歴と配線図ドキュメントを参照)。

Parts

51
QtyValueFootprintReferences
22ceoloide:switch_choc_v1_v2S1, S2, S3, S10, S11, S12, S13, S14, S15, S16, S17, S18, S19, S20, S21, S22 +6
22ceoloide:diode_tht_sod123D1, D2, D3, D10, D11, D12, D13, D14, D15, D16, D17, D18, D19, D20, D21, D22 +6
4ceoloide:mounting_hole_npthMH1, MH2, MH3, MH4
1ceoloide:power_switch_smd_sidePWR1
1local:mcu_xiao_nrf52840_plusMCU1
1ceoloide:battery_connector_jst_ph_2JST1

Similar boards

  • 2 layers216.9 × 86.8 mmSweepv2, the printed circuit board in 3D

    Sweepv2

    davidphilipbarr/Sweep

    Sweep - a small promicro based keyboard inspired by the Ferris.

    51 parts2.1k
  • 2 layers49.4 × 94.2 mmPin board 1, the printed circuit board in 3D

    Pin board 1

    rusefi/rusefi

    rusefi - GPL internal combustion engine control unit

    51 parts1.2k
  • 2 layers72 × 42 mmNRF24 jammer, the printed circuit board in 3D

    NRF24 jammer

    W0rthlessS0ul/nRF24_jammer

    The nRF24 jammer is a powerful tool that requires an ESP32 and configurable numbers of NRF24 modules to assemble.

    51 parts1kMIT
  • 2 layers170 × 162 mmSnowflake, the printed circuit board in 3D

    Snowflake

    hackclub/OnBoard

    💡 Join 1,000 teenagers and make your first PCB with a $100 grant!

    51 parts915
  • 2 layers33 × 50 mmESP32-bat monitor latch, the printed circuit board in 3D

    ESP32-bat monitor latch

    pcbreflux/espressif

    all espressif stuff will committed here

    51 parts608GPL-3.0
  • 2 layersTUSS4470 shield, the printed circuit board in 3D

    TUSS4470 shield

    Neumi/open_echo

    Open Source echo sounder / depth sounder / SONAR for bathymetry and research. Arduino based and compatible.

    51 parts530
  • 2 layers45.7 × 123.5 mmMASTER ARM PANEL, the printed circuit board in 3D

    MASTER ARM PANEL

    jrsteensen/OpenHornet

    OpenHornet 1:1 F/A-18C Simulator Repository

    51 parts431
  • 2 layers50.8 × 69.2 mmUikit, the printed circuit board in 3D

    Uikit

    vsfteam/vsf

    Versaloon Software Framework -- a tiny preemptive-capable event-driven incremental software framework for embedded systems

    51 parts341Apache-2.0

Questions

How big is the First left PCB?

It measures 134.2 × 100 mm and has 2 copper layers, 1.6 mm thick.

What parts does the First left use?

51 parts. 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 First left KiCad files?

From the sunda-eimami/ULTRA_KEYBOARDS repository on GitHub, at the commit this page was made from: the board is kicad/first_left.kicad_pcb. PCBKit opens the board in the browser, with nothing to install.

Can I use the First left design in my own project?

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