home-assistant · rokam · Jan 26, 2023 · Jan 26, 2023 · Jan 27, 2023 · Jan 31, 2023
diff --git a/.github/workflows/add_prs_to_project.yml b/.github/workflows/add_prs_to_project.yml
@@ -13,7 +13,7 @@ jobs:
       - name: Generate app token
         id: token
         # Pinned to a specific version of the action for security reasons
-        uses: tibdex/github-app-token@021a2405c7f990db57f5eae5397423dcc554159c # v1.7.0
+        uses: tibdex/github-app-token@b62528385c34dbc9f38e5f4225ac829252d1ea92 # v1.8.0
         with:
           app_id: ${{ secrets.PROJECTS_APP_ID }}
           private_key: ${{ secrets.PROJECTS_APP_PEM }}

diff --git a/Gemfile b/Gemfile
@@ -20,7 +20,7 @@ group :jekyll_plugins do
 end
 
 gem 'sinatra', '3.0.5'
-gem 'nokogiri', '1.14.0'
+gem 'nokogiri', '1.14.1'
 
 # Windows and JRuby does not include zoneinfo files, so bundle the tzinfo-data gem
 # and associated library

diff --git a/Gemfile.lock b/Gemfile.lock
@@ -5,7 +5,7 @@ GEM
       public_suffix (>= 2.0.2, < 6.0)
     chunky_png (1.4.0)
     colorator (1.1.0)
-    commonmarker (0.23.7)
+    commonmarker (0.23.8)
     compass (1.0.3)
       chunky_png (~> 1.2)
       compass-core (~> 1.0.2)
@@ -73,10 +73,10 @@ GEM
     multi_json (1.15.0)
     mustermann (3.0.0)
       ruby2_keywords (~> 0.0.1)
-    nokogiri (1.14.0)
+    nokogiri (1.14.1)
       mini_portile2 (~> 2.8.0)
       racc (~> 1.4)
-    nokogiri (1.14.0-x64-mingw32)
+    nokogiri (1.14.1-x64-mingw32)
       racc (~> 1.4)
     pathutil (0.16.2)
       forwardable-extended (~> 2.6)
@@ -114,12 +114,12 @@ GEM
     terminal-table (3.0.2)
       unicode-display_width (>= 1.1.1, < 3)
     tilt (2.0.11)
-    tzinfo (2.0.5)
+    tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
     tzinfo-data (1.2022.7)
       tzinfo (>= 1.0.0)
     unicode-display_width (2.4.2)
-    webrick (1.7.0)
+    webrick (1.8.1)
 
 PLATFORMS
   ruby
@@ -132,7 +132,7 @@ DEPENDENCIES
   jekyll-paginate (= 1.1.0)
   jekyll-sitemap (= 1.4.0)
   jekyll-toc (= 0.18.0)
-  nokogiri (= 1.14.0)
+  nokogiri (= 1.14.1)
   rake (= 13.0.6)
   sass-globbing (= 1.1.5)
   sassc (= 2.1.0)

diff --git a/package-lock.json b/package-lock.json
diff --git a/package.json b/package.json
@@ -9,7 +9,7 @@
     "remark-lint-fenced-code-flag": "^3.1.1",
     "remark-lint-no-shell-dollars": "^3.1.1",
     "remark-stringify": "^10.0.2",
-    "textlint": "^12.6.0",
+    "textlint": "^13.1.0",
     "textlint-filter-rule-comments": "^1.2.2",
     "textlint-rule-common-misspellings": "^1.0.1",
     "textlint-rule-terminology": "^3.0.4"

diff --git a/source/_dashboards/iframe.markdown b/source/_dashboards/iframe.markdown
@@ -38,6 +38,11 @@ aspect_ratio:
   description: 'Forces the height of the image to be a ratio of the width. Valid formats: Height percentage value (`23%`) or ratio expressed with colon or "x" separator (`16:9` or `16x9`). For a ratio, the second element can be omitted and will default to "1" (`1.78` equals `1.78:1`).'
   type: string
   default: "50%"
+allow_open_top_navigation:
+  required: false
+  description: 'Allow the user to open iframe content links by opening the default browser in the Home Assistant mobile app. It is false by default because it adds allow-top-navigation-by-user-activation on the iframe sandbox attribute which is less secure. So set it to true if you need it and are confident with the iframe content.'
+  type: boolean
+  default: false
 title:
   required: false
   description: The card title.

