550 lines
31 KiB
ReStructuredText
550 lines
31 KiB
ReStructuredText
esphomeyaml
|
|
===========
|
|
|
|
Hi there! This is the documentation for esphomeyaml, a project that aims to make using ESP8266/ESP32 boards with
|
|
Home Assistant very easy with no programming experience required.
|
|
|
|
esphomeyaml will:
|
|
|
|
* Read your configuration file and warn you about potential errors (like using the invalid pins.)
|
|
* Create a custom C++ sketch file for you using esphomeyaml's powerful C++ generation engine.
|
|
* Compile the sketch file for you using `platformio <http://platformio.org/>`__.
|
|
* Upload the binary to your ESP via Over the Air updates.
|
|
* Automatically start remote logs via MQTT.
|
|
|
|
|
|
Features
|
|
~~~~~~~~
|
|
|
|
* **No programming experience required:** just edit YAML configuration
|
|
files like you're used to with Home Assistant.
|
|
* **Flexible:** Use `esphomelib <https://github.com/OttoWinter/esphomelib>`__'s powerful core to create custom sensors/outputs.
|
|
* **Fast and efficient:** Written in C++ and keeps memory consumption to a minimum.
|
|
* **Small binaries:** Only the sensors/devices you actually use will appear in the binary.
|
|
* **Made for Home Assistant:** Almost all Home Assistant features are supported out of the box. Including RGB lights and many more.
|
|
* **Easy reproducible configuration:** No need to go through a long setup process for every single node. Just copy a configuration file and run a single command.
|
|
* **Smart Over The Air Updates:** esphomeyaml has OTA updates deeply integrated into the system. It even automatically enters a recovery mode if a boot loop is detected.
|
|
* **Powerful logging engine:** View colorful logs and debug issues remotely.
|
|
* **It's Open Source 😺**
|
|
|
|
|
|
Guides
|
|
~~~~~~
|
|
|
|
================================================== ================================================== ==================================================
|
|
|Getting Started through Command Line|_ |Getting Started through HassIO Add-On|_ |Configuration Types|_
|
|
-------------------------------------------------- -------------------------------------------------- --------------------------------------------------
|
|
`Getting Started through Command Line`_ `Getting Started through HassIO Add-On`_ `Configuration Types`_
|
|
-------------------------------------------------- -------------------------------------------------- --------------------------------------------------
|
|
|Migrating from Sonoff-Tasmota|_ |Migrating from ESPurna|_ |Migrating from ESPEasy|_
|
|
-------------------------------------------------- -------------------------------------------------- --------------------------------------------------
|
|
`Migrating from Sonoff-Tasmota`_ `Migrating from ESPurna`_ `Migrating from ESPEasy`_
|
|
-------------------------------------------------- -------------------------------------------------- --------------------------------------------------
|
|
|Automations|_ |FAQ and Tips|_ |Contributing|_
|
|
-------------------------------------------------- -------------------------------------------------- --------------------------------------------------
|
|
`Automations`_ `FAQ and Tips`_ `Contributing`_
|
|
================================================== ================================================== ==================================================
|
|
|
|
.. |Getting Started through Command Line| image:: /esphomeyaml/images/console.svg
|
|
:class: component-image
|
|
.. _Getting Started through Command Line: /esphomeyaml/guides/getting_started_command_line.html
|
|
.. |Getting Started through HassIO Add-On| image:: /esphomeyaml/images/home-assistant.svg
|
|
:class: component-image
|
|
.. _Getting Started through HassIO Add-On: /esphomeyaml/guides/getting_started_hassio.html
|
|
.. |Configuration Types| image:: /esphomeyaml/images/settings.svg
|
|
:class: component-image
|
|
.. _Configuration Types: /esphomeyaml/guides/configuration-types.html
|
|
.. |Migrating from Sonoff-Tasmota| image:: /esphomeyaml/images/tasmota.svg
|
|
:class: component-image
|
|
.. _Migrating from Sonoff-Tasmota: /esphomeyaml/guides/migrate_sonoff_tasmota.html
|
|
.. |Migrating from ESPurna| image:: /esphomeyaml/images/espurna.svg
|
|
:class: component-image
|
|
.. _Migrating from ESPurna: /esphomeyaml/guides/migrate_espurna.html
|
|
.. |Migrating from ESPEasy| image:: /esphomeyaml/images/espeasy.svg
|
|
:class: component-image
|
|
.. _Migrating from ESPEasy: /esphomeyaml/guides/migrate_espeasy.html
|
|
.. |Automations| image:: /esphomeyaml/images/auto-fix.svg
|
|
:class: component-image
|
|
.. _Automations: /esphomeyaml/guides/automations.html
|
|
.. |FAQ and Tips| image:: /esphomeyaml/images/question_answer.svg
|
|
:class: component-image
|
|
.. _FAQ and Tips: /esphomeyaml/guides/faq.html
|
|
.. |Contributing| image:: /esphomeyaml/images/github-circle.svg
|
|
:class: component-image
|
|
.. _Contributing: /esphomeyaml/guides/contributing.html
|
|
|
|
|
|
.. _devices:
|
|
|
|
Devices
|
|
^^^^^^^
|
|
|
|
This list contains a bunch of getting started and more advanced guides for using esphomeyaml.
|
|
Technically, all ESP8266/ESP32 devices (and therefore all Sonoff devices) are supported by esphomeyaml/lib.
|
|
These are only the devices for which I've had the time to set up dedicated guides.
|
|
|
|
================================================== ================================================== ==================================================
|
|
|Generic ESP8266|_ |Generic ESP32|_ |NodeMCU ESP8266|_
|
|
-------------------------------------------------- -------------------------------------------------- --------------------------------------------------
|
|
`Generic ESP8266`_ `Generic ESP32`_ `NodeMCU ESP8266`_
|
|
-------------------------------------------------- -------------------------------------------------- --------------------------------------------------
|
|
|NodeMCU ESP32|_ |Sonoff S20|_ |Sonoff 4CH|_
|
|
-------------------------------------------------- -------------------------------------------------- --------------------------------------------------
|
|
`NodeMCU ESP32`_ `Sonoff S20`_ `Sonoff 4CH`_
|
|
-------------------------------------------------- -------------------------------------------------- --------------------------------------------------
|
|
|Generic Sonoff|_ |Sonoff Basic|_
|
|
-------------------------------------------------- -------------------------------------------------- --------------------------------------------------
|
|
`Generic Sonoff`_ `Sonoff Basic`_
|
|
================================================== ================================================== ==================================================
|
|
|
|
.. |Generic ESP8266| image:: /esphomeyaml/images/esp8266.svg
|
|
:class: component-image
|
|
.. _Generic ESP8266: /esphomeyaml/devices/esp8266.html
|
|
.. |Generic ESP32| image:: /esphomeyaml/images/esp32.svg
|
|
:class: component-image
|
|
.. _Generic ESP32: /esphomeyaml/devices/esp32.html
|
|
.. |NodeMCU ESP8266| image:: /esphomeyaml/images/nodemcu_esp8266.jpg
|
|
:class: component-image
|
|
.. _NodeMCU ESP8266: /esphomeyaml/devices/nodemcu_esp8266.html
|
|
.. |NodeMCU ESP32| image:: /esphomeyaml/images/nodemcu_esp32.jpg
|
|
:class: component-image
|
|
.. _NodeMCU ESP32: /esphomeyaml/devices/nodemcu_esp32.html
|
|
.. |Sonoff S20| image:: /esphomeyaml/images/sonoff_s20.jpg
|
|
:class: component-image
|
|
.. _Sonoff S20: /esphomeyaml/devices/sonoff_s20.html
|
|
.. |Sonoff Basic| image:: /esphomeyaml/devices/images/sonoff_basic.jpg
|
|
:class: component-image
|
|
.. _Sonoff Basic: /esphomeyaml/devices/sonoff_basic.html
|
|
.. |Sonoff 4CH| image:: /esphomeyaml/images/sonoff_4ch.jpg
|
|
:class: component-image
|
|
.. _Sonoff 4CH: /esphomeyaml/devices/sonoff_4ch.html
|
|
.. |Generic Sonoff| image:: /esphomeyaml/images/sonoff.svg
|
|
:class: component-image
|
|
.. _Generic Sonoff: /esphomeyaml/devices/sonoff.html
|
|
|
|
|
|
Core Components
|
|
~~~~~~~~~~~~~~~
|
|
|
|
============================== ============================== ==============================
|
|
|Core|_ |WiFi|_ |MQTT|_
|
|
------------------------------ ------------------------------ ------------------------------
|
|
`Core`_ `WiFi`_ `MQTT`_
|
|
------------------------------ ------------------------------ ------------------------------
|
|
|I²C Bus|_ |OTA Updates|_ |Logger|_
|
|
------------------------------ ------------------------------ ------------------------------
|
|
`I²C Bus`_ `OTA Updates`_ `Logger`_
|
|
------------------------------ ------------------------------ ------------------------------
|
|
|Web Server|_ |Power Supply|_ |Deep Sleep|_
|
|
------------------------------ ------------------------------ ------------------------------
|
|
`Web Server`_ `Power Supply`_ `Deep Sleep`_
|
|
============================== ============================== ==============================
|
|
|
|
.. |Core| image:: /esphomeyaml/images/cloud-circle.svg
|
|
:class: component-image
|
|
.. _Core: /esphomeyaml/components/esphomeyaml.html
|
|
.. |WiFi| image:: /esphomeyaml/images/network-wifi.svg
|
|
:class: component-image
|
|
.. _WiFi: /esphomeyaml/components/wifi.html
|
|
.. |MQTT| image:: /esphomeyaml/images/mqtt.png
|
|
:class: component-image
|
|
.. _MQTT: /esphomeyaml/components/mqtt.html
|
|
.. |I²C Bus| image:: /esphomeyaml/images/i2c.svg
|
|
:class: component-image
|
|
.. _I²C Bus: /esphomeyaml/components/i2c.html
|
|
.. |OTA Updates| image:: /esphomeyaml/images/system-update.svg
|
|
:class: component-image
|
|
.. _OTA Updates: /esphomeyaml/components/ota.html
|
|
.. |Logger| image:: /esphomeyaml/images/file-document-box.svg
|
|
:class: component-image
|
|
.. _Logger: /esphomeyaml/components/logger.html
|
|
.. |Web Server| image:: /esphomeyaml/images/http.svg
|
|
:class: component-image
|
|
.. _Web Server: /esphomeyaml/components/web_server.html
|
|
.. |Power Supply| image:: /esphomeyaml/images/power.svg
|
|
:class: component-image
|
|
.. _Power Supply: /esphomeyaml/components/power_supply.html
|
|
.. |Deep Sleep| image:: /esphomeyaml/images/hotel.svg
|
|
:class: component-image
|
|
.. _Deep Sleep: /esphomeyaml/components/deep_sleep.html
|
|
|
|
|
|
Sensor Components
|
|
~~~~~~~~~~~~~~~~~
|
|
|
|
================================================== ================================================== ==================================================
|
|
|Sensor Core|_ |ADC|_ |ADS1115|_
|
|
-------------------------------------------------- -------------------------------------------------- --------------------------------------------------
|
|
`Sensor Core`_ `ADC`_ `ADS1115`_
|
|
-------------------------------------------------- -------------------------------------------------- --------------------------------------------------
|
|
|BH1750|_ |BME280|_ |BME680|_
|
|
-------------------------------------------------- -------------------------------------------------- --------------------------------------------------
|
|
`BH1750`_ `BME280`_ `BME680`_
|
|
-------------------------------------------------- -------------------------------------------------- --------------------------------------------------
|
|
|BMP085|_ |Dallas|_ |DHT|_
|
|
-------------------------------------------------- -------------------------------------------------- --------------------------------------------------
|
|
`BMP085`_ `Dallas`_ `DHT`_
|
|
-------------------------------------------------- -------------------------------------------------- --------------------------------------------------
|
|
|DHT12|_ |ESP32 Hall Sensor|_ |HDC1080|_
|
|
-------------------------------------------------- -------------------------------------------------- --------------------------------------------------
|
|
`DHT12`_ `ESP32 Hall Sensor`_ `HDC1080`_
|
|
-------------------------------------------------- -------------------------------------------------- --------------------------------------------------
|
|
|HTU21D|_ |MAX6675|_ |MPU6050|_
|
|
-------------------------------------------------- -------------------------------------------------- --------------------------------------------------
|
|
`HTU21D`_ `MAX6675`_ `MPU6050`_
|
|
-------------------------------------------------- -------------------------------------------------- --------------------------------------------------
|
|
|Pulse Counter|_ |Rotary Encoder|_ |SHT3X-D|_
|
|
-------------------------------------------------- -------------------------------------------------- --------------------------------------------------
|
|
`Pulse Counter`_ `Rotary Encoder`_ `SHT3X-D`_
|
|
-------------------------------------------------- -------------------------------------------------- --------------------------------------------------
|
|
|Template Sensor|_ |TSL2561|_ |Ultrasonic Sensor|_
|
|
-------------------------------------------------- -------------------------------------------------- --------------------------------------------------
|
|
`Template Sensor`_ `TSL2561`_ `Ultrasonic Sensor`_
|
|
-------------------------------------------------- -------------------------------------------------- --------------------------------------------------
|
|
|WiFi Signal Sensor|_ |Custom Sensor|_
|
|
-------------------------------------------------- -------------------------------------------------- --------------------------------------------------
|
|
`WiFi Signal Sensor`_ `Custom Sensor`_
|
|
================================================== ================================================== ==================================================
|
|
|
|
.. |Sensor Core| image:: /esphomeyaml/images/folder-open.svg
|
|
:class: component-image
|
|
.. _Sensor Core: /esphomeyaml/components/sensor/index.html
|
|
.. |ADC| image:: /esphomeyaml/images/flash.svg
|
|
:class: component-image
|
|
.. _ADC: /esphomeyaml/components/sensor/adc.html
|
|
.. |ADS1115| image:: /esphomeyaml/images/ads1115.jpg
|
|
:class: component-image
|
|
.. _ADS1115: /esphomeyaml/components/sensor/ads1115.html
|
|
.. |BH1750| image:: /esphomeyaml/images/bh1750.jpg
|
|
:class: component-image
|
|
.. _BH1750: /esphomeyaml/components/sensor/bh1750.html
|
|
.. |BME280| image:: /esphomeyaml/images/bme280.jpg
|
|
:class: component-image
|
|
.. _BME280: /esphomeyaml/components/sensor/bme280.html
|
|
.. |BME680| image:: /esphomeyaml/images/bme680.jpg
|
|
:class: component-image
|
|
.. _BME680: /esphomeyaml/components/sensor/bme680.html
|
|
.. |BMP085| image:: /esphomeyaml/images/bmp180.jpg
|
|
:class: component-image
|
|
.. _BMP085: /esphomeyaml/components/sensor/bmp085.html
|
|
.. |Dallas| image:: /esphomeyaml/images/dallas.jpg
|
|
:class: component-image
|
|
.. _Dallas: /esphomeyaml/components/sensor/dallas.html
|
|
.. |DHT| image:: /esphomeyaml/images/dht22.jpg
|
|
:class: component-image
|
|
.. _DHT: /esphomeyaml/components/sensor/dht.html
|
|
.. |DHT12| image:: /esphomeyaml/images/dht12.jpg
|
|
:class: component-image
|
|
.. _DHT12: /esphomeyaml/components/sensor/dht12.html
|
|
.. |ESP32 Hall Sensor| image:: /esphomeyaml/images/magnet.svg
|
|
:class: component-image
|
|
.. _ESP32 Hall Sensor: /esphomeyaml/components/sensor/esp32_hall.html
|
|
.. |HDC1080| image:: /esphomeyaml/images/hdc1080.jpg
|
|
:class: component-image
|
|
.. _HDC1080: /esphomeyaml/components/sensor/hdc1080.html
|
|
.. |HTU21D| image:: /esphomeyaml/images/htu21d.jpg
|
|
:class: component-image
|
|
.. _HTU21D: /esphomeyaml/components/sensor/htu21d.html
|
|
.. |MAX6675| image:: /esphomeyaml/images/max6675.jpg
|
|
:class: component-image
|
|
.. _MAX6675: /esphomeyaml/components/sensor/max6675.html
|
|
.. |MPU6050| image:: /esphomeyaml/images/mpu6050.jpg
|
|
:class: component-image
|
|
.. _MPU6050: /esphomeyaml/components/sensor/mpu6050.html
|
|
.. |Pulse Counter| image:: /esphomeyaml/images/pulse.svg
|
|
:class: component-image
|
|
.. _Pulse Counter: /esphomeyaml/components/sensor/pulse_counter.html
|
|
.. |Rotary Encoder| image:: /esphomeyaml/images/rotary_encoder.jpg
|
|
:class: component-image
|
|
.. _Rotary Encoder: /esphomeyaml/components/sensor/rotary_encoder.html
|
|
.. |SHT3X-D| image:: /esphomeyaml/images/sht3xd.jpg
|
|
:class: component-image
|
|
.. _SHT3X-D: /esphomeyaml/components/sensor/sht3xd.html
|
|
.. |Template Sensor| image:: /esphomeyaml/images/description.svg
|
|
:class: component-image
|
|
.. _Template Sensor: /esphomeyaml/components/sensor/template.html
|
|
.. |TSL2561| image:: /esphomeyaml/images/tsl2561.jpg
|
|
:class: component-image
|
|
.. _TSL2561: /esphomeyaml/components/sensor/tsl2561.html
|
|
.. |Ultrasonic Sensor| image:: /esphomeyaml/images/ultrasonic.jpg
|
|
:class: component-image
|
|
.. _Ultrasonic Sensor: /esphomeyaml/components/sensor/ultrasonic.html
|
|
.. |WiFi Signal Sensor| image:: /esphomeyaml/images/network-wifi.svg
|
|
:class: component-image
|
|
.. _WiFi Signal Sensor: /esphomeyaml/components/sensor/wifi_signal.html
|
|
.. |Custom Sensor| image:: /esphomeyaml/images/language-cpp.svg
|
|
:class: component-image
|
|
.. _Custom Sensor: /esphomeyaml/components/sensor/custom.html
|
|
|
|
|
|
Binary Sensor Components
|
|
~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
============================== ============================== ==============================
|
|
|Binary Sensor Core|_ |GPIO|_ |Status|_
|
|
------------------------------ ------------------------------ ------------------------------
|
|
`Binary Sensor Core`_ `GPIO`_ `Status`_
|
|
------------------------------ ------------------------------ ------------------------------
|
|
|ESP32 BLE Device|_ |ESP32 Touch Pad|_ |Template Binary Sensor|_
|
|
------------------------------ ------------------------------ ------------------------------
|
|
`ESP32 BLE Device`_ `ESP32 Touch Pad`_ `Template Binary Sensor`_
|
|
============================== ============================== ==============================
|
|
|
|
.. |Binary Sensor Core| image:: /esphomeyaml/images/folder-open.svg
|
|
:class: component-image
|
|
.. _Binary Sensor Core: /esphomeyaml/components/binary_sensor/index.html
|
|
.. |GPIO| image:: /esphomeyaml/images/pin.svg
|
|
:class: component-image
|
|
.. _GPIO: /esphomeyaml/components/binary_sensor/gpio.html
|
|
.. |Status| image:: /esphomeyaml/images/server-network.svg
|
|
:class: component-image
|
|
.. _Status: /esphomeyaml/components/binary_sensor/status.html
|
|
.. |ESP32 BLE Device| image:: /esphomeyaml/images/bluetooth.svg
|
|
:class: component-image
|
|
.. _ESP32 BLE Device: /esphomeyaml/components/binary_sensor/esp32_ble.html
|
|
.. |ESP32 Touch Pad| image:: /esphomeyaml/images/touch.svg
|
|
:class: component-image
|
|
.. _ESP32 Touch Pad: /esphomeyaml/components/binary_sensor/esp32_touch.html
|
|
.. |Template Binary Sensor| image:: /esphomeyaml/images/description.svg
|
|
:class: component-image
|
|
.. _Template Binary Sensor: /esphomeyaml/components/binary_sensor/template.html
|
|
|
|
|
|
|
|
Output Components
|
|
~~~~~~~~~~~~~~~~~
|
|
|
|
============================== ============================== ==============================
|
|
|Output Core|_ |ESP8266 Software PWM|_ |GPIO Output|_
|
|
------------------------------ ------------------------------ ------------------------------
|
|
`Output Core`_ `ESP8266 Software PWM`_ `GPIO Output`_
|
|
------------------------------ ------------------------------ ------------------------------
|
|
|ESP32 LEDC|_ |PCA9685|_
|
|
------------------------------ ------------------------------ ------------------------------
|
|
`ESP32 LEDC`_ `PCA9685`_
|
|
============================== ============================== ==============================
|
|
|
|
.. |Output Core| image:: /esphomeyaml/images/folder-open.svg
|
|
:class: component-image
|
|
.. _Output Core: /esphomeyaml/components/output/index.html
|
|
.. |ESP8266 Software PWM| image:: /esphomeyaml/images/pwm.png
|
|
:class: component-image
|
|
.. _ESP8266 Software PWM: /esphomeyaml/components/output/esp8266_pwm.html
|
|
.. |GPIO Output| image:: /esphomeyaml/images/pin.svg
|
|
:class: component-image
|
|
.. _GPIO Output: /esphomeyaml/components/output/gpio.html
|
|
.. |ESP32 LEDC| image:: /esphomeyaml/images/pwm.png
|
|
:class: component-image
|
|
.. _ESP32 LEDC: /esphomeyaml/components/output/ledc.html
|
|
.. |PCA9685| image:: /esphomeyaml/images/pca9685.jpg
|
|
:class: component-image
|
|
.. _PCA9685: /esphomeyaml/components/output/pca9685.html
|
|
|
|
|
|
Light Components
|
|
~~~~~~~~~~~~~~~~
|
|
|
|
============================== ============================== ==============================
|
|
|Light Core|_ |Binary Light|_ |Monochromatic Light|_
|
|
------------------------------ ------------------------------ ------------------------------
|
|
`Light Core`_ `Binary Light`_ `Monochromatic Light`_
|
|
------------------------------ ------------------------------ ------------------------------
|
|
|RGB Light|_ |RGBW Light|_ |FastLED Clockless Light|_
|
|
------------------------------ ------------------------------ ------------------------------
|
|
`RGB Light`_ `RGBW Light`_ `FastLED Clockless Light`_
|
|
------------------------------ ------------------------------ ------------------------------
|
|
|FastLED SPI Light|_
|
|
------------------------------ ------------------------------ ------------------------------
|
|
`FastLED SPI Light`_
|
|
============================== ============================== ==============================
|
|
|
|
.. |Light Core| image:: /esphomeyaml/images/folder-open.svg
|
|
:class: component-image
|
|
.. _Light Core: /esphomeyaml/components/light/index.html
|
|
.. |Binary Light| image:: /esphomeyaml/images/lightbulb.svg
|
|
:class: component-image
|
|
.. _Binary Light: /esphomeyaml/components/light/binary.html
|
|
.. |Monochromatic Light| image:: /esphomeyaml/images/brightness-medium.svg
|
|
:class: component-image
|
|
.. _Monochromatic Light: /esphomeyaml/components/light/monochromatic.html
|
|
.. |RGB Light| image:: /esphomeyaml/images/rgb.png
|
|
:class: component-image
|
|
.. _RGB Light: /esphomeyaml/components/light/rgb.html
|
|
.. |RGBW Light| image:: /esphomeyaml/images/rgbw.png
|
|
:class: component-image
|
|
.. _RGBW Light: /esphomeyaml/components/light/rgbw.html
|
|
.. |FastLED Clockless Light| image:: /esphomeyaml/images/color_lens.svg
|
|
:class: component-image
|
|
.. _FastLED Clockless Light: /esphomeyaml/components/light/fastled_clockless.html
|
|
.. |FastLED SPI Light| image:: /esphomeyaml/images/color_lens.svg
|
|
:class: component-image
|
|
.. _FastLED SPI Light: /esphomeyaml/components/light/fastled_spi.html
|
|
|
|
|
|
Switch Components
|
|
~~~~~~~~~~~~~~~~~
|
|
|
|
============================== ============================== ==============================
|
|
|Switch Core|_ |GPIO Switch|_ |IR Transmitter|_
|
|
------------------------------ ------------------------------ ------------------------------
|
|
`Switch Core`_ `GPIO Switch`_ `IR Transmitter`_
|
|
------------------------------ ------------------------------ ------------------------------
|
|
|Restart Switch|_ |Shutdown Switch|_ |Generic Output Switch|_
|
|
------------------------------ ------------------------------ ------------------------------
|
|
`Restart Switch`_ `Shutdown Switch`_ `Generic Output Switch`_
|
|
------------------------------ ------------------------------ ------------------------------
|
|
|Template Switch|_
|
|
------------------------------ ------------------------------ ------------------------------
|
|
`Template Switch`_
|
|
============================== ============================== ==============================
|
|
|
|
.. |Switch Core| image:: /esphomeyaml/images/folder-open.svg
|
|
:class: component-image
|
|
.. _Switch Core: /esphomeyaml/components/switch/index.html
|
|
.. |GPIO Switch| image:: /esphomeyaml/images/pin.svg
|
|
:class: component-image
|
|
.. _GPIO Switch: /esphomeyaml/components/switch/gpio.html
|
|
.. |IR Transmitter| image:: /esphomeyaml/images/remote.svg
|
|
:class: component-image
|
|
.. _IR Transmitter: /esphomeyaml/components/switch/ir_transmitter.html
|
|
.. |Restart Switch| image:: /esphomeyaml/images/restart.svg
|
|
:class: component-image
|
|
.. _Restart Switch: /esphomeyaml/components/switch/restart.html
|
|
.. |Shutdown Switch| image:: /esphomeyaml/images/power_settings.svg
|
|
:class: component-image
|
|
.. _Shutdown Switch: /esphomeyaml/components/switch/shutdown.html
|
|
.. |Generic Output Switch| image:: /esphomeyaml/images/upload.svg
|
|
:class: component-image
|
|
.. _Generic Output Switch: /esphomeyaml/components/switch/output.html
|
|
.. |Template Switch| image:: /esphomeyaml/images/description.svg
|
|
:class: component-image
|
|
.. _Template Switch: /esphomeyaml/components/switch/template.html
|
|
|
|
|
|
|
|
|
|
Fan Components
|
|
~~~~~~~~~~~~~~
|
|
|
|
============================== ============================== ==============================
|
|
|Fan Core|_ |Binary Fan|_ |Speed Fan|_
|
|
------------------------------ ------------------------------ ------------------------------
|
|
`Fan Core`_ `Binary Fan`_ `Speed Fan`_
|
|
============================== ============================== ==============================
|
|
|
|
.. |Fan Core| image:: /esphomeyaml/images/folder-open.svg
|
|
:class: component-image
|
|
.. _Fan Core: /esphomeyaml/components/fan/index.html
|
|
.. |Binary Fan| image:: /esphomeyaml/images/fan.svg
|
|
:class: component-image
|
|
.. _Binary Fan: /esphomeyaml/components/fan/binary.html
|
|
.. |Speed Fan| image:: /esphomeyaml/images/fan.svg
|
|
:class: component-image
|
|
.. _Speed Fan: /esphomeyaml/components/fan/speed.html
|
|
|
|
|
|
Cover Components
|
|
^^^^^^^^^^^^^^^^
|
|
|
|
============================== ============================== ==============================
|
|
|Cover Core|_ |Template Cover|_
|
|
------------------------------ ------------------------------ ------------------------------
|
|
`Cover Core`_ `Template Cover`_
|
|
============================== ============================== ==============================
|
|
|
|
.. |Cover Core| image:: /esphomeyaml/images/folder-open.svg
|
|
:class: component-image
|
|
.. _Cover Core: /esphomeyaml/components/cover/index.html
|
|
.. |Template Cover| image:: /esphomeyaml/images/description.svg
|
|
:class: component-image
|
|
.. _Template Cover: /esphomeyaml/components/cover/template.html
|
|
|
|
|
|
Misc Components
|
|
~~~~~~~~~~~~~~~
|
|
|
|
============================== ============================== ==============================
|
|
|Dallas Hub|_ |IR Transmitter Hub|_ |PCA9685 Hub|_
|
|
------------------------------ ------------------------------ ------------------------------
|
|
`Dallas Hub`_ `IR Transmitter Hub`_ `PCA9685 Hub`_
|
|
------------------------------ ------------------------------ ------------------------------
|
|
|ADS1115 Hub|_ |Debug Component|_ |PCF8574 I/O Expander|_
|
|
------------------------------ ------------------------------ ------------------------------
|
|
`ADS1115 Hub`_ `Debug Component`_ `PCF8574 I/O Expander`_
|
|
------------------------------ ------------------------------ ------------------------------
|
|
|ESP32 BLE Hub|_ |ESP32 Touch Hub|_
|
|
------------------------------ ------------------------------ ------------------------------
|
|
`ESP32 BLE Hub`_ `ESP32 Touch Hub`_
|
|
============================== ============================== ==============================
|
|
|
|
.. |Dallas Hub| image:: /esphomeyaml/images/dallas.jpg
|
|
:class: component-image
|
|
.. _Dallas Hub: /esphomeyaml/components/dallas.html
|
|
.. |IR Transmitter Hub| image:: /esphomeyaml/images/remote.svg
|
|
:class: component-image
|
|
.. _IR Transmitter Hub: /esphomeyaml/components/ir_transmitter.html
|
|
.. |PCA9685 Hub| image:: /esphomeyaml/images/pca9685.jpg
|
|
:class: component-image
|
|
.. _PCA9685 Hub: /esphomeyaml/components/pca9685.html
|
|
.. |ADS1115 Hub| image:: /esphomeyaml/images/ads1115.jpg
|
|
:class: component-image
|
|
.. _ADS1115 Hub: /esphomeyaml/components/ads1115.html
|
|
.. |Debug Component| image:: /esphomeyaml/images/bug-report.svg
|
|
:class: component-image
|
|
.. _Debug Component: /esphomeyaml/components/debug.html
|
|
.. |PCF8574 I/O Expander| image:: /esphomeyaml/images/pcf8574.jpg
|
|
:class: component-image
|
|
.. _PCF8574 I/O Expander: /esphomeyaml/components/pcf8574.html
|
|
.. |ESP32 BLE Hub| image:: /esphomeyaml/images/bluetooth.svg
|
|
:class: component-image
|
|
.. _ESP32 BLE Hub: /esphomeyaml/components/esp32_ble.html
|
|
.. |ESP32 Touch Hub| image:: /esphomeyaml/images/touch.svg
|
|
:class: component-image
|
|
.. _ESP32 Touch Hub: /esphomeyaml/components/esp32_touch.html
|
|
|
|
|
|
Cookbook
|
|
^^^^^^^^
|
|
|
|
This list contains items that are technically already supported by other components.
|
|
|
|
================================================== ================================================== ==================================================
|
|
|Garage Door|_ |PIR Sensor|_ |Relay|_
|
|
-------------------------------------------------- -------------------------------------------------- --------------------------------------------------
|
|
`Garage Door`_ `PIR Sensor`_ `Relay`_
|
|
-------------------------------------------------- -------------------------------------------------- --------------------------------------------------
|
|
|BRUH Multisensor|_ |TEMT6000|_ |Non-Invasive Power Meter|_
|
|
-------------------------------------------------- -------------------------------------------------- --------------------------------------------------
|
|
`BRUH Multisensor`_ `TEMT6000`_ `Non-Invasive Power Meter`_
|
|
================================================== ================================================== ==================================================
|
|
|
|
.. |Garage Door| image:: /esphomeyaml/images/window-open.svg
|
|
:class: component-image
|
|
.. _Garage Door: /esphomeyaml/cookbook/garage-door.html
|
|
.. |PIR Sensor| image:: /esphomeyaml/images/pir.jpg
|
|
:class: component-image
|
|
.. _PIR Sensor: /esphomeyaml/cookbook/pir.html
|
|
.. |Relay| image:: /esphomeyaml/images/relay.jpg
|
|
:class: component-image
|
|
.. _Relay: /esphomeyaml/cookbook/relay.html
|
|
.. |BRUH Multisensor| image:: /esphomeyaml/images/bruh.png
|
|
:class: component-image
|
|
.. _BRUH Multisensor: /esphomeyaml/cookbook/bruh.html
|
|
.. |TEMT6000| image:: /esphomeyaml/images/temt6000.jpg
|
|
:class: component-image
|
|
.. _TEMT6000: /esphomeyaml/cookbook/temt6000.html
|
|
.. |Non-Invasive Power Meter| image:: /esphomeyaml/images/power_meter.jpg
|
|
:class: component-image
|
|
.. _Non-Invasive Power Meter: /esphomeyaml/cookbook/power_meter.html
|
|
|
|
Do you have other awesome automations or 2nd order components? Please feel free to add them to the
|
|
documentation for others to copy. See :doc:`Contributing <guides/contributing>`.
|
|
|
|
.. toctree::
|
|
:hidden:
|
|
|
|
components/index
|
|
cookbook/index
|
|
devices/index
|
|
guides/index
|