Skip to the content
PCBKitNew board
2 layers118 × 118 mmInput main, the printed circuit board in 3D

Input main

hdh7485/agent-deck

Physical AI agent controller for Codex, Hermes, OMX, and tmux workflows

Open in PCBKitView on GitHub.kicad_pcb
Size
118 × 118 mm
Copper layers
2
Thickness
1.6 mm
Parts
74
Nets
62
Pads
316
Tracks, vias
23, 0
Pours
2
Routed
Yes
KiCad
KiCad 10.0 (file 20260206)
Created
15 Jul 2026
Updated
16 Jul 2026

Overview

Input main is an open-source printed circuit board by hdh7485, from the hdh7485/agent-deck repository on GitHub. It is a 2-layer board of 118 × 118 mm with 74 parts on 62 nets, routed with 23 tracks and 0 vias.

It is built around the MCP23017-E/SO, SN74AHCT1G125DBVR(UMW) and TPS2553DBVR-1, with the 1N4148W and SK6812MINI-E among its other parts. Its parts include 24 diodes, 18 capacitors, 12 switches, 7 resistors and 4 ICs.

Main components

5

README

README.md

Agent Deck

Codex, Hermes, OMX, tmux 같은 AI 에이전트 작업을 물리적으로 제어하고 상태를 RGB로 표시하는 데스크톱 컨트롤러 프로젝트입니다.

이 프로젝트는 공개된 제품 경험을 참고하되, 공개되지 않은 OpenAI Micro의 회로·펌웨어·프로토콜을 추정하거나 복제하지 않습니다. 목표는 기능적으로 유사한 사용자 경험을 제공하는 독자 설계입니다.

V1 범위

  • PCB 고정형 MX 호환 기계식 키 12개, Kailh 핫스왑 소켓, 키별 다이오드. 터치 오른쪽 K11은 기본 2u 마이크/PTT 키
  • 전체 12키 개별 RGB 상태 표시
  • 클릭 가능한 로터리 엔코더 1개
  • 낮은 원형 오목 캡을 씌운 5방향 디지털 내비게이션 스위치 1개
  • 단일 원형 정전식 터치 패드 1개
  • XIAO ESP32-S3 Plus와 XIAO nRF52840 Plus 비교 평가
  • USB HID, Vendor HID, BLE HID 및 상태 통신 실험
  • Codex/Hermes/OMX/tmux 상태를 정규화하는 PC 브리지
  • USB 전원 우선 검증 후 1셀 Li-Po 평가

OLED나 LCD는 사용하지 않습니다. 모든 입력 부품은 브레드보드가 아니라 입력 PCB에 직접 실장합니다.

현재 기준 설계

V1은 공용 입력 PCB와 MCU별 어댑터 보드를 사용합니다. 입력 PCB에는 키 매트릭스, MCP23017, 내비게이션 스위치, 정전식 터치 IC, 엔코더, RGB LED 및 전원 보호 회로를 두고, 어댑터는 XIAO 보드별 핀·전원·USB 차이를 흡수합니다.

  • 키 12개: 5핀 MX 호환 스위치, Kailh CPG151101S11-16 핫스왑 소켓, 다이오드를 포함한 4×4 매트릭스. K11은 호스트 음성 입력을 누르는 동안만 여는 기본 PTT 매핑
  • MCP23017: 키 매트릭스, 5방향 스위치, 터치 출력 처리
  • 엔코더 A/B/클릭: MCU 직접 연결
  • 터치: AT42QT1010 계열 외부 IC 우선
  • RGB: 5V 주소 지정 LED, 74AHCT1G125 레벨 시프터, 전류 제한 전원 스위치
  • USB-C: V1에서는 장착한 XIAO의 온보드 USB-C를 케이스 밖으로 노출
  • 배터리: 어댑터 측에서 각 XIAO의 충전·배터리 회로를 사용하고 공용 PCB에 충전기를 중복하지 않음

이 결정은 회로도 작성 전 공식 회로도 대조와 벤치 실험으로 다시 검증합니다.

KiCad V1 엔지니어링 드래프트

Agent Deck V1 common input PCB perspective

