Skip to the content
2 layers100 × 255.2 mmKombucha, the printed circuit board in 3D

キーキャップをつけて完成です。 こちらのファームウェアを書き込んでください。XIAO RP2040のBのスイッチを押す代わりに、XIAO RP2040に一番近いキーを押しながらUSBケーブルを繋ぐことでRPI-RP2のドライブを出すことが出来ます。 - tarohayashikombuchastickstick.uf2 - 後期型向け tarohayashikombuchastickstick.uf2

Size
100 × 255.2 mm
Copper layers
2
Thickness
1.6 mm
Parts
84
Nets
51
Pads
526
Tracks, vias
857, 74
Pours
2
Routed
Yes
KiCad
KiCad 6 (file 20211014)
Created
25 Jan 2023
Updated
24 May 2026

Overview

Kombucha is an open-source printed circuit board by Taro-Hayashi, from the Taro-Hayashi/Kombucha2 repository on GitHub. It is a 2-layer board of 100 × 255.2 mm with 84 parts on 51 nets, routed with 857 tracks and 74 vias.

Its parts include 11 diodes, 11 switches and 4 connectors. It belongs with the RP2040 boards of this library.

README

README.md

Kombucha ジョイスティック 左手向けビルドガイド(右手向け)

キット内容

部品名数
1メインボード1
2トッププレート1
3ボトムプレート1
4ジョイスティック基板1
5アクリルプレート4
6スペーサー(細)(短)4黄銅・3mm
7スペーサー(細)(長)4黄銅・7mm
8スペーサー(太)(短)9ステンレス・7mm
9スペーサー(太)(長)12ステンレス・16mm
10ねじ(短)14黒
11ねじ(長)12銀
12スプリング2
13ピンヘッダ(短)25ピン
14ピンヘッダ(長)17 or 8ピン
147ピンヘッダ2XIAO RP2040用
15ピンソケット(短)1
16ピンソケット(長)1
17スイッチソケット9
18ホイールエンコーダー111mm
19ホイール1
20ジョイスティック1
21キャップ1
22タクタイルスイッチ17.5mm
23タクタイルスイッチSMD17mm
24ダイオード11
25LED9
26ゴム足4

キット以外に必要なもの

部品名数
XIAO RP20401TALP KEYBOARD、秋月電子通商
Cherry MX互換キースイッチ1TALP KEYBOARD、遊舎工房
Cherry MX互換キーキャップ(1U)1TALP KEYBOARD、遊舎工房
Type-C USB ケーブル1遊舎工房、秋月電子通商、100円均一など

必要な工具

工具名
はんだごて
はんだ
精密ドライバー
ニッパー

準備

左右を決める

このキットは基板の表裏を変えることで左手用と右手用を作り分けることができます。
どちらの面にどの部品を実装するかが基板に書いてあるので参考にしてください。

基板には初期型と後期型が存在し、2023年5月分の在庫では混在しています(今後は後期型に統一されます)。後期型の場合基板に書いてありますのでご確認ください。

XIAO RP2040にテストファームウェアを書き込む

こちらのファイルをダウンロードしてください。

基板上の右のBのボタンを押しながらPCに接続するとRPI-RP2というドライブとして認識されます。
ダウンロードしたファイルを書き込むとXIAO RP2040をキーボードとして使えるようになります。

はんだ付け

ボトムプレートのはんだ付け

左右を確認してボトムプレートにピンソケット2つをはんだ付けします。

ボトムプレートのピンソケットと同じ面にスペーサー(太)(短)をねじ(短)で止めます。黄丸の4箇所にはスペーサー(細)(長)を使います。
反対の面にはゴム足を貼ります。

ジョイスティック基板のはんだ付け

ジョイスティック基板にジョイスティックをはんだ付けします。
ジョイスティックが中央に戻らないことがありますが、アクリルプレートを取り付ける前の正常な動作です。

ボトムプレートのピンソケットに5ピンヘッダを立てます。短い方を差しました。
後期型の場合は画像のピンを開けて差し込んでください。違っているとネジ穴が合わないので確認してから半田付けしてください。

ジョイスティック基板をスペーサー(細)(長)の上にのせ、スペーサー(太)(長)でボトムプレートに固定します。

