wonderslug/esphome-ancs

This project lets a small, cheap ESP32 microcontroller receive notifications from a nearby iPhone over Bluetooth. iPhones have a built-in Bluetooth service called ANCS (Apple Notification Center Service), which is the same system AirPods and Apple Watch use to know when your phone rings. This component teaches the ESP32 to speak that same protocol, so your phone hands over incoming call alerts, iMessages, calendar reminders, and app pings directly to the device. The main use is triggering home automations. When your iPhone rings, the ESP32 can tell Home Assistant about it, and Home Assistant can then flash lights, ring a chime, or do anything else you have set up. The classic example in the README is helping someone who leaves their phone on silent: instead of a missed call, the whole house reacts. No phone app is required, no cloud service is involved, and there is no subscription. The component is built for ESPHome, a system for programming ESP32 boards through simple configuration files rather than raw code. You add it to your ESPHome setup using a few lines of YAML and pick one of three included packages depending on how much control you want. The simplest option fires Home Assistant events for every notification with almost no configuration. A second option automatically creates named sensors in Home Assistant. The third gives you a bare component to wire up however you like. There is one important setup step that trips people up: pairing the ESP32 to your iPhone cannot be done through the standard iOS Bluetooth settings screen. Apple does not show unofficial devices there. Instead, you use a free third-party app called nRF Connect to initiate the first connection, which causes iOS to show its normal pairing dialog. After that first pairing, the phone reconnects on its own whenever the ESP32 is in range. The component requires the ESP-IDF framework (not the Arduino framework) and only works with iPhones running iOS 7 or later. Because the ESP32's Bluetooth radio is fully dedicated to this ANCS connection, it cannot run other Bluetooth features like Bluetooth proxy or BLE device tracking at the same time.