2021-08-11 06:07:18 +02:00
|
|
|
AM43 Sensor
|
|
|
|
|
===========
|
|
|
|
|
|
|
|
|
|
.. seo::
|
|
|
|
|
:description: Sensors on AM43/BLE covers in ESPHome.
|
2021-11-16 03:19:33 +01:00
|
|
|
:image: am43.jpg
|
2021-08-11 06:07:18 +02:00
|
|
|
|
|
|
|
|
The ``am43`` sensor platform allows you to read the light and
|
|
|
|
|
battery sensors on an AM43 BLE cover motor. The platform connects
|
|
|
|
|
to the device over the ESP32's BLE peripheral.
|
|
|
|
|
|
|
|
|
|
.. note::
|
|
|
|
|
|
|
|
|
|
This component does NOT support Tuya-based versions of this device,
|
|
|
|
|
as the protocol is completely different. If your device is controlled
|
|
|
|
|
with the SmartLife app, then it will not work.
|
|
|
|
|
|
|
|
|
|
.. figure:: images/am43.jpg
|
|
|
|
|
:align: right
|
|
|
|
|
|
|
|
|
|
.. code-block:: yaml
|
|
|
|
|
|
|
|
|
|
# Example configuration entry
|
|
|
|
|
|
|
|
|
|
esp32_ble_tracker:
|
|
|
|
|
|
|
|
|
|
ble_client:
|
2024-07-15 01:40:55 +02:00
|
|
|
- mac: XX:XX:XX:XX:XX:XX
|
2021-08-11 06:07:18 +02:00
|
|
|
id: am43_device
|
|
|
|
|
|
|
|
|
|
sensor:
|
|
|
|
|
- platform: am43
|
|
|
|
|
ble_client_id: am43_device
|
|
|
|
|
battery_level:
|
|
|
|
|
name: "Kitchen blinds battery"
|
|
|
|
|
illuminance:
|
|
|
|
|
name: "Kitchen blinds light"
|
|
|
|
|
|
|
|
|
|
For more details on setting up this device, see the
|
|
|
|
|
:doc:`/components/cover/am43` component.
|
|
|
|
|
|
|
|
|
|
Configuration variables:
|
|
|
|
|
------------------------
|
|
|
|
|
|
|
|
|
|
- **ble_client_id** (**Required**, :ref:`config-id`): The id of the ``ble_client`` entry associated with the device.
|
|
|
|
|
- **battery_level** (*Optional*): The information for the battery level sensor.
|
|
|
|
|
|
|
|
|
|
- **name** (**Required**, string): The name for the battery level sensor.
|
|
|
|
|
- **id** (*Optional*, :ref:`config-id`): Set the ID of this sensor for use in lambdas.
|
|
|
|
|
- All other options from :ref:`Sensor <config-sensor>`.
|
|
|
|
|
- **illuminance** (*Optional*): The information for the light level sensor.
|
|
|
|
|
|
|
|
|
|
- **name** (**Required**, string): The name for the light level sensor.
|
|
|
|
|
- **id** (*Optional*, :ref:`config-id`): Set the ID of this sensor for use in lambdas.
|
|
|
|
|
- All other options from :ref:`Sensor <config-sensor>`.
|
|
|
|
|
|
|
|
|
|
- **update_interval** (*Optional*, :ref:`config-time`): The interval to check the
|
|
|
|
|
sensor. Defaults to ``60s``.
|
|
|
|
|
|
|
|
|
|
.. note::
|
|
|
|
|
|
|
|
|
|
It is recommended to also setup the :doc:`/components/cover/am43`.
|
|
|
|
|
|
|
|
|
|
See Also
|
|
|
|
|
--------
|
|
|
|
|
|
|
|
|
|
- :doc:`index`
|
|
|
|
|
- :doc:`/components/cover/am43`
|
|
|
|
|
- :ref:`automation`
|
|
|
|
|
- :apiref:`sensor/am43/am43.h`
|
|
|
|
|
- :ghedit:`Edit`
|
