2 layers50 × 23.2 mm
Analog
hoglet67/RGBtoHDMI
Bare-metal Raspberry Pi project that provides pixel-perfect sampling of Retro Computer RGB/YUV video and conversion to HDMI
32 parts1kGPL-3.0
2 layers16 × 20 mm
ESPKey
JakobPetersson/ESPKeyWiegand data logger, replay device and micro door-controller
- Size
- 16 × 20 mm
- Copper layers
- 2
- Thickness
- 1.6 mm
- Parts
- 32
- Nets
- 25
- Pads
- 86
- Tracks, vias
- 262, 25
- Pours
- 2
- Routed
- Yes
- KiCad
- KiCad 9.0 (file 20241229)
- Created
- 6 Sep 2025
- Updated
- 6 Sep 2025
Overview
ESPKey is an open-source printed circuit board by JakobPetersson, from the JakobPetersson/ESPKey repository on GitHub, published under the GPL-2.0 licence. It is a 2-layer board of 16 × 20 mm with 32 parts on 25 nets, routed with 262 tracks and 25 vias.
Its parts include 18 resistors, 4 capacitors, 3 transistors, 2 ICs and 2 connectors. It belongs with the ESP8266 boards of this library.
README
README.mdWhat the heck is this anyway?
ESPKey is a small device which can be implanted into facility access control systems. ESPKey is compatible with pretty much every door that requires a card swipe or tap with optional pin code to unlock. It even works on many systems requiring finger print or other biometric authentication. Inserting an ESPKey behind a card reader is better than a skimmer because not only can it log all authorized use of a system, it can also inject or replay captured credentials. Once ESPKey shows you what credentials work on this door, use your favorite RFID tools to clone or simulate those credentials for use on other doors. Want to show someone how insecure their facility is? This is an incredibly easy way to start.
In case you need a simple access control system to play with, ESPKey can do that too. All you need is a card reader, ESPKey and some device to be controlled (like a door lock, electric strike, magnetic lock or just an indicator light). ESPKey replaces the giant door controller, allowing you to build a simple mobile test lab. Or a great little portable RFID credential sponge, ready to be hand carried or installed in any heavily trafficked area.
Releases
Have a look over here for the latest pre-built firmware and UI release.
Build instructions
- Install PlatformIO Core
- Run these commands:
# Build project
$ pio run# Upload firmware
$ pio run --target upload# Build specific environment
$ pio run -e esp12# Upload firmware for the specific environment
$ pio run -e esp12 --target upload# Clean build files
$ pio run --target clean- Launch html_src/publish.sh to generate ui-update.sh. When connected to ESPKey's web server, launch ui-update.sh to upload the files that make the web UI.
Usage
Check out this great documentation put together by Babak of Red Team Tools.
Hardware
Hardware can be purchased or have a look in the hardware directory if you want to build your own.
Parts
32| Qty | Value | Footprint | References |
|---|---|---|---|
| 11 | 12k7 | Resistors_SMD:R_0402 | R4, R5, R6, R7, R8, R9, R10, R12, R13, R15, R16 |
| 3 | 22k | Resistors_SMD:R_0402 | R11, R14, R17 |
| 3 | 2N7002 | TO_SOT_Packages_SMD:SOT-23 | Q1, Q2, Q3 |
| 2 | 100n | Capacitors_SMD:C_0603 | C2, C5 |
| 2 | 22u | Capacitors_SMD:C_0805 | C1, C4 |
| 2 | 75k | Resistor_SMD:R_0603_1608Metric | R1, R2 |
| 1 | 24k | Resistor_SMD:R_0603_1608Metric | R3 |
| 1 | 3.6uH | Custom_Inductors:ELL4_M-small | L1 |
| 1 | 330 | Resistors_SMD:R_0402 | R18 |
| 1 | ESP-12 | ESP8266:ESP-12-SMD | U2 |
| 1 | LOGO | OmegaPwn v3.0 Logo:Untitled | G*** |
| 1 | PWR | LEDs:LED_0603 | D1 |
| 1 | Power | Connector_IDC_SMD:SSL_DW_IDC_02 | P1 |
| 1 | RT6212A/B | TO_SOT_Packages_SMD:SOT-23-6 | U1 |
| 1 | Wiegand | Connector_IDC_SMD:SSL_DW_IDC_03 | P2 |
Questions
How big is the ESPKey PCB?
It measures 16 × 20 mm and has 2 copper layers, 1.6 mm thick.
What parts does the ESPKey use?
32 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 ESPKey KiCad files?
From the JakobPetersson/ESPKey repository on GitHub, at the commit this page was made from: the board is hardware/kicad/ESPKey.kicad_pcb and its schematic hardware/kicad/ESPKey.kicad_sch. PCBKit opens the board in the browser, with nothing to install.
Can I use the ESPKey design in my own project?
Its repository publishes it under the GPL-2.0 licence: you may reuse it on that licence's terms (keep the author's notice, and for a copyleft licence share your changes alike).
Similar boards
- 2 layers136.8 × 54.2 mm
Retropie zero
hackclub/OnBoard
💡 Join 1,000 teenagers and make your first PCB with a $100 grant!
32 parts915 - 2 layers
- 2 layers16 × 20 mm
ESPKey
octosavvi/ESPKey
Wiegand data logger, replay device and micro door-controller
32 parts353GPL-2.0 - 2 layers82 × 40.9 mm
Display7447
zmaker/arduino_cookbook
gli sketch del nuovo progetto Arduino Cookbook e dei video di YouTube
32 parts269 - 2 layers40 × 38 mm
Shield
murexrobotics/electrical
Highly integrated electronics design and printed circuit boards (PCBs) for the MATE ROV Competition. Attempt the impossible.
32 parts192MIT - 2 layers47 × 39 mm
Qrss clock tx
swharden/AVR-projects
A collection of standalone AVR projects written in C
32 parts184MIT - 2 layers30.9 × 63 mm
Stm32-io extend
hardenedlinux/cheap-pcb
Cheap PCB: Better understanding the current status of hardware supply chain
32 parts170CC0-1.0