飛び出たピンヘッダをニッパーで切りはんだ付けしましょう(ギリギリまで切りすぎるとうまくはんだ付けできないことがあります)。

ジョイスティックにキャップを取り付けます。

メインボードのはんだ付け

LEDをはんだ付けします。欠けている方向と白い線が合うように置きます。

XIAO RP2040を7ピンヘッダーではんだ付けします。両面をはんだ付けします。

USBケーブルを接続してLEDが発光することを確かめてください。光らない場合は向きが間違っていたりどこかでショートしていたりはんだ付けが足りない可能性があります。

USBケーブルを抜いてください。はんだ付けの作業は通電していない状態で行います。
この後も部品を取り付けるごとにその部品の動作を確認するとトラブルの原因を突き止めやすいです。

ダイオードを折り曲げて差し込み、固定するためにさらに曲げます。表裏を指定してありますがどちら側でも構いません。
ダイオードには向きがあるので、黒線と基板の矢印の向きを合わせてください。

はんだ付けをしたら足をニッパーで切ります。

スイッチソケットをはんだ付けします。裏表に注意してください。

メインボードにホイールエンコーダーとタクタイルスイッチ(足が下に伸びている方)をはんだ付けします。表裏に注意してください。

ボトムプレートにピンヘッダを差し込みます。

ボトムプレートにメインボードを載せ、スペーサー(太)(長)でボトムプレートに固定します。トッププレートで隠れる黄丸の一箇所だけはねじ(短)で止めます。
飛び出たピンヘッダをニッパーで切ってはんだ付けしましょう。テストファームウェアではジョイスティックは動作しません。

トッププレートの4隅にスイッチを差し込みます。差し込みが硬い場合はここですべてのスイッチを固定してしまう方がいいかもしれません(スイッチの種類によって変わります)。

スペーサーを通してメインボードに乗せ、キースイッチがスイッチソケットに入るように押し込みます。
キースイッチのピンが曲がらないように気をつけてください。

全てのスイッチを差し込み、ホイールをホイールエンコーダーに差し込みます。

アクリルプレートから保護フィルムを剥がして、ねじ(長)で止めます。

キーキャップをつけて完成です。 こちらのファームウェアを書き込んでください。XIAO RP2040のBのスイッチを押す代わりに、XIAO RP2040に一番近いキーを押しながらUSBケーブルを繋ぐことでRPI-RP2のドライブを出すことが出来ます。

カスタマイズ

LEDを消したい時は親指クラスタ(最下段)の奥のキーを押しながらジョイスティックを押し込んでください。

ジョイスティックを含めた全てのキーはVIAというWebサイト(もしくはアプリケーション)で好きなものに変更することができます。
こちらのJSONファイルをダウンロードしてください。

Google Chrome(Microsoft Edge)を利用して下記webサイトにアクセスするか、VIAのアプリケーションをダウンロードして起動してください。

DESIGNタブのLoadでダウンロードしたJSONファイルを読み込ませるとキーの変更が出来るようになります(アプリ版ではまずShow Design tabをオンにしてください)。

CONFIGUREタブのAuthorize device+からKombuchaを追加してください。

左右の変更

LAYOUTSから見た目の左右を変更することができます。

ホイールの割り当てキー

キーマップ変更画面で上部の丸をクリックするとホイールを回転させた時と押し込んだ時に入力されるキーを変更することができます。

その他の利用方法

ジョイスティックでマウスカーソルを動かすことも可能で、その場合はこちらのファイルをダウンロードしてファームウェアを書き換えてください。

認識が不安定ですが、こちらのファームウェアを書き込むことでKombuchaをゲームパッドとして認識させることもできます。

標準では親指クラスタの真ん中のキーを長押しするとカーソル/ジョイパッドの方向を変更できます。

機能(カーソル)機能(パッド)キーコード
X軸反転CUSTOM(65)
Y軸反転CUSTOM(66)
XY逆転方向変更CUSTOM(67)

SPECIALタブのAnyで割り当てることができます。

ジョイスティックの補正

WindowsではスタートメニューにJOY.CPLと打ち込むとスティックの補正ができます。

