

Attachment2
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.mdESP32 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:
hardware/Controller.kicad_pcbThis 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
| Button | Action |
|---|---|
| B1 | Ctrl + C |
| B2 | Ctrl + V |
| B3 | Ctrl + X |
| B4 | Ctrl + Z |
| B5 | 8-second mouse movement run |
LED: solid ON when connected
Group 2 — Work Launch Macros
| Button | Action |
|---|---|
| B1 | Windows search → cmd → ssh CB37 |
| B2 | Launch Edge |
| B3 | Launch Super |
| B4 | Launch Arduino |
| B5 | Launch Bluetooth |
LED: 2 blink pattern
Group 3 — Auto Mode
Toggle behaviors:
| Button | Mode |
|---|---|
| B1 | Auto left click |
| B2 | Auto right click |
| B3 | Auto middle click |
| B4 | Spam key “E” |
| B5 | Spam 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:
firmware/PaulsESP32.inoCompile and upload to the board.
Usage
- Power the controller
- Pair over Bluetooth
- Use button 6 to select mode
- Use buttons 1–5 for actions
Designed primarily for Windows but functions as a generic BLE HID device.
Project Structure
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| Qty | Value | Footprint | References |
|---|---|---|---|
| 1 | 4 Pin Connector | UserDefined:MPU6050HiLetGO | MPU1 |
| 1 | ESP 32 RS | UserDefined:ESP32-DEVKITV1-Paul-Half2 | ESP32RightSide1 |
| 1 | SPISDCard | Connector_PinHeader_2.54mm:PinHeader_1x06_P2.54mm_Vertical | SDCardBoard1 |
| 1 | ~ | UserDefined:LPS22 | AdaLPS1 |
| 1 | ~ | UserDefined:Adafruit GPS PA1010D | AdaGPS1 |
| 1 | ~ | UserDefined:SHTBoard | AdaSHT1 |
More from ZBZFirst/KiCad-Projects
5- 2 layers45.3 × 75.9 mm

- 2 layers25.4 × 17.8 mm

- 2 layers25.4 × 17.8 mm

- 2 layers

- 2 layers

Similar boards
- 2 layers18.5 × 11.1 mm

Switch
byrantech/laptop
anyon_e, a highly integrated, high end, open source laptop. Attempt the impossible.
6 parts4.3kMIT - 2 layers14.6 × 33 mm

- 2 layers9 × 9 mm

Dpoint
Jcparkyn/dpoint
Open-source digital stylus using camera tracking and inertial measurements
6 parts1.1kMIT - 2 layers51.5 × 16.6 mm

MicroswitchXY Endstop
VoronDesign/Voron-Hardware
Cool Hardware designed by the Voron Design group
6 parts1.1kGPL-3.0 - 2 layers21.9 × 76.7 mm

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 mm

Businesscard
hackclub/OnBoard
💡 Join 1,000 teenagers and make your first PCB with a $100 grant!
6 parts915 - 2 layers20.3 × 15.2 mm

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 mm

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.