ESP32 ANCS MQTT BRIDGE

Home Assistant iOS ANCS Installer

ESP32가 iPhone 알림을 ANCS로 받아 MQTT를 통해 Home Assistant에 전달하도록 펌웨어를 설치합니다.

Apple Notification Center Service (ANCS): 블루투스(BLE)를 통해 아이폰 등의 iOS 기기 알림을 스마트워치나 이어폰 같은 주변 기기로 전달해 주는 애플 규격 서비스입니다

이 페이지는 ESP32 펌웨어 설치용입니다. HACS는 Home Assistant 동반 통합만 설치하며 ESP32 펌웨어를 설치하거나 업데이트하지 않습니다.

보드 선택

LIVE TARGET --:--:-- KST

BUILD: v0.3.8
FLASH: 4 MB+
PIPE: ANCS → MQTT

SECURE CONTEXT 확인 중

WEB SERIAL 확인 중

INSTALL MODE USB CHIP AUTO DETECT

UNIFIED INSTALLER

ESP32 보드 선택

WROOM-32는 유효한 ESP32 하드웨어 계열입니다. 보드 각인이나 구매 기록의 칩 계열과 같은 항목을 선택하세요.

ESP32 계열

선택은 안내 표시를 바꾸며, 실제 이미지는 ESP Web Tools가 연결된 칩과 통합 manifest를 기준으로 선택합니다.

FAMILY: ESP32 / WROOM-32
BOOT GPIO: GPIO 0
VALIDATION: v0.3.8 build verified
IMAGE: 4 MB factory image

READY TO FLASH

ESP32 / WROOM-32

BUILD VERIFIED

ESP32/WROOM-32 계열용 v0.3.8 ANCS-to-MQTT factory build입니다.

브라우저 요구 사항 데스크톱 Chrome 또는 Edge와 데이터 전송 USB 케이블이 필요합니다. 충전 전용 케이블은 직렬 포트를 표시하지 않습니다.

전체 지우기 주의 ESP Web Tools에서 full erase를 선택하면 저장된 Wi-Fi, MQTT, BLE bond가 모두 삭제됩니다.

USB AUTO DETECT FLASH

이 브라우저는 USB 설치를 지원하지 않습니다. 데스크톱 Chrome 또는 Edge를 사용하세요. USB 설치는 HTTPS 또는 localhost에서만 실행할 수 있습니다.

v0.3.8 · ESP-IDF 6.0.2 SHA256 E16E79299560

지원 대상: ESP32/WROOM-32, ESP32-C2, ESP32-C3, ESP32-C5, ESP32-C6, ESP32-C61, ESP32-S3. ESP32-S2는 BLE가 없고 ESP32-H2는 Wi-Fi가 없어 이 ANCS-to-MQTT 대상에서 제외됩니다.

SETUP STEPS

설치 후 연결 절차

플래시, 설정 AP, Wi-Fi/MQTT 저장, 설정 포털 내 iPhone 등록, Home Assistant Discovery, 알림 확인 순서로 진행합니다.

01 / FLASH

펌웨어 플래시

데스크톱 Chrome 또는 Edge에서 데이터 USB 케이블로 ESP32를 연결하고 보드 계열을 선택한 뒤 설치 버튼을 누릅니다. full erase는 Wi-Fi, MQTT, BLE bond를 모두 지우는 경우에만 선택합니다.

02 / SETUP AP

설정 AP 접속

플래시 후 IOS-ANCS-SETUP-XXXXXX Wi-Fi에 연결합니다. 비밀번호는 ancs-xxxxxx입니다. XXXXXX는 기본 Wi-Fi MAC 주소의 마지막 6자리 16진수이며, SSID에서는 대문자, 비밀번호에서는 소문자를 사용합니다. 이 값은 모델 번호가 아닙니다.

03 / PROVISION

Wi-Fi와 MQTT 저장

브라우저에서 http://192.168.4.1을 열고 Wi-Fi와 MQTT broker 정보를 저장합니다. 같은 페이지의 iPhone 기기 등록 버튼으로 페이지를 떠나지 않고 등록 창을 열 수 있습니다.

04 / HOME ASSISTANT

MQTT Discovery 확인

ESP32가 broker에 연결되면 MQTT Discovery가 Home Assistant 장치와 iPhone 등록 시작 버튼을 생성합니다. HACS 동반 통합은 HACS My 링크로 추가할 수 있지만 펌웨어를 플래시하지 않습니다.

05 / PAIR

iPhone 페어링

설정 포털의 iPhone 기기 등록, Home Assistant의 iPhone 등록 시작 또는 BOOT 3초 누르기로 120초 등록 창을 엽니다. 고정 PIN 123456를 iOS Bluetooth에 입력하고 알림 공유를 허용합니다.

06 / VERIFY

알림 확인

Home Assistant에서 최근 알림과 앱 이름이 갱신되는지 확인합니다. iPhone의 ANCS Display Name을 우선 사용하며, 첫 조회 뒤에는 연결 세션 캐시를 사용합니다. 조회 실패 시에도 알림은 유지되고 정적 매핑과 원본 앱 ID로 폴백합니다. 폴백 대응표는 앱 ID 참고 문서를 확인하세요.

증상	확인
USB 포트가 보이지 않음	데스크톱 Chrome/Edge, HTTPS Pages, 데이터 USB 케이블을 확인합니다.
설정 AP가 보이지 않음	플래시 완료 후 재부팅을 기다리고, 필요하면 BOOT 버튼을 3초 눌러 복구 창을 엽니다.
포털이 열리지 않음	`IOS-ANCS-SETUP-XXXXXX`에 연결된 상태에서 `http://192.168.4.1`을 엽니다.
Home Assistant 장치가 없음	MQTT broker 접속, Discovery 활성화, retained config publish를 확인합니다.
iPhone이 보이지 않음	120초 등록 창과 iOS Bluetooth 권한을 확인합니다.
알림이 비어 있음	알림 공유 허용, iOS 알림 설정, MQTT payload를 확인합니다.