diff --git a/source/_integrations/bring.markdown b/source/_integrations/bring.markdown index 521fd29266e..69670d55c8a 100644 --- a/source/_integrations/bring.markdown +++ b/source/_integrations/bring.markdown @@ -36,10 +36,10 @@ Available as a mobile app on [Google Play for Android](https://play.google.com/s ## How you can use this integration -- **Automated notifications:** Receive alerts on your phone when essential items are added to your list or when the quantity of items reaches a set value. -- **List updates based on events:** Automatically add items to your shopping list when appliances are low on supplies, like dishwasher salt, or need routine maintenance, such as tub cleaner for the washer. -- **Voice control:** Use voice assistants connected to Home Assistant to add items to your **Bring!** list. -- **Geofencing:** Receive reminders when you are near a specific store and need to pick up items, based on your location. +- **Automated notifications**: Receive alerts on your phone when essential items are added to your list or when the quantity of items reaches a set value. +- **List updates based on events**: Automatically add items to your shopping list when appliances are low on supplies, like dishwasher salt, or need routine maintenance, such as tub cleaner for the washer. +- **Voice control**: Use voice assistants connected to Home Assistant to add items to your **Bring!** list. +- **Geofencing**: Receive reminders when you are near a specific store and need to pick up items, based on your location. ## Prerequisites @@ -65,10 +65,10 @@ Password: ## Sensors -- **Urgent:** Shows the number of items tagged with the **Urgent** badge on the shopping list. Completed items are excluded. -- **On occasion:** Displays the count of items marked with the **If convenient** badge. -- **Discount only:** Indicates the number of items tagged with the **Offer** badge. -- **Region & Language:** The sensor can be used for diagnostics. If everything is set correctly, it will display the selected region for the shopping list. If it shows **Unknown**, the region has not been set properly in the **Bring!** app. +- **Urgent**: Shows the number of items tagged with the **Urgent** badge on the shopping list. Completed items are excluded. +- **On occasion**: Displays the count of items marked with the **If convenient** badge. +- **Discount only**: Indicates the number of items tagged with the **Offer** badge. +- **Region & Language**: The sensor can be used for diagnostics. If everything is set correctly, it will display the selected region for the shopping list. If it shows **Unknown**, the region has not been set properly in the **Bring!** app. - **List access**: Indicates whether the shopping list is **personal** (private) or **shared** (accessible to others). ## Actions @@ -80,7 +80,9 @@ You can use the actions from the [to-do list](/integrations/todo/) to create, up The **Bring!** integration offers an action to send push notifications to the Bring! mobile apps of other members of a shared shopping list. The Bring! mobile app has 4 predefined notification types. {% note %} + If you want to receive these notifications, you must use a dedicated account, as outlined in the [known limitations](#known-limitations). + {% endnote %} | Data attribute | Optional | Description | @@ -89,23 +91,24 @@ If you want to receive these notifications, you must use a dedicated account, as | `message` | no | Type of push notification to send to list members. See [Notification types](#available-notification-types). | | `item` | yes | Required for `urgent_message`. Item to include in the message. For example: *Attention! Attention! - We still urgently need: Cilantro*. | - ### Available notification types -| Notification type | Name of notification | -| ----------------- | -------------------------------------------------------------- | -| going_shopping | I'm going shopping! - Last chance for adjustments | -| changed_list | I changed the list! - Take a look at the items | -| shopping_done | The shopping is done! - The fridge is well stocked | -| urgent_message | Attention! Attention! - We still urgently need: `[Items]` | +| Notification type | Name of notification | +| ------------------- | -------------------------------------------------------------- | +| `going_shopping` | I'm going shopping! - Last chance for adjustments | +| `changed_list` | I changed the list! - Take a look at the items | +| `shopping_done` | The shopping is done! - The fridge is well stocked | +| `urgent_message` | Attention! Attention! - We still urgently need: `[Items]` | {% note %} + The notification that list members receive differs from the label shown in the Bring! app. This variation depends not only on the recipient’s language settings but also on the sender's profile name. Additionally, notifications may change with new app updates. Here are some example notifications: - `name` is going shopping for "`shopping list name`"! Last chance to make changes - `name` went shopping for "`shopping list name`"! The fridge is well stocked - `name` updated the list "`shopping list name`"! Take a look at the articles - Attention, something's missing! Please buy `item` urgently + {% endnote %} ### Sending a going shopping notification @@ -207,7 +210,7 @@ The **Bring!** integration relies on an active internet connection to communicat - A **502 - Bad Gateway** error (`aiohttp.client_exceptions.ClientResponseError: 502, message='Bad Gateway'`) is known to occur occasionally (1–2 times per day) but is usually temporary. The integration will retry automatically after 90 seconds, so there’s no need to take action. -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 diff --git a/source/_integrations/home_connect.markdown b/source/_integrations/home_connect.markdown index a19729f0a59..8d3cdc9a00b 100644 --- a/source/_integrations/home_connect.markdown +++ b/source/_integrations/home_connect.markdown @@ -56,6 +56,10 @@ Note that it depends on the appliance and on API permissions which of the featur Some devices only have the state `on` and turn off is not supported by the appliance, check [power state availability at Home Connect API documentation](https://api-docs.home-connect.com/settings/#power-state) for more information. {% endnote %} +## Supported devices + +You can find information about supported devices on the [Home Connect website](https://www.home-connect.com/global/smart-home-appliances). + ## Prerequisites 1. Visit [https://developer.home-connect.com](https://developer.home-connect.com) and sign up for a developer account. diff --git a/source/_integrations/pyload.markdown b/source/_integrations/pyload.markdown index 0e7932c88ae..451c4be167f 100644 --- a/source/_integrations/pyload.markdown +++ b/source/_integrations/pyload.markdown @@ -69,23 +69,23 @@ Password: ## Sensors -- **Speed:** Monitors the current download speed. -- **Active downloads:** Indicates the number of files pyLoad is actively downloading -- **Downloads in queue:** Shows the number of downloads currently in the queue. -- **Finished downloads:** Indicates the number of completed downloads. -- **Free space:** Shows the available disk space in the download directory. +- **Speed**: Monitors the current download speed. +- **Active downloads**: Indicates the number of files pyLoad is actively downloading +- **Downloads in queue**: Shows the number of downloads currently in the queue. +- **Finished downloads**: Indicates the number of completed downloads. +- **Free space**: Shows the available disk space in the download directory. ## Buttons -- **Abort all running downloads:** Aborts all currently running downloads. -- **Delete finished files/packages:** Deletes all finished files and packages. -- **Restart all failed files/packages:** Restarts all failed downloads. +- **Abort all running downloads**: Aborts all currently running downloads. +- **Delete finished files/packages**: Deletes all finished files and packages. +- **Restart all failed files/packages**: Restarts all failed downloads. - **Restart pyLoad core**: Restarts the pyLoad core. ## Switches -- **Pause/Resume Queue:** Pauses or resumes the download queue. When paused, active downloads will continue, but new downloads in the queue will not start. -- **Auto-reconnect:** If configured, enables pyLoad to automatically reconnect the internet connection. +- **Pause/Resume Queue**: Pauses or resumes the download queue. When paused, active downloads will continue, but new downloads in the queue will not start. +- **Auto-reconnect**: If configured, enables pyLoad to automatically reconnect the internet connection. ## Automations diff --git a/source/_integrations/zha.markdown b/source/_integrations/zha.markdown index e175f998fe6..93af200ec9c 100644 --- a/source/_integrations/zha.markdown +++ b/source/_integrations/zha.markdown @@ -143,14 +143,16 @@ Some other Zigbee coordinator hardware may not support a firmware that is capabl - [ZiGate-Ethernet (Ethernet gateway board for PiZiGate)](https://zigate.fr/produit/zigate-ethernet/) - [ZiGate + WiFi Pack](https://zigate.fr/produit/zigatev2-pack-wifi/) -#### Warning about using Zigbee Coordinator over Wi-Fi/WAN/VPN - {% caution %} -Be aware that using a Zigbee Coordinator via a Serial-Proxy-Server (also known as Serial-to-IP bridge or Ser2Net remote adapter) over a Wi-Fi, WAN, or VPN connection is not recommended. -Serial protocols used by the Zigbee Coordinator do not have enough robustness, resilience, or fault tolerance to handle packet loss and latency delays that can occur over unstable connections. +- It is **not recommended** to run a coordinator via **Serial-Proxy-Server** _(also called Serial-to-IP bridge or Ser2Net remote adapter)_ over: + + - **Wi-Fi**, + - **WAN**, or + - **VPN** -A Zigbee Coordinator requires a stable local connection to its serial port interface with no drops in communication between it and the Zigbee gateway application running on the host computer. +- The coordinator requires a stable, local connection to its serial port interface without drops in communication with the Zigbee gateway application running on the host computer. +- Serial protocols used by the coordinator do not have enough robustness, resilience, or fault tolerance to handle packet loss and latency delays that can occur over unstable connections. {% endcaution %} ## Configuration requirements