Skip to the content
2 layersReceiver, the printed circuit board in 3D

Custom ESP32 BLE HID controller + matching PCB design.

Copper layers
2
Thickness
1.6 mm
Parts
3
Nets
38
Pads
58
Tracks, vias
22, 0
Routed
Yes
KiCad
KiCad 9.0 (file 20241229)
Created
14 Jun 2025
Updated
16 Feb 2026

Overview

Receiver is an open-source printed circuit board by ZBZFirst, from the ZBZFirst/KiCad-Projects repository on GitHub. It is a 2-layer board with 3 parts on 38 nets, routed with 22 tracks and 0 vias.

It is built around the ADS1115IDGS. Its parts include 1 IC and 1 connector.

Main components

1

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

3
QtyValueFootprintReferences
1ADS1115IDGSUserDefined:ADS1115FootPrintU1
1AveaLogicConnector_Dsub:DSUB-25_Pins_Horizontal_P2.77x2.84mm_EdgePinOffset9.90mm_Housed_MountingHolesOffset11.32mmJ1
1~UserDefined:ESP32-DEVKITV1-Paul-Half2ESP32 Right Side1

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 layers52.8 × 49 mmAttachment2, the printed circuit board in 3D

    Attachment2

    ZBZFirst/KiCad-Projects

    Custom ESP32 BLE HID controller + matching PCB design.

    6 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 layersGlove, the printed circuit board in 3D

    Glove

    ZBZFirst/KiCad-Projects

    Custom ESP32 BLE HID controller + matching PCB design.

    2 parts1

Similar boards

  • 4 layers70 × 43 mmUSMU v10, the printed circuit board in 3D

    USMU v10

    joeltroughton/uSMU

    Credit card-sized, USB-powered 4 quadrant source-measure unit hardware and firmware

    137 parts187
  • 4 layers66.3 × 40.2 mmCm4 drone, the printed circuit board in 3D

    Cm4 drone

    dridri/bcflight

    Raspberry Pi based drone flight controller and remote control

    56 parts175GPL-3.0
  • 4 layers192.1 × 126.9 mmStradex1, the printed circuit board in 3D

    Stradex1

    Bylin-code/Stradex1

    STRADEX1 Documentation and Build Instructions ============== I've always wanted to put my violin skills to use in a MIDI environment, but there really isn't a controller on the market that can emulate the feel of a…

    24 parts101
  • 4 layers100 × 49.8 mmExpansion board, the printed circuit board in 3D

    Expansion board

    reubenstr/zuko

    A quadruped robot dog!

    75 parts51MIT
  • 2 layers96 × 74.4 mmMonolith, the printed circuit board in 3D

    Monolith

    luftaquila/monolith

    DIY wireless real-time datalogging platform for Student Formula and Baja.

    138 parts45
  • 4 layers160 × 73.2 mmMainPCB, the printed circuit board in 3D

    MainPCB

    doppelgrau/esp32-f9p-io-board

    An IO-PCB (two motor-driver/H-bridge, CAN, RS232, ADS1115, relay, ethernet, ardusimple f9p compatible connector) with an ESP32 for 12V power, three 15V tolerant analog inputs, three 5V tolerant inputs.

    162 parts39
  • 2 layers140.7 × 86.5 mmUPD board, the printed circuit board in 3D

    UPD board

    uniclogs/uniclogs-hardware

    University Class Open Ground Station Hardware

    185 parts32GPL-3.0
  • 4 layers20 × 30 mmNanoAmmeter v2, the printed circuit board in 3D

    NanoAmmeter v2

    joeltroughton/nanoAmmeter

    A small ammeter for measuring printed glucose biosensors

    35 parts29

Questions

What parts does the Receiver use?

3 parts, built around the ADS1115IDGS. 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 Receiver KiCad files?

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

Can I use the Receiver design in my own project?

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