현재 저장소에는 다음 실제 KiCad 설계 소스가 있습니다.

  • 공용 입력 PCB: 12키, 12다이오드, 키별 RGB 12개, MCP23017, EC11, 5방향 입력, AT42QT1010 터치, TPS2553 RGB 전류 제한, AHCT 레벨 시프터
  • XIAO ESP32-S3 Plus 전용 어댑터
  • XIAO nRF52840 Plus 전용 어댑터
  • 세 보드의 블록 회로도와 재현 가능한 생성 스크립트

이 파일은 부품 배치와 전기 넷을 검토하기 위한 엔지니어링 드래프트입니다. 장거리 배선은 정확한 스위치·내비게이션·커넥터·플레이트 치수를 확정한 뒤 수동 라우팅하므로 아직 PCB 제작용 릴리스가 아닙니다. 현재 검증 결과와 남은 DRC 항목은 KiCad 검증 기록에 있습니다.

3D 프린트 케이스 핏체크

Agent Deck V1 top control layout

Agent Deck V1 enclosure exploded view

현재 PCB 좌표에서 생성한 하판, 상부 베젤, 12키 1.5 mm MX 플레이트 STL이 mechanical/exports/v1-fit-check/에 있습니다. 공개 외형처럼 상단은 엔코더–키 2개–조이스틱, 하단은 터치–2u PTT–보조 키로 배치했습니다. 모든 키캡은 각인 없는 검정 반투명 스모크 재질을 의도하며, 1u와 2u 키를 19 mm 격자와 1.8 mm 명목 간격으로 정렬했습니다. 공용 PCB는 118 × 118 mm, 케이스 외형은 125.8 × 125.8 × 17.0 mm의 정사각형입니다. 정확한 2u 스태빌라이저·스위치·USB·배터리·터치 치수가 아직 확정되지 않았으므로 양산 케이스가 아니라 조립 간섭을 찾기 위한 출력용 초안입니다.

문서 지도

제작 순서

  1. 두 MCU의 최소 펌웨어와 통신 경로를 개발 보드에서 검증
  2. 공식 핀맵·회로도와 선택 부품 데이터시트로 회로도 작성
  3. 입력 PCB와 MCU 어댑터 PCB 설계 및 DRC/ERC
  4. 스위치 플레이트 설계
  5. 케이스와 USB/안테나/배터리 간섭 검증
  6. 조립 및 전기적 안전 검사
  7. USB/BLE/입력/RGB/전력/재연결/위험 동작 E2E 테스트

상태

V1 공용 입력 PCB와 두 MCU 어댑터의 KiCad 엔지니어링 드래프트를 만들었고, 세 블록 회로도는 ERC를 통과했습니다. PCB는 배치·넷리스트 검토 단계이며 부품 규격을 잠근 뒤 수동 라우팅, DRC 정리, 플레이트/케이스 3D 간섭 검증을 진행해야 합니다. 펌웨어와 PC 브리지는 아직 구조 문서 단계입니다.

Parts

74
QtyValueFootprintReferences
12100nF LED localC_0603_1608MetricC1, C2, C3, C4, C5, C6, C7, C8, C9, C10, C11, C12
121N4148WD_SOD-123D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12
12SK6812MINI-ELED_SK6812MINI-E_3.2x2.8mm_P1.5mm_ReverseMountLED1, LED2, LED3, LED4, LED5, LED6, LED7, LED8, LED9, LED10, LED11, LED12
11MX 1u hot-swap / CPG151101S11-16AgentDeck:MX_1u_Kailh_CPG151101S11-16_HotswapSW1, SW2, SW3, SW4, SW5, SW6, SW7, SW8, SW9, SW10, SW12
4M3MountingHole_3.2mm_M3H1, H2, H3, H4
1100k EN pulldownR_0603_1608MetricR3
1100nFC_0603_1608MetricC21
1100nF MCP23017C_0603_1608MetricC22
110k OE pullupR_0603_1608MetricR4
110nF C0G touch candidateC_0603_1608MetricC20
110uF 10V X7R 3V3 railC_1206_3216MetricC32
110uF 10V X7R LED railC_1206_3216MetricC31
114 mm circular touch electrodeAgentDeck:Touch_Electrode_14mmE1
1150uF 10V low-profile polymer candidateCP_EIA-7343-31_Kemet-DC30
11k touch seriesR_0603_1608MetricR1
1232k 1% ILIM (~117mA typ)R_0603_1608MetricR2
1330R RGB dataR_0603_1608MetricR5
14.7k SCL pullupR_0603_1608MetricR7
14.7k SDA pullupR_0603_1608MetricR6
1AT42QT1010-TSHRSOT-23-6U2
1COMMON_MCU_ADAPTER_2x10PinSocket_2x10_P2.54mm_VerticalJ1
1EC11E15244G1 candidateRotaryEncoder_Alps_EC11E-Switch_Vertical_H20mmENC1
1MCP23017-E/SOSOIC-28W_7.5x17.9mm_P1.27mmU1
1MMBT3904 RGB OE inverterSOT-23Q1
1MX 2u PTT hot-swap / stabilizer TBD / CPG151101S11-16AgentDeck:MX_1u_Kailh_CPG151101S11-16_HotswapSW11
1RKJXM1015004 low-profile stick candidate / land pattern provisionalAgentDeck:Nav_RKJXM1015004_ELECTRICAL_PLACEHOLDERNAV1
1SN74AHCT1G125DBVRSOT-23-5U4
1TPS2553DBVRSOT-23-6U3

