From 1e1345d937fd30234d3d900bde4d63fd304abdde Mon Sep 17 00:00:00 2001 From: mchangsp Date: Tue, 25 Feb 2025 01:47:34 +0100 Subject: [PATCH 01/12] Update slide_local.markdown (#37678) --- source/_integrations/slide_local.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/slide_local.markdown b/source/_integrations/slide_local.markdown index 2958422c420..77aadac796b 100644 --- a/source/_integrations/slide_local.markdown +++ b/source/_integrations/slide_local.markdown @@ -74,7 +74,7 @@ The integration fetches data from the device every 15 seconds. ## Known limitations -The integration only provides connection with Slide devices via the local API. For connecting via the cloud API, please use the [Slide](./slide) integration. +The integration only provides connection with Slide devices via the local API. The cloud API is no longer available. ## Remove integration From 65ba6a9948f65b21c75b2f455a263a333cc22778 Mon Sep 17 00:00:00 2001 From: TJ Horner Date: Mon, 24 Feb 2025 17:24:09 -0800 Subject: [PATCH 02/12] Update Dexcom docs to clarify email user ID is required (#37664) --- source/_integrations/dexcom.markdown | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/source/_integrations/dexcom.markdown b/source/_integrations/dexcom.markdown index a31e6d65f25..efe2f1d2358 100644 --- a/source/_integrations/dexcom.markdown +++ b/source/_integrations/dexcom.markdown @@ -18,7 +18,9 @@ The Dexcom integration allows you to view your CGM data from [Dexcom](https://ww ## Prerequisites -You will need to set up the [Dexcom Share](https://provider.dexcom.com/education-research/cgm-education-use/videos/setting-dexcom-share-and-follow) feature in your Dexcom G6 App to use this integration. Enabling the Dexcom Share service requires setup of at least one follower. The integration will use the Dexcom user's credentials, not the follower's credentials. +You will need to set up the Dexcom Share feature in your Dexcom [G6](https://provider.dexcom.com/education-research/cgm-education-use/videos/setting-dexcom-share-and-follow) or [G7](https://www.dexcom.com/faqs/how-do-i-share-my-dexcom-g7-glucose-data-with-followers) app to use this integration. Enabling the Dexcom Share service requires setup of at least one follower. The integration will use the Dexcom user's credentials, not the follower's credentials. + +Your Dexcom account must have an email address—not a phone number—as its primary user ID. If you normally log into your Dexcom account using a phone number, then this integration will not work. It is unfortunately not possible to change from a phone to email user ID after an account is created, so you will need to create a new Dexcom account in this case. {% include integrations/config_flow.md %} From 52b44388a21907ff09b8e3c16b179f933254b717 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Tue, 25 Feb 2025 07:57:13 +0100 Subject: [PATCH 03/12] build(deps-dev): bump sass-embedded from 1.85.0 to 1.85.1 (#37684) Bumps [sass-embedded](https://github.com/sass-contrib/sass-embedded-host-ruby) from 1.85.0 to 1.85.1. - [Commits](https://github.com/sass-contrib/sass-embedded-host-ruby/compare/v1.85.0...v1.85.1) --- updated-dependencies: - dependency-name: sass-embedded dependency-type: direct:development update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> --- Gemfile | 2 +- Gemfile.lock | 6 +++--- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/Gemfile b/Gemfile index 78b4e119bbc..0a47dbe1fbd 100644 --- a/Gemfile +++ b/Gemfile @@ -10,7 +10,7 @@ group :development do gem 'stringex', '2.8.6' # > 2.1.0 causes slowdowns https://github.com/sass/sassc-ruby/issues/189 gem 'sassc', '2.1.0' - gem 'sass-embedded', '1.85.0' + gem 'sass-embedded', '1.85.1' gem 'rubocop', '1.72.2' gem 'ruby-lsp', '0.23.11' gem 'rackup', '2.2.1' diff --git a/Gemfile.lock b/Gemfile.lock index 39cff3dffb0..3e400e3d2be 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -141,9 +141,9 @@ GEM ruby2_keywords (0.0.5) safe_yaml (1.0.5) sass (3.4.25) - sass-embedded (1.85.0-arm64-darwin) + sass-embedded (1.85.1-arm64-darwin) google-protobuf (~> 4.29) - sass-embedded (1.85.0-x86_64-linux-gnu) + sass-embedded (1.85.1-x86_64-linux-gnu) google-protobuf (~> 4.29) sass-globbing (1.1.5) sass (>= 3.1) @@ -186,7 +186,7 @@ DEPENDENCIES rake (= 13.2.1) rubocop (= 1.72.2) ruby-lsp (= 0.23.11) - sass-embedded (= 1.85.0) + sass-embedded (= 1.85.1) sass-globbing (= 1.1.5) sassc (= 2.1.0) sinatra (= 4.1.1) From b0c2998f9ad6a3763689964a0514ecaccd76b150 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Tue, 25 Feb 2025 07:57:33 +0100 Subject: [PATCH 04/12] build(deps-dev): bump sorbet-runtime from 0.5.11851 to 0.5.11856 (#37685) Bumps [sorbet-runtime](https://github.com/sorbet/sorbet) from 0.5.11851 to 0.5.11856. - [Release notes](https://github.com/sorbet/sorbet/releases) - [Commits](https://github.com/sorbet/sorbet/commits) --- updated-dependencies: - dependency-name: sorbet-runtime dependency-type: indirect update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> --- Gemfile.lock | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Gemfile.lock b/Gemfile.lock index 3e400e3d2be..c713dafde37 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -158,7 +158,7 @@ GEM rack-protection (= 4.1.1) rack-session (>= 2.0.0, < 3) tilt (~> 2.0) - sorbet-runtime (0.5.11851) + sorbet-runtime (0.5.11856) stringex (2.8.6) terminal-table (3.0.2) unicode-display_width (>= 1.1.1, < 3) From b347db27f73dd76156ba3cfc04bf567b89eba35c Mon Sep 17 00:00:00 2001 From: Manu <4445816+tr4nt0r@users.noreply.github.com> Date: Tue, 25 Feb 2025 08:02:26 +0100 Subject: [PATCH 05/12] Fix formatting (#37675) --- source/_integrations/habitica.markdown | 36 ++++++++++++++------------ 1 file changed, 19 insertions(+), 17 deletions(-) diff --git a/source/_integrations/habitica.markdown b/source/_integrations/habitica.markdown index 0ba104f2012..ef5948cbf99 100644 --- a/source/_integrations/habitica.markdown +++ b/source/_integrations/habitica.markdown @@ -114,8 +114,8 @@ The following Habitica tasks are available as to-do lists in Home Assistant. You ## Calendars -- **To-Do calendar:** Lists the due dates for all active to-do tasks. Each event on this calendar represents a to-do item that has a set due date, making it easy to track upcoming deadlines and plan accordingly. -- **Dailies calendar:** Displays all daily tasks that are scheduled for today and are still active. It also shows all tasks scheduled for future dates, helping you stay organized and track upcoming routines. The calendar sensor will be active if there are unfinished tasks for today and display the next due daily (based on sort order if there are multiple tasks due for that day). +- **To-Do calendar**: Lists the due dates for all active to-do tasks. Each event on this calendar represents a to-do item that has a set due date, making it easy to track upcoming deadlines and plan accordingly. +- **Dailies calendar**: Displays all daily tasks that are scheduled for today and are still active. It also shows all tasks scheduled for future dates, helping you stay organized and track upcoming routines. The calendar sensor will be active if there are unfinished tasks for today and display the next due daily (based on sort order if there are multiple tasks due for that day). - **To-Do reminders calendar**: Lists events for reminders associated with your to-dos in Habitica, helping you track when notifications for specific to-dos are expected. - **Dailies reminders calendar**: Shows events for reminders linked to your Habitica dailies, ensuring you know when notifications for your dailies will occur. @@ -134,13 +134,13 @@ If you've unlocked the class system, button controls for casting player and part - **Ethereal surge**: You sacrifice Mana so the rest of your party, except for other mages, gains MP. (based on: INT) - **Earthquake**: Your mental power shakes the earth and buffs your party's intelligence. (based on: unbuffed INT) -- **Chilling frost:** With one cast, ice freezes all your streaks so they won't reset to zero tomorrow. +- **Chilling frost**: With one cast, ice freezes all your streaks so they won't reset to zero tomorrow. ### Warrior - **Defensive stance**: You crouch low and gain a buff to constitution. (based on: unbuffed CON) - **Valorous presence**: Your boldness buffs your whole party's strength. (based on: unbuffed STR) -- **Intimidating gaze:** Your fierce stare buffs your whole Party's constitution. (based on: unbuffed CON) +- **Intimidating gaze**: Your fierce stare buffs your whole Party's constitution. (based on: unbuffed CON) ### Rogue @@ -172,9 +172,9 @@ Use a skill or spell from your Habitica character on a specific task to affect i #### Available skills -- **Rogue:** `pickpocket`, `backstab` -- **Warrior:** `smash` -- **Mage:** `fireball` +- **Rogue**: `pickpocket`, `backstab` +- **Warrior**: `smash` +- **Mage**: `fireball` To use task aliases, make sure **Developer Mode** is enabled under [**Settings -> Site Data**](https://habitica.com/user/settings/siteData). Task aliases can only be edited via the **Habitica** web client. @@ -211,7 +211,9 @@ Terminate your party's ongoing quest. All progress will be lost, and the quest r | `config_entry` | no | Config entry of the character to abort the quest. | {% note %} + Actions marked with 🔒 have usage restrictions. See action descriptions for details. + {% endnote %} ### Action `habitica.start_quest` 🔒 @@ -264,20 +266,20 @@ Use a transformation item from your Habitica character's inventory on a member o - **Snowball**: `snowball` (transforms into a snowfriend) - **Spooky sparkles**: `spooky_sparkles` (transforms into a ghost) - **Seafoam**: `seafoam` (transforms into a starfish) -- **Shiny seed** `shiny_seed` (transforms into flower) +- **Shiny seed**: `shiny_seed` (transforms into flower) ### Action `habitica.get_tasks` Fetch tasks from your Habitica account, with optional filters to narrow down the results for more precise task retrieval. -| Data attribute | Optional | Description | -| -------------- | -------- | -------------------------------------------------------------------------------------------------------- | -| config_entry | no | Choose the Habitica character to retrieve tasks from. | -| type | yes | Filter tasks by type. Valid types: "habits", "dailies", "todos", "rewards". | -| priority | yes | Filter tasks by difficulty. Valid values: "trivial", "easy", "medium", "hard". | -| task | yes | Select specific tasks by matching their name (or task ID). | -| tag | yes | Filter tasks that have one or more of the selected tags. | -| keyword | yes | Filter tasks by keyword, searching across titles, notes, and checklists. | +| Data attribute | Optional | Description | +| ---------------- | -------- | -------------------------------------------------------------------------------------------------------- | +| `config_entry` | no | Choose the Habitica character to retrieve tasks from. | +| `type` | yes | Filter tasks by type. Valid types: `habits`, `dailies`, `todos`, `rewards`. | +| `priority` | yes | Filter tasks by difficulty. Valid values: `trivial`, `easy`, `medium`, `hard`. | +| `task` | yes | Select specific tasks by matching their name (or task ID). | +| `tag` | yes | Filter tasks that have one or more of the selected tags. | +| `keyword` | yes | Filter tasks by keyword, searching across titles, notes, and checklists. | ## Automations @@ -419,7 +421,7 @@ Please keep these limits in mind to avoid exceeding Habitica's request allowance The Habitica integration relies on an active internet connection to communicate with **Habitica**. If you encounter issues, verify that your network connection is stable. Additionally, the Habitica service itself may experience downtime, whether unexpected or due to scheduled maintenance. In these trying times of uncertainty and challenge, when fate tests your resolve, seek guidance from the [Habitica Outage Instructions](https://habitica.fandom.com/wiki/Outage_Instructions) on the community-maintained Habitica wiki — wisdom shared by adventurers who have faced such trials before. -In any case, when reporting an issue, please enable [debug logging](/docs/configuration/troubleshooting/#debug-logs-and-diagnostics), restart the integration, and as soon as the issue reoccurs stop the debug logging again (_download of debug log file will start automatically_). Further _if still possible_, please also download the [diagnostics](/integrations/diagnostics) data. If you have collected the debug log and the diagnostics data, provide them with the issue report. +In any case, when reporting an issue, please enable [debug logging](/docs/configuration/troubleshooting/#debug-logs-and-diagnostics), restart the integration, and as soon as the issue reoccurs stop the debug logging again (*download of debug log file will start automatically*). Further, if still possible, please also download the [diagnostics](/integrations/diagnostics) data. If you have collected the debug log and the diagnostics data, provide them with the issue report. ## Remove integration From 0559d5b429580dad2ec6a887eed5af441c20d1dc Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?J=2E=20Diego=20Rodr=C3=ADguez=20Royo?= Date: Tue, 25 Feb 2025 08:05:16 +0100 Subject: [PATCH 06/12] Add known limitations section to Home Connect (#37677) * Add known limitations section to Home Connect * Apply suggestions Co-authored-by: Franck Nijhof --------- Co-authored-by: Franck Nijhof --- source/_integrations/home_connect.markdown | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/source/_integrations/home_connect.markdown b/source/_integrations/home_connect.markdown index 8d3cdc9a00b..2139abc36b7 100644 --- a/source/_integrations/home_connect.markdown +++ b/source/_integrations/home_connect.markdown @@ -185,3 +185,8 @@ Changes a setting. | `device_id` | no | Id of a device associated with the home appliance. | | `key` | no | Key of the setting. | | `value` | no | Value of the setting. | + +## Known limitations + +- The Home Connect API does not fully match the Home Connect app. Some programs, options, or settings available in the app may not be accessible or usable via the API. +- This integration supports only one integration entry, as the Home Connect API does not allow for the unique identification of an account. From 793b6aaad4d7df97f30f04b669f541fac9012f33 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?J=2E=20Diego=20Rodr=C3=ADguez=20Royo?= Date: Tue, 25 Feb 2025 08:26:33 +0100 Subject: [PATCH 07/12] Add Home Connect troubleshooting documentation (#37679) * Add Home Connect troubleshooting documentation * tiny tweaks --------- Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- source/_integrations/home_connect.markdown | 67 ++++++++++++++++++++++ 1 file changed, 67 insertions(+) diff --git a/source/_integrations/home_connect.markdown b/source/_integrations/home_connect.markdown index 2139abc36b7..572dccb4aa2 100644 --- a/source/_integrations/home_connect.markdown +++ b/source/_integrations/home_connect.markdown @@ -186,7 +186,74 @@ Changes a setting. | `key` | no | Key of the setting. | | `value` | no | Value of the setting. | +## Troubleshooting + +### I could not configure the Home Connect integration + +#### Symptom: I tried to configure the Home Connect integration, but it failed with the message `Error while obtaining access token.` + +##### Description + +This problem might occur when the application credentials are not correctly configured. + +##### Solution + +To solve the above issue, follow these steps: + +1. Go to {% my integrations title="**Settings** > **Devices & services**" %}. +2. In the top right corner, select the three dots {% icon "mdi:dots-vertical" %} menu and select **Application credentials**. + + ![Devices and services overflow menu](/images/integrations/application_credentials/devices-and-services-menu.png) + + ![Application credential list](/images/integrations/application_credentials/application-credentials.png) +3. Select the three dots {% icon "mdi:dots-vertical" %} menu from the application credentials you created for the Home Connect integration and select **Delete**. +4. Add the Home Connect integration again under {% my integrations title="**Settings** > **Devices & services**" %} + +### Unavailable entities for a device + +#### Symptom: "The entities related to an appliance were available but no longer are" + +After reloading the Home Connect integration, the entities related to an appliance that used to be available are no longer available. +Also, when downloading the diagnostics data from the device entry, the following data is obtained: + +```json +{ + "data": { + "connected": false, + "status": {}, + "programs": null + } +} +``` + +##### Description + +Unavailable entities can have multiple causes: + +- The appliance is turned off. When it is turned off, the appliance is disconnected and the API does not retrieve information about the appliance. +- The appliance is experiencing a network issue. +- The Home Connect API is experiencing issues. + +##### Solution + +To try to solve the above issues, follow these steps: + +1. Turn on the appliance and reload the Home Connect integration. +2. If the appliance is turned on and the issue persists, check the network connection of the appliance and perform a soft reset on the appliance. +3. If the issue persists, check the connection of the appliance with the Home Connect API by checking it in the Home Connect app. + 1. Open the Home Connect app. + 2. Go to the appliance that is experiencing the issue. + 3. At the bottom of the screen, open the settings menu. + 4. Go to the **Network** section. + 5. Verify if the appliance is connected to the cloud: + - If the line between the appliance and the cloud is red and with a red warning icon {% icon "mdi:alert-outline" %}, the appliance is not connected to the Home Connect API. + - If the line between the appliance and the cloud is green, the appliance is connected to the cloud. +4. If everything is correct and the issue persists, contact Home Connect support. + - [Home Connect service and contact](https://www.home-connect.com/us/en/support/contact-and-service) + - [Home Connect developer Help & Support](https://developer.home-connect.com/support) + ## Known limitations - The Home Connect API does not fully match the Home Connect app. Some programs, options, or settings available in the app may not be accessible or usable via the API. - This integration supports only one integration entry, as the Home Connect API does not allow for the unique identification of an account. + From 6745c51c87c76df74926f5a46a1fbf9a9c643df0 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?J=2E=20Diego=20Rodr=C3=ADguez=20Royo?= Date: Tue, 25 Feb 2025 08:34:45 +0100 Subject: [PATCH 08/12] Add use cases to Home Connect (#37681) --- source/_integrations/home_connect.markdown | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/source/_integrations/home_connect.markdown b/source/_integrations/home_connect.markdown index 572dccb4aa2..8f6114b803c 100644 --- a/source/_integrations/home_connect.markdown +++ b/source/_integrations/home_connect.markdown @@ -31,6 +31,14 @@ ha_integration_type: integration The Home Connect integration allows users to integrate their home appliances supporting the Home Connect standard for Bosch and Siemens using the [official cloud API](https://developer.home-connect.com). +## Use cases + +- Monitor the multiple sensors of the appliance and trigger automations based on these sensors. +- Start programs on your appliances from your dashboard. +- Monitor the program status of the appliances. +- Control the light of your appliances. +- Adjust the appliance settings. + The integration will add one Home Assistant device for each connected home appliance which will have the following entities: - A power switch From a977f9c8f4d81937607540aef6ebd2a8742219da Mon Sep 17 00:00:00 2001 From: kylehakala Date: Tue, 25 Feb 2025 01:41:57 -0600 Subject: [PATCH 09/12] ZHA troubleshooting: reformat hue reset (#37682) * reformat ZHA Hue reset section * Switch to endimportant * fix typo in block * fix typo in block * Move hue and lutron steps into collapsible blocks, clean up wording/phrasing * Add missing quotes in details title * Outline options in this section before providing steps * Consolidate remote-reset sections * revise steps and phrasing * move important reminder to end of section to improve readability * Move general note out of remote-specific steps; move important text to top of section --- source/_integrations/zha.markdown | 59 ++++++++++++++++++++++--------- 1 file changed, 43 insertions(+), 16 deletions(-) diff --git a/source/_integrations/zha.markdown b/source/_integrations/zha.markdown index b9bc2722152..30e8115d4b0 100644 --- a/source/_integrations/zha.markdown +++ b/source/_integrations/zha.markdown @@ -701,31 +701,58 @@ logger: ### Add Philips Hue bulbs that have previously been added to another bridge -Philips Hue bulbs/lights that have previously been paired/added to another bridge/gateway will not show up during search in ZHA to pair/add a Zigbee device. That is because you have to first manually restore your bulbs/lights back to their factory default settings first, and just removing them from your old bridge/gateway is not enough to do so. Instead to achieve a proper device factory reset you can use one of these methods below. +Philips Hue bulbs that have previously been paired to another bridge/gateway will not show up during search in ZHA to add a Zigbee device. **Bulbs must be restored back to their factory default settings**. -You can use a Philips Hue Dimmer Switch or Lutron Connected Bulb Remote to factory-reset your bulbs. For this to work, the remote does not have to be paired with your previous bridge. Also, make sure there are no other Hue bulbs nearby that have just been turned on when using this method. Otherwise, you risk resetting them too. +{% important %} +**You must factory-reset the device.** -Newer Philips Hue bulbs you can reset via Bluetooth. The official Android app can connect to one of these bulbs even if it is already paired to a bridge. Then, you can reset the bulb in the app. +- Simply "removing" them from your old bridge/gateway is not sufficient. +- Be sure there are no other Hue bulbs nearby that have just been powered-on when using this method or you will risk resetting them in this process. -#### Philips Hue Dimmer Switch +{% endimportant %} -1. Turn on your Hue bulb/light you want to reset. (It is important that the bulb has just been turned). -2. Hold the Philips Hue Dimmer Switch near your bulb (closer than 10 centimeters / 4 inches). -3. Press and hold the (I)/(ON) and (O)/(OFF) buttons on the Philips Hue Dimmer Switch. The bulb should start blinking in 10-20 seconds. The bulb will blink, then turn off, then turn on. You can now release the dimmer buttons. -4. Your bulb is now factor reset and ready for pairing. A green light on the top left of the dimmer remote indicates that your bulb has been successfully reset to factory default settings. +The following reset methods can be used (depending on the bulb version): -Note: If you are unable to reset the bulb, remove it from the Hue Bridge and retry the procedure. +- **Zigbee remote:** + - Steps are outlined below for either the _Philips Hue Dimmer Switch_ or _Lutron Connected Bulb Remote_. + - The remote does not have to be paired with your previous bridge. +- **Bluetooth via Android app:** + - Newer Philips Hue bulbs can reset via Bluetooth using the official Android app. + - This is an option even if the bulb is already paired to a bridge. +- **Hue Thief command-line tool**: + - Advanced users can use a third-party tool called [Hue Thief](https://github.com/vanviegen/hue-thief/). + - This requires an EZSP-based Zigbee USB stick. -#### Lutron Connected Bulb Remote +#### Factory-reset using a Zigbee remote -1. Turn on your Hue bulb/light you want to reset. (It is important that the bulb has just been turned). -2. Hold the Dimmer Switch near your bulb (closer than 10 centimeters / 4 inches) -3. Press and hold the 2nd (up arrow) and 4th (light off) buttons on the Lutron Connected Bulb Remote simultaneously for about 10 seconds continuously until your bulb starts to blink and the green LED on the remote should also start blink slowly. -4. Continue to hold both buttons on the remote until the green LED on it stops blinking. Your bulb should also have stopped blinking and eventually turn on again indicating that your bulb has been successfully reset to factory default settings. +Icons or button names may vary between generations of remotes. The remote used for resetting does not have to be paired with your previous bridge. -#### hue-thief +{% details "To reset using a remote:" %} -Follow the instructions on [https://github.com/vanviegen/hue-thief/](https://github.com/vanviegen/hue-thief/) (EZSP-based Zigbee USB stick required) +1. Identify which buttons will be used later to perform the reset (based on the brand of remote): + - **Philips Hue Dimmer Switch**: + - Use the **(I)/(ON)** and **(O)/(OFF)** buttons. + - Button labels or icons may vary based on the generation of Hue remote. + - **Lutron Connected Bulb Remote:** + - Use the **2nd (up arrow)** and **4th (light off)** buttons. +2. Turn on the Hue bulb you want to reset. + - **It is important that the bulb has _just_ been powered on.** +3. Hold the remote near your bulb, closer than 10cm (about 4 inches). +4. Press-and-hold both buttons identified in the first step and continue holding them once the bulb begins to blink. + - Expect to hold the buttons for about another 10 seconds while the bulb blinks. + - **Lutron Connected Bulb Remote:** The green LED on the remote should also begin to blink slowly. +5. Release both buttons once the bulb turns off. + - **Lutron Connected Bulb Remote:** You can release the buttons after the green LED stops flashing on the remote. +6. The bulb will turn back on immediately after to indicate the factory-reset is complete. + - The bulb is now ready for pairing to ZHA following normal steps for [adding devices](#adding-devices). + +{% tip %} +A green light on the top left of the Philips Hue Dimmer Switch remote indicates that your bulb has been successfully reset to factory default settings. +{% endtip %} + +{% enddetails %} + +If you are unable to reset the bulb using a method above, remove it from the Hue Bridge (if it was re-discovered by the Hue Bridge) and try the procedure again. ### ZHA Start up issue with Home Assistant or Home Assistant Container From 4c464a3ea60d58e949bf2ea290bd8bcac27a9da5 Mon Sep 17 00:00:00 2001 From: kylehakala Date: Tue, 25 Feb 2025 02:08:03 -0600 Subject: [PATCH 10/12] ZHA: reformat large markdown table as collapsible sections (#37649) * Format table as separate collapsible list sections * Be more descriptive on what is inside the sections * remove lingering character from link markdown * tiny tweak --------- Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- source/_integrations/zha.markdown | 83 +++++++++++++++++++++++-------- 1 file changed, 61 insertions(+), 22 deletions(-) diff --git a/source/_integrations/zha.markdown b/source/_integrations/zha.markdown index 30e8115d4b0..8ce1d9a68a2 100644 --- a/source/_integrations/zha.markdown +++ b/source/_integrations/zha.markdown @@ -194,29 +194,68 @@ If you are use ZiGate or Sonoff ZBBridge you have to use some special usb_path c ### Discovery via USB or Zeroconf -Some devices can be auto-discovered, which can simplify the ZHA setup process. The following devices have been tested with discovery and offer a quick setup experience: +Some devices can be auto-discovered, which can simplify the ZHA setup process. The following devices have been tested with discovery and offer a quick setup experience. -| Device | Discovery Method | Identifier | -| ------------------------------------------------------------------------------------------------------------------------------------------- | ---------------- | ------------------------------ | -| [ITead SONOFF Zigbee 3.0 USB Dongle Plus V2 Model "ZBDongle-E" (EFR32MG21 variant)](https://itead.cc/product/zigbee-3-0-usb-dongle/) | USB | 1A86:55D4 | -| [ITead SONOFF Zigbee 3.0 USB Dongle Plus Model "ZBDongle-P" (CC2652P variant)](https://itead.cc/product/sonoff-zigbee-3-0-usb-dongle-plus/) | USB | 10C4:EA60 | -| [Bitron Video/SMaBiT BV AV2010/10](https://manuals.smabit.eu/len/av2010_10.html) | USB | 10C4:8B34 | -| [ConBee II](https://phoscon.de/conbee2) | USB | 1CF1:0030 | -| [ConBee III](https://phoscon.de/conbee3) | USB | 0403:6015 | -| [Nortek HUSBZB-1](https://www.nortekcontrol.com/products/2gig/husbzb-1-gocontrol-quickstick-combo/) | USB | 10C4:8A2A | -| [slae.sh CC2652RB development stick](https://slae.sh/projects/cc2652/) | USB | 10C4:EA60 | -| [SMLIGHT SLZB-07](https://smlight.tech/product/slzb-07/) | USB | 10C4:EA60 | -| [ZigStar Stick (CC2652 + CH340B variant)](https://zig-star.com/projects/zigbee-stick-v4/) | USB | 1A86:7523 | -| [Tube’s EFR32 Pro Ethernet/Serial Coordinator](https://www.tubeszb.com/) | USB | 10C4:EA60 | -| [ZigStar Coordinators](https://zig-star.com/) | USB | 1A86:7523 | -| [XZG - Universal Firmware for Zigbee Gateway](https://xzg.xyzroe.cc/) | Zeroconf | xzg.local. | -| [SMLIGHT SLZB-06 POE Zigbee LAN WiFi USB Adapter](https://smlight.tech/product/slzb-06/) | Zeroconf | slzb-06.local. | -| [ZigStar UZG Universal Zigbee Gateway (UZG-01)](https://uzg.zig-star.com) | Zeroconf | uzg-01._tcp.local. | -| [cod.m Zigbee Coordinator](https://docs.codm.de/zigbee/coordinator/) | Zeroconf | czc._tcp.local. | -| [ZigStar LAN/POE Coordinators](https://zig-star.com/projects/zigbee-gw-lan/) | Zeroconf | zigstargw.local. | -| [Tube's CC2652P2 USB-powered Zigbee to Ethernet Serial Coordinator)](https://www.tubeszb.com/) | Zeroconf | tube_zb_gw_cc2652p2.local. | -| [Tube's CC2652P2 PoE-powered Zigbee to Ethernet Serial Coordinator)](https://www.tubeszb.com/) | Zeroconf | tube_zb_gw_cc2652p2_poe.local. | -| [Tube's EFR32 Based Zigbee to Ethernet Serial Coordinator)](https://www.tubeszb.com/) | Zeroconf | tube_zb_gw_efr32.local. | +{% details "USB discovery devices" %} + +- **Bitron** + - [Bitron Video/SMaBiT BV AV2010/10](https://manuals.smabit.eu/len/av2010_10.html) + - Identifier: `10C4:8B34` +- **ConBee** + - [ConBee II](https://phoscon.de/conbee2) + - Identifier: `1CF1:0030` + - [ConBee III](https://phoscon.de/conbee3) + - Identifier: `0403:6015` +- **ITead** + - [ITead SONOFF Zigbee 3.0 USB Dongle Plus V2 Model "ZBDongle-E" (EFR32MG21 variant)](https://itead.cc/product/zigbee-3-0-usb-dongle/) + - Identifier: `1A86:55D4` + - [ITead SONOFF Zigbee 3.0 USB Dongle Plus Model "ZBDongle-P" (CC2652P variant)](https://itead.cc/product/sonoff-zigbee-3-0-usb-dongle-plus) + - Identifier: `10C4:EA60` +- **Nortek** + - [Nortek HUSBZB-1](https://www.nortekcontrol.com/products/2gig/husbzb-1-gocontrol-quickstick-combo/) + - Identifier: `10C4:8A2A` +- **slae.sh** + - [slae.sh CC2652RB development stick](https://slae.sh/projects/cc2652/) + - Identifier: `10C4:EA60` +- **SMLIGHT** + - [SMLIGHT SLZB-07](https://smlight.tech/product/slzb-07/) + - Identifier: `10C4:EA60` +- **Tube** + - [Tube’s EFR32 Pro Ethernet/Serial Coordinator](https://www.tubeszb.com/) + - Identifier: `10C4:EA60` +- **ZigStar** + - [ZigStar Stick (CC2652 + CH340B variant)](https://zig-star.com/projects/zigbee-stick-v4/) + - Identifier: `1A86:7523` + - [ZigStar Coordinators](https://zig-star.com/) + - Identifier: `1A86:7523` + +{% enddetails %} + +{% details "Zeroconf discovery devices" %} + +- **cod.m** + - [cod.m Zigbee Coordinator](https://docs.codm.de/zigbee/coordinator/) + - Identifier: `czc._tcp.local.` +- **SMLIGHT** + - [SMLIGHT SLZB-06 POE Zigbee LAN WiFi USB Adapter](https://smlight.tech/product/slzb-06/) + - Identifier: `slzb-06.local.` +- **Tube** + - [Tube's CC2652P2 USB-powered Zigbee to Ethernet Serial Coordinator](https://www.tubeszb.com/) + - Identifier: `tube_zb_gw_cc2652p2.local.` + - [Tube's CC2652P2 PoE-powered Zigbee to Ethernet Serial Coordinator](https://www.tubeszb.com/) + - Identifier: `tube_zb_gw_cc2652p2_poe.local.` + - [Tube's EFR32 Based Zigbee to Ethernet Serial Coordinator](https://www.tubeszb.com/) + - Identifier: `tube_zb_gw_efr32.local.` +- **XZG** + - [XZG - Universal Firmware for Zigbee Gateway](https://xzg.xyzroe.cc/) + - Identifier: `xzg.local.` +- **ZigStar** + - [ZigStar UZG Universal Zigbee Gateway (UZG-01)](https://uzg.zig-star.com) + - Identifier: `uzg-01._tcp.local.` + - [ZigStar LAN/POE Coordinators](https://zig-star.com/projects/zigbee-gw-lan/) + - Identifier: `zigstargw.local.` + +{% enddetails %} Additional devices in the [Compatible hardware](#compatible-hardware) section may be discoverable, however, only devices that have been confirmed discoverable are listed above. From 43260d8670bc6795565c1890d5c2a56525ef4d4f Mon Sep 17 00:00:00 2001 From: kylehakala Date: Tue, 25 Feb 2025 02:11:00 -0600 Subject: [PATCH 11/12] ZHA: Clean up formatting on Compatible Hardware sections (#37647) * Adds subsection to separate out 3.0 support notes * Collapse non-recommended hardware down to reduce clutter, wrap in a warning block for added context * Replace 'recommended' with 'suggested' to avoid mixing terminology * Use a single collapsing section for all non-recommended hardware * place warning block inside collapsing section and remove icons to minimize visual distraction * Fix mixed word choice * Clean up warning format, refer to additional info on how to improve section --- source/_integrations/zha.markdown | 93 +++++++++++++++++++++---------- 1 file changed, 64 insertions(+), 29 deletions(-) diff --git a/source/_integrations/zha.markdown b/source/_integrations/zha.markdown index 8ce1d9a68a2..e9b557c3460 100644 --- a/source/_integrations/zha.markdown +++ b/source/_integrations/zha.markdown @@ -83,11 +83,15 @@ Note that because Zigbee relies on "mesh networking" technology it depends heavi ## Compatible hardware -ZHA {% term integration %} uses a hardware independent Zigbee stack implementation with modular design, which means that it can support any one of the many Zigbee coordinator radio modules/adapters available from different manufacturers, as long as that module/adapter is compatible with [zigpy](https://github.com/zigpy/zigpy). +The hardware-independent design of this integration provides support for many Zigbee coordinators available from different manufacturers, as long as the coordinator is compatible with the [zigpy](https://github.com/zigpy/zigpy) library. -Note! Zigbee 3.0 support or not in zigpy, depends primarily on your Zigbee coordinator hardware and its firmware. Some Zigbee coordinator hardware supports Zigbee 3.0 but might be shipped with an older firmware which does not. In such a case you may want to upgrade the firmware manually yourself. +### Zigbee 3.0 support -Some other Zigbee coordinator hardware may not support a firmware that is capable of Zigbee 3.0 at all but can still be fully functional and feature-complete for your needs. This is very common as many, if not most, Zigbee devices do not yet Zigbee 3.0. As a general rule, newer Zigbee coordinator hardware generally supports Zigbee 3.0 firmware and it is up to its manufacturer to make such firmware available for them. +Some coordinators may not support firmware capable of Zigbee 3.0, but they can still be fully functional and feature-complete for your needs. Support for Zigbee 3.0 depends primarily on your coordinator hardware and firmware. + +{% note %} +Newer coordinators generally support Zigbee 3.0 firmware, but it is up to the manufacturer to make such firmware available to them. If your coordinator was shipped with an older firmware version, you may want to manually upgrade the firmware. +{% endnote %} ### Recommended Zigbee radio adapters and modules @@ -104,31 +108,62 @@ Some other Zigbee coordinator hardware may not support a firmware that is capabl ### Other supported but not recommended Zigbee radio adapters or modules -- Silicon Labs EmberZNet based radios using legacy hardware using the EZSP protocol (via the [bellows](https://github.com/zigpy/bellows) library for zigpy) - - [Elelabs Zigbee USB Adapter](https://elelabs.com/products/elelabs-usb-adapter.html)/POPP ZB-Stick (Note! Not a must but recommend [upgrade the EmberZNet NCP application firmware](https://github.com/Elelabs/elelabs-zigbee-ezsp-utility)) - - [Elelabs Zigbee Raspberry Pi Shield](https://elelabs.com/products/elelabs-zigbee-shield.html) (Note! Not a must but recommend [upgrade the EmberZNet NCP application firmware](https://github.com/Elelabs/elelabs-zigbee-ezsp-utility)) - - [ITead Sonoff ZBBridge](https://itead.cc/product/sonoff-zbbridge/) (Note! [WiFi-based bridges are not recommended for ZHA with EZSP radios](https://github.com/home-assistant/home-assistant.io/issues/17170). Also, this first has to be flashed with [Tasmota firmware and Silabs EmberZNet NCP EZSP UART Host firmware to use as Serial-to-IP adapter](https://www.digiblur.com/2020/07/how-to-use-sonoff-zigbee-bridge-with.html)) - - [Nortek GoControl QuickStick Combo Model HUSBZB-1 (Z-Wave & Zigbee Ember 3581 USB Adapter)](https://www.nortekcontrol.com/products/2gig/husbzb-1-gocontrol-quickstick-combo/) (Note! Not a must but recommend [upgrade the EmberZNet NCP application firmware](https://github.com/walthowd/husbzb-firmware)) - - [Bitron Video/Smabit BV AV2010/10 USB-Stick](https://manuals.smabit.eu/len/av2010_10.html) with Silicon Labs Ember 3587 - - Telegesis ETRX357USB/ETRX357USB-LR/ETRX357USB-LRS+8M (Note! These first have to be [flashed with other EmberZNet firmware](https://github.com/walthowd/husbzb-firmware)) -- Texas Instruments based radios using legacy hardware (via the [zigpy-znp](https://github.com/zigpy/zigpy-znp) library for zigpy) - - [CC2538 USB stick, module, or dev board hardware flashed with Z-Stack coordinator firmware](https://www.zigbee2mqtt.io/information/supported_adapters) (no longer recommended as only got deprecated old end-of-life firmware) - - [CC2530/CC2531 USB stick, module, or dev board hardware flashed with Z-Stack coordinator firmware](https://www.zigbee2mqtt.io/information/supported_adapters) (no longer recommended as uses deprecated hardware and very old end-of-life firmware, plus will not work properly at all if the whole Zigbee network has more than 15-20 devices) -- dresden elektronik deCONZ based Zigbee radios using legacy hardware (via the [zigpy-deconz](https://github.com/zigpy/zigpy-deconz) library for zigpy) - - [ConBee II (a.k.a. ConBee 2) USB adapter from dresden elektronik](https://phoscon.de/conbee2) - - [RaspBee II (a.k.a. RaspBee 2) Raspberry Pi Shield from dresden elektronik](https://phoscon.de/raspbee2) - - [ConBee USB adapter from dresden elektronik](https://phoscon.de/conbee) - - [RaspBee Raspberry Pi Shield from dresden elektronik](https://phoscon.de/raspbee) -- Digi XBee Zigbee based radios (via the [zigpy-xbee](https://github.com/zigpy/zigpy-xbee) library for zigpy) - - [Digi XBee Series 3 (xbee3-24)](https://www.digi.com/products/embedded-systems/digi-xbee/rf-modules/2-4-ghz-rf-modules/xbee3-zigbee-3) and [Digi XBee Series S2C](https://www.digi.com/products/embedded-systems/digi-xbee/rf-modules/2-4-ghz-rf-modules/xbee-zigbee) modules - - Note! While not a must, [it is recommend to upgrade XBee Series 3 and S2C to newest firmware using XCTU](https://www.digi.com/resources/documentation/Digidocs/90002002/Default.htm#Tasks/t_load_zb_firmware.htm) - - [Digi XBee Series 2 (S2)](https://www.digi.com/support/productdetail?pid=3430) modules (Note! This first have to be [flashed with Zigbee Coordinator API firmware](https://www.digi.com/support/productdetail?pid=3430)) -- ZiGate based radios (via the [zigpy-zigate](https://github.com/zigpy/zigpy-zigate) library for zigpy and require firmware 3.1d or later) - - [ZiGate USB](https://zigate.fr/produit/zigate-usb/) - - [ZiGate USB-DIN](https://zigate.fr/produit/zigatev2-usb-din/) - - [PiZiGate (ZiGate Raspberry Pi module)](https://zigate.fr/produit/pizigatev2/) - - [ZiGate-Ethernet (Ethernet gateway board for PiZiGate)](https://zigate.fr/produit/zigate-ethernet/) - - [ZiGate + WiFi Pack](https://zigate.fr/produit/zigatev2-pack-wifi/) +{% details "List of hardware that is not recommended" %} + +{% warning %} + +The following hardware is supported, but _not recommended_. Specific models and details are noted where available in each section. + +{% endwarning %} + +**Silicon Labs EmberZNet based radios using legacy hardware using the EZSP protocol (via the [bellows](https://github.com/zigpy/bellows) library for zigpy)** + +- [Elelabs Zigbee USB Adapter](https://elelabs.com/products/elelabs-usb-adapter.html)/POPP ZB-Stick + - It is suggested to [upgrade the EmberZNet NCP application firmware](https://github.com/Elelabs/elelabs-zigbee-ezsp-utility) +- [Elelabs Zigbee Raspberry Pi Shield](https://elelabs.com/products/elelabs-zigbee-shield.html) + - It is suggested to [upgrade the EmberZNet NCP application firmware](https://github.com/Elelabs/elelabs-zigbee-ezsp-utility) +- [ITead Sonoff ZBBridge](https://itead.cc/product/sonoff-zbbridge/) + - Note: [WiFi-based bridges are not recommended for ZHA with EZSP radios](https://github.com/home-assistant/home-assistant.io/issues/17170). + - These first need to be flashed with [Tasmota firmware and Silabs EmberZNet NCP EZSP UART Host firmware to use as Serial-to-IP adapter](https://www.digiblur.com/2020/07/how-to-use-sonoff-zigbee-bridge-with.html) +- [Nortek GoControl QuickStick Combo Model HUSBZB-1 (Z-Wave & Zigbee Ember 3581 USB Adapter)](https://www.nortekcontrol.com/products/2gig/husbzb-1-gocontrol-quickstick-combo/) + - It is suggested to [upgrade the EmberZNet NCP application firmware](https://github.com/walthowd/husbzb-firmware) +- [Bitron Video/Smabit BV AV2010/10 USB-Stick](https://manuals.smabit.eu/len/av2010_10.html) with Silicon Labs Ember 3587 +- Telegesis ETRX357USB/ETRX357USB-LR/ETRX357USB-LRS+8M + - These first need to be [flashed with other EmberZNet firmware](https://github.com/walthowd/husbzb-firmware) + +**Texas Instruments based radios using legacy hardware (via the [zigpy-znp](https://github.com/zigpy/zigpy-znp) library for zigpy)** + +- [CC2538 USB stick, module, or dev board hardware flashed with Z-Stack coordinator firmware](https://www.zigbee2mqtt.io/information/supported_adapters) + - This is no longer recommended as it can only run deprecated (old/end-of-life) firmware. +- [CC2530/CC2531 USB stick, module, or dev board hardware flashed with Z-Stack coordinator firmware](https://www.zigbee2mqtt.io/information/supported_adapters) + - This is no longer recommended as it uses deprecated hardware and very old, end-of-life firmware. + - This will not work properly if the Zigbee network has more than 15-20 devices. + +**dresden elektronik deCONZ based Zigbee radios using legacy hardware (via the [zigpy-deconz](https://github.com/zigpy/zigpy-deconz) library for zigpy)** + +- [ConBee II (a.k.a. ConBee 2) USB adapter from dresden elektronik](https://phoscon.de/conbee2) +- [RaspBee II (a.k.a. RaspBee 2) Raspberry Pi Shield from dresden elektronik](https://phoscon.de/raspbee2) +- [ConBee USB adapter from dresden elektronik](https://phoscon.de/conbee) +- [RaspBee Raspberry Pi Shield from dresden elektronik](https://phoscon.de/raspbee) + +**Digi XBee Zigbee based radios (via the [zigpy-xbee](https://github.com/zigpy/zigpy-xbee) library for zigpy)** + +- [Digi XBee Series 3 (xbee3-24)](https://www.digi.com/products/embedded-systems/digi-xbee/rf-modules/2-4-ghz-rf-modules/xbee3-zigbee-3) and [Digi XBee Series S2C](https://www.digi.com/products/embedded-systems/digi-xbee/rf-modules/2-4-ghz-rf-modules/xbee-zigbee) modules + - It is suggested to [upgrade XBee Series 3 and S2C to newest firmware using XCTU](https://www.digi.com/resources/documentation/Digidocs/90002002/Default.htm#Tasks/t_load_zb_firmware.htm) +- [Digi XBee Series 2 (S2)](https://www.digi.com/support/productdetail?pid=3430) modules + - These first need to be [flashed with Zigbee Coordinator API firmware](https://www.digi.com/support/productdetail?pid=3430) + +**ZiGate based radios (via the [zigpy-zigate](https://github.com/zigpy/zigpy-zigate) library for zigpy and require firmware 3.1d or later)** + +- [ZiGate USB](https://zigate.fr/produit/zigate-usb/) +- [ZiGate USB-DIN](https://zigate.fr/produit/zigatev2-usb-din/) +- [PiZiGate (ZiGate Raspberry Pi module)](https://zigate.fr/produit/pizigatev2/) +- [ZiGate-Ethernet (Ethernet gateway board for PiZiGate)](https://zigate.fr/produit/zigate-ethernet/) +- [ZiGate + WiFi Pack](https://zigate.fr/produit/zigatev2-pack-wifi/) + +{% enddetails %} + +If you find an opportunity to improve this information, refer to the section on how to [add support for new and unsupported devices](#how-to-add-support-for-new-and-unsupported-devices). {% caution %} @@ -572,7 +607,7 @@ ZHA does not currently support devices that can only use the ZSE ("Zigbee Smart ### Knowing which devices are supported Home Assistant's ZHA {% term integration %} supports all standard Zigbee device types. It should be compatible with most Zigbee devices as long as they fully conform to the official ZCL (Zigbee Cluster Library) specifications defined by the [CSA (Connectivity Standards Alliance, formerly the Zigbee Alliance)](https://csa-iot.org/all-solutions/zigbee/). There is therefore no official compatibility list of devices that will work out-of-the-box with the ZHA {% term integration %} -Not all hardware manufacturers always fully comply with the standard specifications. Sometimes, they may also implement unique features. For this reason, some Zigbee devices pair/join fine with ZHA but then only show none or only a few entities in the {% term integration %}. Developers can work around most such interoperability issues by adding conversion/translation code in custom device handlers. For more information, refer to the section below on _How to add support for new and unsupported devices_. +Not all hardware manufacturers always fully comply with the standard specifications. Sometimes, they may also implement unique features. For this reason, some Zigbee devices pair/join fine with ZHA but then only show none or only a few entities in the {% term integration %}. Developers can work around most such interoperability issues by adding conversion/translation code in custom device handlers. For more information, refer to the section below on [How to add support for new and unsupported devices](#how-to-add-support-for-new-and-unsupported-devices). For clarification, normally only devices that do not fully conform to CSA's ZCL specifications that will not present all standard attributes as entities for configuration in the ZHA {% term integration %}. Zigbee devices that only use the standard clusters and attributes that are Zigbee specifications set by the Connectivity Standards Alliance should not need custom device handlers. From abbd14c23dcd9583f44e5898ba524fb20315fded Mon Sep 17 00:00:00 2001 From: elmurato <1382097+elmurato@users.noreply.github.com> Date: Tue, 25 Feb 2025 15:32:20 +0100 Subject: [PATCH 12/12] Add removal instructions to minecraft_server.markdown (#37691) --- source/_integrations/minecraft_server.markdown | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/source/_integrations/minecraft_server.markdown b/source/_integrations/minecraft_server.markdown index e37e18d7d9d..d3d74c75154 100644 --- a/source/_integrations/minecraft_server.markdown +++ b/source/_integrations/minecraft_server.markdown @@ -77,3 +77,9 @@ For Bedrock Edition servers following sensors are provided additionally: {% note %} Player names are only available on Java Edition servers. Depending on the server, the player names list may not be shown completely. Some servers and plugins limit or completely hide this list or even replace the player names with fake ones to show some custom messages there. {% endnote %} + +## Removing the integration + +This integration follows standard integration removal. No extra steps are required. + +{% include integrations/remove_device_service.md %}