プロパティから調整を選びウィザードに従ってください。

上手く動かない場合はゲームパッドとしてではなく通常のファームウェアにカーソルキーやWASDを割り当ててお使いください。

meishi Trackball Moduleを使う

はんだ付け

一度分解し、ボトムプレートにタクタイルスイッチSMDをはんだ付けします。
ピンヘッダーが有る側の2箇所はスペーサー(細)(長)、無い側の2箇所はスペーサー(細)(短)をねじ止めします。 meishi Trackball Moduleを基板から切り離してください。
meishi Trackball Module互換基板を使う場合はこちらをご覧ください。

ジョイスティックの時と同様にピンヘッダを立てモジュール付属のねじを使って基板の位置を決めたらはんだ付けします。
後期型の場合は画像のピンを開けて差し込んでください。違っているとネジ穴が合わないので確認してから半田付けしてください。

はんだ付けをしたらねじを一度はずしてモジュール基板を取り外し、センサーの保護フィルムをはがしてレンズとボールケースを取り付けます。

ピンヘッダーのない側にスペーサー(細)(短)をねじで止めます。

スペーサーの上にスプリングを立てます。 ねじでスペーサー(細)(長)側も止めるとボールのクリックができるようになります。 組み立て直したら完成です。

ファームウェアはこちらをお使いください。

トラックボールの調整

標準では親指クラスタの真ん中のキーを押しながらボールの左右のキーを押すとセンサーの感度(CPI)を増減できます。その下のキーを押すとマウスカーソルの上下左右の十字方向と10°の微調整が可能です。

機能キーコード
CPI増CUSTOM(65)
CPI増CUSTOM(66)
角度増CUSTOM(67)
角度減CUSTOM(67)

SPECIALタブのAnyで割り当てることができます。

その他

ファームウェアのフォルダ

ファームウェアまとめ

※5/21 後期版向けのファームウェアを追加しました。

VIA用JSON

アクリルプレートのデータ

DXF、SVG、kicadファイルが入っています。

謝辞

aki27さんのコードを参考にトラックボール用のファームウェアを書きました。

販売サイト

Parts

84
QtyValueFootprintReferences
20Hole_kbdth:Hole_2mm_M2H1, H2, H3, H4, H5, H6, H10, H11, H12, H13, H14, H15, H16, H17, H18, H20 +4
11D_kbdth:DIP_Diode_ReversibleD1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11
9SW_PUSH_kbdth:Slit_Keyswitchswh1, swh2, swh3, swh4, swh5, swh6, swh7, swh8, swh9
9SW_PUSH_kbdth:Switch_Cherry_MX_Socket_ReversibleSW1, SW2, SW3, SW4, SW5, SW6, SW7, SW8, SW9
8YS-SK6812MINI-E_kbdth:LED_SK6812MINI-E_Backlight_NoHoleBLF1, BLF2, BLF3, BLF4, BLF5, BLF6, BLF7, BLF8
8YS-SK6812MINI-E_kbdth:LED_SK6812MINI-E_BacklightBLB1, BLB2, BLB3, BLB4, BLB5, BLB6, BLB7, BLB8
4Breakaway_Tabs_kbdth:Hole_Breakaway_Tabsb1, b2, b3, b4
3Hole_kbdth:Hole_4mm_SpacerH7, H41, H51
2Conn_01x06_kbdth:Hole_PinHeader_1x06_P2.54mm_VerticalJ2, J3
2Conn_01x08_Female_kbdth:PinHeader_1x08_P2.54mm_VerticalJ1, J4
2SW_PUSH_kbdth:Switch_Tactile_SMDSW10, SW11
2Switch_Tactile_kbdth:Switch_TactileTac, Tac
1Rotary_Encoder_kbdth:Encoder_Wheel_11mm+7.5mm_reversibleWheel1
1XIAO-RP2040_kbdth:MCU_XIAO_RP2040M1
1YS-SK6812MINI-E_Backlight_kbdth:LED_SK6812MINI-E_BacklightBLB9
1YS-SK6812MINI-E_Backlight_kbdth:LED_SK6812MINI-E_Backlight_NoHoleBLF9

