esphome-docs/components/light/lightwaverf.rst
Christian 5db8708f93
add lightwave (#2915)
Co-authored-by: Keith Burzinski <kbx81x@gmail.com>
Co-authored-by: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
2023-09-06 10:33:52 +12:00

94 lines
2.4 KiB
ReStructuredText

LightWaveRF Switch
==================
.. seo::
:description: LightWaveRF Switch Lights
:image: brightness-medium.svg
The ``LightWaveRF`` light platform creates a module to dump and send commands to light switches
.. figure:: images/lightwaverf.jpg
:align: center
:width: 40.0%
LightwaveRF switches are very common in UK automation. They allow control of lights, sockets, relays and more via RF remote or via a hub.
Using an inexpensive RF transmitter and receiver you can control your devices via ESPHome.
.. code-block:: yaml
# Example configuration entry
# Specify the two pins to connect the receiver and transmitter
lightwaverf:
read_pin: 13
write_pin: 14
# Create a switch to trigger a light
switch:
- platform: template
name: "Turn off sofa"
id: light_off_ceiling_sofa
turn_on_action:
lightwaverf.send_raw:
code: [0x04, 0x00, 0x00, 0x00, 0x0f, 0x03, 0x0d, 0x09, 0x08, 0x08]
name: "Sofa"
repeat: 1
Note: To gather the RAW codes from the remote, setup the ``read_pin`` and observe in the logs the printing of the codes.
Configuration variables:
------------------------
- **read_pin** (**Required**, :ref:`Pin Schema <config-pin_schema>`): The pin that the receiver is connected to
- **write_pin** (**Required**, :ref:`Pin Schema <config-pin_schema>`): the pin that the transmitter is connected to
.. lightwaverf.send_raw:
``lightwaverf.send_raw`` Action
--------------------------------
Send the raw data that has been captured via the dump system
.. code-block:: yaml
on_...:
then:
- lightwaverf.send_raw:
code: [0x04, 0x00, 0x00, 0x00, 0x0f, 0x03, 0x0d, 0x09, 0x08, 0x08]
name: "Sofa"
repeat: 1
Configuration variables:
------------------------
- **name** (*Optional*, string): The name to give for the action
- **code** (**Required**, list hex): The raw dump in an array of hex
- **repeat** (*Optional*, int): The number of times the message will be repeated
- **inverted** (*Optional*, boolean): Send the signal inverted
Compatible Hardware
-------------------
The RF transmitters/receivers listed below have been confirmed to work with the current code base. If you discover others that work, please let us know!
Compatible transmitter:
- MX-FS-03V
Compatible receiver:
- RXB6
See Also
--------
- :doc:`/components/light/index`
- :ghedit:`Edit`