mirror of
https://github.com/esphome/esphome-docs.git
synced 2024-11-08 09:52:07 +01:00
35 lines
941 B
ReStructuredText
35 lines
941 B
ReStructuredText
|
BLE Component
|
||
|
|
=============
|
||
|
|
|
||
|
|
.. seo::
|
||
|
|
:description: Instructions for setting up Bluetooth LE in ESPHome.
|
||
|
|
:image: bluetooth.svg
|
||
|
|
|
||
|
|
The ``esp32_ble`` 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:
|
||
|
|
|
||
|
|
|
||
|
|
Configuration variables:
|
||
|
|
------------------------
|
||
|
|
|
||
|
|
- **server** (*Optional*): Starts the BLE GATT server
|
||
|
|
|
||
|
|
- **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>`.
|
||
|
|
|
||
|
|
See Also
|
||
|
|
--------
|
||
|
|
|
||
|
|
- :doc:`esp32_improv`
|
||
|
|
- :apiref:`esp32_ble/ble.h`
|
||
|
|
- :ghedit:`Edit`
|