2021-06-11 22:31:35 +02:00
|
|
|
BLE Server
|
|
|
|
|
==========
|
|
|
|
|
|
|
|
|
|
.. seo::
|
|
|
|
|
:description: Instructions for setting up Bluetooth LE GATT Server in ESPHome.
|
|
|
|
|
:image: bluetooth.svg
|
|
|
|
|
|
|
|
|
|
The ``esp32_ble_server`` component in ESPHome sets up a simple BLE GATT server that exposes the device name,
|
|
|
|
|
manufacturer and board. This component allows other components to create their own services to expose
|
|
|
|
|
data and control.
|
|
|
|
|
|
|
|
|
|
.. code-block:: yaml
|
|
|
|
|
|
|
|
|
|
# Example configuration
|
|
|
|
|
|
|
|
|
|
esp32_ble_server:
|
2023-08-17 22:05:32 +02:00
|
|
|
manufacturer: "Orange"
|
|
|
|
|
manufacturer_data: [0x4C, 0, 0x23, 77, 0xF0 ]
|
2021-06-11 22:31:35 +02:00
|
|
|
|
|
|
|
|
|
|
|
|
|
Configuration variables:
|
|
|
|
|
------------------------
|
|
|
|
|
|
|
|
|
|
- **manufacturer** (*Optional*, string): The name of the manufacturer/firmware creator. Defaults to ``ESPHome``.
|
|
|
|
|
- **model** (*Optional*, string): The model name of the device. Defaults to the friendly name of the ``board`` chosen
|
|
|
|
|
in the :ref:`core configuration <esphome-configuration_variables>`.
|
2023-08-17 22:05:32 +02:00
|
|
|
- **manufacturer_data** (*Optional*, list of bytes): The manufacturer-specific data to include in the advertising
|
|
|
|
|
packet. Should be a list of bytes, where the first two are the little-endian representation of the 16-bit
|
|
|
|
|
manufacturer ID as assigned by the Bluetooth SIG.
|
2021-06-11 22:31:35 +02:00
|
|
|
|
|
|
|
|
See Also
|
|
|
|
|
--------
|
|
|
|
|
|
|
|
|
|
- :doc:`esp32_ble`
|
|
|
|
|
- :doc:`esp32_improv`
|
|
|
|
|
- :apiref:`esp32_ble/ble.h`
|
|
|
|
|
- :ghedit:`Edit`
|
