HomeKey-ESP32
HomeKey-ESP32
1️⃣ HomeKey-ESP32 프로젝트 살펴보기
| 항목 | 내용 |
|---|---|
| 목적 | ESP32 + PN532 조합만으로 Apple Home Key(NFC) 기능을 DIY 잠금장치에 구현하기 위한 오픈소스 펌웨어 |
| 주요 HW | • ESP32 dev board • PN532 NFC 모듈(SPI) • 선택 : W5500·DM9051 등 이더넷 PHY 지원 GitHub |
| 라이선스 | MIT License GitHub |
| 최근 상태 | 2025-11-22 기준 10번째 릴리스, ★ 798 · 포크 57 GitHub |
✨ 핵심 기능
Apple Home Key 완전 지원
Express Mode(화면·Face ID 불필요), Power Reserve(배터리 5시간 예비 전원), iPhone·Apple Watch 동시 지원, 300 ms 이하 인증
스마트홈 연동 : HomeKit 네이티브·MQTT(HA, OpenHAB)·복합 Lock State 지원
웹 UI & OTA : Svelte 5 + Tailwind, 실시간 WebSocket 로그, 브라우저 플래셔 지원
모듈형 C++ 아키텍처 : NFC/Lock/Web/MQTT/Config 매니저로 역할 분리, 확장성 우수
구분 | 설명 |
|---|---|
ESP32의 역할 | Apple HomeKey 인증 절차를 수행하는 NFC 리더기 역할을 합니다. 일반적인 NFC 태그를 읽는 수준을 넘어, Apple의 보안 요구사항을 충족하고 기기와 안전하게 통신해야 합니다. |
NFC 신호 처리 | 1. PN532 NFC 모듈이 iPhone/Apple Watch에서 전송되는 HomeKey NFC 신호를 수신합니다. |
최종 동작 | 인증이 성공하면, ESP32는 해당 사용자 정보를 MQTT 메시지로 발행합니다. 이 메시지는 Home Assistant와 같은 스마트 홈 플랫폼에서 "잠금 해제" 명령을 실행하는 트리거로 사용됩니다. |
'인증 절차 구현': ESP32 자체가 HomeKit 및 HomeKey의 복잡한 보안 및 인증 절차를 자체적으로 구현하여, Apple 기기가 이 ESP32 장치를 정식 HomeKey 리더기로 인식하고 통신하도록 만드는 것입니다.
2️⃣ Apple Home Key 심층 세션
Home Key란?
iOS 15에서 도입된 지갑(Apple Wallet) 기반 디지털 집-키로, iPhone 또는 Apple Watch를 잠금장치 NFC 리더에 툭 대면 즉시 열립니다.
Apple HomeKey(홈 키)는 iPhone 또는 Apple Watch를 사용하여 NFC(근거리 무선 통신) 방식으로 호환되는 스마트 도어락의 잠금을 해제할 수 있게 해주는 기능입니다. 전통적인 열쇠나 도어락 비밀번호 대신, 사용자의 Apple 기기를 디지털 키로 활용하는 것입니다.
이 기능은 Apple의 스마트 홈 플랫폼인 HomeKit에 통합되어 있으며, 사용자에게 높은 편리성과 보안을 동시에 제공합니다.
작동 방식
| 단계 | 설명 |
|---|---|
| ① 설정 | 홈 앱에서 지원 락 추가 → Wallet에 Home Key 카드 발급 |
| ② Express Mode | Face ID·패스코드 없이 슬립 상태에서도 1-Tap 해제 |
| ③ Power Reserve | iPhone 전원 꺼져도 최대 5 시간 NFC 잠금 해제 |
| ④ 보안 | Secure Element + ECP(Enhanced Contactless Polling)로 1회용 암호화 토큰 교환 |
2025년 현재 지원 기기
스마트락
• Schlage Encode Plus, Level Lock +, Aqara U100, Ultraloq Bolt NFC(-> 안드로이드 Tap-to-Unlock 추가 업데이트) 등 9to5Mac+2Geeky Gadgets+2
iPhone / Watch : iPhone XS·11 이후, Apple Watch Series 4 이후 (최신 iOS 17 / watchOS 10 권장)
결론
HomeKey-ESP32는 저렴한 하드웨어를 이용해 Home Key 경험을 직접 구현해볼 수 있는 최적의 학습/DIY 프로젝트입니다.
Apple Home Key 자체는 2025년 현재 스마트락 시장에서 가장 간편하고 안전한 모바일 키 솔루션으로 자리잡고 있으며, Matter·Android NFC 확장과 함께 더욱 빠른 생태계 확장이 예상됩니다.