README.md
1| Supported Targets | ESP32 | ESP32-C3 |
2| ----------------- | ----- | -------- |
3
4# ESP-IDF BLE ANCS Example
5
6The purpose of the Apple Notification Center Service (ANCS) is to give Bluetooth accessories (that connect to iOS devices through a Bluetooth low-energy link) a simple and convenient way to access many kinds of notifications that are generated on iOS devices.
7
8## How to Use Example
9
10Before project configuration and build, be sure to set the correct chip target using:
11
12```bash
13idf.py set-target <chip_name>
14```
15
16The Apple Notification Center Service is a primary service whose service UUID is:
17
18`7905F431-B5CE-4E99-A40F-4B1E122D00D0`
19
20Only one instance of the ANCS may be present on an NP. Due to the nature of iOS, the ANCS is not guaranteed to always be present. As a result, the NC should look for and subscribe to the Service Changed characteristic of the GATT service in order to monitor for the potential publishing and unpublishing of the ANCS at any time.
21
22In its basic form, the ANCS exposes three characteristics:
23Notification Source: UUID `9FBF120D-6301-42D9-8C58-25E699A21DBD` (notifiable)
24Control Point: UUID `69D1D8F3-45E1-49A8-9821-9BBDFDAAD9D9` (writeable with response)
25Data Source: UUID `22EAC6E9-24D6-4BB5-BE44-B36ACE7C7BFB` (notifiable)
26
27All these characteristics require authorization for access.
28
29### Hardware Required
30
31* A development board with ESP32/ESP32-C3 SoC (e.g., ESP32-DevKitC, ESP-WROVER-KIT, etc.)
32* A USB cable for power supply and programming
33
34See [Development Boards](https://www.espressif.com/en/products/devkits) for more information about it.
35
36### Build and Flash
37
38Run `idf.py -p PORT flash monitor` to build, flash and monitor the project.
39
40(To exit the serial monitor, type ``Ctrl-]``.)
41
42See the [Getting Started Guide](https://idf.espressif.com/) for full steps to configure and use ESP-IDF to build projects.
43
44## Example Output
45
46```
47I (0) cpu_start: Starting scheduler on APP CPU.
48I (558) BTDM_INIT: BT controller compile version [1342a48]
49I (568) system_api: Base MAC address is not set
50I (568) system_api: read default base MAC address from EFUSE
51I (568) phy_init: phy_version 4670,719f9f6,Feb 18 2021,17:07:07
52I (918) BLE_ANCS: app_main init bluetooth
53I (1018) BLE_ANCS: REG_EVT
54E (1028) BT_BTM: BTM_BleConfigLocalIcon
55
56I (1058) BLE_ANCS: advertising start success
57```
58
59## Troubleshooting
60
61For any technical queries, please open an [issue](https://github.com/espressif/esp-idf/issues) on GitHub. We will get back to you soon.
62
