Skip to the content
2 layers62 × 80 mmAgentpad rev2 single, the printed circuit board in 3D

Agentpad rev2 single

ymmtr6/agent-pad

RP2040-Zero を使った、8 キー+ロータリーエンコーダーのマクロパッドです。基板(KiCad)、3D プリント外装・キーキャップ、QMK ファームウェア、VIA 定義をまとめています。

Size
62 × 80 mm
Copper layers
2
Thickness
1.6 mm
Parts
14
Nets
13
Pads
85
Tracks, vias
1,218, 28
Routed
Yes
KiCad
KiCad 8 (file 20240108)
Created
14 Oct 2026
Updated
15 Oct 2026

Overview

Agentpad rev2 single is an open-source printed circuit board by ymmtr6, from the ymmtr6/agent-pad repository on GitHub, published under the MIT licence. It is a 2-layer board of 62 × 80 mm with 14 parts on 13 nets, routed with 1,218 tracks and 28 vias.

Its parts include 8 switches and 1 IC. It belongs with the RP2040 boards of this library.

README

README.md

AgentPad

RP2040-Zero を使った、8 キー+ロータリーエンコーダーのマクロパッドです。基板(KiCad)、3D プリント外装・キーキャップ、QMK ファームウェア、VIA 定義をまとめています。

現行版は Rev2(単一基板・裏面ホットスワップ)です。

Rev2 基板(表面)

Rev2 の仕様

  • 基板:62 × 80 × 1.6 mm、四隅に M2 用 Ø2.2 mm 穴
  • キー:MX 互換スイッチ 8 個(19.05 mm ピッチ、3+3+2 配列)
  • ソケット:Kailh CPG151101S11(基板裏面に実装、スイッチは表面から挿す)
  • エンコーダー:EC11(右下、押し込み付き)
  • MCU:Waveshare RP2040-Zero-M
  • USB VID/PID:0x4150 / 0xA902

詳しい寸法は docs/REV2_SINGLE_PCB.md と manifest_rev2.json を参照してください。

デフォルトのキーマップ

左中央右
上段F13F14F15
中段F16F17F18
下段F19F20エンコーダー押し込み:Mute

エンコーダーは反時計回りで音量を下げ、時計回りで上げます。

macOS では F14/F15 が標準で画面の明るさに割り当てられています。システム設定 > キーボード > キーボードショートカット > ディスプレイ で無効にするか、キーを割り当て直してください。

ファームウェアの書き込み

ビルド済みの UF2 が firmware/build/ にあります。

ファイル内容
agent_pad_rev2_via.uf2VIA 対応版(キーマップを VIA で変更できる)
agent_pad_rev2_default.uf2固定キーマップ版
  1. データ通信対応の USB-C ケーブルで PC につなぐ。
  2. BOOT と RESET を同時に押し、RESET を離してから BOOT を離す。
  3. RPI-RP2 ドライブが現れたら、UF2 ファイルをコピーする。
  4. ドライブが消え、AgentPad Rev2 として再起動する。

RESET を素早く 2 回押してもブートローダーに入れます。

VIA でキーマップを変更する

AgentPad は VIA の公式リストに登録していないため、定義ファイルを手動で読み込みます。先に VIA 対応版の UF2 を書き込んでおいてください。

  1. firmware/via/agentpad_rev2.json をダウンロードする。
  2. Chrome または Edge で https://usevia.app を開く。
  3. Settings で「Show Design tab」を有効にする。
  4. Design タブの「Load Draft Definition」で、ダウンロードした JSON を選ぶ。
  5. Configure タブで「Authorize device」を押し、AgentPad Rev2 を選ぶ。

8 キーとエンコーダーの押し込み・左右回転を変更できます。

ファームウェアのビルド

QMK Firmware の公式リポジトリにキーボード定義をコピーしてビルドします。

sh
rsync -a firmware/qmk/keyboards/agent_pad/rev2/ \
  /path/to/qmk_firmware/keyboards/agent_pad/rev2/
cd /path/to/qmk_firmware
make agent_pad/rev2:via

詳しい手順と検証結果は firmware/readme.md にあります。

基板の製造

JLCPCB に発注する Gerber は manufacturing/agentpad_rev2_single_gerber.zip です。発注設定は docs/JLCPCB_ORDER_REV2.md、検証結果は docs/VALIDATION_REV2.md を参照してください。