More from Taro-Hayashi/Kombucha2

3
  • 2 layers99.9 × 93.5 mmKombucha back, the printed circuit board in 3D

    Kombucha back

    Taro-Hayashi/Kombucha2

    キーキャップをつけて完成です。 こちらのファームウェアを書き込んでください。XIAO RP2040のBのスイッチを押す代わりに、XIAO RP2040に一番近いキーを押しながらUSBケーブルを繋ぐことでRPI-RP2のドライブを出すことが出来ます。 - tarohayashikombuchastickstick.uf2 - 後期型向け tarohayashikombuchastickstick.uf2

    24 parts10
  • 2 layers37.1 × 37.1 mmTrackball, the printed circuit board in 3D

    Trackball

    Taro-Hayashi/Kombucha2

    キーキャップをつけて完成です。 こちらのファームウェアを書き込んでください。XIAO RP2040のBのスイッチを押す代わりに、XIAO RP2040に一番近いキーを押しながらUSBケーブルを繋ぐことでRPI-RP2のドライブを出すことが出来ます。 - tarohayashikombuchastickstick.uf2 - 後期型向け tarohayashikombuchastickstick.uf2

    12 parts10
  • 2 layers37.1 × 37.1 mmJoystick, the printed circuit board in 3D

    Joystick

    Taro-Hayashi/Kombucha2

    キーキャップをつけて完成です。 こちらのファームウェアを書き込んでください。XIAO RP2040のBのスイッチを押す代わりに、XIAO RP2040に一番近いキーを押しながらUSBケーブルを繋ぐことでRPI-RP2のドライブを出すことが出来ます。 - tarohayashikombuchastickstick.uf2 - 後期型向け tarohayashikombuchastickstick.uf2

    6 parts10

Similar boards

  • 2 layers182.2 × 116.6 mmRight, the printed circuit board in 3D

    Right

    hackclub/OnBoard

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

    84 parts915
  • 2 layers94.5 × 81.5 mmESP32-wroover adapter pan, the printed circuit board in 3D

    ESP32-wroover adapter pan

    pcbreflux/espressif

    all espressif stuff will committed here

    84 parts608GPL-3.0
  • 2 layers45.8 × 38.3 mmFramework input brkt, the printed circuit board in 3D

    Framework input brkt

    CRImier/MyKiCad

    My KiCad boards. Can't be bothered uploading individually anymore, so here you go.

    84 parts253GPL-3.0
  • 2 layers194.5 × 73.2 mmWizza xiao, the printed circuit board in 3D

    Wizza xiao

    AlaaSaadAbdo/battoota

    Keyboards

    84 parts188
  • 2 layers149.8 × 80 mmEDM Motherboard [23.04.20], the printed circuit board in 3D

    EDM Motherboard [23.04.20]

    Rack-Robotics/Powercore-V1.0-Hardware

    CAD & Electronics for Powercore V1

    84 parts168
  • 2 layers72.5 × 76.4 mmBox emu, the printed circuit board in 3D

    Box emu

    esp-cpp/esp-box-emu

    Star Wars: Dark Forces, Doom, NES, Gameboy/Color, Sega Master System / GameGear, Sega Genesis / MegaDrive, and MSX I/II Emulators running on ESP BOX and ESP BOX-3 with a custom gamepad

    84 parts148MIT
  • 2 layers100 × 100 mmVga, the printed circuit board in 3D

    Vga

    imihajlow/ccpu

    A 8-bit computer made of 74xx series logic gates and memory ICs.

    84 parts145
  • 2 layers106.1 × 155 mmMotherboard, the printed circuit board in 3D

    Motherboard

    Redherring32/OpenTendo-TopLoader

    An Open Source HardWare (OSHW) recreation of the 1993 toploading NES motherboard (Also known as NES-101)

    84 parts94

Questions

How big is the Kombucha PCB?

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

What parts does the Kombucha use?

84 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 Kombucha KiCad files?

From the Taro-Hayashi/Kombucha2 repository on GitHub, at the commit this page was made from: the board is KiCad/kombucha.kicad_pcb and its schematic KiCad/kombucha.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Kombucha design in my own project?

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