Merge pull request #1162 from esphome/bump-1.18.0b2

1.18.0b2
This commit is contained in:
Jesse Hills 2021-05-12 10:18:25 +12:00 committed by GitHub
commit faa09d274a
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
24 changed files with 151 additions and 49 deletions

View File

@ -38,7 +38,7 @@ PROJECT_NAME = "ESPHome"
# could be handy for archiving the generated documentation or if some version # could be handy for archiving the generated documentation or if some version
# control system is used. # control system is used.
PROJECT_NUMBER = 1.18.0b1 PROJECT_NUMBER = 1.18.0b2
# Using the PROJECT_BRIEF tag one can provide an optional one line description # Using the PROJECT_BRIEF tag one can provide an optional one line description
# for a project that appears at the top of each page and should give viewer a # for a project that appears at the top of each page and should give viewer a

View File

@ -1,5 +1,5 @@
ESPHOME_PATH = ../esphome ESPHOME_PATH = ../esphome
ESPHOME_REF = v1.18.0b1 ESPHOME_REF = v1.18.0b2
.PHONY: html html-strict cleanhtml deploy help webserver Makefile netlify netlify-api api netlify-dependencies svg2png copy-svg2png .PHONY: html html-strict cleanhtml deploy help webserver Makefile netlify netlify-api api netlify-dependencies svg2png copy-svg2png

View File

@ -1 +1 @@
1.18.0b1 1.18.0b2

View File

@ -387,3 +387,19 @@ All changes
- docs: Update scd30 docs to show sensors are optional :docspr:`970` by :ghuser:`jesserockz` (cherry-picked) - docs: Update scd30 docs to show sensors are optional :docspr:`970` by :ghuser:`jesserockz` (cherry-picked)
- esphome: fix esp8266 remote_transmitter using incorrect timings :esphomepr:`1465` by :ghuser:`hcoohb` (cherry-picked) - esphome: fix esp8266 remote_transmitter using incorrect timings :esphomepr:`1465` by :ghuser:`hcoohb` (cherry-picked)
- esphome: rc522 increased retry loop count :esphomepr:`1506` by :ghuser:`glmnet` (cherry-picked) - esphome: rc522 increased retry loop count :esphomepr:`1506` by :ghuser:`glmnet` (cherry-picked)
Past Changelogs
---------------
.. toctree::
:maxdepth: 1
v1.15.0
v1.14.0
v1.13.0
v1.12.0
v1.11.0
v1.10.0
v1.9.0
v1.8.0
v1.7.0

View File

@ -221,3 +221,20 @@ All changes
- docs: Update canbus.rst :docspr:`1115` by :ghuser:`meijerwynand` - docs: Update canbus.rst :docspr:`1115` by :ghuser:`meijerwynand`
- docs: Update diy.rst :docspr:`1114` by :ghuser:`murilobaliego` - docs: Update diy.rst :docspr:`1114` by :ghuser:`murilobaliego`
- docs: Update email addresses :docspr:`1122` by :ghuser:`jesserockz` - docs: Update email addresses :docspr:`1122` by :ghuser:`jesserockz`
Past Changelogs
---------------
.. toctree::
:maxdepth: 1
v1.16.0
v1.15.0
v1.14.0
v1.13.0
v1.12.0
v1.11.0
v1.10.0
v1.9.0
v1.8.0
v1.7.0

View File

@ -41,6 +41,13 @@ Breaking Changes
- esphome: Raise minimum python version to 3.7 :esphomepr:`1673` (breaking-change) - esphome: Raise minimum python version to 3.7 :esphomepr:`1673` (breaking-change)
- esphome: Change wifi signal strength unit to dBm :esphomepr:`1734` by :ghuser:`mbo18` (breaking-change) - esphome: Change wifi signal strength unit to dBm :esphomepr:`1734` by :ghuser:`mbo18` (breaking-change)
Beta Fixes
----------
- docs: Update allowed characters for node names :docspr:`1072` by :ghuser:`pkuehne`
- docs: Replaced set_password with new_password :docspr:`1157` by :ghuser:`PaulAntonDeen`
- esphome: Fix build issues for idf 4.2 (Support ESP32-S2) :esphomepr:`1433` by :ghuser:`misery`
All changes All changes
----------- -----------
@ -103,3 +110,21 @@ All changes
- docs: add External components docs :docspr:`1107` by :ghuser:`glmnet` - docs: add External components docs :docspr:`1107` by :ghuser:`glmnet`
- esphome: Implement external custom components installing from YAML :esphomepr:`1630` (new-integration) - esphome: Implement external custom components installing from YAML :esphomepr:`1630` (new-integration)
- esphome: Update copyright year :esphomepr:`1760` by :ghuser:`bonanitech` - esphome: Update copyright year :esphomepr:`1760` by :ghuser:`bonanitech`
Past Changelogs
---------------
.. toctree::
:maxdepth: 1
v1.17.0
v1.16.0
v1.15.0
v1.14.0
v1.13.0
v1.12.0
v1.11.0
v1.10.0
v1.9.0
v1.8.0
v1.7.0

View File

@ -9,7 +9,7 @@ RC522 RFID
.. _rc522-component: .. _rc522-component:
The ``rc522`` component allows you to use RC522 RFID controllers The ``rc522`` component allows you to use RC522 RFID controllers
(`datasheet <hthttps://www.nxp.com/docs/en/data-sheet/MFRC522.pdff>`__, `Ali Express <https://es.aliexpress.com/item/1260729519.html>`__) (`datasheet <https://www.nxp.com/docs/en/data-sheet/MFRC522.pdf>`__, `Ali Express <https://es.aliexpress.com/item/1260729519.html>`__)
with ESPHome. ESPHome can read the tag UID from it, every RFID tag comes with a unique with ESPHome. ESPHome can read the tag UID from it, every RFID tag comes with a unique
UID value. Each known tag can be associated to a binary sensor, or you can use the tag information directly. UID value. Each known tag can be associated to a binary sensor, or you can use the tag information directly.
See :ref:`rc522-setting_up_tags` for information on how to setup individual binary sensors for this component. See :ref:`rc522-setting_up_tags` for information on how to setup individual binary sensors for this component.

View File

