From cd7b4be366d256db81494eb61144a5e2eab910d7 Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Mon, 23 Jan 2023 13:59:46 +0000 Subject: [PATCH 01/10] Ban ChatGPT post --- ...3-help-others-leave-ai-at-the-dor.markdown | 20 +++++++++++++++++++ 1 file changed, 20 insertions(+) create mode 100644 source/_posts/2023-01-23-help-others-leave-ai-at-the-dor.markdown diff --git a/source/_posts/2023-01-23-help-others-leave-ai-at-the-dor.markdown b/source/_posts/2023-01-23-help-others-leave-ai-at-the-dor.markdown new file mode 100644 index 00000000000..b19fcf3781f --- /dev/null +++ b/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. From fd2f144378ce11aee22364dd1df6861763ae2ecd Mon Sep 17 00:00:00 2001 From: "J. Nick Koston" Date: Mon, 23 Jan 2023 07:21:25 -1000 Subject: [PATCH 02/10] Update Bluetooth documentation from recent issue triage (#25826) --- source/_integrations/bluetooth.markdown | 98 ++++++++++++++----------- 1 file changed, 54 insertions(+), 44 deletions(-) diff --git a/source/_integrations/bluetooth.markdown b/source/_integrations/bluetooth.markdown index e683346fcbc..45009b6255b 100644 --- a/source/_integrations/bluetooth.markdown +++ b/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 + +
+These adapters may require additional patch files available at https://github.com/winterheart/broadcom-bt-firmware for stable operation. + +There is currently no supported method to install these patch files when using Home Assistant Operating System. +
+ +- 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 + +
+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. +
+ - 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 @@ -181,10 +197,13 @@ These adapters do not have a reset pin. If they stop responding, there is curren ## 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 +212,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 +235,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 From 5da3176894fbb79c1833d62475ccf244b50482de Mon Sep 17 00:00:00 2001 From: Johan Vromans Date: Mon, 23 Jan 2023 18:23:01 +0100 Subject: [PATCH 03/10] Update single card restriction (#25841) --- source/_dashboards/panel.markdown | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/source/_dashboards/panel.markdown b/source/_dashboards/panel.markdown index 0e883d5899e..9eb981207fd 100644 --- a/source/_dashboards/panel.markdown +++ b/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. @@ -16,4 +16,4 @@ type: required: true description: "`panel`" type: string -{% endconfiguration %} \ No newline at end of file +{% endconfiguration %} From 0570eeb30a877d74062825a13b1779b4d226bae8 Mon Sep 17 00:00:00 2001 From: Tom Puttemans Date: Mon, 23 Jan 2023 18:49:11 +0100 Subject: [PATCH 04/10] Expand dsmr_reader documentation (#24671) --- source/_integrations/dsmr_reader.markdown | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/source/_integrations/dsmr_reader.markdown b/source/_integrations/dsmr_reader.markdown index c7bd2929d6c..f016a67e3bb 100644 --- a/source/_integrations/dsmr_reader.markdown +++ b/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. From 7eaa61f913d60cf078165cc0fee7b15e515e0b19 Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Mon, 23 Jan 2023 16:32:05 -0500 Subject: [PATCH 05/10] Recommend NGINX (#25905) --- source/_integrations/http.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/http.markdown b/source/_integrations/http.markdown index e7b9b78fdb1..2f93c232f61 100644 --- a/source/_integrations/http.markdown +++ b/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: From 220c2679422a309fb83df37141137bdbeaf76e57 Mon Sep 17 00:00:00 2001 From: Andrew Berry Date: Mon, 23 Jan 2023 17:12:35 -0500 Subject: [PATCH 06/10] Document warning when detecting a CSR clone (#25876) Co-authored-by: J. Nick Koston --- source/_integrations/bluetooth.markdown | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/source/_integrations/bluetooth.markdown b/source/_integrations/bluetooth.markdown index 45009b6255b..6a050f02915 100644 --- a/source/_integrations/bluetooth.markdown +++ b/source/_integrations/bluetooth.markdown @@ -192,8 +192,9 @@ 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 -- 5 CORE CSR 4.0 (CSR CLONE) - 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. + - Multiple unbranded adapters labeled with CSR 4.0 + - 5 CORE CSR 4.0 ## Multiple adapters From b9cd9ec6c33b368b6bd66a98a4632862a686671d Mon Sep 17 00:00:00 2001 From: Hellis81 <61010215+Hellis81@users.noreply.github.com> Date: Tue, 24 Jan 2023 08:39:08 +0100 Subject: [PATCH 07/10] Added the 6XS BBQ thermometer (#25913) --- source/_integrations/inkbird.markdown | 1 + 1 file changed, 1 insertion(+) diff --git a/source/_integrations/inkbird.markdown b/source/_integrations/inkbird.markdown index db439ce338a..6ad2bb41fc2 100644 --- a/source/_integrations/inkbird.markdown +++ b/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) From 160a8ef9a189c2d691cbd913a6e0f9720870bfbe Mon Sep 17 00:00:00 2001 From: Johan Vromans Date: Tue, 24 Jan 2023 12:03:04 +0100 Subject: [PATCH 08/10] Clarify meaning of start duration (#25915) --- source/_integrations/timer.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/timer.markdown b/source/_integrations/timer.markdown index 82b3313e1ee..4f542fe0661 100644 --- a/source/_integrations/timer.markdown +++ b/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` From f74feb14e582477d57f709ca099dc8df69e7d955 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Tue, 24 Jan 2023 20:24:03 +0100 Subject: [PATCH 09/10] Bump concurrent-ruby from 1.1.10 to 1.2.0 (#25911) Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> --- Gemfile.lock | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Gemfile.lock b/Gemfile.lock index 670af4abf9b..1b8d7e8ba3d 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -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) From b8b69b24f677a8fcda3d76dbcda8eed133978a74 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Tue, 24 Jan 2023 20:31:59 +0100 Subject: [PATCH 10/10] Bump commonmarker from 0.23.6 to 0.23.7 (#25923) Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> --- Gemfile.lock | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Gemfile.lock b/Gemfile.lock index 1b8d7e8ba3d..b724f0bcf29 100644 --- 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.6) + commonmarker (0.23.7) compass (1.0.3) chunky_png (~> 1.2) compass-core (~> 1.0.2)