jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-19 07:17:14 +00:00
Code Issues Packages Projects Releases Wiki Activity

Merge branch 'current' into zha-introduction

Browse Source
This commit is contained in:
kylehakala 2025-02-24 16:33:08 -06:00 committed by GitHub
commit 6ffbd7228c
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
4 changed files with 40 additions and 31 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

35
source/_integrations/bring.markdown
View File

@ -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 ## 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. - **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. - **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. - **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. - **Geofencing**: Receive reminders when you are near a specific store and need to pick up items, based on your location.
## Prerequisites ## Prerequisites
@ -65,10 +65,10 @@ Password:
## Sensors ## Sensors
- **Urgent:** Shows the number of items tagged with the **Urgent** badge on the shopping list. Completed items are excluded. - **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. - **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. - **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. - **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). - **List access**: Indicates whether the shopping list is **personal** (private) or **shared** (accessible to others).
## Actions ## 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. 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 %} {% note %}
If you want to receive these notifications, you must use a dedicated account, as outlined in the [known limitations](#known-limitations). If you want to receive these notifications, you must use a dedicated account, as outlined in the [known limitations](#known-limitations).
{% endnote %} {% endnote %}
| Data attribute | Optional | Description | | 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). | | `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*. | | `item` | yes | Required for `urgent_message`. Item to include in the message. For example: *Attention! Attention! - We still urgently need: Cilantro*. |
### Available notification types ### Available notification types
| Notification type | Name of notification | | Notification type | Name of notification |
| ----------------- | -------------------------------------------------------------- | | ------------------- | -------------------------------------------------------------- |
| going_shopping | I'm going shopping! - Last chance for adjustments | | `going_shopping` | I'm going shopping! - Last chance for adjustments |
| changed_list | I changed the list! - Take a look at the items | | `changed_list` | I changed the list! - Take a look at the items |
| shopping_done | The shopping is done! - The fridge is well stocked | | `shopping_done` | The shopping is done! - The fridge is well stocked |
| urgent_message | Attention! Attention! - We still urgently need: `[Items]` | | `urgent_message` | Attention! Attention! - We still urgently need: `[Items]` |
{% note %} {% 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: 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` 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` went shopping for "`shopping list name`"! The fridge is well stocked
- `name` updated the list "`shopping list name`"! Take a look at the articles - `name` updated the list "`shopping list name`"! Take a look at the articles
- Attention, something's missing! Please buy `item` urgently - Attention, something's missing! Please buy `item` urgently
{% endnote %} {% endnote %}
### Sending a going shopping notification ### 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. - 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 ## Remove integration

4
source/_integrations/home_connect.markdown
View File

@ -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. 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 %} {% 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 ## Prerequisites
1. Visit [https://developer.home-connect.com](https://developer.home-connect.com) and sign up for a developer account. 1. Visit [https://developer.home-connect.com](https://developer.home-connect.com) and sign up for a developer account.

20
source/_integrations/pyload.markdown
View File

@ -69,23 +69,23 @@ Password:
## Sensors ## Sensors
- **Speed:** Monitors the current download speed. - **Speed**: Monitors the current download speed.
- **Active downloads:** Indicates the number of files pyLoad is actively downloading - **Active downloads**: Indicates the number of files pyLoad is actively downloading
- **Downloads in queue:** Shows the number of downloads currently in the queue. - **Downloads in queue**: Shows the number of downloads currently in the queue.
- **Finished downloads:** Indicates the number of completed downloads. - **Finished downloads**: Indicates the number of completed downloads.
- **Free space:** Shows the available disk space in the download directory. - **Free space**: Shows the available disk space in the download directory.
## Buttons ## Buttons
- **Abort all running downloads:** Aborts all currently running downloads. - **Abort all running downloads**: Aborts all currently running downloads.
- **Delete finished files/packages:** Deletes all finished files and packages. - **Delete finished files/packages**: Deletes all finished files and packages.
- **Restart all failed files/packages:** Restarts all failed downloads. - **Restart all failed files/packages**: Restarts all failed downloads.
- **Restart pyLoad core**: Restarts the pyLoad core. - **Restart pyLoad core**: Restarts the pyLoad core.
## Switches ## 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. - **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. - **Auto-reconnect**: If configured, enables pyLoad to automatically reconnect the internet connection.
## Automations ## Automations

12
source/_integrations/zha.markdown
View File

@ -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-Ethernet (Ethernet gateway board for PiZiGate)](https://zigate.fr/produit/zigate-ethernet/)
- [ZiGate + WiFi Pack](https://zigate.fr/produit/zigatev2-pack-wifi/) - [ZiGate + WiFi Pack](https://zigate.fr/produit/zigatev2-pack-wifi/)
#### Warning about using Zigbee Coordinator over Wi-Fi/WAN/VPN
{% caution %} {% 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 %} {% endcaution %}
## Configuration requirements ## Configuration requirements