@ -23,7 +23,7 @@ request so it will be added (see FAQ).
+---------------------------------------+---------------------+----------------------+ +---------------------------------------+---------------------+----------------------+
| Daikin | ``daikin`` | yes | | Daikin | ``daikin`` | yes |
+---------------------------------------+---------------------+----------------------+ +---------------------------------------+---------------------+----------------------+
| Fujitsu General | ``fujitsu_general`` | | | Fujitsu General | ``fujitsu_general`` | yes |
+---------------------------------------+---------------------+----------------------+ +---------------------------------------+---------------------+----------------------+
| Mitsubishi | ``mitsubishi`` | | | Mitsubishi | ``mitsubishi`` | |
+---------------------------------------+---------------------+----------------------+ +---------------------------------------+---------------------+----------------------+

View File

@ -152,6 +152,9 @@ These temperatures are used when the device first starts up.
**At least one of** ``default_target_temperature_low`` **and** ``default_target_temperature_high`` **At least one of** ``default_target_temperature_low`` **and** ``default_target_temperature_high``
**must be specified.** **must be specified.**
``min_temperature`` and ``max_temperature`` from the base climate component **are used to define the range**
of allowed temperature values in the thermostat component. See :doc:`/components/climate/index`
Heating and Cooling Actions Heating and Cooling Actions
*************************** ***************************
@ -267,7 +270,9 @@ Advanced Options
.. note:: .. note::
While this platform uses the term temperature everywhere, it can also be used to regulate other values. While this platform uses the term temperature everywhere, it can also be used to regulate other values.
For example, controlling humidity is also possible with this platform. For example, controlling humidity is also possible with this platform. Note that ``min_temperature`` and
``max_temperature`` from the base climate component are used the define the range of adjustability and the
defaults will probably not make sense for control of things like humidity. See :doc:`/components/climate/index`
Bang-bang vs. Thermostat Bang-bang vs. Thermostat
------------------------ ------------------------

View File

@ -82,8 +82,9 @@ This action makes the given deep sleep component enter deep sleep immediately.
on_...: on_...:
then: then:
- deep_sleep.enter: deep_sleep_1 - deep_sleep.enter:
sleep_duration: 20min id: deep_sleep_1
sleep_duration: 20min
Configuration options: Configuration options:

View File

@ -34,10 +34,10 @@ There are numerous board types out there. Some initialize differently as well. T
cs_pin: D1 cs_pin: D1
dc_pin: D2 dc_pin: D2
rotation: 0 rotation: 0
devicewidth: 128 device_width: 128
deviceheight: 160 device_height: 160
colstart: 0 col_start: 0
rowstart: 0 row_start: 0
eightbitcolor: true eightbitcolor: true
update_interval: 5s update_interval: 5s

View File

@ -49,6 +49,11 @@ configuration.
.. code-block:: yaml .. code-block:: yaml
# Example configuration entry # Example configuration entry
font:
- file: 'fonts/Comic Sans MS.ttf'
id: font1
size: 8
spi: spi:
clk_pin: D0 clk_pin: D0
mosi_pin: D1 mosi_pin: D1
@ -62,7 +67,7 @@ configuration.
model: 2.90in model: 2.90in
full_update_every: 30 full_update_every: 30
lambda: |- lambda: |-
it.print(0, 0, id(font), "Hello World!"); it.print(0, 0, id(font1), "Hello World!");
Configuration variables: Configuration variables:
------------------------ ------------------------
@ -73,7 +78,7 @@ Configuration variables:
- ``1.54in`` - ``1.54in``
- ``2.13in`` (not tested) - ``2.13in`` (not tested)
- ``2.13in-ttgo`` (T5_V2.3 tested) - ``2.13in-ttgo`` (T5_V2.3 tested. Also works for Wemos D1 Mini ePaper Shield 2.13 1.0.0 "LOLIN")
- ``2.13in-ttgo-b73`` (T5_V2.3 with B73 display tested) - ``2.13in-ttgo-b73`` (T5_V2.3 with B73 display tested)
- ``2.13in-ttgo-b1`` (T5_V2.3 with B1 display tested) - ``2.13in-ttgo-b1`` (T5_V2.3 with B1 display tested)
- ``2.70in`` (currently not working with the HAT Rev 2.1 version) - ``2.70in`` (currently not working with the HAT Rev 2.1 version)

View File

@ -24,7 +24,7 @@ Configuration variables:
- **name** (**Required**, string): This is the name of the node. It - **name** (**Required**, string): This is the name of the node. It
should always be unique in your ESPhome network. May only contain lowercase should always be unique in your ESPhome network. May only contain lowercase
characters, digits, underscores and hyphens. See :ref:`esphome-changing_node_name`. characters, digits and hyphens. See :ref:`esphome-changing_node_name`.
- **platform** (**Required**, string): The platform your board is on, - **platform** (**Required**, string): The platform your board is on,
either ``ESP32`` or ``ESP8266``. See :ref:`esphome-arduino_version`. either ``ESP32`` or ``ESP8266``. See :ref:`esphome-arduino_version`.
- **board** (**Required**, string): The board ESPHome should - **board** (**Required**, string): The board ESPHome should

View File

