Skip to the content
2 layers41.6 × 47.3 mmHomekey, the printed circuit board in 3D

HomeKey-ESP32-PCB A miniaturized, wall-mountable HomeKey reader board

Size
41.6 × 47.3 mm
Copper layers
2
Thickness
1.6 mm
Parts
71
Nets
73
Pads
288
Tracks, vias
468, 149
Pours
309
Routed
Yes
KiCad
KiCad 8.0 (file 20240108)
Created
3 Jul 2024
Updated
7 Jul 2026

Overview

Homekey is an open-source printed circuit board by lollokara, from the lollokara/HomeKey-ESP32-PCB repository on GitHub. It is a 2-layer board of 41.6 × 47.3 mm with 71 parts on 73 nets, routed with 468 tracks and 149 vias.

It is built around the ESP32-C3-WROOM-02-H4, TLV75533PDRV and PMEG2010BER. Its parts include 33 capacitors, 15 resistors, 4 ICs, 3 diodes and 3 connectors. It belongs with the ESP32 and RISC-V boards of this library.

Main components

3

README

README.md

HomeKey-ESP32-PCB

A miniaturized, wall-mountable HomeKey reader board

A custom PCB implementation of rednblkx/HomeKey-ESP32 that brings Apple HomeKey NFC unlocking into a form factor small enough to hide behind your existing wall plate.

License: MIT

HomeKey-ESP32-PCB 3D render

What is this?

This project is a hardware redesign of the excellent HomeKey-ESP32 firmware by @rednblkx. Instead of using a separate development board wired to a breakout PN532 module, everything is integrated onto a single, compact PCB.

The board packs an ESP32-C3 and an NFC reader front-end with an on-board coaxial NFC antenna into a footprint designed to fit inside a European 503 (3-module) flush-mount wall box. This lets you install a fully functional Apple HomeKey reader directly behind a standard wall plate — no external modules, no messy wiring.

Key Highlights

  • All-in-one PCB — ESP32-C3 + NFC front-end + coaxial antenna on a single board
  • Fits a European 503 plug slot — designed for standard flush-mount wall boxes
  • Integrated coaxial NFC antenna — tuned on-board antenna, no external coil needed
  • Runs the original HomeKey-ESP32 firmware — full Apple HomeKey / HomeKit compatibility
  • Fully open hardware — designed in KiCad, with schematics, layout, Gerbers and a 3D model included

Get the Board

Don't want to fabricate it yourself? You can order the PCB directly from PCBWay:

➡️ ESP32 HomeKey on PCBWay

Designed in KiCad

The entire board is designed with KiCad, so the complete hardware source is open and editable. The repository includes:

  • Hierarchical KiCad schematics (Homekey.kicad_sch, ESP32.kicad_sch, NFC.kicad_sch, Power.kicad_sch, Square.kicad_sch)
  • KiCad PCB layout (Homekey.kicad_pcb) and project file (Homekey.kicad_pro)
  • Exported schematic PDF (Homekey.pdf)
  • Bill of Materials (Homekey.xlsx)
  • A 3D model of the assembly (Homekey 3D.step.zip)

You can open the project directly in KiCad to review, modify, or re-fabricate the board.

Repository Structure

text
HomeKey-ESP32-PCB/
├── Firmware/              # HomeKey-ESP32 firmware (based on the original repo)
├── Gerbers/               # Fabrication-ready Gerber files
├── ESP32.kicad_sch        # ESP32-C3 subsheet
├── NFC.kicad_sch          # NFC front-end + antenna subsheet
├── Power.kicad_sch        # Power supply subsheet
├── Square.kicad_sch       # Additional subsheet
├── Homekey.kicad_sch      # Top-level schematic
├── Homekey.kicad_pcb      # PCB layout
├── Homekey.kicad_pro      # KiCad project file
├── Homekey.pdf            # Schematic (PDF export)
├── Homekey.xlsx           # Bill of Materials
├── Homekey-job.gbrjob     # Gerber job file
├── Homekey 3D.step.zip    # 3D model of the board
├── Homekey-3D-render.png  # 3D render of the assembled board
└── README.md

Getting Started

