From 255a3b361121debec82237a0b2ef663480db1373 Mon Sep 17 00:00:00 2001 From: Jesse Hills <3060199+jesserockz@users.noreply.github.com> Date: Tue, 24 Aug 2021 13:28:33 +1200 Subject: [PATCH 1/9] Fix bump-version script for no `v` (#1414) --- script/bump-version.py | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/script/bump-version.py b/script/bump-version.py index 0a38889f9..a5ee3557f 100755 --- a/script/bump-version.py +++ b/script/bump-version.py @@ -49,11 +49,11 @@ def sub(path, pattern, repl, expected_count=1): def write_version(version: Version): - # ESPHOME_REF = v1.14.4 + # ESPHOME_REF = 2021.8.0 sub( "Makefile", r"ESPHOME_REF = .*", - f"ESPHOME_REF = v{version}" if not version.dev else "ESPHOME_REF = dev", + f"ESPHOME_REF = {version}" if not version.dev else "ESPHOME_REF = dev", ) # PROJECT_NUMBER = 1.14.4 sub( From e94618771407bac981301a16f0408f12fe696075 Mon Sep 17 00:00:00 2001 From: Jesse Hills <3060199+jesserockz@users.noreply.github.com> Date: Tue, 24 Aug 2021 14:26:35 +1200 Subject: [PATCH 2/9] Bump version to 2021.8.1 --- Doxygen | 2 +- Makefile | 2 +- _static/version | 2 +- conf.py | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/Doxygen b/Doxygen index 7c3e8be59..33926b6ce 100644 --- a/Doxygen +++ b/Doxygen @@ -38,7 +38,7 @@ PROJECT_NAME = "ESPHome" # could be handy for archiving the generated documentation or if some version # control system is used. -PROJECT_NUMBER = 2021.8.0 +PROJECT_NUMBER = 2021.8.1 # 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 diff --git a/Makefile b/Makefile index c05ce9e7f..3635f6b2b 100644 --- a/Makefile +++ b/Makefile @@ -1,5 +1,5 @@ ESPHOME_PATH = ../esphome -ESPHOME_REF = 2021.8.0 +ESPHOME_REF = 2021.8.1 .PHONY: html html-strict cleanhtml deploy help webserver Makefile netlify netlify-api api netlify-dependencies svg2png copy-svg2png diff --git a/_static/version b/_static/version index a77cee31c..3f8cfaf55 100644 --- a/_static/version +++ b/_static/version @@ -1 +1 @@ -2021.8.0 \ No newline at end of file +2021.8.1 \ No newline at end of file diff --git a/conf.py b/conf.py index da0771112..36143327e 100644 --- a/conf.py +++ b/conf.py @@ -69,7 +69,7 @@ author = "Otto Winter" # The short X.Y version. version = "2021.8" # The full version, including alpha/beta/rc tags. -release = "2021.8.0" +release = "2021.8.1" # The language for content autogenerated by Sphinx. Refer to documentation # for a list of supported languages. From 50a99fa2ce08413ee11d9c7f33f878f8f03e8b26 Mon Sep 17 00:00:00 2001 From: Jesse Hills <3060199+jesserockz@users.noreply.github.com> Date: Tue, 24 Aug 2021 14:27:51 +1200 Subject: [PATCH 3/9] Update changelog for 2021.8.1 --- changelog/2021.8.0.rst | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/changelog/2021.8.0.rst b/changelog/2021.8.0.rst index b1276ff7b..441d9d780 100644 --- a/changelog/2021.8.0.rst +++ b/changelog/2021.8.0.rst @@ -98,6 +98,18 @@ need to downgrade the esphome version because a new version does not work the wa should be using the snapshot/backup feature built into Home Assistant Supervisor to rollback. +Release 2021.8.1 - August 24 +---------------------------- + +- Fix pypi download url :esphomepr:`2177` by :ghuser:`jesserockz` +- Light: include ON_OFF capability to BRIGHTNESS ColorMode :esphomepr:`2186` by :ghuser:`puuu` +- Fix addressable light control without transitions & effects with transitions :esphomepr:`2187` by :ghuser:`oxan` +- mqtt_light: remove legacy API config that is not compatible with HA 2021.8 :esphomepr:`2183` by :ghuser:`puuu` +- Tuya fan component uses enum datapoint type for speed instead of integer :esphomepr:`2182` by :ghuser:`nuttytree` +- Fix template select lambda :esphomepr:`2198` by :ghuser:`ssieb` +- Send Celsius temperature unit in MQTT discovery message :esphomepr:`1840` by :ghuser:`mtl010957` + + Full list of changes -------------------- From 4f29f772305261d2fad74fb41ef3bd0cb5c55ddc Mon Sep 17 00:00:00 2001 From: Jesse Hills <3060199+jesserockz@users.noreply.github.com> Date: Tue, 24 Aug 2021 14:28:08 +1200 Subject: [PATCH 4/9] Update supporters for 2021.8.1 --- guides/supporters.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/guides/supporters.rst b/guides/supporters.rst index 0f9c6843d..b8aa935e7 100644 --- a/guides/supporters.rst +++ b/guides/supporters.rst @@ -82,6 +82,7 @@ Contributors - `Viktr (@BbIKTOP) `__ - `J. Nick Koston (@bdraco) `__ - `Ben Suffolk (@bensuffolk) `__ +- `Ivan Bessarabov (@bessarabov) `__ - `Bierchermuesli (@Bierchermuesli) `__ - `JDavid (@blackhack) `__ - `Branimir Lambov (@blambov) `__ @@ -479,6 +480,7 @@ Contributors - `Derrick Lyndon Pallas (@pallas) `__ - `Panuruj Khambanonda (PK) (@panuruj) `__ - `Pasi Suominen (@pasiz) `__ +- `Patrick Felstead (@patfelst) `__ - `Paul Deen (@PaulAntonDeen) `__ - `Paul Monigatti (@paulmonigatti) `__ - `Paul Nicholls (@pauln) `__ @@ -685,4 +687,4 @@ Contributors - `ZTX18 (@ZTX18) `__ - `Christian Zufferey (@zuzu59) `__ -*This page was last updated August 18, 2021.* +*This page was last updated August 24, 2021.* From 0d0eec784d90fa4d95ea0c035612b38e376feaab Mon Sep 17 00:00:00 2001 From: Jesse Hills <3060199+jesserockz@users.noreply.github.com> Date: Wed, 25 Aug 2021 13:32:28 +1200 Subject: [PATCH 5/9] Remove custom uart text sensor from table (#1418) --- index.rst | 1 - 1 file changed, 1 deletion(-) diff --git a/index.rst b/index.rst index 929cc2603..3ebc71a61 100644 --- a/index.rst +++ b/index.rst @@ -497,7 +497,6 @@ Text Sensor Components BLE Scanner, components/text_sensor/ble_scanner, bluetooth.svg Template Text Sensor, components/text_sensor/template, description.svg Custom Text Sensor, components/text_sensor/custom, language-cpp.svg - Custom UART Text Sensor, components/text_sensor/uart, language-cpp.svg Nextion Text Sensor, components/text_sensor/nextion, nextion.jpg Climate Components From 39aa899ece318a1ba0b2448b7d4f21bae18c6caf Mon Sep 17 00:00:00 2001 From: Seganku Date: Tue, 24 Aug 2021 18:33:12 -0700 Subject: [PATCH 6/9] Update Nextion Editor URL (#1416) --- components/display/nextion.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/components/display/nextion.rst b/components/display/nextion.rst index 43459b5fb..516c7ef8e 100644 --- a/components/display/nextion.rst +++ b/components/display/nextion.rst @@ -78,7 +78,7 @@ Rendering Lambda With Nextion displays, a dedicated chip on the display itself does the whole rendering. ESPHome can only send *instructions* to the display to tell it *how* to render something and *what* to render. -First, you need to use the `Nextion Editor `__ to +First, you need to use the `Nextion Editor `__ to create a display file and insert it using the SD card slot. Then, in the rendering ``lambda``, you can use the various API calls to populate data on the display: From 6d8f24d2693b3236d7d289e5dc6d827e8c593534 Mon Sep 17 00:00:00 2001 From: Oxan van Leeuwen Date: Wed, 25 Aug 2021 03:37:12 +0200 Subject: [PATCH 7/9] Update devices documentation (#1412) --- components/esphome.rst | 18 ++++++++++-------- devices/esp32.rst | 9 +++++++-- devices/esp8266.rst | 2 +- devices/nodemcu_esp8266.rst | 3 ++- devices/sonoff.rst | 4 ---- devices/sonoff_basic.rst | 1 - 6 files changed, 20 insertions(+), 17 deletions(-) diff --git a/components/esphome.rst b/components/esphome.rst index 7f96ef3d2..709a93ceb 100644 --- a/components/esphome.rst +++ b/components/esphome.rst @@ -27,14 +27,14 @@ Configuration variables: - **name** (**Required**, string): This is the name of the node. It should always be unique in your ESPHome network. May only contain lowercase characters, digits and hyphens. See :ref:`esphome-changing_node_name`. -- **platform** (**Required**, string): The platform your board is on, - either ``ESP32`` or ``ESP8266``. See :ref:`esphome-arduino_version`. -- **board** (**Required**, string): The board ESPHome should - specify for PlatformIO. For the ESP32, choose the appropriate one - from `this list `__ - and use `this list `__ - for ESP8266-based boards. *This only affects pin aliases and some internal settings*, if unsure - choose the generic board option! +- **platform** (**Required**, string): The platform your board is using, + either ``ESP32`` or ``ESP8266``. +- **board** (**Required**, string): The PlatformIO board ID that should + be used. Choose the appropriate board from + `this list ` for the ESP8266, and + `this list for the ESP32 (the icon + next to the name can be used to copy the board ID). *This only affects pin aliases and some internal settings*, + if unsure choose a generic board from Espressif. Advanced options: @@ -105,6 +105,8 @@ option you can tell ESPHome which Arduino framework to use for compiling. For the ESP8266, you currently can manually pin the Arduino version to these values (see the full list of Arduino frameworks `here `__): +* `3.0.1 `__ (not recommended yet) +* `3.0.0 `__ (not recommended yet) * `2.7.4 `__ (default) * `2.7.3 `__ * `2.7.2 `__ diff --git a/devices/esp32.rst b/devices/esp32.rst index e530bc01e..0ecaafb1e 100644 --- a/devices/esp32.rst +++ b/devices/esp32.rst @@ -4,10 +4,11 @@ Generic ESP32 .. seo:: :description: Information about how to use generic ESP32 boards in ESPHome. :image: esp32.png + :keywords: ESP32 -All ESP32-based devices are supported by ESPHome. Simply select ``ESP32`` when +All devices based on the original ESP32 are supported by ESPHome. Simply select ``ESP32`` when the ESPHome wizard asks you for your platform and choose a board type -from `this link `__ when the wizard +from `this link `__ when the wizard asks you for the board type. .. code-block:: yaml @@ -18,6 +19,10 @@ asks you for the board type. platform: ESP32 board: +.. note:: + + Support for the ESP32-S2 and ESP32-C3 is currently in development. + The ESP32 boards often use the internal GPIO pin numbering on the board, this means that you don't have to worry about other kinds of pin numberings, yay! diff --git a/devices/esp8266.rst b/devices/esp8266.rst index 69183b39f..a2cf4c7d2 100644 --- a/devices/esp8266.rst +++ b/devices/esp8266.rst @@ -8,7 +8,7 @@ Generic ESP8266 All ESP8266-based devices are supported by ESPHome. Simply select ``ESP8266`` when the ESPHome wizard asks you for your platform and choose a board type -from `this link `__ when the wizard +from `this link `__ when the wizard asks you for the board type. diff --git a/devices/nodemcu_esp8266.rst b/devices/nodemcu_esp8266.rst index 4e0bbda36..777328a86 100644 --- a/devices/nodemcu_esp8266.rst +++ b/devices/nodemcu_esp8266.rst @@ -43,10 +43,11 @@ In general, it is best to just use the ``D0``, ``D1``, ... pin numbering to avoi Note that in certain conditions you *can* use the pins marked as ``INTERNAL`` in above image. - ``D0`` also can be used to wake the device up from :doc:`deep sleep ` if - the pin is connected to the ``RESET`` pin. ``D0`` is additionally connected to the LED + the pin is connected to the ``RESET`` pin. On some boards ``D0`` is additionally connected to the LED next to the UART chip, but in an inverted mode. - ``D3``, ``D4`` and ``D8`` are used on startup to determine the boot mode, therefore these pins should not be pulled low on startup. You can, however, still use them as output pins. +- ``D4`` additionally is connected to the blue LED next to the antenna, but in an inverted mode. - ``A0``: This pin can be used as a normal GPIO pin (like ``D1`` etc) but additionally can measure voltages from 0 to 1.0V using the :doc:`/components/sensor/adc`. - ``VIN``: This board can be powered by an external power supply by using this pin. Supply a voltage depends on the board you use. Some boards support up to 12V, some up to 5V. diff --git a/devices/sonoff.rst b/devices/sonoff.rst index 480bec526..0c4004c49 100644 --- a/devices/sonoff.rst +++ b/devices/sonoff.rst @@ -15,10 +15,6 @@ and shipping from China takes a long time, I've only set up dedicated guides for name: platform: ESP8266 board: esp8285 - arduino_version: 2.4.2 - -The selected board and arduino_version are required in v1.14.3 (and probably later), see -https://github.com/esphome/issues/issues/931 for details. After that use the following list of pin to function mappings to set up your Sonoff device. This list has been compiled from the Sonoff Tasmota pin source file which can be found here: diff --git a/devices/sonoff_basic.rst b/devices/sonoff_basic.rst index 1b64d5305..a0d330536 100644 --- a/devices/sonoff_basic.rst +++ b/devices/sonoff_basic.rst @@ -55,7 +55,6 @@ exposes all of the basic functions. name: platform: ESP8266 board: esp8285 - arduino_version: 2.4.2 wifi: ssid: From 3ca1b6a15856e25736ca23753a789a26dc9b0e3a Mon Sep 17 00:00:00 2001 From: haade <76404800+haade-administrator@users.noreply.github.com> Date: Wed, 25 Aug 2021 03:46:17 +0200 Subject: [PATCH 8/9] Update diy.rst (#1391) --- guides/diy.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/guides/diy.rst b/guides/diy.rst index d8811e959..a1d5f9909 100644 --- a/guides/diy.rst +++ b/guides/diy.rst @@ -48,6 +48,7 @@ Blog Posts & Videos - `Baseboard (Line Voltage) Thermostat from Smart Switch `__ by :ghuser:`rjmurph2241` - `Office Doorbell `__ by :ghuser:`shish` - `Display TM1637 with ESPHome and MQTT showing Youtube subscribers count and other info `__ by :ghuser:`electrofun-smart` +- `Automate your garage door with ESP8266 lysignal Yunshan 7v-30v `__ by :ghuser:`haade-administrator` Custom Components & Code ------------------------ From c9287aa60e69c04fc7089d4e448480b360bb8c8c Mon Sep 17 00:00:00 2001 From: Stephen Tierney Date: Wed, 25 Aug 2021 11:56:44 +1000 Subject: [PATCH 9/9] Fix CO2 spelling inconsistency (#1419) --- index.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.rst b/index.rst index 3ebc71a61..708912fc4 100644 --- a/index.rst +++ b/index.rst @@ -175,7 +175,7 @@ Air Quality SGP40, components/sensor/sgp40, sgp40.jpg, Volatile organics SM300D2, components/sensor/sm300d2, sm300d2.jpg, Air quality SPS30, components/sensor/sps30, sps30.jpg, Particulate - T6613/15, components/sensor/t6615, t6615.png, C02 + T6613/15, components/sensor/t6615, t6615.png, CO2 ZyAura, components/sensor/zyaura, zgm053.jpg, CO2 & Temperature & Humidity