@ -106,7 +106,7 @@ Base Configuration:
- **id** (*Optional*, :ref:`config-id`): Manually specify the ID used for code generation. - **id** (*Optional*, :ref:`config-id`): Manually specify the ID used for code generation.
- **sensing_pin** (*Optional*, :ref:`Pin Schema <config-pin_schema>`): Pin connected to the reader's finger detection signal (WAKEUP) output. - **sensing_pin** (*Optional*, :ref:`Pin Schema <config-pin_schema>`): Pin connected to the reader's finger detection signal (WAKEUP) output.
- **password** (*Optional*, int): Password to use for authentication. Defaults to ``0x00``. - **password** (*Optional*, int): Password to use for authentication. Defaults to ``0x00``.
- **set_password** (*Optional*, int): Sets a new password to use for authentication. See :ref:`fingerprint_grow-set_new_password` for more information. - **new_password** (*Optional*, int): Sets a new password to use for authentication. See :ref:`fingerprint_grow-set_new_password` for more information.
- **on_finger_scan_matched** (*Optional*, :ref:`Automation <automation>`): An action to be performed when an enrolled fingerprint is scanned. See :ref:`fingerprint_grow-on_finger_scan_matched`. - **on_finger_scan_matched** (*Optional*, :ref:`Automation <automation>`): An action to be performed when an enrolled fingerprint is scanned. See :ref:`fingerprint_grow-on_finger_scan_matched`.
- **on_finger_scan_unmatched** (*Optional*, :ref:`Automation <automation>`): An action to be performed when an unknown fingerprint is scanned. See :ref:`fingerprint_grow-on_finger_scan_unmatched`. - **on_finger_scan_unmatched** (*Optional*, :ref:`Automation <automation>`): An action to be performed when an unknown fingerprint is scanned. See :ref:`fingerprint_grow-on_finger_scan_unmatched`.
- **on_enrollment_scan** (*Optional*, :ref:`Automation <automation>`): An action to be performed when a fingerprint is scanned during enrollment. See :ref:`fingerprint_grow-on_enrollment_scan`. - **on_enrollment_scan** (*Optional*, :ref:`Automation <automation>`): An action to be performed when a fingerprint is scanned during enrollment. See :ref:`fingerprint_grow-on_enrollment_scan`.
@ -169,15 +169,15 @@ Setting a New Password
Forgetting the password will render your fingerprint reader unusable! Forgetting the password will render your fingerprint reader unusable!
You can set a new password for your fingerprint reader using the ``set_password:`` configuration option. The password is defined as a 32-bit unsigned integer. You can set a new password for your fingerprint reader using the ``new_password:`` configuration option. The password is defined as a 32-bit unsigned integer.
.. code-block:: yaml .. code-block:: yaml
fingerprint_grow: fingerprint_grow:
password: 0x275FE3D2 # Existing password, can be omitted if it's the default of 0x00 password: 0x275FE3D2 # Existing password, can be omitted if it's the default of 0x00
set_password: 0x72AB96CD # New password new_password: 0x72AB96CD # New password
The ``set_password:`` configuration option is meant to be compiled, flashed to the ESP device and run once, after which it's removed and the new password is defined in the ``password:`` configuration option to be compiled and flashed again. The ``new_password:`` configuration option is meant to be compiled, flashed to the ESP device and run once, after which it's removed and the new password is defined in the ``password:`` configuration option to be compiled and flashed again.
.. code-block:: yaml .. code-block:: yaml

View File

@ -900,10 +900,7 @@ Configuration variables:
- **method** (*Optional*): Listening method, one of ``multicast`` or ``unicast``. Defaults to ``multicast``. - **method** (*Optional*): Listening method, one of ``multicast`` or ``unicast``. Defaults to ``multicast``.
<<<<<<< HEAD
The udp port esphome is listening on is 5568. The udp port esphome is listening on is 5568.
=======
>>>>>>> current
.. _E1.31: https://www.doityourselfchristmas.com/wiki/index.php?title=E1.31_(Streaming-ACN)_Protocol .. _E1.31: https://www.doityourselfchristmas.com/wiki/index.php?title=E1.31_(Streaming-ACN)_Protocol
.. _JINX: http://www.live-leds.de/jinx-v1-3-with-resizable-mainwindow-real-dmx-and-sacne1-31/ .. _JINX: http://www.live-leds.de/jinx-v1-3-with-resizable-mainwindow-real-dmx-and-sacne1-31/

View File

@ -4,11 +4,12 @@ CSE7766 Power Sensor
.. seo:: .. seo::
:description: Instructions for setting up CSE7766 power sensors for the Sonoff Pow R2 :description: Instructions for setting up CSE7766 power sensors for the Sonoff Pow R2
:image: cse7766.png :image: cse7766.png
:keywords: cse7766, Sonoff Pow R2 :keywords: cse7766, cse7759b, Sonoff Pow R2
The ``cse7766`` sensor platform allows you to use your CSE7766 voltage/current and power sensors The ``cse7766`` sensor platform allows you to use your CSE7766 voltage/current and power sensors
(`datasheet <http://dl.itead.cc/S31/CSE7766.pdf>`__) sensors with (`datasheet <http://dl.itead.cc/S31/CSE7766.pdf>`__) sensors with
ESPHome. This sensor is commonly found in Sonoff POW R2. ESPHome. This sensor is commonly found in Sonoff POW R2. CSE7759B is similar to CSE7766
and works with this integration.
As the communication with the CSE7766 done using UART, you need As the communication with the CSE7766 done using UART, you need
to have an :ref:`UART bus <uart>` in your configuration with the ``rx_pin`` connected to the CSE7766. to have an :ref:`UART bus <uart>` in your configuration with the ``rx_pin`` connected to the CSE7766.

View File

@ -4,11 +4,13 @@ HLW8012 Power Sensor
.. seo:: .. seo::
:description: Instructions for setting up HLW8012 power sensors for the Sonoff Pow R1 :description: Instructions for setting up HLW8012 power sensors for the Sonoff Pow R1
:image: hlw8012.png :image: hlw8012.png
:keywords: HLW8012, Sonoff Pow R1 :keywords: HLW8012, CSE7759, BL0937, Sonoff Pow R1
The ``hlw8012`` sensor platform allows you to use your HLW8012 voltage/current and power sensors The ``hlw8012`` sensor platform allows you to use your HLW8012 voltage/current and power sensors
(`datasheet <https://github.com/xoseperez/hlw8012/blob/master/docs/HLW8012.pdf>`__) sensors with (`datasheet <https://github.com/xoseperez/hlw8012/blob/master/docs/HLW8012.pdf>`__) sensors with
ESPHome. This sensor is commonly found in Sonoff POWs. ESPHome. This sensor is commonly found in Sonoff POWs. CSE7759 and BL0937 are similar to HLW8012
and work with this integration. Beware that CSE7759B is different and should be used
with the :doc:`CSE7766 <cse7766>` integration.
This sensor has two data outputs which both encode values using the frequency of a modulated signal: CF and CF1. This sensor has two data outputs which both encode values using the frequency of a modulated signal: CF and CF1.
CF's frequency is proportional to the (active) power measured and CF1 is proportional to the current/voltage. Using CF's frequency is proportional to the (active) power measured and CF1 is proportional to the current/voltage. Using

View File

