From 34437b87df9f0a9b4d06960b0b570671e0af1fa2 Mon Sep 17 00:00:00 2001 From: jjlawren Date: Tue, 10 May 2022 01:50:40 -0500 Subject: [PATCH 01/16] Add Sonos favorites notes (#22642) Co-authored-by: Franck Nijhof --- source/_integrations/sonos.markdown | 36 +++++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) diff --git a/source/_integrations/sonos.markdown b/source/_integrations/sonos.markdown index b29f301bb42..f8071a0b7b2 100644 --- a/source/_integrations/sonos.markdown +++ b/source/_integrations/sonos.markdown @@ -40,6 +40,7 @@ Speaker-level controls are exposed as `number` or `switch` entities. Additionall ### Sensors +- **Each Sonos system**: Sonos Favorites - **Devices with battery**: Battery level, Power state - **Home theater devices**: Audio Input Format - **Voice-enabled devices**: Microphone Enabled @@ -64,6 +65,41 @@ The Sonos integration adds one `switch` for each alarm set in the Sonos app. The The microphone can only be enabled/disabled from physical buttons on the Sonos device and cannot be controlled from Home Assistant. A `binary_sensor` reports its current state. +### Sonos Favorites support notes + +The favorites sensor provides the names and `media_content_id` values for each of the favorites saved to My Sonos in the native Sonos app. This sensor is intended for users that need to access the favorites in a custom template. For most users, accessing favorites by using the Media Browser functionality and "Play media" script/automation action is recommended. + +If using the provided `media_content_id` with the `media_player.play_media` service, the `media_content_type` must be set to "favorite_item_id". + +Example templates: + +{% raw %} + +```yaml +# Get all favorite names as a list (old behavior) +{{ state_attr("sensor.sonos_favorites", "items").values() | list }} + +# Pick a specific favorite name by position +{{ (state_attr("sensor.sonos_favorites", "items").values() | list)[3] }} + +# Pick a random item's `media_content_id` +{{ state_attr("sensor.sonos_favorites", "items") | list | random }} + +# Loop through and grab name & media_content_id +{% for media_id, name in state_attr("sensor.sonos_favorites", "items").items() %} + {{ name, media_id }} +{% endfor %} +``` + +{% endraw %} + +
+ +The Sonos favorites sensor (`sensor.sonos_favorites`) is disabled by default. It can be found and enabled from the entities associated with the Sonos integration on your {% my integrations %} page. + +
+ + ## Playing media Sonos accepts a variety of `media_content_id` formats in the `media_player.play_media` service, but most commonly as URIs. For example, both Spotify and Tidal share links can be provided as-is. Playback of [music hosted on a Plex server](/integrations/plex#sonos-playback) is possible. Direct HTTP/HTTPS links to local or remote media files can also be used if the Sonos device can reach the URI directly, but specific media encoding support may vary. From 222c939b5d17aa0be45e4d3e54351b4f1dc5b15a Mon Sep 17 00:00:00 2001 From: Sven <85389871+wrt54g@users.noreply.github.com> Date: Wed, 11 May 2022 08:55:45 +0200 Subject: [PATCH 02/16] Update number of integrations (#22705) --- source/_includes/custom/features.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_includes/custom/features.html b/source/_includes/custom/features.html index 9e2ff868878..a23fceb329c 100644 --- a/source/_includes/custom/features.html +++ b/source/_includes/custom/features.html @@ -2,7 +2,7 @@
- Works with over 1000 devices + Works with over 1900 devices

From 2fe0e6195518f18bac10a7a2697cd4a6b92e21e0 Mon Sep 17 00:00:00 2001 From: Mick Vleeshouwer Date: Wed, 11 May 2022 11:42:25 +0200 Subject: [PATCH 03/16] Add Somfy deprecation notice (#22702) Co-authored-by: Franck Nijhof --- source/_integrations/overkiz.markdown | 2 -- source/_integrations/somfy.markdown | 6 ++++++ 2 files changed, 6 insertions(+), 2 deletions(-) diff --git a/source/_integrations/overkiz.markdown b/source/_integrations/overkiz.markdown index 62935753e49..22927eba045 100644 --- a/source/_integrations/overkiz.markdown +++ b/source/_integrations/overkiz.markdown @@ -58,8 +58,6 @@ The Overkiz (by Somfy) integration platform is used by many different vendors, l - Somfy TaHoma Switch [(instructions)](#tahoma-switch) - Thermor Cozytouch -If you own a Somfy hub, you could also use the [Somfy integration](/integrations/somfy/) which uses the official API. - ### TaHoma Switch Multiple users reported that the TaHoma Switch will work with this integration **after** you create a scene in the TaHoma app and wait for a few hours. diff --git a/source/_integrations/somfy.markdown b/source/_integrations/somfy.markdown index 7f3a6403cfa..84412774629 100644 --- a/source/_integrations/somfy.markdown +++ b/source/_integrations/somfy.markdown @@ -18,6 +18,12 @@ ha_platforms: ha_integration_type: integration --- +

+ +The Somfy Open API (cloud-based) has been deprecated in favor of the [Somfy TaHoma Developer Mode](https://developer.somfy.com/developer-mode) and will shut down after June 21st, 2022. The [Overkiz integration](/integrations/overkiz/) will support this new local API and can already be used to control your Somfy devices via the cloud. + +
+ The Somfy integration will allow users to integrate their Somfy devices into Home Assistant using the [official API](https://developer.somfy.com/somfy-open-api/apis). ## Installation From ce449014f72fbc31852443f3824af02c8f33979d Mon Sep 17 00:00:00 2001 From: Shai Ungar Date: Thu, 12 May 2022 16:17:38 +0300 Subject: [PATCH 04/16] indicate which sensors are disabled by default (by design) (#22722) --- source/_integrations/sabnzbd.markdown | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/source/_integrations/sabnzbd.markdown b/source/_integrations/sabnzbd.markdown index 196b956e733..974d22d6086 100644 --- a/source/_integrations/sabnzbd.markdown +++ b/source/_integrations/sabnzbd.markdown @@ -34,17 +34,17 @@ You need to grab your API key from your SABnzbd instance in order to configure t This component will create these sensors: -- `status`: The current status of SABnzbd (Idle, Paused, etc.) -- `speed`: The current download speed -- `queue`: The total size of the download queue -- `left`: The remaining size of the download queue -- `disk`: The total disk size at SABnzbd's download location -- `disk_free`: The available disk space at SABnzbd's download location -- `queue_count`: The number of items in the download queue -- `daily_total`: GB downloaded today -- `weekly_size`: GB downloaded this week -- `monthly_total`: GB downloaded this month -- `total`: Total GB downloaded +- `status`: The current status of SABnzbd. (Idle, Paused, etc.) +- `speed`: The current download speed. +- `queue`: The total size of the download queue. +- `left`: The remaining size of the download queue. +- `disk`: The total disk size at SABnzbd's download location. +- `disk_free`: The available disk space at SABnzbd's download location. +- `queue_count`: The number of items in the download queue. +- `total`: Total GB downloaded. +- `daily_total`: GB downloaded today. (disabled by default) +- `weekly_size`: GB downloaded this week. (disabled by default) +- `monthly_total`: GB downloaded this month. (disabled by default) ## Services From a595dad1932ee73c9548415674302fa685220cd7 Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Thu, 12 May 2022 17:36:04 -0700 Subject: [PATCH 05/16] 2022.5.4 (#22723) --- _config.yml | 4 +- .../_posts/2022-05-04-release-20225.markdown | 72 ++++++++++++++++++- 2 files changed, 73 insertions(+), 3 deletions(-) diff --git a/_config.yml b/_config.yml index 5aaa9940891..ed322d03ba9 100644 --- a/_config.yml +++ b/_config.yml @@ -107,8 +107,8 @@ social: # Home Assistant release details current_major_version: 2022 current_minor_version: 5 -current_patch_version: 3 -date_released: 2022-05-08 +current_patch_version: 4 +date_released: 2022-05-12 # Either # or the anchor link to latest release notes in the blog post. # Must be prefixed with a # and have double quotes around it. diff --git a/source/_posts/2022-05-04-release-20225.markdown b/source/_posts/2022-05-04-release-20225.markdown index 2e1e9b9f9c7..17c6bf4f64c 100644 --- a/source/_posts/2022-05-04-release-20225.markdown +++ b/source/_posts/2022-05-04-release-20225.markdown @@ -64,6 +64,7 @@ Enjoy the release! - [Release 2022.5.1 - May 5](#release-202251---may-5) - [Release 2022.5.2 - May 6](#release-202252---may-6) - [Release 2022.5.3 - May 8](#release-202253---may-8) +- [Release 2022.5.4 - May 12](#release-202254---may-12) - [Need help? Join the community!](#need-help-join-the-community) - [Breaking Changes](#breaking-changes) - [Farewell to the following](#farewell-to-the-following) @@ -815,7 +816,76 @@ The following integrations are now available via the Home Assistant UI: [sql docs]: /integrations/sql/ [totalconnect docs]: /integrations/totalconnect/ [ukraine_alarm docs]: /integrations/ukraine_alarm/ -**** + +## Release 2022.5.4 - May 12 + +- Fix timezone issue on onvif integration ([@marvinroger] - [#70473]) ([onvif docs]) +- Fix Insteon issue with dimmer default on level ([@teharris1] - [#71426]) ([insteon docs]) +- Migrate sabnzbd sensors unique ids ([@shaiu] - [#71455]) ([sabnzbd docs]) +- Bump simplisafe-python to 2022.05.1 ([@bachya] - [#71545]) ([simplisafe docs]) +- Fix SABnzbd config check ([@shaiu] - [#71549]) ([sabnzbd docs]) +- Fix typer/click incompatibilty for unifiprotect ([@AngellusMortis] - [#71555]) ([unifiprotect docs]) +- Improve Google Cast detection of HLS playlists ([@emontnemery] - [#71564]) ([cast docs]) +- Correct device class for meater cook sensors ([@emontnemery] - [#71565]) ([meater docs]) +- Bump pychromecast to 12.1.2 ([@emontnemery] - [#71567]) ([cast docs]) +- Bump logi_circle to 0.2.3 ([@evanjd] - [#71578]) ([logi_circle docs]) +- Bump nam backend library to version 1.2.4 ([@bieniu] - [#71584]) ([nam docs]) +- Bump pydeconz to v92 ([@Kane610] - [#71613]) ([deconz docs]) +- Fix wrong brightness level change visible in UI ([@rappenze] - [#71655]) ([fibaro docs]) +- Prevent history_stats from rejecting states when microseconds differ ([@bdraco] - [#71704]) ([history_stats docs]) +- Fix zwave_js device automation bug ([@raman325] - [#71715]) ([zwave_js docs]) +- Fix merge conflict with master to dev in sabnzbd (CI fix) ([@bdraco] - [#71605]) ([sabnzbd docs]) +- Add use_wallclock_as_timestamps option to generic ([@uvjustin] - [#71245]) ([generic docs]) +- Changed API for Ukraine Alarm ([@PaulAnnekov] - [#71754]) ([ukraine_alarm docs]) + +[#70473]: https://github.com/home-assistant/core/pull/70473 +[#71245]: https://github.com/home-assistant/core/pull/71245 +[#71426]: https://github.com/home-assistant/core/pull/71426 +[#71455]: https://github.com/home-assistant/core/pull/71455 +[#71545]: https://github.com/home-assistant/core/pull/71545 +[#71549]: https://github.com/home-assistant/core/pull/71549 +[#71555]: https://github.com/home-assistant/core/pull/71555 +[#71564]: https://github.com/home-assistant/core/pull/71564 +[#71565]: https://github.com/home-assistant/core/pull/71565 +[#71567]: https://github.com/home-assistant/core/pull/71567 +[#71578]: https://github.com/home-assistant/core/pull/71578 +[#71584]: https://github.com/home-assistant/core/pull/71584 +[#71605]: https://github.com/home-assistant/core/pull/71605 +[#71613]: https://github.com/home-assistant/core/pull/71613 +[#71655]: https://github.com/home-assistant/core/pull/71655 +[#71704]: https://github.com/home-assistant/core/pull/71704 +[#71715]: https://github.com/home-assistant/core/pull/71715 +[#71754]: https://github.com/home-assistant/core/pull/71754 +[@AngellusMortis]: https://github.com/AngellusMortis +[@Kane610]: https://github.com/Kane610 +[@PaulAnnekov]: https://github.com/PaulAnnekov +[@bachya]: https://github.com/bachya +[@bdraco]: https://github.com/bdraco +[@bieniu]: https://github.com/bieniu +[@emontnemery]: https://github.com/emontnemery +[@evanjd]: https://github.com/evanjd +[@marvinroger]: https://github.com/marvinroger +[@raman325]: https://github.com/raman325 +[@rappenze]: https://github.com/rappenze +[@shaiu]: https://github.com/shaiu +[@teharris1]: https://github.com/teharris1 +[@uvjustin]: https://github.com/uvjustin +[cast docs]: /integrations/cast/ +[deconz docs]: /integrations/deconz/ +[fibaro docs]: /integrations/fibaro/ +[generic docs]: /integrations/generic/ +[history_stats docs]: /integrations/history_stats/ +[insteon docs]: /integrations/insteon/ +[logi_circle docs]: /integrations/logi_circle/ +[meater docs]: /integrations/meater/ +[nam docs]: /integrations/nam/ +[onvif docs]: /integrations/onvif/ +[sabnzbd docs]: /integrations/sabnzbd/ +[simplisafe docs]: /integrations/simplisafe/ +[ukraine_alarm docs]: /integrations/ukraine_alarm/ +[unifiprotect docs]: /integrations/unifiprotect/ +[zwave_js docs]: /integrations/zwave_js/ + ## Need help? Join the community! Home Assistant has a great community of users who are all more than willing From ce9094adeac439281b1f02bf5524aa7cbf912977 Mon Sep 17 00:00:00 2001 From: Paul Annekov Date: Fri, 13 May 2022 03:05:10 +0300 Subject: [PATCH 06/16] Changed API for Ukraine Alarm (#22725) --- source/_integrations/ukraine_alarm.markdown | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/source/_integrations/ukraine_alarm.markdown b/source/_integrations/ukraine_alarm.markdown index 462fdb16b9b..51723c00dc0 100644 --- a/source/_integrations/ukraine_alarm.markdown +++ b/source/_integrations/ukraine_alarm.markdown @@ -14,7 +14,7 @@ ha_platforms: ha_integration_type: integration --- -The Ukraine Alarm integration uses the [Ukraine Alarm](https://www.ukrainealarm.com/) web service to offer air-raid siren notifications. The integration will create 4 binary sensors for your selected region in Ukraine: +The Ukraine Alarm integration uses the siren.pp.ua API - public wrapper for [Ukraine Alarm](https://www.ukrainealarm.com/) web service to offer air-raid siren notifications. The integration will create 4 binary sensors for your selected region in Ukraine: - Air - Artillery @@ -25,6 +25,8 @@ Siren check interval is set to 10 seconds to avoid overloading the API and still ## Setup -To generate an Ukraine Alarm API key, go to [Ukraine Alarm APIs](https://api.ukrainealarm.com/) page, fill in a form and wait for an email with an API key. - {% include integrations/config_flow.md %} + +## Limitations + +You can add up to 5 regions for monitoring to don't hit API rate limit. From 39d106a470177d8c9aafc4222001bff56b96b456 Mon Sep 17 00:00:00 2001 From: RonSpawnson Date: Fri, 13 May 2022 02:15:07 -0500 Subject: [PATCH 07/16] Fixing typo in Automation Basics (#22726) --- source/_docs/automation/basics.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_docs/automation/basics.markdown b/source/_docs/automation/basics.markdown index 0ad584c5e5e..820095a3347 100644 --- a/source/_docs/automation/basics.markdown +++ b/source/_docs/automation/basics.markdown @@ -5,7 +5,7 @@ description: "A breakdown of what an automation consists of." All automations are made up of a trigger and an action. Optionally combined with a condition. Take for example the automation: -> When Paulus arrives home and it is after sunset: Turn the lights on in the living room.". +> When Paulus arrives home and it is after sunset: Turn the lights on in the living room. We can break up this automation into the following three parts: From 5cf52864e9988a2380db0732235efa5960d892da Mon Sep 17 00:00:00 2001 From: "Ian T. Wright" <30420451+IanTWright@users.noreply.github.com> Date: Fri, 13 May 2022 04:41:00 -0400 Subject: [PATCH 08/16] Corrected a minor spelling error in the group documentation (#22718) --- source/_integrations/group.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/group.markdown b/source/_integrations/group.markdown index b5bfe129e59..0be0b8c8471 100644 --- a/source/_integrations/group.markdown +++ b/source/_integrations/group.markdown @@ -145,7 +145,7 @@ media_player: - platform: group entities: - media_player.kitchen_tv - - media_player.livivng_room_tv + - media_player.living_room_tv ``` Example YAML configuration of a switch group: From 9087510f80211f13b06216eab4fcd8a1c59d55ce Mon Sep 17 00:00:00 2001 From: Christopher Bailey Date: Fri, 13 May 2022 21:02:58 -0400 Subject: [PATCH 09/16] Clarify software support docs for UniFi Protect (#22745) --- source/_integrations/unifiprotect.markdown | 29 ++++++++++++++++++++-- 1 file changed, 27 insertions(+), 2 deletions(-) diff --git a/source/_integrations/unifiprotect.markdown b/source/_integrations/unifiprotect.markdown index bae7aaad811..d163c28423d 100644 --- a/source/_integrations/unifiprotect.markdown +++ b/source/_integrations/unifiprotect.markdown @@ -54,9 +54,34 @@ UCKP with Firmware v1.x **do NOT run UniFi OS**, you must upgrade to firmware v2 ### Software Support -The absolute **minimal** software version is `1.20.0` for UniFi Protect. If you have an older version, you will get errors trying to set up the integration. However, the general advice is the latest 2 minor versions of UniFi Protect and hardware supported by those are supported. Since UniFi Protect has its own release cycle, you should only upgrade UniFi Protect _after_ the next Home Assistant release comes out to ensure the new version is fully supported. +The absolute **minimal** software version is `1.20.0` for UniFi Protect. If you have an older version, you will get errors trying to set up the integration. However, the general advice is the latest 2 minor versions of UniFi Protect and hardware supported by those are supported. -Example: as of `2022.2.0` of Home Assistant, UniFi Protect `1.21.0` is the newest UniFi Protect version. So the recommended versions of UniFi Protect to run for a `2022.2.0` version of Home Assistant are `1.20.0`, `1.20.1`, `1.20.2`, `1.20.3`, `1.21.0`. +#### About UniFi Early Access + +Since UniFi Protect has its own release cycle, you should only upgrade UniFi Protect _after_ the next Home Assistant release to ensure the new version is fully supported. Most importantly, that means **do not use Early Access versions of UniFi Protect if you want your UniFi Protect integration to be stable**. Early Access versions can and will break the UniFi Protect Home Assistant integration in unexpectedly. If you desire to use Early Access versions of UniFi Protect, you can disable automatic updates and wait for the next bugfix version of UniFi Protect to come out. + +For example, the latest UniFi Protect Early Access version as of `2022.5.4` is UniFi Protect `2.0.0-beta.5` and the latest Early Access version of UniFi Protect is `2.0.0-beta.7`. So that means: + +* **do not** upgrade to `2.0.0-beta.7` until `2022.5.5` or `2022.6.0` comes out +* the recommended version of UniFi Protect are any `1.21.x` version or `2.0.0-beta` version before `2.0.0-beta.7` + +#### Downgrading UniFi Protect + +In the event you accidentally upgrade to an Early Access version of UniFi Protect and it breaks your UniFi Protect Home Assistant integration, you can access your UniFi OS Console via SSH and then do the following: + +```bash +# run this command first _only_ if you are on a 1.x firmware of the UDM Pro +# it is not needed for the UDM SE, UNVR, etc. +unifi-os shell + +# downgrade UniFi Protect +apt-get update +apt-get install --reinstall --allow-downgrades unifi-protect=2.0.0-beta.5 -y +``` + +You can replace `2.0.0-beta.5` with whatever version of UniFi Protect you want to downgrade to. + +**Note**: if you want to downgrade to another Early Access version, you must have Remote Access enabled and have the Early Access release channel enabled. ### Local User From 7c358d3f254e46d797517a7027d674a789211203 Mon Sep 17 00:00:00 2001 From: Danny Tsang <567982+dannytsang@users.noreply.github.com> Date: Sun, 15 May 2022 13:42:10 +0100 Subject: [PATCH 10/16] Updated navigation to check YAML configuration (#22752) --- source/getting-started/configuration.markdown | 20 +++++++------------ 1 file changed, 7 insertions(+), 13 deletions(-) diff --git a/source/getting-started/configuration.markdown b/source/getting-started/configuration.markdown index d80ba6f5767..39fa06dc8a7 100644 --- a/source/getting-started/configuration.markdown +++ b/source/getting-started/configuration.markdown @@ -13,16 +13,13 @@ The steps below do not apply to Home Assistant Core & Container installations, f We are going to help you make your first changes to `configuration.yaml`. To do this, we are going to install an add-on from the Home Assistant add-on store: the File editor. To get to the add-on store, click on the menu icon in the top left, then open {% my supervisor title="Settings > Add-ons" %}. On the new page, open the add-on store tab. -

- -From the {% my supervisor title="Settings > Add-ons" %} panel, open the add-on store. -

+![Add-on store.](/images/hassio/screenshots/dashboard.png) Under the "Official add-ons" section you will find the File editor add-on. - - Click on File Editor and click on INSTALL. When installation is complete, the UI will go to the add-on details page for the file editor. - - Now start the add-on by clicking on START. - - Open the user interface by clicking on OPEN WEB UI. + - Click on File Editor and click on **Install**. When installation is complete, the UI will go to the add-on details page for the file editor. + - Now start the add-on by clicking on **Start**. + - Open the user interface by clicking on **Open Web UI**. Now let's make a change using the file editor: we are going to change the name, location, unit system, and time zone of your Home Assistant installation. @@ -44,13 +41,10 @@ Now let's make a change using the file editor: we are going to change the name,
- Click the save icon in the top right to commit changes. - - Most changes in `configuration.yaml` require Home Assistant to be restarted to see the changes. You can verify that your changes are acceptable by running a configuration check. Do this by clicking on Configuration in the sidebar, click on "Settings", "Server Controls" and click on the "CHECK configuration" button. When it's valid, it will show the text "Configuration valid!". In order for the "CHECK configuration" button to be visible, you must enable "Advanced Mode" on your user profile. - - Now Restart Home Assistant using the "RESTART" button in the Server management section on the same page. + - Most changes in `configuration.yaml` require Home Assistant to be restarted to see the changes. You can verify that your changes are acceptable by running a configuration check. Do this by clicking on Configuration in the sidebar, click on `Developer-Tools -> YAML` and click on the **Check configuration** button. When it's valid, it will show the text "Configuration valid!". In order for the **Check Configuration**" button to be visible, you must enable "Advanced Mode" on your user profile. + - Now Restart Home Assistant using the **Restart** button in the Server management section on the same page. -

- -Screenshot of the "General" page in the configuration panel. -

+![Screenshot of the "General" page in the configuration panel.](/images/screenshots/configuration-validation.png)
From 71ba39460ce5f33c22dd58272be29993a5ae7f56 Mon Sep 17 00:00:00 2001 From: Danny Tsang <567982+dannytsang@users.noreply.github.com> Date: Sun, 15 May 2022 13:43:39 +0100 Subject: [PATCH 11/16] Updated URL to developers custom card documentation. (#22753) --- source/_dashboards/picture-elements.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_dashboards/picture-elements.markdown b/source/_dashboards/picture-elements.markdown index d5fbc52029d..c6487822f21 100644 --- a/source/_dashboards/picture-elements.markdown +++ b/source/_dashboards/picture-elements.markdown @@ -406,7 +406,7 @@ elements: ### Custom Elements The process for creating and referencing custom elements is the same as for custom cards. -Please see the [developer documentation](https://developers.home-assistant.io/docs/frontend/custom-ui/lovelace-custom-card.html) +Please see the [developer documentation](https://developers.home-assistant.io/docs/frontend/custom-ui/custom-card) for more information. {% configuration %} From 961fff69101b0951260c9fa3b0fd60892efcc078 Mon Sep 17 00:00:00 2001 From: Jason Wragg <53080867+jasonwragg@users.noreply.github.com> Date: Sun, 15 May 2022 19:22:00 +0100 Subject: [PATCH 12/16] Corrected spelling of laser in binary sensor (#22761) --- source/_integrations/brother.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/brother.markdown b/source/_integrations/brother.markdown index 3e3d0fcd155..4b3c5921bee 100644 --- a/source/_integrations/brother.markdown +++ b/source/_integrations/brother.markdown @@ -51,7 +51,7 @@ template: {{ is_state('sensor.hl_l2340d_status', 'no paper') }} - binary_sensor: - - name: 'Later Printer Paper Jam' + - name: 'Laser Printer Paper Jam' state: > {{ is_state('sensor.hl_l2340d_status', 'paper jam') }} ``` From b7a421d202aa2836a2d587ab7f991a690b0a2e55 Mon Sep 17 00:00:00 2001 From: "J. Nick Koston" Date: Sun, 15 May 2022 14:21:01 -0500 Subject: [PATCH 13/16] Fix typos in unifiprotect documentation (#22756) --- source/_integrations/unifiprotect.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_integrations/unifiprotect.markdown b/source/_integrations/unifiprotect.markdown index d163c28423d..d9ae9069355 100644 --- a/source/_integrations/unifiprotect.markdown +++ b/source/_integrations/unifiprotect.markdown @@ -58,7 +58,7 @@ The absolute **minimal** software version is `1.20.0` for UniFi Protect. If you #### About UniFi Early Access -Since UniFi Protect has its own release cycle, you should only upgrade UniFi Protect _after_ the next Home Assistant release to ensure the new version is fully supported. Most importantly, that means **do not use Early Access versions of UniFi Protect if you want your UniFi Protect integration to be stable**. Early Access versions can and will break the UniFi Protect Home Assistant integration in unexpectedly. If you desire to use Early Access versions of UniFi Protect, you can disable automatic updates and wait for the next bugfix version of UniFi Protect to come out. +Since UniFi Protect has its own release cycle, you should only upgrade UniFi Protect _after_ the next Home Assistant release to ensure the new version is fully supported. Most importantly, that means **do not use Early Access versions of UniFi Protect if you want your UniFi Protect integration to be stable**. Early Access versions can and will break the UniFi Protect Home Assistant integration unexpectedly. If you desire to use Early Access versions of UniFi Protect, you can disable automatic updates and wait for the next bugfix version of UniFi Protect to come out. For example, the latest UniFi Protect Early Access version as of `2022.5.4` is UniFi Protect `2.0.0-beta.5` and the latest Early Access version of UniFi Protect is `2.0.0-beta.7`. So that means: @@ -76,7 +76,7 @@ unifi-os shell # downgrade UniFi Protect apt-get update -apt-get install --reinstall --allow-downgrades unifi-protect=2.0.0-beta.5 -y +apt-get install --reinstall --allow-downgrades unifi-protect=2.0.0~beta.5 -y ``` You can replace `2.0.0-beta.5` with whatever version of UniFi Protect you want to downgrade to. From 12ce1a99b3f6f0154a088927751c9dd2c3e94a75 Mon Sep 17 00:00:00 2001 From: LFPoulain <35775235+lfpoulain@users.noreply.github.com> Date: Sun, 15 May 2022 21:41:26 +0200 Subject: [PATCH 14/16] Update unit_of_measurement for TemperatureSensor (#22755) --- source/_integrations/homekit.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/homekit.markdown b/source/_integrations/homekit.markdown index bc44cc01835..69392fecd5d 100644 --- a/source/_integrations/homekit.markdown +++ b/source/_integrations/homekit.markdown @@ -422,7 +422,7 @@ The following integrations are currently supported: | lock | DoorLock | Support for `lock / unlock`. | | media_player | MediaPlayer | Represented as a series of switches which control `on / off`, `play / pause`, `play / stop`, or `mute` depending on `supported_features` of entity and the `mode` list specified in `entity_config`. | | media_player | TelevisionMediaPlayer | All media players that have `tv` as their `device_class`. Represented as Television and Remote accessories in HomeKit to control `on / off`, `play / pause`, `select source`, or `volume increase / decrease`, depending on `supported_features` of entity. Requires iOS 12.2/macOS 10.14.4 or later. | -| sensor | TemperatureSensor | All sensors that have `Celsius` or `Fahrenheit` as their `unit_of_measurement` or `temperature` as their `device_class`. | +| sensor | TemperatureSensor | All sensors that have `°C` or `°F` as their `unit_of_measurement` and `temperature` as their `device_class`. | | sensor | HumiditySensor | All sensors that have `%` as their `unit_of_measurement` and `humidity` as their `device_class`. | | sensor | AirQualitySensor | All sensors that have `pm25` as part of their `entity_id` or `pm25` as their `device_class` | | sensor | CarbonMonoxideSensor | All sensors that have `co` as their `device_class` | From 9f46093f0d473e08ff43c4f3934b56806a946cf7 Mon Sep 17 00:00:00 2001 From: G Johansson Date: Sun, 15 May 2022 22:04:55 +0200 Subject: [PATCH 15/16] Update markdown Trafikverket Train (#22657) Co-authored-by: Franck Nijhof --- source/_integrations/trafikverket_train.markdown | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/source/_integrations/trafikverket_train.markdown b/source/_integrations/trafikverket_train.markdown index f3ebca343b6..ee0d42ff215 100644 --- a/source/_integrations/trafikverket_train.markdown +++ b/source/_integrations/trafikverket_train.markdown @@ -20,21 +20,23 @@ Retrieve train departure information from [Trafikverket](https://www.trafikverke ## Use cases -- Retrieve the next departure and information connected to it for a specific train line. -- Retrieve information for specific departure time on a specific train line. +- Retrieve the next departure between two stations. +- Retrieve information for specific departure time between two stations. - Set up an alert or perform actions if your train is delayed or canceled. ## Retrieved data - Next departure for the specific train line. - Canceled status. -- The number of minutes delayed. +- Delayed time. - Planned time if no delays occur. - Estimated time of arrival if delays occur. - Actual time - when it did arrive. - Other information / additional texts. - Deviations. +The next departure is calculated from actual, estimated, and planned to provide the most accurate information about departure. + ## Prerequisites Please click [here](https://api.trafikinfo.trafikverket.se/) and register to obtain the API key. From 0dea1e0b2ed56680ae56f2cdadb03b263b5e2b2a Mon Sep 17 00:00:00 2001 From: uvjustin <46082645+uvjustin@users.noreply.github.com> Date: Mon, 16 May 2022 15:19:09 +0800 Subject: [PATCH 16/16] Update generic documentation for use_wallclock_as_timestamps option (#22747) Co-authored-by: Franck Nijhof --- source/_integrations/generic.markdown | 20 +++++++++++--------- 1 file changed, 11 insertions(+), 9 deletions(-) diff --git a/source/_integrations/generic.markdown b/source/_integrations/generic.markdown index 797978ec364..6f5e9bb2c50 100644 --- a/source/_integrations/generic.markdown +++ b/source/_integrations/generic.markdown @@ -26,24 +26,26 @@ You must enter a URL in at least one of the fields **Still Image URL** or **Stre [Templates](/topics/templating/) are allowed in the URL fields, which can be used to select different images or parameterize the URL depending on the status of sensors. Template validity and network access are checked during the configuration steps. {% configuration_basic %} -still_image_url: +Still Image URL: description: "The URL your camera serves the image on, e.g., `http://192.168.1.21:2112/`. Can be a [template](/topics/templating/). At least one of still_image_url or stream_source must be provided." -stream_source: +Stream Source: description: "The URL your camera serves the live stream on, e.g., `rtsp://user:pass@192.168.1.21:554/`. Can be a [template](/topics/templating/). Usernames and passwords must be embedded in the URL. At least one of still_image_url or stream_source must be provided. Note that a stream_source without a still_image_url can only be used if the [stream integration](/integrations/stream/) is configured." -username: +Username: description: The username for accessing your camera. Note that this username applies only to still_image_url and not to stream_source. -password: +Password: description: The password for accessing your camera. Note that this password applies only to still_image_url and not to stream_source. -authentication: +Authentication: description: "Type for authenticating the requests `basic` or `digest`." -limit_refetch_to_url_change: +Limit refetch to URL change: description: Limits re-fetching of the remote image to when the URL changes. Only relevant if using a template to fetch the remote image. -framerate: +Frame Rate: description: The number of frames-per-second (FPS) of the stream. Can cause heavy traffic on the network and/or heavy load on the camera. -verify_ssl: +Verify SSL certificate: description: Enable or disable SSL certificate verification. Set to false to use an http-only camera, or you have a self-signed SSL certificate and haven't installed the CA certificate to enable verification. -rtsp_transport: +RTSP transport protocol: description: "Set the RTSP transport protocol to `tcp`, `udp`, `udp_multicast` or `http`." +Use wallclock as timestamps: + description: ([Advanced Mode](/blog/2019/07/17/release-96/#advanced-mode) only) Rewrite the camera timestamps. This may help with playback or crashing issues from Wi-Fi cameras or cameras of certain brands (e.g., EZVIZ). {% endconfiguration_basic %}