From 907ebdc6aefede981162d2f84ef10cc76b6850c3 Mon Sep 17 00:00:00 2001
From: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
Date: Thu, 8 Aug 2024 09:49:01 +0200
Subject: [PATCH 001/484] Rename yaml icon to config file icon. update
description (#34193)
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
---
.../getting-started/concepts-terminology.markdown | 2 +-
.../{yaml-icon.png => config-file_icon.png} | Bin
2 files changed, 1 insertion(+), 1 deletion(-)
rename source/images/getting-started/{yaml-icon.png => config-file_icon.png} (100%)
diff --git a/source/getting-started/concepts-terminology.markdown b/source/getting-started/concepts-terminology.markdown
index c9e9fa14cda8..965c545a48ab 100644
--- a/source/getting-started/concepts-terminology.markdown
+++ b/source/getting-started/concepts-terminology.markdown
@@ -13,7 +13,7 @@ Integrations are pieces of software that allow Home Assistant to connect to othe
Some integration cards show an icon:
- The cloud icon 
indicates that this integration depends on the cloud.
-- The YAML icon 
indicates that this integration was not setup via the UI. You have either set it up in YAML or it is a dependency set up by an other integration. If you want to configure it, you will need to do so in your configuration.yaml file.
+The file icon 
indicates that this integration was not set up via the UI. You have either set it up in your {% term "`configuration.yaml`" %} file, or it is a dependency set up by another integration. If you want to configure it, you will need to do so in your {% term "`configuration.yaml`" %} file.
- The custom icon 
indicates that this is not an official Home Assistant integration but that it was custom made. It could be imported from another source, for example downloaded from HACS.
For a full list of compatible {% term integrations %}, refer to the [integrations](/integrations) documentation.
diff --git a/source/images/getting-started/yaml-icon.png b/source/images/getting-started/config-file_icon.png
similarity index 100%
rename from source/images/getting-started/yaml-icon.png
rename to source/images/getting-started/config-file_icon.png
From 4db0d677550dce04269075bd60a177ab1d13ced3 Mon Sep 17 00:00:00 2001
From: override80
Date: Thu, 8 Aug 2024 12:18:46 +0200
Subject: [PATCH 002/484] Fix: update seventeentrack example card (#34198)
---
source/_integrations/seventeentrack.markdown | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/source/_integrations/seventeentrack.markdown b/source/_integrations/seventeentrack.markdown
index c8308a9ee8ee..46878d070b0e 100644
--- a/source/_integrations/seventeentrack.markdown
+++ b/source/_integrations/seventeentrack.markdown
@@ -62,7 +62,7 @@ type: markdown
title: Packages in transit
content: >
{% for package in
- states.sensor.seventeentrack_packages_in_transit.attributes.packages %}
+ states.sensor['17track_in_transit'].attributes.packages %}
>- **{{ package.friendly_name }} ({{ package.tracking_number }}):** {{
package.info_text }}
From 9580a2f41e58da245616d3a95ab49b52495f2688 Mon Sep 17 00:00:00 2001
From: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
Date: Thu, 8 Aug 2024 12:19:42 +0200
Subject: [PATCH 003/484] Matter device update: add screenshot (#34197)
---
source/_integrations/matter.markdown | 11 +++++++++--
.../integrations/matter/matter_ota_message.png | Bin 0 -> 26645 bytes
2 files changed, 9 insertions(+), 2 deletions(-)
create mode 100644 source/images/integrations/matter/matter_ota_message.png
diff --git a/source/_integrations/matter.markdown b/source/_integrations/matter.markdown
index 74a06d0807cf..1255b1fce9b4 100644
--- a/source/_integrations/matter.markdown
+++ b/source/_integrations/matter.markdown
@@ -322,9 +322,16 @@ This section provides a bit more information on some of the categories:
**IP addresses**: Typically more than one IPv6 address is shown: link local, unique local, and global unicast. In some cases a device also supports IPv4. In that case there will also be listed an IPv4 address here.
-## Matter device updates
+## Matter OTA device updates
-The Matter standard supports OTA (Over-the-Air) updates optionally. Matter devices that support Matter updates will have an [update entity](/integrations/update). Furthermore, the CSA DCL (Distributed Compliance Ledger) stores firmware update information. Home Assistant reads firmware update information directly from the DCL to learn about available updates. By default, the integration checks every 12 hours for an update. If you want to force an update check, use the `homeassistant.update_entity` [action](/integrations/homeassistant/) with the update entity as the target.
+The Matter protocol supports OTA (Over-the-Air) software updates. But the OTA software update is an optional feature for Matter devices, so not all Matter devices implement it. Home Assistant creates an update entity for every Matter device which does support Matter updates.
+
+The CSA operates a Distributed Compliance Ledger (DCL) which provides metadata for firmware updates. By default, the Matter update entities check the DCL every 12 hours for updates. If you want to force an update check, use the `homeassistant.update_entity` [action](/integrations/homeassistant/), with the update entity as the target. Currently, Eve and Nanoleaf are using the DCL to provide updates. It is expected that in future, more and more firmware updates become available through the DCL.
+
+
+
+Notification of an OTA update for a Matter device
+
## Experiment with Matter using a ESP32 dev board
diff --git a/source/images/integrations/matter/matter_ota_message.png b/source/images/integrations/matter/matter_ota_message.png
new file mode 100644
index 0000000000000000000000000000000000000000..11ec08ccaa52ee9d6e940c95c5ddebd1cf5c57f3
GIT binary patch
literal 26645
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
L
Date: Thu, 8 Aug 2024 12:26:50 +0200
Subject: [PATCH 004/484] Explain Reolink password character set limitiations
(#34196)
Co-authored-by: Franck Nijhof
---
source/_integrations/reolink.markdown | 3 ++-
1 file changed, 2 insertions(+), 1 deletion(-)
diff --git a/source/_integrations/reolink.markdown b/source/_integrations/reolink.markdown
index cac2c1e41837..24002159f63f 100644
--- a/source/_integrations/reolink.markdown
+++ b/source/_integrations/reolink.markdown
@@ -35,7 +35,8 @@ The integration allows you to control [Reolink](https://reolink.com/) NVRs or ca
{% include integrations/config_flow.md %}
-On the Reolink device, a user account with admin privileges is needed for the proper operation of this integration.
+- On the Reolink device, a user account with admin privileges is needed for the proper operation of this integration.
+- The password used for the Reolink device can only contain characters `a-z, A-Z, 0-9 or @$*~_-+=!?.,:;'()[]`. Other special characters will cause encoding issues in the video streams used by this integration and are, therefore, not allowed. When using an incompatible special character in the password, the integration will prompt you to change the password.
{% include integrations/option_flow.md %}
{% configuration_basic %}
From 0ed5a9ba89f1755b54cefba12d26fdbd54509793 Mon Sep 17 00:00:00 2001
From: Franck Nijhof
Date: Thu, 8 Aug 2024 14:11:43 +0200
Subject: [PATCH 005/484] Fix/Adjust WLED documentation (#34204)
---
source/_integrations/wled.markdown | 68 ++++++++++++++++++------------
1 file changed, 40 insertions(+), 28 deletions(-)
diff --git a/source/_integrations/wled.markdown b/source/_integrations/wled.markdown
index 5f2634743817..6d858121c657 100644
--- a/source/_integrations/wled.markdown
+++ b/source/_integrations/wled.markdown
@@ -27,11 +27,19 @@ ha_integration_type: device
---
[WLED](https://kno.wled.ge) is a fast and feature-rich
-implementation of an ESP8266/ESP32 webserver to control
-NeoPixel (WS2812B, WS2811, SK6812, APA102, and similar) LED's.
+implementation of an ESP8266/ESP32 webserver to control NeoPixel LEDs
+(like WS2812B, WS2811, SK6812, and similar) and SPI based chipsets
+(like WS2801 and APA102).
-While Home Assistant supports WLED 0.8.4 and higher, the use of WLED 0.10 and
-newer is recommended to get the optimal experience.
+## Prerequisites
+
+{% important %}
+This integration requires a WLED device running WLED 0.14.0 or newer.
+{% endimportant %}
+
+You can install the latest version of WLED on your device by going to
+the [WLED web installer](https://install.wled.me/) or by downloading the
+latest release from the [WLED GitHub releases page](https://github.com/Aircoookie/WLED/releases).
{% include integrations/config_flow.md %}
@@ -46,10 +54,8 @@ Only native supported features of a light in Home Assistant are supported
### Using WLED segments
-WLED can split a single LED strip into multiple segments.
-These segments can be controlled separately in WLED and in Home Assistant as
-well. The fully-featured segment control has been introduced in WLED 0.10
-but has been partly around via APIs since WLED 0.8.6.
+WLED can split a single LED strip into multiple segments. These segments can be
+controlled separately in WLED and in Home Assistant as well.
If WLED has 1 segment defined (the default), that one segment controls the whole
LED strip. Home Assistant creates a single light {% term entity %} to control the
@@ -63,7 +69,8 @@ Additionally, select and number entities described below will be created for eac
## Select entities
-This {% term integration %} provides selects for the following information from WLED:
+This {% term integration %} provides [select entities](/integrations/select)
+for the following information from WLED:
- Playlist
- Preset
@@ -71,52 +78,57 @@ This {% term integration %} provides selects for the following information from
## Number entities
-This {% term integration %} provides `number` entities to control the following, segment-specific settings:
+This {% term integration %} provides [number entities](/integrations/number)
+to control the following, segment-specific settings:
- Intensity
- Speed
## Sensor entities
-This {% term integration %} provides sensors for the following information from WLED:
+This {% term integration %} provides [sensor entities](/integrations/sensor)
+for the following information from WLED:
-- Estimated current (in mA).
+- Estimated current (in mA)
- Uptime (disabled by default)
-- Free memory (in bytes, disabled by default).
-- Wi-Fi Signal Strength (in %, disabled by default).
-- Wi-Fi Signal Strength (RSSI in dBm, disabled by default).
-- Wi-Fi Channel (disabled by default).
-- Wi-Fi BSSID (disabled by default).
-- IP.
+- Free memory (in bytes, disabled by default)
+- Wi-Fi Signal Strength (in %, disabled by default)
+- Wi-Fi Signal Strength (RSSI in dBm, disabled by default)
+- Wi-Fi Channel (disabled by default)
+- Wi-Fi BSSID (disabled by default)
+- IP Address
## Switches
-The {% term integration %} will create a number of switches:
+The {% term integration %} will also create a number of
+[switch entities](/integrations/switch).
### Nightlight
Toggles the WLED Timer.
-Can be configured on the WLED itself under settings > LED Preferences > Timed light.
+Can be configured on the WLED itself under
+**Settings** > **LED Preferences** > **Timed light**.
### Sync receive and sync send
Toggles the synchronization between multiple WLED devices.
-Can be configured on the WLED itself under settings > Sync Interfaces > WLED Broadcast.
+Can be configured on the WLED itself under
+**Ssettings** > **Sync Interfaces** > **WLED Broadcast**.
[WLED Sync documentation](https://kno.wled.ge/interfaces/udp-realtime/)
## Firmware updates
-The {% term integration %} has an [update entity](/integrations/update/) that provides
-information on the latest available version of WLED and indicates if a
-firmware update is available for installation.
+The {% term integration %} has an [update entity](/integrations/update/)
+that provides information on the latest available version of WLED
+and indicates if a firmware update is available for installation.
The firmware update can be triggered and installed onto your WLED device
directly from Home Assistant.
-The update {% term entity %} will only provide updates to stable versions, unless you are
-using a beta version of WLED. In that case, the update {% term entity %} will also provide
-updates to newer beta versions.
+The update {% term entity %} will only provide updates to stable versions,
+unless you are using a beta version of WLED. In that case, the update
+{% term entity %} will also provide updates to newer beta versions.
{% include integrations/option_flow.md %}
@@ -182,7 +194,7 @@ to a preset called My Preset:
An automation to turn on a WLED light and select a specific palette and
set intensity, and speed can be created by first calling the `light.turn_on`
-service, then calling the `select.select_option` action to select the
+action, then calling the `select.select_option` action to select the
palette, then call the `number.set_value` action to set the intensity
and again to set the speed.
From 595dfc24ca49e14a2c7cf20d3c57ed2da04ffe3f Mon Sep 17 00:00:00 2001
From: "Mr. Bubbles"
Date: Thu, 8 Aug 2024 16:27:57 +0200
Subject: [PATCH 006/484] Improve documentation for IronOS integration (#34094)
* Clarification for raw tip voltage sensor, add ha category
* add comma
---
source/_integrations/iron_os.markdown | 7 ++++++-
1 file changed, 6 insertions(+), 1 deletion(-)
diff --git a/source/_integrations/iron_os.markdown b/source/_integrations/iron_os.markdown
index 3f3591357e4a..bdd7fa27a551 100644
--- a/source/_integrations/iron_os.markdown
+++ b/source/_integrations/iron_os.markdown
@@ -2,6 +2,7 @@
title: IronOS
description: Instructions on how to integrate IronOS-based Pinecil V2 devices with Home Assistant.
ha_category:
+ - Number
- Sensor
ha_iot_class: Local Polling
ha_release: 2024.8
@@ -17,6 +18,10 @@ ha_platforms:
The **IronOS** {% term integration %} seamlessly connects Home Assistant with PINE64's Pinecil V2 soldering irons, allowing for remote monitoring and control. This integration provides real-time updates on temperature, power, and various other settings and diagnostic information.
+## Minimum requirements
+
+- **Pinecil V2** requires IronOS v2.21 or higher to connect to Home Assistant. Please refer to the [Pinecil Wiki](https://wiki.pine64.org/wiki/Pinecil_Firmware#Overview) for update instructions.
+
{% include integrations/config_flow.md %}
## Number controls
@@ -34,7 +39,7 @@ The **IronOS** {% term integration %} seamlessly connects Home Assistant with PI
- **Max tip temperature:** Indicates the maximum temperature that the currently inserted soldering iron tip supports.
- **Power level:** Displays the duty cycle of the pulse-width modulation (PWM) in percent, indicating the current power output of the soldering iron (for example, "50%" for a 50% duty cycle).
- **Power source:** Identifies the current power source used by the soldering iron, such as DC input, USB Quick Charge, USB Power Delivery, or USB Power Delivery VBUS.
-- **Raw tip voltage:** Measures the raw voltage at the soldering iron tip.
+- **Raw tip voltage:** Measures the raw voltage at the soldering iron's thermocouple, which is then offset compensated and converted to the tip temperature.
- **Tip resistance:** Indicates the resistance of the currently inserted soldering iron tip (for example, "6.2 Ω" for short tips, "8 Ω" for normal tips)
- **Uptime:** Tracks the total operating time of the soldering iron since its last power-on.
- **Hall effect strength:** (Optional) This feature requires the device to be [modified with a hall effect sensor](https://wiki.pine64.org/wiki/Pinecil_Hall_Effect_Sensor). If a neodymium magnet is attached to the stand, it enables proximity detection and can be utilized to calibrate when the iron enters sleep mode based on its proximity to the stand.
From 3e55eded0f8a245618e621bce0bdb088a37af52a Mon Sep 17 00:00:00 2001
From: Gord <31004434+googanhiem@users.noreply.github.com>
Date: Thu, 8 Aug 2024 18:12:28 +0100
Subject: [PATCH 007/484] Upload of the Works with Home Assistant blog (#34206)
---
...h-home-assistant-becomes-part-ohf.markdown | 48 ++++++++++++++++++
.../images/blog/2024-08-wwha-update/art.jpg | Bin 0 -> 113249 bytes
.../blog/2024-08-wwha-update/wwha-badges.png | Bin 0 -> 48258 bytes
.../wwha-company-logos.png | Bin 0 -> 41308 bytes
4 files changed, 48 insertions(+)
create mode 100644 source/_posts/2024-08-08-works-with-home-assistant-becomes-part-ohf.markdown
create mode 100644 source/images/blog/2024-08-wwha-update/art.jpg
create mode 100644 source/images/blog/2024-08-wwha-update/wwha-badges.png
create mode 100644 source/images/blog/2024-08-wwha-update/wwha-company-logos.png
diff --git a/source/_posts/2024-08-08-works-with-home-assistant-becomes-part-ohf.markdown b/source/_posts/2024-08-08-works-with-home-assistant-becomes-part-ohf.markdown
new file mode 100644
index 000000000000..6ad0cc237bcf
--- /dev/null
+++ b/source/_posts/2024-08-08-works-with-home-assistant-becomes-part-ohf.markdown
@@ -0,0 +1,48 @@
+---
+layout: post
+title: "Works with Home Assistant becomes part of the Open Home Foundation"
+description: "A number of changes to the program are looking to build a better hardware ecosystem for the smart home."
+date: 2024-08-08 00:00:01
+date_formatted: "August 8, 2024"
+author: Guy Sie
+comments: true
+categories: Announcements
+og_image: /images/blog/2024-08-wwha-update/art.jpg
+---
+
Art by Clelia Rella
+
+After two successful years of [Works with Home Assistant](https://partner.home-assistant.io/), we’re continuing our work to improve this program. With this in mind, the program will move to the non-profit organization that owns Home Assistant, the [Open Home Foundation](https://www.openhomefoundation.org/), which will ensure it is always aligned with the [values of the Open Home](https://www.openhomefoundation.org/about/).
+
+Read on to see how we're making several small but important changes to add more clarity to the program, and ultimately working to build a better, larger hardware ecosystem of smart home devices.
+
+
+
+## What is Works with Home Assistant
+
+When you want to add something to your smart home the choices can be daunting; we want stable, supported devices that are built on standards that last. We understood how hard it could be to navigate all this and [set up Works with Home Assistant in 2022](/blog/2022/07/12/partner-program/), clearly indicating to users which brands provided the best smart home experiences and will continue to do so into the future. While also encouraging brands to step up their openness, compatibility, and long-term support.
+
+
+
+This program has been quite successful and now includes seven companies, including [Leviton](/blog/2022/07/27/leviton-partner/), [Third Reality](/blog/2022/10/13/third-reality-partner/), [Ultraloq](/blog/2022/10/25/ultraloq-partner/), [Jasco](/blog/2022/10/26/jasco-partner/), [Heltun](/blog/2023/03/03/heltun-partner/), [HomeSeer](/blog/2023/04/11/homeseer-partner/), and [HomeWizard](/blog/2023/12/07/homewizard-joins-works-with-home-assistant-program/). Our community regularly recommends the brands in this program, not only because they carry the “Works with” logo but because they just work. This seamless operation is because Nabu Casa tests devices and works with the brand to ensure their software meets our requirements to provide what we consider to be the best Home Assistant experience. They also guarantee when joining that they will address issues and maintain support with Home Assistant over time.
+
+We have had lots of positive feedback from the brands in the program. First off, if you’re already doing things right, i.e. focusing on local control, supporting users, and keeping software compatible, it's relatively easy to join. It is also significantly more affordable compared to other partner programs. We want to connect our users to good hardware and help reward the brands that make the right decisions: win-win.
+
+## Open Home Foundation steps in
+
+This year we [announced the Open Home Foundation](https://www.openhomefoundation.org/blog/announcing-the-open-home-foundation/), a non-profit organization that now owns and governs the Home Assistant project. It makes logical sense that Works with Home Assistant now sits alongside its parent organization, but there are other key benefits. Specifically, it is now clear that this program is not a commercial endeavor; it is solely here to encourage a better-supported hardware ecosystem for Home Assistant.
+
+Nabu Casa, the commercial partner of the Open Home Foundation, previously successfully administered the program. By placing the program under the foundation, it provides another layer to ensure the program remains focused on its mission.
+
+## The update
+
+While we’re making this shift from Nabu Casa to the Open Home Foundation, we’re also taking the opportunity to do some housekeeping, improving the program on several fronts.
+
+From now on the program will be certifying individual devices instead of whole brands. Previously, an integration was approved for Works with Home Assistant, and all devices that could work with the integration could fall under the program. By making testing and certification device-specific, it becomes much clearer to users which devices they can purchase with confidence. We will soon start listing devices that have been certified specifically.
+
+
No brands have used the Cloud badge before, so no one is affected by its removal.
+
+The cloud badge has been discontinued and this is due to our belief, and observation, that all [cloud-based products are always doomed to stop working](https://newsletter.openhomefoundation.org/all-cloud-based-products-will-come-to-an-end/), some sooner than others. Considering the [cases over the past year](https://newsletter.openhomefoundation.org/all-cloud-based-products-will-come-to-an-end/#:~:text=How%20not%20to%20phase%20out%20cloud%2Dbased%20products) of cloud-based devices becoming useless after the cloud service they depended on was shut down, and the lengths needed to keep them somewhat functional, we no longer believe the Works with Home Assistant promise can be upheld by cloud-based devices.
+
+## Conclusion
+
+We want to see Works with Home Assistant continue to grow, ultimately covering every smart home device category, allowing for a home completely made of products that will give the best experience. We’d recommend users to always consider these products first, and also encourage more brands to [get in touch to join](https://partner.home-assistant.io/). Let’s build a more open hardware ecosystem together.
diff --git a/source/images/blog/2024-08-wwha-update/art.jpg b/source/images/blog/2024-08-wwha-update/art.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..8c89fb0fbd880aee134e3b87a60ee52c9d9836d3
GIT binary patch
literal 113249
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�b&=>}KSb11X2Gu`0
zDhMr9AL=K0S#Czb%l#m(_LU4}wSIs%xY=$AtyooN^1I$aD-1$e%Q7T(=*7%{QNrCKN+vXh#H@j-;5#tuedKkU&YI7sfbrN&2
zU$04e$|Opc*u7>WuaBhRz1$WpsaCJZ?h6GLhu+~!{&TA%dJ=^Z_N>HtySpF|L(|6R
z3+fqoYVzjA)`fKY?dHTq+d_p@8N7d%gMzYMK@VsxqS!9%XA%1m<;-PD$4
zVfTOzG(4#uN+z4h
z%FC5zq37?j%PpM{J-!x{1OC7KMmvCXg)r6$Ju3kqK+llxwIwuphA#V)`YgkF6mQXE
zY>ngv4Edw>z;wo_GOI38J8#3Eo)(9*sudvw#xFDK4jM7zv%4A9fj-B6t|M>ic6DLqP&Vyd1?5nPV+kSr^P|XuKSzYK;Oq88(rFkyn<}mLr5a&La7zqzL
zD6O)keNxu3!nc>>3&J|n<|3#`i1S3hUlnttZ!r_oWYaIQaNNS34nei1o>}A%zbmCi
zKX&fc(
zZCa;*3BVt*_ohyd$%+Mf2x1A>*Mfsli4v$}00<
zLoGUFw%#&