@ -48,8 +48,9 @@ Configuration variables:
- **id** (*Optional*, :ref:`config-id`): Manually specify the ID used for code generation. - **id** (*Optional*, :ref:`config-id`): Manually specify the ID used for code generation.
- **total** (*Optional*): Report the total number of pulses - **total** (*Optional*): Report the total number of pulses.
All options from :ref:`Sensor <config-sensor>`.
- All options from :ref:`Sensor <config-sensor>`.
- All other options from :ref:`Sensor <config-sensor>`. - All other options from :ref:`Sensor <config-sensor>`.
@ -75,7 +76,7 @@ count the light pulses on a power meter, you can do the following:
unit_of_measurement: 'kW' unit_of_measurement: 'kW'
name: 'Power Meter House' name: 'Power Meter House'
filters: filters:
- multiply: 0.06 - multiply: 0.06 # (60s/1000 pulses per kWh)
Counting total pulses Counting total pulses
@ -94,13 +95,13 @@ measure the total consumed energy in kWh.
unit_of_measurement: 'kW' unit_of_measurement: 'kW'
name: 'Power Meter House' name: 'Power Meter House'
filters: filters:
- multiply: 0.06 - multiply: 0.06 # (60s/1000 pulses per kWh)
total: total:
unit_of_measurement: 'kWh' unit_of_measurement: 'kWh'
name: 'Energy Meter House' name: 'Energy Meter House'
filters: filters:
- multiply: 0.001 - multiply: 0.001 # (1/1000 pulses per kWh)
See Also See Also
-------- --------

View File

@ -179,8 +179,8 @@ Configuration variables:
- **eap** (*Optional*): See :ref:`eap`. - **eap** (*Optional*): See :ref:`eap`.
- **channel** (*Optional*, int): The channel of the network (1-14). If given, only connects to networks - **channel** (*Optional*, int): The channel of the network (1-14). If given, only connects to networks
that are on this channel. that are on this channel.
- **bssid** (*Optional*, string): Optionally define a BSSID (MAC-Address) of the network to connect to. - **bssid** (*Optional*, string): The connection's BSSID (MAC address). BSSIDs must consist of six
This can be used to further restrict which networks to connect to. two-digit hexadecimal values separated by colon characters ("``:``"). All letters must be in upper case.
- **hidden** (*Optional*, boolean): Whether this network is hidden. Defaults to false. - **hidden** (*Optional*, boolean): Whether this network is hidden. Defaults to false.
If you add this option you also have to specify ssid. If you add this option you also have to specify ssid.
- **priority** (*Optional*, float): The priority of this network. After each time, the network with - **priority** (*Optional*, float): The priority of this network. After each time, the network with

View File

@ -69,7 +69,7 @@ author = "Otto Winter"
# The short X.Y version. # The short X.Y version.
version = "1.18" version = "1.18"
# The full version, including alpha/beta/rc tags. # The full version, including alpha/beta/rc tags.
release = "1.18.0b1" release = "1.18.0b2"
# The language for content autogenerated by Sphinx. Refer to documentation # The language for content autogenerated by Sphinx. Refer to documentation
# for a list of supported languages. # for a list of supported languages.

View File

@ -24,6 +24,18 @@ And... that should already be it :)
:align: center :align: center
:width: 80.0% :width: 80.0%
.. note::
Some energy meters have an exposed S0 port (which essentially just is a switch that closes), if
that is the case the photodiode can be replaced with the following connection.
.. code-block::
S0 ------------ VCC
S0 --+-- 10k -- GND
. |
. +--------- GPIO12
For ESPHome, you can then use the For ESPHome, you can then use the
:doc:`pulse counter sensor </components/sensor/pulse_counter>` using below configuration: :doc:`pulse counter sensor </components/sensor/pulse_counter>` using below configuration:
@ -35,7 +47,7 @@ For ESPHome, you can then use the
unit_of_measurement: 'kW' unit_of_measurement: 'kW'
name: 'Power Meter' name: 'Power Meter'
filters: filters:
- multiply: 0.06 - multiply: 0.06 # (60s/1000 pulses per kWh)
Adjust ``GPIO12`` to match your set up of course. The output from the pulse counter sensor is in Adjust ``GPIO12`` to match your set up of course. The output from the pulse counter sensor is in
``pulses/min`` and we also know that 1000 pulses from the LED should equal 1kWh of power usage. ``pulses/min`` and we also know that 1000 pulses from the LED should equal 1kWh of power usage.

View File

@ -248,7 +248,6 @@ added ``board``, and overridden ``name`` substitutions):
platform: ESP8266 platform: ESP8266
board: esp01_1m board: esp01_1m
includes: [] includes: []
board_flash_mode: dout
libraries: [] libraries: []
esp8266_restore_from_flash: false esp8266_restore_from_flash: false
build_path: device01 build_path: device01

View File

