Merge branch 'current' into next

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.6)
+    commonmarker (0.23.7)
     compass (1.0.3)
       chunky_png (~> 1.2)
       compass-core (~> 1.0.2)
@@ -18,7 +18,7 @@ GEM
       sass (>= 3.3.0, < 3.5)
     compass-import-once (1.0.5)
       sass (>= 3.2, < 3.5)
-    concurrent-ruby (1.1.10)
+    concurrent-ruby (1.2.0)
     em-websocket (0.5.3)
       eventmachine (>= 0.12.9)
       http_parser.rb (~> 0)

source/_dashboards/panel.markdown

@@ -2,10 +2,10 @@
 type: view
 title: Panel View
 sidebar_label: Panel
-description: "The panel view shows 1 card in the fullwidth of the screen."
+description: "The panel view shows a single card in the full width of the screen."
 ---
 
-In this view the first card is rendered full-width, other cards in the view will not be rendered. 
+The view must have exactly one card. This card is rendered full-width. 
 
 This view doesn't have support for badges.
 

source/_integrations/bluetooth.markdown

@@ -77,33 +77,22 @@ Some systems may not come with Bluetooth and require a USB adapter. Installing a
 
 If you experience an unreliable Bluetooth connection, installing a short USB extension cable between your Bluetooth adapter and your Home Assistant server may improve reliability.
 
-### Known working high performance adapters
+### Known working high-performance adapters
+
+#### Cambridge Silicon Radio (CSR) Based adapters
 
-- ASUS USB-BT400 (BCM20702A0)
 - Avantree BTDG-40S (CSR8510A10)
-- Cable Matters 604002-BLK (BCM20702A0)
 - Enbiawit BT403 (CSR8510A10)
 - Feasycom FSC-BP119 (CSR8510A10) 📶
-- GMYLE 3340 (BCM20702A0)
 - HIDEEZ BT0015-01 (CSR8510A10)
-- IOGEAR GBU521W6 (BCM20702A0)
-- INSIGNIA NS-PCY5BMA (BCM20702A0)
-- Kinivo BTD-400 (BCM20702A0)
-- LM Technologies LM1010 (BCM20702A0) 📶
 - Nuu You BT40 (CSR8510A10)
 - ORICO BTA-403 (CSR8510A10)
 - ORICO BTA-409 (CSR8510A10)
 - Panda Wireless PBU40 (CSR8510A10)
-- Plugable USB-BT4LE (BCM20702A0)
 - QGOO BT-06A (CSR8510A10)
-- Raspberry Pi 3B+ (CYW43455)
-- Raspberry Pi 4B (CYW43455)
 - ROCKETEK BT4Y (CSR8510A10)
 - SABRENT BT-UB40 (CSR8510A10)
-- SoundBot SB342 (BCM20702A0)
 - StarTech USBBT1EDR4 (CSR8510A10)
-- StarTech USBBT2EDR4 (BCM20702A0)
-- Targus ACB10US1 (BCM20702A0)
 - Techkey PBT06H (CSR8510A10)
 - TRENDnet TBW-107UB (CSR8510A10)
 - UGREEN CM109 (CSR8510A10)
@@ -112,6 +101,43 @@ If you experience an unreliable Bluetooth connection, installing a short USB ext
 
 📶 Denotes external antenna
 