diff --git a/source/_docs/blueprint/schema.markdown b/source/_docs/blueprint/schema.markdown
@@ -55,6 +55,10 @@ domain:
     `automation` and `script` are supported.
   type: string
   required: true
+author:
+  description: The name of the blueprint author.
+  type: string
+  required: false
 homeassistant:
   description: >
     Home Assistant requirements to be able to use the blueprint successfully.

diff --git a/source/_docs/configuration/templating.markdown b/source/_docs/configuration/templating.markdown
@@ -309,6 +309,7 @@ The same thing can also be expressed as a test:
 
 ### Areas
 
+- `areas()` returns the full list of area IDs
 - `area_id(lookup_value)` returns the area ID for a given device ID, entity ID, or area name. Can also be used as a filter.
 - `area_name(lookup_value)` returns the area name for a given device ID, entity ID, or area ID. Can also be used as a filter.
 - `area_entities(area_name_or_id)` returns the list of entity IDs tied to a given area ID or name. Can also be used as a filter.
@@ -318,6 +319,10 @@ The same thing can also be expressed as a test:
 
 {% raw %}
 
+```text
+{{ areas() }}  # ['area_id']
+```
+
 ```text
 {{ area_id('Living Room') }}  # 'deadbeefdeadbeefdeadbeefdeadbeef'
 ```

diff --git a/source/_docs/mqtt.markdown b/source/_docs/mqtt.markdown
diff --git a/source/_includes/asides/docs_navigation.html b/source/_includes/asides/docs_navigation.html
@@ -40,17 +40,25 @@ <h1 class="title delta">Topics</h1>
         </ul>
       </li>
       <li>
-        <b>Home Energy Management</b>
+        <b>{% active_link /docs/assist/ Assist %}</b>
+        <ul>
+          <li>{% active_link /docs/assist/android/ Assist for Android Wear %}</li>
+          <li>{% active_link /docs/assist/apple/ Assist for Apple devices %}</li>
+          <li>{% active_link /docs/assist/builtin_sentences/ Built-in sentences %}</li>
+          <li>{% active_link /docs/assist/custom_sentences/ Custom sentences %}</li>
+        </ul>
+      </li>
+      <li>
+        <b>{% active_link /docs/energy/ Home Energy Management %}</b>
         <ul>
-          <li>{% active_link /docs/energy/ Introduction %}</li>
           <li>{% active_link /docs/energy/electricity-grid/ Electricity Grid %}</li>
           <li>{% active_link /docs/energy/solar-panels/ Solar Panels %}</li>
           <li>{% active_link /docs/energy/individual-devices/ Individual Devices %}</li>
           <li>{% active_link /docs/energy/faq/ FAQ %}</li>
         </ul>
       </li>
       <li>
-        <b>Advanced Configuration</b>
+        Advanced Configuration
         <ul>
           <li>{% active_link /docs/configuration/remote/ Remote access %}</li>
           <li>
@@ -81,7 +89,7 @@ <h1 class="title delta">Topics</h1>
         </ul>
       </li>
       <li>
-        <b>Core objects</b>
+        Core objects
         <ul>
           <li>{% active_link /docs/configuration/events/ Events %}</li>
           <li>
@@ -155,18 +163,18 @@ <h1 class="title delta">Topics</h1>
         </ul>
       </li>
       <li>
-        <b>{% active_link /docs/mqtt/ MQTT %}</b>
+        <b>{% active_link /integrations/mqtt MQTT %}</b>
         <ul>