@ -96,12 +96,12 @@ That's no good. Here are some steps that resolve some problems:
How to submit an issue report How to submit an issue report
----------------------------- -----------------------------
First of all, thank you very much to everybody submitting issue reports! While I try to test ESPHome/yaml as much as First of all, thank you very much to everybody submitting issue reports! While we try to test ESPHome/YAML as much as
I can using my own hardware, I don't own every single device type and mostly only do tests with my own home automation we can using our available hardware, we don't own every single device type and rely on testing done by the community
system. When doing some changes in the core, it can quickly happen that something somewhere breaks. Issue reports are a and the contributors. When doing some changes in the core, it can quickly happen that something somewhere breaks.
great way for me to track and (hopefully) fix issues, so thank you! Issue reports are a great way for us to track and (hopefully) fix issues, so thank you!
For me to fix the issue quickly, there are some things that would be really helpful: For us to fix the issue quickly, there are some things that would be really helpful:
1. **Just writing "X doesn't work" or "X gives bug" is not helpful!!!** Seriously, how do you expect 1. **Just writing "X doesn't work" or "X gives bug" is not helpful!!!** Seriously, how do you expect
help given just that information? help given just that information?
@ -121,7 +121,7 @@ It's simple. Run:
.. code-block:: bash .. code-block:: bash
pip install -U esphome pip3 install -U esphome
# From docker: # From docker:
docker pull esphome/esphome:latest docker pull esphome/esphome:latest
@ -139,7 +139,7 @@ by installing the tested beta:
.. code-block:: bash .. code-block:: bash
# For pip-based installs # For pip-based installs
pip install --pre -U esphome pip3 install --pre -U esphome
# For docker-based installs # For docker-based installs
docker run [...] -it esphome/esphome:beta livingroom.yaml run docker run [...] -it esphome/esphome:beta livingroom.yaml run
@ -155,13 +155,13 @@ How do I use the latest bleeding edge version?
---------------------------------------------- ----------------------------------------------
First, a fair warning that the latest bleeding edge version is not always stable and might have issues. First, a fair warning that the latest bleeding edge version is not always stable and might have issues.
If you find some, please do however report them if you have time :) If you find some, please do however report them.
To install the dev version of ESPHome: To install the dev version of ESPHome:
- In Hass.io: Add the ESPHome repository `https://github.com/esphome/hassio <https://github.com/esphome/hassio>` - In Hass.io: Add the ESPHome repository `https://github.com/esphome/hassio <https://github.com/esphome/hassio>`
in Add-on store -> Repositories. Then install the add-on ``ESPHome Dev`` in Add-on store -> Repositories. Then install the add-on ``ESPHome Dev``
- From ``pip``: Run ``pip install https://github.com/esphome/esphome/archive/dev.zip`` - From ``pip``: Run ``pip3 install https://github.com/esphome/esphome/archive/dev.zip``
- From docker, use the `esphome/esphome:dev <https://hub.docker.com/r/esphome/esphome/tags?page=1&name=dev>`__ image - From docker, use the `esphome/esphome:dev <https://hub.docker.com/r/esphome/esphome/tags?page=1&name=dev>`__ image
.. code-block:: bash .. code-block:: bash
@ -192,7 +192,7 @@ request in the `ESPHome feature request tracker <https://github.com/esphome/feat
I have a question... How can I contact you? I have a question... How can I contact you?
------------------------------------------- -------------------------------------------
Sure! I'd be happy to help :) You can contact me here: Sure! We are be happy to help :) You can contact us here:
- `Discord <https://discord.gg/KhAMKrd>`__ - `Discord <https://discord.gg/KhAMKrd>`__
- `Home Assistant Community Forums <https://community.home-assistant.io/c/third-party/esphome>`__ - `Home Assistant Community Forums <https://community.home-assistant.io/c/third-party/esphome>`__
@ -206,8 +206,8 @@ Sure! I'd be happy to help :) You can contact me here:
My node keeps reconnecting randomly My node keeps reconnecting randomly
----------------------------------- -----------------------------------
Jep, that's a known issue. However, it seems to be very low-level and I don't really know Jep, that's a known issue. However, it seems to be very low-level and we don't really know
how to solve it. I'm working on possible workarounds for the issue but currently I do how to solve it. We are working on possible workarounds for the issue but currently we do
not have a real solution. not have a real solution.
Some steps that can help with the issue: Some steps that can help with the issue:

View File