Questions

How big is the Input main PCB?

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

What parts does the Input main use?

74 parts, built around the MCP23017-E/SO, SN74AHCT1G125DBVR(UMW), TPS2553DBVR-1 and 1N4148W. 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 Input main KiCad files?

From the hdh7485/agent-deck repository on GitHub, at the commit this page was made from: the board is hardware/kicad/input-main/input-main.kicad_pcb and its schematic hardware/kicad/adapters/xiao-esp32s3-plus/xiao-esp32s3-plus.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Input main design in my own project?

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

More from hdh7485/agent-deck

2
  • 2 layers76 × 38 mmXiao esp32s3-plus, the printed circuit board in 3D

    Xiao esp32s3-plus

    hdh7485/agent-deck

    Physical AI agent controller for Codex, Hermes, OMX, and tmux workflows

    7 parts
  • 2 layers76 × 38 mmXiao nrf52840-plus, the printed circuit board in 3D

    Xiao nrf52840-plus

    hdh7485/agent-deck

    Physical AI agent controller for Codex, Hermes, OMX, and tmux workflows

    7 parts

Similar boards

  • 2 layers250.2 × 84.2 mmGemini panel, the printed circuit board in 3D

    Gemini panel

    thanoslabs/keyboards

    Schematics, pcbs, layout files for all my keyboard projects

    151 parts
  • 6 layers90 × 90 mmCodex micro wired revA route nognd, the printed circuit board in 3D

    Codex micro wired revA route nognd

    slopus/codex-keybored

    A 100% vibe-coded hardware build: Fusion 360, six-layer KiCad PCB, STM32 firmware, and live JLC factory handoff.

    97 parts10
  • 2 layers178 × 711 mmMSAP-2 rev.A SMD, the printed circuit board in 3D

    MSAP-2 rev.A SMD

    mehrantsi/MSAP-2

    An 8-bit computer. Successor to MSAP-1

    658 parts13MIT
  • 4 layers52 × 74 mmFRC Sensor CAN, the printed circuit board in 3D

    FRC Sensor CAN

    barkinvar/sugerCANe

    A compact interface for three NPN, PNP or logic sensors on an FRC robot. Each port has a removable 5 V / 12 V power jumper; input type is configured in software.

    144 parts1
  • 4 layers150 × 107.5 mmBase, the printed circuit board in 3D

    Base

    bornier-dev/bornier

    Open source EtherCAT slaves for machine tools running LinuxCNC: hardware, firmware and tooling.

    517 parts
  • 4 layers120 × 100 mmHotel test illustrative, the printed circuit board in 3D

    Hotel test illustrative

    rbrtwtrs/A2D-Test

    Rev A ESP32-P4 Nano bench simulator/operator1.2. Companion: https://github.com/rovshop/herc-hotel-p4-firmware

    162 parts
  • 2 layers228.6 × 79.4 mmTzarc keyboards ghoul, the printed circuit board in 3D

    Tzarc keyboards ghoul

    punkfab/pcb-corpus

    235 real KiCad boards from open-source hardware repositories, prepared as a placement and routing benchmark

    191 parts1
  • 2 layers208.8 × 396.9 mmFerris, the printed circuit board in 3D

    Ferris

    pierrechevalier83/ferris

    A low profile split keyboard designed to satisfy one single use case elegantly

    145 parts1.3k