1. Get the Board

  • Buy it ready-made: order the PCB directly from PCBWay.
  • Fabricate it yourself: use the ready-to-order files in the Gerbers folder with your preferred PCB fab house.
  • Refer to Homekey.xlsx for the Bill of Materials and Homekey.pdf for the schematic.
  • To modify the design first, open Homekey.kicad_pro in KiCad.

2. Flash the Firmware

The board runs the standard HomeKey-ESP32 firmware. The Firmware folder contains a build based on the original repository.

bash
# Install esptool (one-time setup)
pip install esptool

# Flash the firmware (replace YOUR_PORT)
esptool.py --port YOUR_PORT write_flash 0x0 firmware.factory.bin

Prefer a GUI? Use the browser-based flasher — no command line needed.

For firmware configuration, pairing, and usage, follow the official documentation:

3. Install & Pair

  1. Mount the board inside your 503 wall box behind the plate.
  2. Connect to the device's setup WiFi AP and configure your WiFi + HomeKit setup code.
  3. Pair with Apple Home and start unlocking with a tap of your iPhone or Apple Watch. 🎉

Credits

  • @rednblkx — creator of the original HomeKey-ESP32 firmware this board is built for
  • @kormax — reverse-engineered the HomeKey NFC protocol
  • @kupa22 — researched the HAP side of HomeKey

License

This project is licensed under the MIT License — see the LICENSE file for details.

Disclaimer

This project implements Apple HomeKey functionality through reverse engineering.

  • Not affiliated with, nor condoned by, Apple Inc.
  • Use at your own risk for security-critical applications.
  • Apple, iPhone, and Apple Watch are trademarks of Apple Inc.
  • ESP32 is a trademark of Espressif Systems (Shanghai) Co., Ltd.

Parts

71
QtyValueFootprintReferences
1010uFCapacitor_SMD:C_0805_2012MetricC3, C6, C10, C11, C13, C25, C27, C30, C31, C33
5100nFCapacitor_SMD_AKL:C_0603_1608MetricC5, C7, C8, C9, C14
4100nFCapacitor_SMD:C_0603_1608MetricC2, C12, C28, C32
410KResistor_SMD_AKL:R_0603_1608MetricR1, R10, R11, R12
422pFCapacitor_SMD_AKL:C_0603_1608MetricC1, C4, C20, C21
3TestPointTestPoint:TestPoint_THTPad_1.5x1.5mm_Drill0.7mmGND1, RX1, TX1
21R5 1%Resistor_SMD_AKL:R_0603_1608MetricR4, R5
21uFCapacitor_SMD:C_0603_1608MetricC26, C34
2220R@100MhzInductor_SMD:L_0603_1608MetricFB1, FB2
2220pFCapacitor_SMD_AKL:C_0603_1608MetricC16, C17
222R 1%Resistor_SMD_AKL:R_0603_1608MetricR8, R9
2560nHInductor_SMD:L_0805_2012MetricL1, L2
25K1 1%Resistor_SMD_AKL:R_0603_1608MetricR6, R7
275RResistor_SMD_AKL:R_0603_1608MetricR13, R15
2CK_KMS2xxGButton_Switch_SMD:SW_SPST_CK_KMS2xxGPBOOT1, RST1
2NCCapacitor_SMD_AKL:C_0603_1608MetricC18, C19
1100pFCapacitor_SMD:C_0603_1608MetricC22
1100pFCapacitor_SMD_AKL:C_0603_1608MetricC23
1150RResistor_SMD_AKL:R_0603_1608MetricR14
11K 1%Resistor_SMD_AKL:R_0603_1608MetricR2
11K69 1%Resistor_SMD_AKL:R_0603_1608MetricR3
11nFCapacitor_SMD_AKL:C_0603_1608MetricC15
11nFCapacitor_SMD:C_0603_1608MetricC24
127.12MHzCrystal:Crystal_SMD_3225-4Pin_3.2x2.5mmY1
1330uHInductor_SMD:L_Bourns_SRN6045TAL3
1ESP32-C3-WROOM-02RF_Module:ESP32-C3-WROOM-02U1
1HiroseConnector_Coaxial:U.FL_Hirose_U.FL-R-SMT-1_VerticalJ1
1Inolux_IN-P55TATRGBLED_SMD:LED_Inolux_IN-P55TATRGB_PLCC6_5.0x5.5mm_P1.8mmD3
1MAX17501AxTBPackage_DFN_QFN:TDFN-10-1EP_2x3mm_P0.5mm_EP0.9x2mmU3
1MBR0570Diode_SMD:D_SOD-123D1
1PMEG2010BERDiode_SMD:Nexperia_CFP3_SOD-123WD2
1PN5321A3HN_C1xxPackage_DFN_QFN:HVQFN-40-1EP_6x6mm_P0.5mm_EP4.1x4.1mmU2
1SEL0Jumper:SolderJumper-3_P2.0mm_Open_TrianglePad1.0x1.5mmSEL0
1SEL1Jumper:SolderJumper-3_P2.0mm_Open_TrianglePad1.0x1.5mmSEL1
1Screw_Terminal_01x02TerminalBlock_Phoenix:TerminalBlock_Phoenix_MPT-0,5-2-2.54_1x02_P2.54mm_HorizontalJ2
1TLV75533PDRVPackage_SON:WSON-6-1EP_2x2mm_P0.65mm_EP1x1.6mmU4
1USB_C_Receptacle_USB2.0_16PConnector_USB:USB_C_Receptacle_GCT_USB4110J3