+Most of these adapters can hold five (5) connections at the same time.
+
+These adapters generally offer the fastest connect times and do not require additional drivers or patch files.
+
+#### Broadcom (BCM) based adapters
+
+<div class='note warning'>
+These adapters may require additional patch files available at <a href="https://github.com/winterheart/broadcom-bt-firmware">https://github.com/winterheart/broadcom-bt-firmware</a> for stable operation.
+  
+There is currently no supported method to install these patch files when using Home Assistant Operating System.
+</div>
+  
+- ASUS USB-BT400 (BCM20702A0)
+- Cable Matters 604002-BLK (BCM20702A0)
+- GMYLE 3340 (BCM20702A0)
+- IOGEAR GBU521W6 (BCM20702A0)
+- INSIGNIA NS-PCY5BMA (BCM20702A0)
+- Kinivo BTD-400 (BCM20702A0)
+- LM Technologies LM1010 (BCM20702A0) 📶
+- Plugable USB-BT4LE (BCM20702A0)
+- SoundBot SB342 (BCM20702A0)
+- StarTech USBBT2EDR4 (BCM20702A0)
+- Targus ACB10US1 (BCM20702A0)
+
+📶 Denotes external antenna
+
+Most of these adapters can hold seven (7) connections at the same time.
+
+#### Cypress based adapters
+
+- Raspberry Pi 3B+ (CYW43455)
+- Raspberry Pi 4B (CYW43455)
+
+These adapters are connected via the UART bus which may limit their performance.
+
+#### High-performance determination methodology
+
 Performance is primarily determined by a combination of the chip and the Linux drivers for the adapter. Some vendors using the same chip had an unacceptable performance and are listed as unsupported.
 
 The following requirements must be met for an adapter to be labeled as High Performance:
@@ -128,20 +154,14 @@ Performance testing used the following hardware:
 - Advertisements from an Oral-B iO Series 8
 - External Adapters only: Home Assistant Blue running Home Assistant Operating System 9.3 with a USB extension cable.
 
-#### Broadcom adapters (BCM20702A0)
-
-Most of these adapters can hold seven (7) connections at the same time.
-
-These adapters may take an additional 120 seconds to initialize after boot with Home Assistant Operating System 9.3 when using an ODROID N2+; eventually, they come online.
-
-#### Cambridge Silicon Radio adapters (CSR8510A10)
-
-Most of these adapters can hold five (5) connections at the same time.
-
-These adapters generally offer the fastest connect times.
-
 ### Known working adapters
 
+#### Realtek RTL8761BU adapters
+
+<div class='note warning'>
+These adapters do not have a reset pin. If they stop responding, there is currently no way for the kernel to reset them automatically. A generic USB reset for these adapters has been introduced in Linux kernel 6.1 and later.
+</div>
+
 - ASUS USB-BT500 (RTL8761BU)
 - Avantree DG45 (RTL8761BU)
 - COMCAST CF-B03 (RTL8761BU)
@@ -160,10 +180,6 @@ These adapters generally offer the fastest connect times.
 
 📶 Denotes external antenna
 
-#### Realtek RTL8761BU adapters
-
-These adapters do not have a reset pin. If they stop responding, there is currently no way for the kernel to reset them automatically. A generic USB reset for these adapters has been introduced in Linux kernel 6.1 and later.
-
 ### Unsupported adapters
 
 - Alfa AWUS036EACS (RTL8821CU) - Frequent connection failures and drop outs
@@ -176,15 +192,19 @@ These adapters do not have a reset pin. If they stop responding, there is curren
 - UGREEEN CM591 (ATS2851) - No driver available yet for USB id 10d7:b012
 - tp-link UB400 (CSR4) - Frequent connection failures with active connections
 - tp-link UB500 (RTL8761BU) - Frequent connection failures with active connections
-- Unbranded CSR 4.0 clones with USB id 0a12:0001 - Unrecoverable driver failure
+- CSR 4.0 clones with USB id 0a12:0001 - Unrecoverable driver failure: These clones will usually show a message like `CSR: Unbranded CSR clone detected; adding workarounds and force-suspending once...` in the system log when they are plugged in.
-- 5 CORE CSR 4.0 (CSR CLONE) - Unrecoverable driver failure
+  - Multiple unbranded adapters labeled with CSR 4.0
+  - 5 CORE CSR 4.0
 
 ## Multiple adapters
 
+The Bluetooth integration employs automatic failover and connection path logic to achieve high availability.
+
 Support for multiple local Bluetooth adapters is available on Linux systems only. Place adapters far enough away from each other to reduce interference.
 
 The following methods are known to work to add multiple adapters:
 
