esphome-docs/components/tm1651.rst
2020-01-08 11:16:40 -03:00

101 lines
2.6 KiB
ReStructuredText

TM1651 Battery Display
======================
.. seo::
:description: Instructions for setting up TM1651 Battery Display.
:image: tm1651_battery_display.jpg
.. _tm1651:
Battery Display
---------------
The ``tm1651`` display platform allows you to use battery display units based on TM1651 chip, like
`this one <https://aliexpress.com/item/32811491559.html>`__
with ESPHome. Currently integration supports level and brightness setting. All updates can be made via lambda expressions.
.. figure:: images/tm1651-battery-display.jpg
:align: center
:width: 70.0%
.. code-block:: yaml
tm1651:
id: tm1651_battery
clk_pin: D6
dio_pin: D5
Configuration variables:
************************
- **clk_pin** (**Required**, :ref:`Pin Schema <config-pin_schema>`): CLK pin
- **dio_pin** (**Required**, :ref:`Pin Schema <config-pin_schema>`): DIO pin
- **id** (*Optional*, :ref:`config-id`): Manually specify the ID used for code generation.
.. _tm1651-set_level_action:
``tm1651.set_level`` Action
---------------------------
This :ref:`Action <config-action>` changes the level of the battery display at runtime.
.. code-block:: yaml
on_...:
- tm1651.set_level:
id: tm1651_battery
level: 50
Configuration variables:
- **id** (**Required**, :ref:`config-id`): The ID of the TM1651.
- **level** (**Required**, :ref:`templatable <config-templatable>`, int): Level from 9 to 100
.. _tm1651-set_brightness_action:
``tm1651.set_brightness`` Action
--------------------------------
This :ref:`Action <config-action>` allows you to manually change the brightness of the battery display at runtime.
.. code-block:: yaml
on_...:
- tm1651.set_brightness:
id: tm1651_battery
brightness: 1
Configuration variables:
- **id** (**Required**, :ref:`config-id`): The ID of the TM1651.
- **brightness** (**Required**, :ref:`templatable <config-templatable>`, int): There is three levels of brightness
(``1``, ``2`` or ``3``) from lowest to highest brightness.
Advanced Configuration
----------------------
You also can control this component with lambda expressions
.. code-block:: yaml
api:
services:
- service: battery_level
variables:
level: int
then:
- lambda: |-
id(tm1651_battery).set_level(level);
- service: battery_brightness
variables:
brightness: int
then:
- lambda: |-
id(tm1651_battery).set_brightness(brightness);
See Also
--------
- :doc:`index`
- :ghedit:`Edit`