Skip to the content
2 layers52.8 × 49 mmAttachment2, the printed circuit board in 3D

Custom ESP32 BLE HID controller + matching PCB design.

Size
52.8 × 49 mm
Copper layers
2
Thickness
1.6 mm
Parts
6
Nets
22
Pads
54
Tracks, vias
94, 0
Routed
Yes
KiCad
KiCad 9.0 (file 20241229)
Created
14 Jun 2025
Updated
16 Feb 2026

Overview

Attachment2 is an open-source printed circuit board by ZBZFirst, from the ZBZFirst/KiCad-Projects repository on GitHub. It is a 2-layer board of 52.8 × 49 mm with 6 parts on 22 nets, routed with 94 tracks and 0 vias.

README

README.md

ESP32 Controller


Reference Images

PCB Layout

Attachment

Finished Build


Custom ESP32 BLE HID controller + matching PCB design.

This project combines:

  • ESP32 firmware (BLE composite keyboard + mouse)
  • KiCad PCB layout for a dedicated 7-button controller
  • Multi-mode input system for productivity + automation

Designed as a personal hardware controller that behaves like a wireless keyboard/mouse macro pad.


Features

  • BLE composite HID device (keyboard + mouse)
  • 7 physical buttons
  • Mode switching system
  • Auto-click / auto-key spam mode
  • Windows quick-launch macros
  • Non-blocking firmware architecture
  • Visual LED status patterns
  • Custom PCB layout (KiCad)

Hardware

Board

ESP32-based custom PCB with:

  • 7 tactile switches
  • Onboard LED status indicator
  • ESP32 dev module header
  • Dedicated GPIO routing per button

KiCad layout included in repository.

File:

text
hardware/Controller.kicad_pcb

This board is designed specifically to run the included firmware.


Firmware Behavior

The controller has 3 operating groups.

Button 6 cycles groups.
Button 7 forces disconnect (reboot).


Group 1 — Default Productivity

ButtonAction
B1Ctrl + C
B2Ctrl + V
B3Ctrl + X
B4Ctrl + Z
B58-second mouse movement run

LED: solid ON when connected


Group 2 — Work Launch Macros

ButtonAction
B1Windows search → cmd → ssh CB37
B2Launch Edge
B3Launch Super
B4Launch Arduino
B5Launch Bluetooth

LED: 2 blink pattern


Group 3 — Auto Mode

Toggle behaviors:

ButtonMode
B1Auto left click
B2Auto right click
B3Auto middle click
B4Spam key “E”
B5Spam key “F”

Press the same button again to stop.

LED: 3 blink pattern


LED Status

  • Off → not connected
  • Solid → group 1
  • 2 blinks → group 2
  • 3 blinks → group 3

Blink sequence repeats every 2 seconds.


Installation

Requirements

  • Arduino IDE
  • ESP32 board package
  • NimBLE / BLE HID libraries

Open:

text
firmware/PaulsESP32.ino

Compile and upload to the board.


Usage

  1. Power the controller
  2. Pair over Bluetooth
  3. Use button 6 to select mode
  4. Use buttons 1–5 for actions

Designed primarily for Windows but functions as a generic BLE HID device.


Project Structure

text
firmware/
  PaulsESP32.ino

hardware/
  Controller.kicad_pcb
  schematics/

Credits

PCB + firmware design: Paul Casillas
Artwork: Bree Pierce

Personal project.


License

MIT — free to modify and build.

file is in

AutoClicker/AutoClickerbyController.ino

Parts

6
QtyValueFootprintReferences
14 Pin ConnectorUserDefined:MPU6050HiLetGOMPU1
1ESP 32 RSUserDefined:ESP32-DEVKITV1-Paul-Half2ESP32RightSide1
1SPISDCardConnector_PinHeader_2.54mm:PinHeader_1x06_P2.54mm_VerticalSDCardBoard1
1~UserDefined:LPS22AdaLPS1
1~UserDefined:Adafruit GPS PA1010DAdaGPS1
1~UserDefined:SHTBoardAdaSHT1

More from ZBZFirst/KiCad-Projects

5
  • 2 layers45.3 × 75.9 mmController, the printed circuit board in 3D

    Controller

    ZBZFirst/KiCad-Projects

    Custom ESP32 BLE HID controller + matching PCB design.

    14 parts1
  • 2 layers25.4 × 17.8 mmSHT40, the printed circuit board in 3D

    SHT40

    ZBZFirst/KiCad-Projects

    Custom ESP32 BLE HID controller + matching PCB design.

    5 parts1
  • 2 layers25.4 × 17.8 mmLPS22, the printed circuit board in 3D

    LPS22

    ZBZFirst/KiCad-Projects

    Custom ESP32 BLE HID controller + matching PCB design.

    3 parts1
  • 2 layersReceiver, the printed circuit board in 3D

    Receiver

    ZBZFirst/KiCad-Projects

    Custom ESP32 BLE HID controller + matching PCB design.

    3 parts1
  • 2 layersGlove, the printed circuit board in 3D

    Glove

    ZBZFirst/KiCad-Projects

    Custom ESP32 BLE HID controller + matching PCB design.

    2 parts1

Similar boards

  • 2 layers18.5 × 11.1 mmSwitch, the printed circuit board in 3D

    Switch

    byrantech/laptop

    anyon_e, a highly integrated, high end, open source laptop. Attempt the impossible.

    6 parts4.3kMIT
  • 2 layers14.6 × 33 mmBrain board SD Card 1, the printed circuit board in 3D

    Brain board SD Card 1

    rusefi/rusefi

    rusefi - GPL internal combustion engine control unit

    6 parts1.2k
  • 2 layers9 × 9 mmDpoint, the printed circuit board in 3D

    Dpoint

    Jcparkyn/dpoint

    Open-source digital stylus using camera tracking and inertial measurements

    6 parts1.1kMIT
  • 2 layers51.5 × 16.6 mmMicroswitchXY Endstop, the printed circuit board in 3D

    MicroswitchXY Endstop

    VoronDesign/Voron-Hardware

    Cool Hardware designed by the Voron Design group

    6 parts1.1kGPL-3.0
  • 2 layers21.9 × 76.7 mmAmiga External, the printed circuit board in 3D

    Amiga External

    hoglet67/RGBtoHDMI

    Bare-metal Raspberry Pi project that provides pixel-perfect sampling of Retro Computer RGB/YUV video and conversion to HDMI

    6 parts1kGPL-3.0
  • 2 layers88.9 × 50.8 mmBusinesscard, the printed circuit board in 3D

    Businesscard

    hackclub/OnBoard

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

    6 parts915
  • 2 layers20.3 × 15.2 mmL0 RGB led, the printed circuit board in 3D

    L0 RGB led

    Luos-io/luos_engine

    Open-source and real-time orchestrator for cyber-physical-systems, to easily design, test and deploy embedded applications and digital twins.

    6 parts546MIT
  • 2 layers9 × 3.6 mmOpticalEncoder, the printed circuit board in 3D

    OpticalEncoder

    adamb314/ServoProject

    Getting the most out of your hobby servo

    6 parts545

Questions

How big is the Attachment2 PCB?

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

What parts does the Attachment2 use?

6 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 Attachment2 KiCad files?

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

Can I use the Attachment2 design in my own project?

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