esphome-docs/components/remote_transmitter.rst

59 lines
2.0 KiB
ReStructuredText
Raw Normal View History

2018-06-13 22:38:49 +02:00
Remote Transmitter Component
============================
2018-11-14 22:12:27 +01:00
.. seo::
:description: Instructions for setting up remote transmitters in esphomelib
:image: remote.png
2018-11-14 22:12:27 +01:00
:keywords: RF, infrared
2018-06-13 22:38:49 +02:00
The ``remote_transmitter`` component lets you send infrared messages to control
devices in your home. First, you need to setup a global hub that specifies which pin your remote
sender is connected to. Afterwards you can create :doc:`individual
switches </components/switch/remote_transmitter>` that each send a pre-defined remote signal to a device.
2018-06-13 22:38:49 +02:00
Use-cases are for example infrared remotes or 433MHz signals.
.. note::
This component is *much* more accurate on the ESP32, since that chipset has a dedicated
peripheral for sending exact signal sequences.
.. code-block:: yaml
2018-06-13 22:38:49 +02:00
# Example configuration entry
remote_transmitter:
pin: GPIO32
carrier_duty_percent: 50%
# Individual switches
switch:
- platform: remote_transmitter
name: "Panasonic TV Off"
panasonic:
address: 0x4004
command: 0x100BCBD
Configuration variables:
------------------------
- **pin** (**Required**, :ref:`config-pin`): The pin to transmit the remote signal on.
- **carrier_duty_percent** (*Optional*, int): How much of the time the remote is on. For example, infrared
protocols modulate the signal using a carrier signal. Set this is ``50%`` if you're working with IR leds and to
``100%`` if working with a other things like 433MHz transmitters.
- **id** (*Optional*, :ref:`config-id`): Manually specify
the ID used for code generation. Use this if you have multiple remote transmitters.
.. note::
See :ref:`finding_remote_codes` for a guide for setting this up.
See Also
--------
2018-08-24 22:44:01 +02:00
- `RCSwitch <https://github.com/sui77/rc-switch>`__ by `Suat Özgür <https://github.com/sui77>`__
- `IRRemoteESP8266 <https://github.com/markszabo/IRremoteESP8266/>`__ by `Mark Szabo-Simon <https://github.com/markszabo>`__
- :apiref:`remote/remote_transmitter.h`
- :ghedit:`Edit`
2018-10-12 16:33:22 +02:00
.. disqus::