@ -45,6 +45,7 @@ Contributors
- `Alex Mekkering (@AlexMekkering) <https://github.com/AlexMekkering>`__ - `Alex Mekkering (@AlexMekkering) <https://github.com/AlexMekkering>`__
- `Alex (@alexyao2015) <https://github.com/alexyao2015>`__ - `Alex (@alexyao2015) <https://github.com/alexyao2015>`__
- `Amish Vishwakarma (@amishv) <https://github.com/amishv>`__ - `Amish Vishwakarma (@amishv) <https://github.com/amishv>`__
- `andig (@andig) <https://github.com/andig>`__
- `András Bíró (@andrasbiro) <https://github.com/andrasbiro>`__ - `András Bíró (@andrasbiro) <https://github.com/andrasbiro>`__
- `Andreas Hergert (@andreashergert1984) <https://github.com/andreashergert1984>`__ - `Andreas Hergert (@andreashergert1984) <https://github.com/andreashergert1984>`__
- `Andrzej (@andriej) <https://github.com/andriej>`__ - `Andrzej (@andriej) <https://github.com/andriej>`__
@ -57,9 +58,11 @@ Contributors
- `Darius Ratkevičius (@aphex008) <https://github.com/aphex008>`__ - `Darius Ratkevičius (@aphex008) <https://github.com/aphex008>`__
- `Ash McKenzie (@ashmckenzie) <https://github.com/ashmckenzie>`__ - `Ash McKenzie (@ashmckenzie) <https://github.com/ashmckenzie>`__
- `Pavel Pletenev (@ASMfreaK) <https://github.com/ASMfreaK>`__ - `Pavel Pletenev (@ASMfreaK) <https://github.com/ASMfreaK>`__
- `Mike Dunston (@atanisoft) <https://github.com/atanisoft>`__
- `Achilleas Pipinellis (@axilleas) <https://github.com/axilleas>`__ - `Achilleas Pipinellis (@axilleas) <https://github.com/axilleas>`__
- `Kamil Trzciński (@ayufan) <https://github.com/ayufan>`__ - `Kamil Trzciński (@ayufan) <https://github.com/ayufan>`__
- `Nicholas Peters (@Azimath) <https://github.com/Azimath>`__ - `Nicholas Peters (@Azimath) <https://github.com/Azimath>`__
- `Daniel (@azrael783) <https://github.com/azrael783>`__
- `Florian Mösch (@badbadc0ffee) <https://github.com/badbadc0ffee>`__ - `Florian Mösch (@badbadc0ffee) <https://github.com/badbadc0ffee>`__
- `balk77 (@balk77) <https://github.com/balk77>`__ - `balk77 (@balk77) <https://github.com/balk77>`__
- `Paulus Schoutsen (@balloob) <https://github.com/balloob>`__ - `Paulus Schoutsen (@balloob) <https://github.com/balloob>`__
@ -69,6 +72,7 @@ Contributors
- `Ben Suffolk (@bensuffolk) <https://github.com/bensuffolk>`__ - `Ben Suffolk (@bensuffolk) <https://github.com/bensuffolk>`__
- `Bierchermuesli (@Bierchermuesli) <https://github.com/Bierchermuesli>`__ - `Bierchermuesli (@Bierchermuesli) <https://github.com/Bierchermuesli>`__
- `Jim Ekman (@blejdfist) <https://github.com/blejdfist>`__ - `Jim Ekman (@blejdfist) <https://github.com/blejdfist>`__
- `Bob (@Bmooij) <https://github.com/Bmooij>`__
- `Mauricio Bonani (@bonanitech) <https://github.com/bonanitech>`__ - `Mauricio Bonani (@bonanitech) <https://github.com/bonanitech>`__
- `boradwell (@boradwell) <https://github.com/boradwell>`__ - `boradwell (@boradwell) <https://github.com/boradwell>`__
- `Patrik Hermansson (@bphermansson) <https://github.com/bphermansson>`__ - `Patrik Hermansson (@bphermansson) <https://github.com/bphermansson>`__
@ -82,13 +86,16 @@ Contributors
- `Carlos Gustavo Sarmiento (@carlos-sarmiento) <https://github.com/carlos-sarmiento>`__ - `Carlos Gustavo Sarmiento (@carlos-sarmiento) <https://github.com/carlos-sarmiento>`__
- `Carlos Garcia Saura (@CarlosGS) <https://github.com/CarlosGS>`__ - `Carlos Garcia Saura (@CarlosGS) <https://github.com/CarlosGS>`__
- `cbialobos (@cbialobos) <https://github.com/cbialobos>`__ - `cbialobos (@cbialobos) <https://github.com/cbialobos>`__
- `Ciprian Constantinescu (@cciprian5) <https://github.com/cciprian5>`__
- `Marco (@cdrfun) <https://github.com/cdrfun>`__ - `Marco (@cdrfun) <https://github.com/cdrfun>`__
- `chris-jennings (@chris-jennings) <https://github.com/chris-jennings>`__ - `chris-jennings (@chris-jennings) <https://github.com/chris-jennings>`__
- `Pavel Skuratovich (@Chupaka) <https://github.com/Chupaka>`__
- `John (@CircuitSetup) <https://github.com/CircuitSetup>`__ - `John (@CircuitSetup) <https://github.com/CircuitSetup>`__
- `Chris Debenham (@cjd) <https://github.com/cjd>`__ - `Chris Debenham (@cjd) <https://github.com/cjd>`__
- `Cody James (@codyjamestechnical) <https://github.com/codyjamestechnical>`__ - `Cody James (@codyjamestechnical) <https://github.com/codyjamestechnical>`__
- `John Coggeshall (@coogle) <https://github.com/coogle>`__ - `John Coggeshall (@coogle) <https://github.com/coogle>`__
- `James Crook (@cooljimy84) <https://github.com/cooljimy84>`__ - `James Crook (@cooljimy84) <https://github.com/cooljimy84>`__
- `copercini (@copercini) <https://github.com/copercini>`__
- `Corban Mailloux (@corbanmailloux) <https://github.com/corbanmailloux>`__ - `Corban Mailloux (@corbanmailloux) <https://github.com/corbanmailloux>`__
- `Dmitry Berezovsky (@corvis) <https://github.com/corvis>`__ - `Dmitry Berezovsky (@corvis) <https://github.com/corvis>`__
- `Connor Prussin (@cprussin) <https://github.com/cprussin>`__ - `Connor Prussin (@cprussin) <https://github.com/cprussin>`__
@ -122,6 +129,7 @@ Contributors
- `Mickaël Le Baillif (@demikl) <https://github.com/demikl>`__ - `Mickaël Le Baillif (@demikl) <https://github.com/demikl>`__
- `dependabot[bot] (@dependabot[bot]) <https://github.com/dependabot[bot]>`__ - `dependabot[bot] (@dependabot[bot]) <https://github.com/dependabot[bot]>`__
- `Destix (@Destix) <https://github.com/Destix>`__ - `Destix (@Destix) <https://github.com/Destix>`__
- `Dezorian (@Dezorian) <https://github.com/Dezorian>`__
- `Alain Turbide (@Dilbert66) <https://github.com/Dilbert66>`__ - `Alain Turbide (@Dilbert66) <https://github.com/Dilbert66>`__
- `Mark (@Diramu) <https://github.com/Diramu>`__ - `Mark (@Diramu) <https://github.com/Diramu>`__
- `Dirk Heinke (@DirkHeinke) <https://github.com/DirkHeinke>`__ - `Dirk Heinke (@DirkHeinke) <https://github.com/DirkHeinke>`__
@ -181,6 +189,7 @@ Contributors
- `Fredrik Erlandsson (@fredrike) <https://github.com/fredrike>`__ - `Fredrik Erlandsson (@fredrike) <https://github.com/fredrike>`__
- `Evgeny (@freekode) <https://github.com/freekode>`__ - `Evgeny (@freekode) <https://github.com/freekode>`__
- `Brett McKenzie (@freerangeeggs) <https://github.com/freerangeeggs>`__ - `Brett McKenzie (@freerangeeggs) <https://github.com/freerangeeggs>`__
- `Franck Nijhof (@frenck) <https://github.com/frenck>`__
- `Fritz Mueller (@fritzm) <https://github.com/fritzm>`__ - `Fritz Mueller (@fritzm) <https://github.com/fritzm>`__
- `Marc Egli (@frog32) <https://github.com/frog32>`__ - `Marc Egli (@frog32) <https://github.com/frog32>`__
- `mr G1K (@G1K) <https://github.com/G1K>`__ - `mr G1K (@G1K) <https://github.com/G1K>`__
@ -227,6 +236,7 @@ Contributors
- `Jason-nz (@Jason-nz) <https://github.com/Jason-nz>`__ - `Jason-nz (@Jason-nz) <https://github.com/Jason-nz>`__
- `Jason Hines (@jasonehines) <https://github.com/jasonehines>`__ - `Jason Hines (@jasonehines) <https://github.com/jasonehines>`__
- `JbLb (@jblb) <https://github.com/jblb>`__ - `JbLb (@jblb) <https://github.com/jblb>`__
- `James Callaghan (@jcallaghan) <https://github.com/jcallaghan>`__
- `Joshua Dadswell (@jdads1) <https://github.com/jdads1>`__ - `Joshua Dadswell (@jdads1) <https://github.com/jdads1>`__
- `jeff-h (@jeff-h) <https://github.com/jeff-h>`__ - `jeff-h (@jeff-h) <https://github.com/jeff-h>`__
- `Jeff Rescignano (@JeffResc) <https://github.com/JeffResc>`__ - `Jeff Rescignano (@JeffResc) <https://github.com/JeffResc>`__
@ -272,6 +282,7 @@ Contributors
- `KristopherMackowiak (@KristopherMackowiak) <https://github.com/KristopherMackowiak>`__ - `KristopherMackowiak (@KristopherMackowiak) <https://github.com/KristopherMackowiak>`__
- `kroimon (@kroimon) <https://github.com/kroimon>`__ - `kroimon (@kroimon) <https://github.com/kroimon>`__
- `Kendell R (@KTibow) <https://github.com/KTibow>`__ - `Kendell R (@KTibow) <https://github.com/KTibow>`__
- `Jakub Šimo (@kubik369) <https://github.com/kubik369>`__
- `kvvoff (@kvvoff) <https://github.com/kvvoff>`__ - `kvvoff (@kvvoff) <https://github.com/kvvoff>`__
- `Ken Davidson (@kwdavidson) <https://github.com/kwdavidson>`__ - `Ken Davidson (@kwdavidson) <https://github.com/kwdavidson>`__
- `Kyle Manna (@kylemanna) <https://github.com/kylemanna>`__ - `Kyle Manna (@kylemanna) <https://github.com/kylemanna>`__
@ -279,6 +290,7 @@ Contributors
- `Stefan Lässer (@Laess3r) <https://github.com/Laess3r>`__ - `Stefan Lässer (@Laess3r) <https://github.com/Laess3r>`__
- `Steffen Weinreich (@lairsdragon) <https://github.com/lairsdragon>`__ - `Steffen Weinreich (@lairsdragon) <https://github.com/lairsdragon>`__
- `Fredrik Lindqvist (@Landrash) <https://github.com/Landrash>`__ - `Fredrik Lindqvist (@Landrash) <https://github.com/Landrash>`__
- `larsonmpdx (@larsonmpdx) <https://github.com/larsonmpdx>`__
- `lein1013 (@lein1013) <https://github.com/lein1013>`__ - `lein1013 (@lein1013) <https://github.com/lein1013>`__
- `Riku Lindblad (@lepinkainen) <https://github.com/lepinkainen>`__ - `Riku Lindblad (@lepinkainen) <https://github.com/lepinkainen>`__
- `Juraj Liso (@LiJu09) <https://github.com/LiJu09>`__ - `Juraj Liso (@LiJu09) <https://github.com/LiJu09>`__
@ -299,6 +311,7 @@ Contributors
- `Major Péter (@majorpeter) <https://github.com/majorpeter>`__ - `Major Péter (@majorpeter) <https://github.com/majorpeter>`__
- `Manuel Díez (@manutenfruits) <https://github.com/manutenfruits>`__ - `Manuel Díez (@manutenfruits) <https://github.com/manutenfruits>`__
- `Marcel van der Veldt (@marcelveldt) <https://github.com/marcelveldt>`__ - `Marcel van der Veldt (@marcelveldt) <https://github.com/marcelveldt>`__
- `Marc Teale (@marcteale) <https://github.com/marcteale>`__
- `marecabo (@marecabo) <https://github.com/marecabo>`__ - `marecabo (@marecabo) <https://github.com/marecabo>`__
- `Marvin Gaube (@margau) <https://github.com/margau>`__ - `Marvin Gaube (@margau) <https://github.com/margau>`__
- `Martynas Griškonis (@Margriko) <https://github.com/Margriko>`__ - `Martynas Griškonis (@Margriko) <https://github.com/Margriko>`__
@ -310,8 +323,10 @@ Contributors
- `MasterTim17 (@MasterTim17) <https://github.com/MasterTim17>`__ - `MasterTim17 (@MasterTim17) <https://github.com/MasterTim17>`__
- `matikij (@matikij) <https://github.com/matikij>`__ - `matikij (@matikij) <https://github.com/matikij>`__
- `Michel Marti (@matoxp) <https://github.com/matoxp>`__ - `Michel Marti (@matoxp) <https://github.com/matoxp>`__
- `matt123p (@matt123p) <https://github.com/matt123p>`__
- `Maurice Schleußinger (@maurice-schleussinger) <https://github.com/maurice-schleussinger>`__ - `Maurice Schleußinger (@maurice-schleussinger) <https://github.com/maurice-schleussinger>`__
- `mbo18 (@mbo18) <https://github.com/mbo18>`__ - `mbo18 (@mbo18) <https://github.com/mbo18>`__
- `Me No Dev (@me-no-dev) <https://github.com/me-no-dev>`__
- `Joseph Mearman (@Mearman) <https://github.com/Mearman>`__ - `Joseph Mearman (@Mearman) <https://github.com/Mearman>`__
- `Mechotronic (@Mechotronic) <https://github.com/Mechotronic>`__ - `Mechotronic (@Mechotronic) <https://github.com/Mechotronic>`__
- `MeIchthys (@meichthys) <https://github.com/meichthys>`__ - `MeIchthys (@meichthys) <https://github.com/meichthys>`__
@ -322,6 +337,7 @@ Contributors
- `Pauline Middelink (@middelink) <https://github.com/middelink>`__ - `Pauline Middelink (@middelink) <https://github.com/middelink>`__
- `mikosoft83 (@mikosoft83) <https://github.com/mikosoft83>`__ - `mikosoft83 (@mikosoft83) <https://github.com/mikosoft83>`__
- `Minideezel (@minideezel) <https://github.com/minideezel>`__ - `Minideezel (@minideezel) <https://github.com/minideezel>`__
- `André Klitzing (@misery) <https://github.com/misery>`__
- `Matthew Edwards (@mje-nz) <https://github.com/mje-nz>`__ - `Matthew Edwards (@mje-nz) <https://github.com/mje-nz>`__
- `Maarten (@mjkl-gh) <https://github.com/mjkl-gh>`__ - `Maarten (@mjkl-gh) <https://github.com/mjkl-gh>`__
- `mjoshd (@mjoshd) <https://github.com/mjoshd>`__ - `mjoshd (@mjoshd) <https://github.com/mjoshd>`__
@ -361,6 +377,7 @@ Contributors
- `Stanislav Meduna (@numo68) <https://github.com/numo68>`__ - `Stanislav Meduna (@numo68) <https://github.com/numo68>`__
- `Nuno Sousa (@nunofgs) <https://github.com/nunofgs>`__ - `Nuno Sousa (@nunofgs) <https://github.com/nunofgs>`__
- `Chris Nussbaum (@nuttytree) <https://github.com/nuttytree>`__ - `Chris Nussbaum (@nuttytree) <https://github.com/nuttytree>`__
- `obrain17 (@obrain17) <https://github.com/obrain17>`__
- `Dave Walker (@oddsockmachine) <https://github.com/oddsockmachine>`__ - `Dave Walker (@oddsockmachine) <https://github.com/oddsockmachine>`__
- `Olivér Falvai (@ofalvai) <https://github.com/ofalvai>`__ - `Olivér Falvai (@ofalvai) <https://github.com/ofalvai>`__
- `Omar Ghader (@omarghader) <https://github.com/omarghader>`__ - `Omar Ghader (@omarghader) <https://github.com/omarghader>`__
@ -413,6 +430,7 @@ Contributors
- `rnauber (@rnauber) <https://github.com/rnauber>`__ - `rnauber (@rnauber) <https://github.com/rnauber>`__
- `Rob Deutsch (@rob-deutsch) <https://github.com/rob-deutsch>`__ - `Rob Deutsch (@rob-deutsch) <https://github.com/rob-deutsch>`__
- `Rob de Jonge (@robdejonge) <https://github.com/robdejonge>`__ - `Rob de Jonge (@robdejonge) <https://github.com/robdejonge>`__
- `Robert Alfaro (@robert-alfaro) <https://github.com/robert-alfaro>`__
- `Robin Smidsrød (@robinsmidsrod) <https://github.com/robinsmidsrod>`__ - `Robin Smidsrød (@robinsmidsrod) <https://github.com/robinsmidsrod>`__
- `RockBomber (@RockBomber) <https://github.com/RockBomber>`__ - `RockBomber (@RockBomber) <https://github.com/RockBomber>`__
- `RoganDawes (@RoganDawes) <https://github.com/RoganDawes>`__ - `RoganDawes (@RoganDawes) <https://github.com/RoganDawes>`__
@ -459,6 +477,7 @@ Contributors
- `Teemu Mikkonen (@T3m3z) <https://github.com/T3m3z>`__ - `Teemu Mikkonen (@T3m3z) <https://github.com/T3m3z>`__
- `Taigar2015 (@Taigar2015) <https://github.com/Taigar2015>`__ - `Taigar2015 (@Taigar2015) <https://github.com/Taigar2015>`__
- `Levente Tamas (@tamisoft) <https://github.com/tamisoft>`__ - `Levente Tamas (@tamisoft) <https://github.com/tamisoft>`__
- `tantive (@tantive) <https://github.com/tantive>`__
- `TBobsin (@TBobsin) <https://github.com/TBobsin>`__ - `TBobsin (@TBobsin) <https://github.com/TBobsin>`__
- `Team Super Panda (@teamsuperpanda) <https://github.com/teamsuperpanda>`__ - `Team Super Panda (@teamsuperpanda) <https://github.com/teamsuperpanda>`__
- `teffcz (@teffcz) <https://github.com/teffcz>`__ - `teffcz (@teffcz) <https://github.com/teffcz>`__
@ -472,6 +491,7 @@ Contributors
- `Mateusz Soszyński (@TheLastGimbus) <https://github.com/TheLastGimbus>`__ - `Mateusz Soszyński (@TheLastGimbus) <https://github.com/TheLastGimbus>`__
- `Andrew Quested (@thenameiwantedwastaken) <https://github.com/thenameiwantedwastaken>`__ - `Andrew Quested (@thenameiwantedwastaken) <https://github.com/thenameiwantedwastaken>`__
- `Zixuan Wang (@TheNetAdmin) <https://github.com/TheNetAdmin>`__ - `Zixuan Wang (@TheNetAdmin) <https://github.com/TheNetAdmin>`__
- `Simon (@theOzzieRat) <https://github.com/theOzzieRat>`__
- `Florian Gareis (@TheZoker) <https://github.com/TheZoker>`__ - `Florian Gareis (@TheZoker) <https://github.com/TheZoker>`__
- `Thomas Klingbeil (@thomasklingbeil) <https://github.com/thomasklingbeil>`__ - `Thomas Klingbeil (@thomasklingbeil) <https://github.com/thomasklingbeil>`__
- `Andrew Thompson (@thompsa) <https://github.com/thompsa>`__ - `Andrew Thompson (@thompsa) <https://github.com/thompsa>`__
@ -497,6 +517,7 @@ Contributors
- `Tuckie (@Tuckie) <https://github.com/Tuckie>`__ - `Tuckie (@Tuckie) <https://github.com/Tuckie>`__
- `Alexey Vlasov (@turbulator) <https://github.com/turbulator>`__ - `Alexey Vlasov (@turbulator) <https://github.com/turbulator>`__
- `Seppel Hardt (@tuxBurner) <https://github.com/tuxBurner>`__ - `Seppel Hardt (@tuxBurner) <https://github.com/tuxBurner>`__
- `Thorsten von Eicken (@tve) <https://github.com/tve>`__
- `tyomikh (@tyomikh) <https://github.com/tyomikh>`__ - `tyomikh (@tyomikh) <https://github.com/tyomikh>`__
- `ukewea (@ukewea) <https://github.com/ukewea>`__ - `ukewea (@ukewea) <https://github.com/ukewea>`__
- `Vc (@Valcob) <https://github.com/Valcob>`__ - `Vc (@Valcob) <https://github.com/Valcob>`__
@ -530,4 +551,4 @@ Contributors
- `San (@zhujunsan) <https://github.com/zhujunsan>`__ - `San (@zhujunsan) <https://github.com/zhujunsan>`__
- `Christian Zufferey (@zuzu59) <https://github.com/zuzu59>`__ - `Christian Zufferey (@zuzu59) <https://github.com/zuzu59>`__
*This page was last updated May 10, 2021.* *This page was last updated May 12, 2021.*