Merge 0940a79a11 into 696a828156

components/qesan_ble_remote.rst

@@ -0,0 +1,70 @@
+QESAN BLE Remote
+================
+
+.. seo::
+    :description: Instructions for receiving QESAN BLE remotes using ESPHome
+    :keywords: tuya, qesan, remote, bluetooth, ble, lamp
+
+The ``qesan_ble_remote`` component allows you to receive button presses from BLE remotes that are often used
+for tuya lamps.
+
+.. figure:: images/qesan_ble_remote.png
+    :align: center
+    :width: 50.0%
+
+This component requires the ``esp32_ble_tracker`` component. This configuration is more reliable than the
+default for receiving button presses:
+
+.. code-block:: yaml
+
+    esp32_ble_tracker:
+      scan_parameters:
+        interval: 100ms
+        window: 20ms
+        active: false
+
+To find the address and button codes of your remote, configure the component without specifying any address.
+When pressing buttons on the remote the codes will appear in the ESPHome log.
+
+Component/Hub
+-------------
+
+.. code-block:: yaml
+
+    # Example configuration entry
+    qesan_ble_remote:
+      - id: my_remote
+        mac_address: 51:45:53:AA:BB:CC
+        address: 0x1234
+
+Configuration variables:
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+- **id** (**Required**, :ref:`config-id`): The id to use for this component.
+- **mac_address** (*Optional*, MAC Address): The MAC address of the remote. Can be found in the ESPHome log. If unspecified, the component reacts to all remotes.
+- **address** (*Optional*, int): The 16-bit address of the remote. Can be found in the ESPHome log. If unspecified, the component reacts to all remotes.
+
+Binary Sensor
+-------------
+
+.. code-block:: yaml
+
+    # Example configuration entry
+    binary_sensor:
+      - platform: qesan_ble_remote
+        id: my_button
+        remote_id: my_remote
+        code: 0x7e
+
+Configuration variables:
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+- **remote_id** (*Optional*): Manually specify the ID of the qesan_ble_remote instance if there are multiple.
+- **code** (**Required**, int): The button code to react to. Can be found in the ESPHome log.
+- All options from :ref:`Binary Sensor <config-binary_sensor>`.
+
+See Also
+--------
+
+- :doc:`/components/esp32_ble_tracker`
+- :ghedit:`Edit`

index.rst

@@ -1003,6 +1003,7 @@ Wireless communication that is **not Wi-Fi.**
 .. imgtable::
 
     IR Remote Climate, components/climate/climate_ir, air-conditioner-ir.svg, dark-invert
+    QESAN BLE Remote, components/qesan_ble_remote, qesan_ble_remote.png
     Remote Receiver, components/remote_receiver, remote.svg, dark-invert
     Remote Transmitter, components/remote_transmitter, remote.svg, dark-invert
     RF Bridge, components/rf_bridge, rf_bridge.jpg