Similar boards

  • 4 layers58.9 × 48.4 mmApppd, the printed circuit board in 3D

    Apppd

    chithigun23/ANUFS-APPPD

    An update to the Accelerator Pedal Position Plausibility Device to remain compliant with the use of a paddle shift system.

    103 parts
  • 4 layers80 × 80 mmTelemetry, the printed circuit board in 3D

    Telemetry

    chithigun23/ANUFS-Telemetry

    To use custom hardware to measure parameters and dynamics of an ICE Formula SAE car.

    159 parts
  • 4 layers23 × 51 mmMemboard, the printed circuit board in 3D

    Memboard

    DEV-ajthedj/memboard

    A custom development board aimed at maximizing the RAM of an RP2350A.

    41 parts
  • 4 layers65 × 49.8 mm2.5in IDE SSD no lengthmatch, the printed circuit board in 3D

    2.5in IDE SSD no lengthmatch

    dosdude1/2.5-inch-ide-ssd

    A custom-designed IDE SSD for use in any machine that utilizies a 2.5" IDE hard disk.

    91 parts334GPL-3.0
  • 6 layers26 × 25 mmTektag, the printed circuit board in 3D

    Tektag

    teklabsdigital/TekTag

    Biosensor for telehealth, patient monitoring, fall detection, dementia geofencing and cardiograms

    93 parts18
  • 4 layers52.5 × 59.7 mmESPHome Indoor Multi Sensor, the printed circuit board in 3D

    ESPHome Indoor Multi Sensor

    mikelawrence/esphome-indoor-multi-sensor-hardware

    ESPHome Indoor Multi-Sensor hardware. This design supports Radar/PIR Presence, Temperature, Humidity, Pressure, Light, CO2, CO, VOC, NOX and PM sensors.

    113 parts14CERN-OHL-P-2.0
  • 2 layers31 × 17 mmUsbCarrierMM8108, the printed circuit board in 3D

    UsbCarrierMM8108

    JeffersonSchostakovich/halowBoards

    MM8108-based adapters in different form factors for EU availability of sub-GHz halow 802.11ah hardware - mainly for decentralised networking (Reticulum mesh) and distributed IoT experimentation purposes.

    23 parts8
  • 2 layers46 × 15.2 mmTots, the printed circuit board in 3D

    Tots

    mimok/yast-hw

    Hardware source files of the YAST security token from OTS Security

    29 parts6CC-BY-4.0

Questions

How big is the Homekey PCB?

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

What parts does the Homekey use?

71 parts, built around the ESP32-C3-WROOM-02-H4, TLV75533PDRV and PMEG2010BER. 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 Homekey KiCad files?

From the lollokara/HomeKey-ESP32-PCB repository on GitHub, at the commit this page was made from: the board is Homekey.kicad_pcb and its schematic ESP32.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Homekey design in my own project?

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