+- [Remote Adapters (Bluetooth proxies)](#remote-adapters-bluetooth-proxies)
 - Long USB Extension cables
 - USB-Ethernet extenders
 - [USB/IP](https://usbip.sourceforge.net/)
@@ -193,19 +213,21 @@ Integrations that have followed the [Best practices for library authors](https:/
 
 ## Passive Scanning
 
-Passive Scanning on Linux can be enabled in the options flow per adapter if the host system runs BlueZ 5.63 or later with experimental features enabled.
+Passive Scanning on Linux can be enabled in the options flow per adapter if the host system runs BlueZ 5.63 or later with experimental features enabled. This functionality is available with Home Assistant Operating System 9.4 and later.
 
 Many integrations require active scanning and may not function when scanning is passive.
 
 {% include integrations/option_flow.md %}
 
-## Remote adapters
+## Remote adapters (Bluetooth proxies)
 
 The Bluetooth integration supports receiving advertisement data from external adapters for devices and sensors that do not need an active connection, as well as establishing active connections. The number of remote scanners is limited only by the performance of the host system.
 
+When adding multiple remote adapters to increase range or available connection slots, separate them enough to avoid interference with each other.
+
 The following remote adapters are supported:
 
-- [ESPHome](https://esphome.io)
+- [ESPHome](https://esphome.github.io/bluetooth-proxies/)
   - Bluetooth advertisement listening: ESPHome ESP32 device with firmware 2022.8.2 or later
   - Single active connection: ESPHome ESP32 device with firmware 2022.9.3 or later
   - Multiple active connections: ESPHome ESP32 device with firmware 2022.11.0 or later
@@ -214,17 +236,6 @@ The following remote adapters are supported:
   - Single active connection: not supported
   - Multiple active connections: not supported
 
-### ESPHome requirements
-
-Devices with an ESP32 chip running ESPHome must enable the `bluetooth_proxy` component and be added to Home Assistant before advertisements are forwarded.
-
-```yaml
-esp32_ble_tracker:
-bluetooth_proxy:
-```
-
-Many integrations require an active scan for discovery. By default, the [ESPHome tracker](https://esphome.io/components/esp32_ble_tracker.html) runs in active mode. Adding ESPHome remotes that have active scanning disabled may cause some integrations to malfunction.
-
 ## Troubleshooting
 
 ### Integrations that require exclusive use of the Bluetooth Adapter

source/_integrations/dsmr_reader.markdown

@@ -34,6 +34,16 @@ To use this DSMR Reader sensor integration, you need to have a DSMR Reader insta
 
 {% include integrations/config_flow.md %}
 
+## Configuring the Energy Dashboard
+
+It is most advisable to not use the "total" and "daily" sources. The regular "reading" sensors provide the most stable source of data for Home Assistant to use. These MQTT values are part of the "Telegram: Split topic" MQTT values within DSMR Reader, so make sure to enable them.
+
+| Section          | Sensors to configure                        |
+| ---------------- | ------------------------------------------- |
+| Grid consumption | Low tariff usage, High tariff usage         |
+| Return to grid   | Low tariff returned, High tariff returned   |
+| Gas consumption  | Gas meter usage                             |
+
 ## Difference with the DSMR integration
 
-This integration relies on the presence of an existing DSMR Reader application setup. It processes the events triggered by the MQTT publishing feature to create sensor entities within Home Assistant. This integration uses the data published on the MQTT broker, no matter how or where the application is installed. By comparison, the [DSMR](/integrations/dsmr/) integration adds a full instance of the DSMR Reader application within Home Assistant. It is possible to have both integrations installed at the same time and working together, but this is not required.
+This integration relies on the presence of an existing DSMR Reader application setup. It processes the events triggered by the MQTT publishing feature to create sensor entities within Home Assistant. This integration uses the data published on the MQTT broker, no matter how or where the application is installed. By comparison, the [DSMR](/integrations/dsmr/) integration connects directly to the smart meter within Home Assistant and doesn't use the DSMR Reader application.

source/_integrations/http.markdown

@@ -42,7 +42,7 @@ server_port:
   type: integer
   default: 8123
 ssl_certificate:
-  description: Path to your TLS/SSL certificate to serve Home Assistant over a secure connection. If using the [Let's Encrypt add-on](https://github.com/home-assistant/hassio-addons/tree/master/letsencrypt) this will be at `/ssl/fullchain.pem`.
+  description: Path to your TLS/SSL certificate to serve Home Assistant over a secure connection. If using the [Let's Encrypt add-on](https://github.com/home-assistant/hassio-addons/tree/master/letsencrypt) this will be at `/ssl/fullchain.pem`. We recommend to use the [NGINX add-on](https://github.com/home-assistant/addons/tree/master/nginx_proxy) instead of using this option.
   required: false
   type: string
 ssl_peer_certificate:

source/_integrations/inkbird.markdown

@@ -22,6 +22,7 @@ Integrates [INKBIRD](https://www.inkbird.com/) devices into Home Assistant.
 - [INKBIRD Bluetooth Thermometer IBS-TH1](https://inkbird.com/products/bluetooth-thermometer-ibs-th1)
 - [INKBIRD Temperature and humidity Hygrometer IBS-TH2](https://inkbird.com/products/hygrometer-ibs-th2)
 - [INKBIRD Bluetooth Smart Sensor ITH-12S](https://inkbird.com/products/bluetooth-smart-sensor-ith-12s)
+- [INKBIRD Bluetooth BBQ Thermometer IBT-6XS](https://inkbird.com/products/bluetooth-bbq-thermometer-ibt-6xs)
 - [INKBIRD Bluetooth Grill Thermometer IBT-4XS](https://inkbird.com/products/bluetooth-grill-thermometer-ibt-4xs)
 - [INKBIRD Bluetooth Grill Thermometer IBT-2X](https://inkbird.com/products/bluetooth-grill-thermometer-ibt-2x)
 - [Nutrichef Smart Wireless Grill Thermometer](https://nutrichefkitchen.com/products/pwirbbq40)

source/_integrations/timer.markdown

@@ -90,7 +90,7 @@ You can also use `entity_id: all` and all active timers will be started.
 | Service data attribute | Optional | Description |
 | ---------------------- | -------- | ----------- |
 | `entity_id`            |      no  | Name of the entity to take action, e.g., `timer.timer0`. |
-| `duration`             |      yes | Duration in seconds or `00:00:00` until the timer finishes. |
+| `duration`             |      yes | Duration in seconds or `01:23:45` format until the timer finishes. |
 
 ### Service `timer.pause`
 

source/_posts/2023-01-23-help-others-leave-ai-at-the-dor.markdown

@@ -0,0 +1,20 @@
+---
+layout: post
+title: "Want to help others? Leave your AI at the door"
+description: "Answers generated by AI, like ChatGPT, are often wrong."
+date: 2023-01-23 00:00:00
+date_formatted: "January 23, 2023"
+author: Paulus Schoutsen
+comments: true
+categories: Public-Service-Announcement
+---
+
+Today we're introducing a new rule for the Home Assistant community: it's no longer allowed to use ChatGPT or other AI systems to help others.
+
+Although these systems generate elaborate and well structured answers, they are wrong. Often they are wrong in subtle ways which only someone with the right expertise could detect. And those people wouldn't need AI to have written that answer.
+
+We appreciate that people want to help others, but if you don't have the knowledge, leave it to someone else. Giving an incorrect answer makes things worse. You are wasting everybody's time, including the person asking the question. Trying out an answer that doesn't work is frustrating because you think you're doing something wrong.
+
+Using an AI system to generate an answer while not providing attribution to AI will result in a ban. If you use attribution, we will delete your post and issue a warning. This also means suggesting someone "ask ChatGPT" is not an acceptable response.
+
+If AI systems get better, we will revisit this rule.