-          <li>{% active_link /docs/mqtt/broker/ Broker %}</li>
-          <li>{% active_link /docs/mqtt/certificate/ Certificate %}</li>
-          <li>{% active_link /docs/mqtt/discovery/ Discovery %}</li>
-          <li>{% active_link /docs/mqtt/service/ Publish service %}</li>
+          <li>{% active_link /integrations/mqtt/#broker-configuration Broker %}</li>
+          <li>{% active_link /integrations/mqtt/#advanced-broker-configuration Certificate %}</li>
+          <li>{% active_link /integrations/mqtt/#mqtt-discovery Discovery %}</li>
+          <li>{% active_link /integrations/mqtt/#publish--dump-services Publish service %}</li>
           <li>
-            {% active_link /docs/mqtt/birth_will/ Birth and last will messages
+            {% active_link /integrations/mqtt/#birth-and-last-will-messages Birth and last will messages
             %}
           </li>
-          <li>{% active_link /docs/mqtt/testing/ Testing your setup %}</li>
-          <li>{% active_link /docs/mqtt/logging/ Logging %}</li>
+          <li>{% active_link /integrations/mqtt/#testing-your-setup Testing your setup %}</li>
+          <li>{% active_link /integrations/mqtt/#logging Logging %}</li>
         </ul>
       </li>
     </ul>

diff --git a/source/_includes/site/sidebar.html b/source/_includes/site/sidebar.html
@@ -57,4 +57,4 @@ <h1 class="title delta">On this page</h1>
       }
     }
   });
-</script>
+</script>
diff --git a/source/_integrations/alarm_control_panel.ifttt.markdown b/source/_integrations/alarm_control_panel.ifttt.markdown
@@ -7,7 +7,7 @@ ha_release: 0.66
 ha_domain: ifttt
 ---
 
-The `ifttt` platform allows you to integrate security systems that have no open API but can be controlled through [IFTTT](https://ifttt.com/discover).
+The `ifttt` platform allows you to integrate security systems that have no open API but can be controlled through [IFTTT](https://ifttt.com/explore).
 
 This platform depends on the [IFTTT](/integrations/ifttt/) Home Assistant integration. See the integrations documentation to set it up.
 

diff --git a/source/_integrations/alarm_control_panel.mqtt.markdown b/source/_integrations/alarm_control_panel.mqtt.markdown
@@ -105,7 +105,7 @@ command_topic:
   required: true
   type: string
 device:
-  description: "Information about the device this alarm panel is a part of to tie it into the [device registry](https://developers.home-assistant.io/docs/en/device_registry_index.html). Only works through [MQTT discovery](/docs/mqtt/discovery/) and when [`unique_id`](#unique_id) is set. At least one of identifiers or connections must be present to identify the device."
+  description: "Information about the device this alarm panel is a part of to tie it into the [device registry](https://developers.home-assistant.io/docs/en/device_registry_index.html). Only works through [MQTT discovery](/integrations/mqtt/#mqtt-discovery) and when [`unique_id`](#unique_id) is set. At least one of identifiers or connections must be present to identify the device."
   required: false
   type: map
   keys:

diff --git a/source/_integrations/alarmdecoder.markdown b/source/_integrations/alarmdecoder.markdown
@@ -130,17 +130,25 @@ Using a combination of the available services and attributes, you can create swi
       friendly_name: Chime
       value_template: "{{ is_state_attr('alarm_control_panel.alarm_panel', 'chime', true) }}"
       turn_on:
-        service: alarmdecoder.alarm_toggle_chime
-        target:
+        - condition: state
           entity_id: alarm_control_panel.alarm_panel
-        data:
-          code: !secret alarm_code
+          attribute: chime
+          state: False
+        - service: alarmdecoder.alarm_toggle_chime
+          target:
+            entity_id: alarm_control_panel.alarm_panel
+          data:
+            code: !secret alarm_code
       turn_off:
-        service: alarmdecoder.alarm_toggle_chime
-        target:
+        - condition: state
           entity_id: alarm_control_panel.alarm_panel
-        data:
-          code: !secret alarm_code
+          attribute: chime
+          state: True
+        - service: alarmdecoder.alarm_toggle_chime
+          target:
+            entity_id: alarm_control_panel.alarm_panel
+          data:
+            code: !secret alarm_code
       icon_template: >-
         {% if is_state_attr('alarm_control_panel.alarm_panel', 'chime', true) %}
           mdi:bell-ring

@@ -402,7 +402,7 @@ See [List of Capability Interfaces and Supported Locales][alexa-supported-locale
 
 The `endpoint`, `client_id` and `client_secret` are optional, and are only required if you want to enable Alexa's proactive mode (i.e., "Send Alexa Events" enabled). Please note the following if you want to enable proactive mode:
 
-- There are different endpoint URLs, depending on the region of your skill. Please check the available endpoints at <https://developer.amazon.com/docs/smarthome/send-events-to-the-alexa-event-gateway.html#endpoints>
+- There are different endpoint URLs, depending on the region of your skill. Please check the available endpoints at <https://developer.amazon.com/docs/smarthome/send-events.html#endpoints>
 - The `client_id` and `client_secret` are not the ones used by the skill that have been set up using "Login with Amazon" (in the [Alexa Developer Console][amazon-dev-console]: Build > Account Linking), but rather from the "Alexa Skill Messaging" (in the Alexa Developer Console: Build > Permissions > Alexa Skill Messaging). To get them, you need to enable the "Send Alexa Events" permission.
 - If the "Send Alexa Events" permission was not enabled previously, you need to unlink and relink the skill using the Alexa App, or else Home Assistant will show the following error: "Token invalid and no refresh token available. Also, you need to restart your Home Assistant after each disabling/enabling the skill in Alexa."
 

@@ -55,4 +55,4 @@ Cloud. Users desiring a local option are encouraged to explore the
 [Ecowitt](https://www.ecowitt.com) family of devices, which are able to read RF signals
 directly from the PWS and transmit them to a variety of other applications, including
 [`ecowitt2mqtt`](https://github.com/bachya/ecowitt2mqtt) (which supports
-[MQTT Discovery](/docs/mqtt/discovery)), or the built-in [Ecowitt](/integrations/ecowitt/) integration.
+[MQTT Discovery](/integrations/mqtt/#mqtt-discovery)), or the built-in [Ecowitt](/integrations/ecowitt/) integration.
@@ -75,6 +75,7 @@ This includes:
 
 - The names of all your core integrations
 - The names and versions of all your custom integrations if you have any
+- The name and version of the engine used in the [recorder integration](/integrations/recorder)
 - Boolean to indicate that the [energy integration](/integrations/energy) is configured
 - Boolean to indicate that [HTTP certificate](https://www.home-assistant.io/integrations/http/#ssl_certificate) is configured
 
@@ -114,6 +115,10 @@ If your system includes the Supervisor, this will also contain:
   "energy": {
     "configured": true
   },
+  "recorder": {
+    "engine": "sqlite",
+    "version": "123"
+  },
   "certificate": false
 }
 ```

@@ -44,6 +44,7 @@ The `august` integration allows you to integrate your [August](https://august.co
 | Yale Conexis L1 | yes |
 | Yale Conexis L2 | yes |
 | Yale Linus | yes |
+| Yale Smart Safe | yes |
 
 There is currently support for the following device types within Home Assistant:
 

diff --git a/source/_integrations/binary_sensor.mqtt.markdown b/source/_integrations/binary_sensor.mqtt.markdown
@@ -69,7 +69,7 @@ availability_topic:
   required: false
   type: string
 device:
-  description: "Information about the device this binary sensor is a part of to tie it into the [device registry](https://developers.home-assistant.io/docs/en/device_registry_index.html). Only works through [MQTT discovery](/docs/mqtt/discovery/) and when [`unique_id`](#unique_id) is set. At least one of identifiers or connections must be present to identify the device."
+  description: "Information about the device this binary sensor is a part of to tie it into the [device registry](https://developers.home-assistant.io/docs/en/device_registry_index.html). Only works through [MQTT discovery](/integrations/mqtt/#mqtt-discovery) and when [`unique_id`](#unique_id) is set. At least one of identifiers or connections must be present to identify the device."
   required: false
   type: map
   keys:

@@ -92,6 +92,7 @@ If you experience an unreliable Bluetooth connection, installing a short USB ext
 - QGOO BT-06A (CSR8510A10)
 - ROCKETEK BT4Y (CSR8510A10)
 - SABRENT BT-UB40 (CSR8510A10)
+- Sena UD100-G03 (CSR8510A10) 📶
 - StarTech USBBT1EDR4 (CSR8510A10)
 - Techkey PBT06H (CSR8510A10)
 - TRENDnet TBW-107UB (CSR8510A10)
@@ -119,6 +120,7 @@ There is currently no supported method to install these patch files when using H
 - IOGEAR GBU521W6 (BCM20702A0)
 - INSIGNIA NS-PCY5BMA (BCM20702A0)
 - Kinivo BTD-400 (BCM20702A0)
+- LM Technologies LM506 (BCM20702A1)
 - LM Technologies LM1010 (BCM20702A0) 📶
 - Plugable USB-BT4LE (BCM20702A0)
 - SoundBot SB342 (BCM20702A0)
@@ -170,6 +172,7 @@ These adapters do not have a reset pin. If they stop responding, there is curren
 - ISEKIE KW-B3519 (RTL8761BU)
 - Maxuni BT-501 (RTL8761BU)
 - MPOW BH45A (RTL8761BU)
+- Plugable USB-BT5 (RTL8761BU)
 - StarTech USBA-BLUETOOTH-V5-C2 (RTL8761BU)
 - SUMEE BT501 (RTL8761BU)
 - UGREEN CM390 (RTL8761BU)

diff --git a/source/_integrations/button.mqtt.markdown b/source/_integrations/button.mqtt.markdown
@@ -67,7 +67,7 @@ command_topic:
   required: false
   type: string
 device:
-  description: "Information about the device this button is a part of to tie it into the [device registry](https://developers.home-assistant.io/docs/en/device_registry_index.html). Only works through [MQTT discovery](/docs/mqtt/discovery/) and when [`unique_id`](#unique_id) is set. At least one of identifiers or connections must be present to identify the device."
+  description: "Information about the device this button is a part of to tie it into the [device registry](https://developers.home-assistant.io/docs/en/device_registry_index.html). Only works through [MQTT discovery](/integrations/mqtt/#mqtt-discovery) and when [`unique_id`](#unique_id) is set. At least one of identifiers or connections must be present to identify the device."
   required: false
   type: map
   keys:

diff --git a/source/_integrations/camera.mqtt.markdown b/source/_integrations/camera.mqtt.markdown
@@ -69,7 +69,7 @@ availability_topic:
   required: false
   type: string
 device:
-  description: "Information about the device this camera is a part of to tie it into the [device registry](https://developers.home-assistant.io/docs/en/device_registry_index.html). Only works through [MQTT discovery](/docs/mqtt/discovery/) and when [`unique_id`](#unique_id) is set. At least one of identifiers or connections must be present to identify the device."
+  description: "Information about the device this camera is a part of to tie it into the [device registry](https://developers.home-assistant.io/docs/en/device_registry_index.html). Only works through [MQTT discovery](/integrations/mqtt/#mqtt-discovery) and when [`unique_id`](#unique_id) is set. At least one of identifiers or connections must be present to identify the device."
   required: false
   type: map
   keys:

diff --git a/source/_integrations/climate.mqtt.markdown b/source/_integrations/climate.mqtt.markdown
@@ -100,7 +100,7 @@ current_temperature_topic:
   required: false
   type: string
 device:
-  description: 'Information about the device this HVAC device is a part of to tie it into the [device registry](https://developers.home-assistant.io/docs/en/device_registry_index.html). Only works through [MQTT discovery](/docs/mqtt/discovery/) and when [`unique_id`](#unique_id) is set. At least one of identifiers or connections must be present to identify the device.'
+  description: 'Information about the device this HVAC device is a part of to tie it into the [device registry](https://developers.home-assistant.io/docs/en/device_registry_index.html). Only works through [MQTT discovery](/integrations/mqtt/#mqtt-discovery) and when [`unique_id`](#unique_id) is set. At least one of identifiers or connections must be present to identify the device.'
   required: false
   type: map
   keys:

diff --git a/source/_integrations/cover.mqtt.markdown b/source/_integrations/cover.mqtt.markdown
@@ -80,7 +80,7 @@ command_topic:
   required: false
   type: string
 device:
-  description: "Information about the device this cover is a part of to tie it into the [device registry](https://developers.home-assistant.io/docs/en/device_registry_index.html). Only works through [MQTT discovery](/docs/mqtt/discovery/) and when [`unique_id`](#unique_id) is set. At least one of identifiers or connections must be present to identify the device."
+  description: "Information about the device this cover is a part of to tie it into the [device registry](https://developers.home-assistant.io/docs/en/device_registry_index.html). Only works through [MQTT discovery](/integrations/mqtt/#mqtt-discovery) and when [`unique_id`](#unique_id) is set. At least one of identifiers or connections must be present to identify the device."
   required: false
   type: map
   keys:

@@ -17,6 +17,7 @@ This integration is a meta-component and configures a default set of integration
 - [Backup](/integrations/backup/) (`backup`)
 - [Bluetooth](/integrations/bluetooth/) (`bluetooth`)
 - [Configuration](/integrations/config/) (`config`)
+- [Conversation](/integrations/conversation/) (`conversation`)
 - [Counter](/integrations/counter/) (`counter`)
 - [DHCP Discovery](/integrations/dhcp/) (`dhcp`)
 - [Energy](/integrations/energy/) (`energy`)
-Original file line number
+Diff line change
@@ Expand Up / @@ -57,4 +57,4 @@ <h1 class="title delta">On this page</h1> @@
           }
         }
       });
-    </script>
+    </script>