# ESP-Brookesia HAL Interface * [中文版本](./README_CN.md) ## Overview `brookesia_hal_interface` is the foundational hardware abstraction component for ESP-Brookesia. It provides a unified abstraction between board-level implementations and upper-layer business logic or other subsystems. The BLE surface provides a runtime-configured, single-connection `ble::PeripheralIface` with 128-bit GATT services and characteristics, write events with owned binary data, notification subscription tracking, negotiated MTU reporting, and advertising/connection lifecycle callbacks. It intentionally does not include Central, Classic Bluetooth, pairing, bonding, or persistent keys in v1. For more information, see the [ESP-Brookesia Programming Guide](https://docs.espressif.com/projects/esp-brookesia/en/latest/hal/interface/index.html). ## How to Use ### Environment Requirements Please refer to the following documentation: - [ESP-Brookesia Programming Guide - Versioning](https://docs.espressif.com/projects/esp-brookesia/en/latest/getting_started.html#getting-started-versioning) - [ESP-Brookesia Programming Guide - Development Environment Setup](https://docs.espressif.com/projects/esp-brookesia/en/latest/getting_started.html#getting-started-dev-environment) ### Add to Your Project Please refer to [ESP-Brookesia Programming Guide - How to Obtain and Use Components](https://docs.espressif.com/projects/esp-brookesia/en/latest/getting_started.html#getting-started-component-usage).
e9f22576bb4d19ca190a8105134010d514574a6b
idf.py add-dependency "espressif/brookesia_hal_interface^0.8.2"