基板データは生成スクリプトから作り直せます。

sh
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
AGENTPAD_OUT=/tmp/agentpad_rev2_single_build .venv/bin/python scripts/generate_agentpad_rev2.py
scripts/run_kicad_drc.sh rev2

DRC の実行には KiCad 9 の kicad-cli が必要です。

外装とキーキャップ

G-code は Creality Ender-3 V3 SE と PLA 用です。USB 接続での印刷手順は docs/ENDER3_V3_SE_USB_PRINTING.md を参照してください。

ディレクトリ構成

パス内容
kicad/KiCad 基板データとフットプリント
scripts/基板データの生成スクリプト、DRC 実行スクリプト
gerber/, manufacturing/生成済みの Gerber と発注用 ZIP
firmware/QMK キーボード定義、ビルド済み UF2、VIA 定義
cad/外装・キーキャップの 3D データ
docs/設計メモ、発注手順、検証結果、画像

Rev1(2 枚構成の旧版)のデータも含まれています。

ライセンス

MIT License です。

ただし firmware/ 以下は QMK Firmware 向けのコードと、QMK を含めてビルドした UF2 なので、QMK に合わせて GPL-2.0-or-later とします。

Parts

14
QtyValueFootprintReferences
8Kailh MX HotswapKailh_MX_Hotswap_1USW1, SW2, SW3, SW4, SW5, SW6, SW7, SW8
4M2 NPTH / head max 4mmMountingHole_2.2mm_M2H1, H2, H3, H4
1EC11E push encoderRotaryEncoder_Alps_EC11E-Switch_Vertical_H20mmENC1
1RP2040-Zero-M (visible top)RP2040-Zero-M_Header_TopU1

More from ymmtr6/agent-pad

1
  • 2 layers68 × 80 mmAgentpad rev1 lower, the printed circuit board in 3D

    Agentpad rev1 lower

    ymmtr6/agent-pad

    RP2040-Zero を使った、8 キー+ロータリーエンコーダーのマクロパッドです。基板(KiCad)、3D プリント外装・キーキャップ、QMK ファームウェア、VIA 定義をまとめています。

    10 partsMIT

Similar boards

  • 2 layers116.8 × 30 mmType d, the printed circuit board in 3D

    Type d

    google/mozc-devices

    Circuit diagrams and firmware source code for Gboard DIY keyboards

    14 parts3kApache-2.0
  • 2 layers32 × 22 mmDiff driver, the printed circuit board in 3D

    Diff driver

    rene-dev/stmbl

    AC Servo Driver for STM32F4

    14 parts990GPL-3.0
  • 2 layers34 × 45 mm2032Charger, the printed circuit board in 3D

    2032Charger

    hackclub/OnBoard

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

    14 parts915
  • 2 layers34 × 109.9 mmTdisplay s3, the printed circuit board in 3D

    Tdisplay s3

    landonr/homeThing

    Wifi Smart Home Remotes that run on ESPHome

    14 parts551GPL-3.0
  • 2 layers45.3 × 42.7 mmMainPcb, the printed circuit board in 3D

    MainPcb

    adamb314/ServoProject

    Getting the most out of your hobby servo

    14 parts545
  • 2 layers42.5 × 28.8 mmC5VRX JACK DIY, the printed circuit board in 3D

    C5VRX JACK DIY

    Twotoz/C5VRX

    Ultra-minimal, zero-CPU 5.8 GHz analog FPV video receiver using ESP32-C5 Wi-Fi 6 PHY MODEM_DIAG, BitScrambler WBFM demodulation & resistor DAC CVBS

    14 parts515GPL-3.0
  • 2 layers62 × 24 mmMai button, the printed circuit board in 3D

    Mai button

    whowechina/mai_pico

    Pico controller for Maimai

    14 parts475

Questions

How big is the Agentpad rev2 single PCB?

It measures 62 × 80 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Agentpad rev2 single use?

14 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 Agentpad rev2 single KiCad files?

From the ymmtr6/agent-pad repository on GitHub, at the commit this page was made from: the board is kicad/agentpad_rev2_single.kicad_pcb. PCBKit opens the board in the browser, with nothing to install.

Can I use the Agentpad rev2 single design in my own project?

Its repository publishes it under the MIT licence: you may reuse it on that licence's terms (keep the author's notice, and for a copyleft licence share your changes alike).