一、项目概述

HomeKey-ESP32-PCB 是一套全开源一体化墙装 Apple HomeKey NFC 读卡器硬件方案，基于 ESP32-C3 主控芯片开发，在 rednblkx HomeKey-ESP32 固件基础上完成硬件重新设计。项目将主控、NFC 射频前端、板载同轴 NFC 天线全部集成在单块 PCB 上，无需外接 PN532 等 NFC 模块，电路板尺寸适配欧洲 503 标准暗盒，支持隐藏预埋在墙面开关底盒内，对接苹果 HomeKit，实现 iPhone、Apple Watch 钱包内 HomeKey 钥匙刷卡开门。整套硬件工程基于 KiCad 设计，原理图、PCB 源文件、生产光绘文件、物料清单、3D 模型全部开源开放，爱好者可自行打板、修改、二次开发。

二、设计背景

市面上已有的 ESP32 HomeKey 方案大多采用开发板外接 PN532 NFC 读卡模块的接线方案，接线繁杂、体积大，很难隐藏安装，不适合墙面预埋。为解决部署痛点，本项目做硬件重构：取消外置模块与外接天线，把整套读卡电路压缩到适配标准暗盒的 PCB 内，完工后仅保留原有墙面面板，读卡设备完全隐藏，兼顾美观度与 HomeKey NFC 门禁能力。

三、核心功能与特性

1. 高度集成一体化硬件 板载 ESP32-C3 主控、NFC 射频前端与同轴调谐 NFC 天线，不需要额外外挂 NFC 模块与天线，单块板子即可完成 WiFi 联网、NFC 读卡、HomeKit 协议交互。

2. 暗盒隐藏式安装 PCB 尺寸适配欧式 503 暗盒，可直接放入墙内预埋底盒，安装后无外露设备，适合家装隐蔽式门禁改造。

3. 原生兼容上游 HomeKey 固件 直接运行成熟的 HomeKey-ESP32 固件，完整实现 Apple HomeKey 协议、HomeKit HAP 接入流程，支持苹果家庭 App 配网、添加钥匙、刷卡解锁。

4. 完整开源硬件交付物 仓库提供 KiCad 分层原理图、PCB 工程、Gerber 生产文件、BOM 物料清单、装配 3D STEP 模型，支持使用者直接送厂打板，也可修改电路、调整布局做定制化改造。

5. 两种固件烧录方式 支持esptool.py命令行烧录，同时兼容浏览器在线烧录工具，无需搭建复杂 ESP-IDF 开发环境，降低上手门槛。

四、工作流程

1. 硬件焊接与供电：PCB 焊接完成后接入供电，装入墙面 503 暗盒；

2. WiFi 配网：设备启动后开启临时配网热点，接入并配置家庭 WiFi；

3. HomeKit 配对：使用 iPhone 扫描 HomeKit 配对码，将读卡器添加至苹果家庭；

4. 钥匙下发：在家庭 App 中添加 Apple HomeKey 钥匙到苹果钱包；

5. 刷卡解锁：iPhone 或 Apple Watch 贴近读卡器，NFC 识别后触发开门动作。

五、开源与风险说明

本项目通过逆向工程实现 Apple HomeKey 协议，不属于苹果官方产品，未获得苹果认证，项目基于 MIT 协议开源。

⚠️ 重要风险提示：本方案仅适合爱好者 DIY 研究，不推荐直接用于高安全等级、生命安全相关门禁场景，使用产生的风险由使用者自行承担。Apple、Apple HomeKey、HomeKit 为苹果公司注册商标。

六、License

MIT License

七、项目地址

https://github.com/lollokara/HomeKey-ESP32-PCB