From e9973f7a69f9eb1a0c1630c2988f48a7cbeb89ed Mon Sep 17 00:00:00 2001 From: Kendell R Date: Thu, 1 Aug 2024 00:34:49 -0700 Subject: [PATCH 1/8] tweak mold indicator wording (#34054) * tweak mold indicator wording * Apply suggestions from code review Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> * tiny tweak --------- Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- source/_integrations/mold_indicator.markdown | 11 +++++++++-- 1 file changed, 9 insertions(+), 2 deletions(-) diff --git a/source/_integrations/mold_indicator.markdown b/source/_integrations/mold_indicator.markdown index e3ca94b0825..45b97b01247 100644 --- a/source/_integrations/mold_indicator.markdown +++ b/source/_integrations/mold_indicator.markdown @@ -15,9 +15,9 @@ related: title: Configuration file --- -The Mold Indicator sensor {% term integration %} consumes information of two temperature sensors and a humidity sensor to give an indication for possible mold growth in your home. In case of bad ventilation and insulation, the indoor humidity may lead to condensation on cold surfaces as the windows or even walls. Condensation or a high relative humidity near those cold surfaces leads to a higher risk for mold growth. This sensor integration estimates the temperature at a pre-calibrated critical point in the room (the coldest surface) and calculates the relative humidity of the air at that point. If the sensor value rises above approximately 70 percent, mold growth might occur and the room should be ventilated. At 100%, the air humidity condensates at the critical point. +The Mold Indicator sensor {% term integration %} uses data from two temperature sensors and a humidity sensor to predict the humidity near a cold surface. High humidity may lead to mold growth at more than ~70% and causes condensation at 100%. -The sensor data may be used e.g., to signal bad air quality (too high air humidity) or to automate operation of indoor air humidifiers to keep the indoor humidity at an optimum. +The sensor data may be used, for example, to detect bad air quality (high humidity) or automate the operation of indoor air humidifiers to keep the indoor humidity at an optimum. ## Configuration @@ -59,9 +59,16 @@ calibration_factor: In this case, the weather forecast temperature sensor is used for the outside temperature. +## Background + +First, this sensor predicts the temperature near the given surface by estimating it from the indoor and outdoor temperatures. The predicted temperature starts with the indoor temperature, then either brings it closer to the outdoor temperature (if the calibration factor is positive, indicating the surface is influenced by the outdoors) or away (if the calibration factor is negative, indicating the surface is inversely correlated with the outdoor temperature). + +From there, the sensor calculates the relative humidity near the given surface based on the dew point. + ## Calibration The Mold Indicator sensor integration needs to be calibrated in order to estimate the temperature at the critical point from the outdoor and indoor temperature. First find the coldest surface in the room (critical point), which is typically near the window frames, but depends on the insulation of your home. For calibration you need to measure the temperature at this critical point and simultaneously write down the values for the indoor- and outdoor temperature sensors used for the Mold Indicator. Be sure that there is a significant indoor to outdoor temperature difference to get the best calibration results. + With the three measured temperatures (in Celsius or Fahrenheit), the calibration_factor for your configuration file is given by: ```text From 3d46eb719f837b0a66f61e003aa9653dfc390946 Mon Sep 17 00:00:00 2001 From: Nikola Kovic Date: Thu, 1 Aug 2024 10:15:01 +0200 Subject: [PATCH 2/8] Add Home Assistant Green on Amazon link to buy box (#33865) * I added Amazon shop to our list of distributors * Update source/green/index.html * Apply suggestions from code review --------- Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> Co-authored-by: Paulus Schoutsen --- source/green/index.html | 21 ++++++++++++++++++--- 1 file changed, 18 insertions(+), 3 deletions(-) diff --git a/source/green/index.html b/source/green/index.html index 179dc2d3ace..f5be07b3259 100644 --- a/source/green/index.html +++ b/source/green/index.html @@ -2312,11 +2312,11 @@ dark_header: true
Shipping to America
- +
πŸ‡ΊπŸ‡Έ
-
ameriDroid
+
Amazon US
Shipping from US
@@ -2326,7 +2326,22 @@ dark_header: true
- + + +
+
+
πŸ‡ΊπŸ‡Έ
+
ameriDroid
+
Shipping from US
+
+ + + +
+ +
From 5a06c155b515fcf66f13f90a5476f6d3e9f8a20a Mon Sep 17 00:00:00 2001 From: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> Date: Thu, 1 Aug 2024 10:38:03 +0200 Subject: [PATCH 3/8] Yellow product page: add FAQ and update Options (#34037) * Yellow product page: add FAQ * rephrase text about standard variant * Tweaks * Fix typo * Fix syntax * rephrase * rephrase * Remove note on chip shortage * Re-add note about rpilocator * remove note about rpi locator * Apply suggestions from code review * rephrase * rephrase * rephrase * Update source/yellow/index.html --- source/yellow/index.html | 31 ++++++++++++++++++------------- 1 file changed, 18 insertions(+), 13 deletions(-) diff --git a/source/yellow/index.html b/source/yellow/index.html index 4b7f339bb93..fe824d402fe 100644 --- a/source/yellow/index.html +++ b/source/yellow/index.html @@ -168,17 +168,6 @@ frontpage_image: /images/frontpage/yellow-frontpage.jpg

Pick your flavor

-
-
2D overview of the content of the Home Assistant Yellow
-
- Home Assistant Yellow
- This flagship version of Home Assistant Yellow is ready to go out of the box. -

- It comes pre-assembled in a custom enclosure with a Raspberry Pi Compute Module 4 (CM4) and a custom heat sink for fanless, silent operation. The CM4 is a version without wireless and has 2 GB RAM and 16 GB eMMC storage. Pre-installed with Home Assistant. -

- To get started, just plug in the power supply and the Ethernet cable. The cables are included in the box. This variant does not have Power-over-Ethernet. -
-
2D overview of the content of the Home Assistant Yellow Kit Power-over-Ethernet variant
@@ -197,6 +186,14 @@ frontpage_image: /images/frontpage/yellow-frontpage.jpg Not included: You must provide your own Raspberry Pi Compute Module 4 and install Home Assistant on it. This allows you to pick the compute module with the memory and eMMC storage to fit your needs. This kit comes with a power supply, but does not support Power-over-Ethernet.
+
+
2D overview of the content of the Home Assistant Yellow
+ +
@@ -212,8 +209,6 @@ frontpage_image: /images/frontpage/yellow-frontpage.jpg

Buying a Raspberry Pi Compute Module 4 (CM4)

If you bought the Home Assistant Yellow Kit, you need to bring your own Raspberry Pi Compute Module 4.

-

A chip shortage still impacts the availability of the CM4. Our recommendation is to use rpilocator. This website tracks the stock of official Raspberry Pi distributors. Follow them on X and enable push notifications. You will be notified as soon as the bot tweets that products are in stock. -

We recommend purchasing a Raspberry Pi Compute Module 4 with the following characteristics:

    @@ -315,6 +310,16 @@ frontpage_image: /images/frontpage/yellow-frontpage.jpg
+

FAQs

+
+ {% details "Can I buy the Home Assistant Yellow pre-assembled?" %}

No. We previously offered a Home Assistant Yellow Standard model that came pre-assembled with a Raspberry Pi CM4, but this model is no longer manufactured. It is now recommended that if you want a more plug-and-play experience, you purchase a Home Assistant Green, as it requires no assembly and matches many of the capabilities of the Yellow, especially if you add a Home Assistant Connect ZBT-1 to give it Zigbee/Thread capability. +

+ {% enddetails %} + + {% details "What happened to Home Assistant Yellow Standard, and will it still be supported?" %}

The Home Assistant Yellow Standard was originally designed to be the beginner option in our product line, as it was pre-assembled and easier to get started with. In 2023, we launched the Home Assistant Green, which offered similar features, including easy setup, but at a lower price point. This led us to end the manufacture of the Home Assistant Yellow Standard and focus on Yellow Kit versions for advanced users. Rest assured, it will continue to receive the same support and software updates as the Yellow Kit variants. +

+ {% enddetails %} +
From d5b698b30e5b37fc4c4087fb9dc72871d95818b9 Mon Sep 17 00:00:00 2001 From: Nikola Kovic Date: Thu, 1 Aug 2024 16:55:20 +0200 Subject: [PATCH 4/8] Clean up messaging around Yellow distribution (#34069) * I added Amazon shop to our list of distributors * Update source/green/index.html * Apply suggestions from code review * clean up messaging --------- Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> Co-authored-by: Paulus Schoutsen --- source/yellow/index.html | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/source/yellow/index.html b/source/yellow/index.html index fe824d402fe..8a9780250ca 100644 --- a/source/yellow/index.html +++ b/source/yellow/index.html @@ -363,7 +363,7 @@ frontpage_image: /images/frontpage/yellow-frontpage.jpg
πŸ‡ΊπŸ‡Έ
ameriDroid
-
Shipping from US. Yellow Kit versions only. Also sells CM4 modules.
+
Shipping from US
πŸ‡ΊπŸ‡Έ
CloudFree
-
Shipping from US. Yellow Kit versions only. Also sells CM4 modules.
+
Shipping from US
πŸ‡¨πŸ‡³
Seeed Studio
-
Shipping from China, US and Germany. Also sells CM4 modules.
+
Shipping from China, US and Germany
πŸ‡¨πŸ‡³
Seeed Studio
-
Shipping from China, US and Germany. Also sells CM4 modules.
+
Shipping from China, US and Germany
πŸ‡΅πŸ‡±
Botland
-
Shipping from Poland. Yellow Kit versions only. Also sells CM4 modules.
+
Shipping from Poland
πŸ‡΅πŸ‡Ή
Mauser
-
Shipping from Portugal. Yellow Kit versions only. Also sells CM4 modules.
+
Shipping from Portugal
πŸ‡¨πŸ‡­
Pi-Shop.ch
-
Shipping from Switzerland. Also sells CM4 modules.
+
Shipping from Switzerland
πŸ‡©πŸ‡°
RaspberryPi.dk
-
Shipping from Denmark. Also sells CM4 modules.
+
Shipping from Denmark
πŸ‡¨πŸ‡³
Seeed Studio
-
Shipping from China, US and Germany. Kit versions only. Also sells CM4 modules.
+
Shipping from China, US and Germany
πŸ‡¬πŸ‡§
The Pi Hut
-
Shipping from the United Kingdom. Kit versions only. Also sells CM4 modules.
+
Shipping from the United Kingdom
Date: Thu, 1 Aug 2024 15:50:55 +0000 Subject: [PATCH 5/8] Add generate content service for OpenAI to match Google AI --- .../openai_conversation.markdown | 47 +++++++++++++++++++ 1 file changed, 47 insertions(+) diff --git a/source/_integrations/openai_conversation.markdown b/source/_integrations/openai_conversation.markdown index 95b5ff82af4..1b54129c5ca 100644 --- a/source/_integrations/openai_conversation.markdown +++ b/source/_integrations/openai_conversation.markdown @@ -158,3 +158,50 @@ template: ``` {% endraw %} + +### Service `openai_conversation.generate_content` + +Allows you to ask OpenAI to generate an content based on a prompt. This service +populates [Response Data](/docs/scripts/service-calls#use-templates-to-handle-response-data) +with the response from OpenAI. + +| Service data attribute | Optional | Description | Example | +| ---------------------- | -------- | ------------------------------------------------------- | ---------------- | +| `config_entry` | no | Integration entry ID to use. | | +| `prompt` | no | The text to turn into an image. | Picture of a dog | +| `image_filename` | yes | List of file names for images to include in the prompt. | /tmp/image.jpg | + +{% raw %} +```yaml +service: openai.generate_content +data: + config_entry: abce6b8696a15e107b4bd843de722249 + prompt: >- + Very briefly describe what you see in this image from my doorbell camera. + Your message needs to be short to fit in a phone notification. Don't + describe stationary objects or buildings. + image_filename: + - /tmp/doorbell_snapshot.jpg +response_variable: generated_content +``` +{% endraw %} + +The response data field `text` will contain the generated content. + +Another example with multiple images: + +{% raw %} +```yaml +service: openai.generate_content +data: + prompt: >- + Briefly describe what happened in the following sequence of images + from my driveway camera. + image_filename: + - /tmp/driveway_snapshot1.jpg + - /tmp/driveway_snapshot2.jpg + - /tmp/driveway_snapshot3.jpg + - /tmp/driveway_snapshot4.jpg +response_variable: generated_content +``` +{% endraw %} \ No newline at end of file From 6d8d8c79a37e0525d072028f074bf5ac686d0d6c Mon Sep 17 00:00:00 2001 From: Tim Laing Date: Thu, 1 Aug 2024 16:03:02 +0000 Subject: [PATCH 6/8] Fixed issue with grammer spotted by CodeRabbit. --- source/_integrations/openai_conversation.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/openai_conversation.markdown b/source/_integrations/openai_conversation.markdown index 1b54129c5ca..6c973aa11c4 100644 --- a/source/_integrations/openai_conversation.markdown +++ b/source/_integrations/openai_conversation.markdown @@ -161,7 +161,7 @@ template: ### Service `openai_conversation.generate_content` -Allows you to ask OpenAI to generate an content based on a prompt. This service +Allows you to ask OpenAI to generate a content based on a prompt. This service populates [Response Data](/docs/scripts/service-calls#use-templates-to-handle-response-data) with the response from OpenAI. From 1f17b1814a386a2fb045e91c28d5bb3ebfe6d363 Mon Sep 17 00:00:00 2001 From: Tim Laing Date: Thu, 1 Aug 2024 16:19:01 +0000 Subject: [PATCH 7/8] Fixed CodeRebbit comments --- .../_integrations/openai_conversation.markdown | 16 ++++++++++------ 1 file changed, 10 insertions(+), 6 deletions(-) diff --git a/source/_integrations/openai_conversation.markdown b/source/_integrations/openai_conversation.markdown index 6c973aa11c4..b46af7edfc4 100644 --- a/source/_integrations/openai_conversation.markdown +++ b/source/_integrations/openai_conversation.markdown @@ -165,13 +165,14 @@ Allows you to ask OpenAI to generate a content based on a prompt. This service populates [Response Data](/docs/scripts/service-calls#use-templates-to-handle-response-data) with the response from OpenAI. -| Service data attribute | Optional | Description | Example | -| ---------------------- | -------- | ------------------------------------------------------- | ---------------- | -| `config_entry` | no | Integration entry ID to use. | | -| `prompt` | no | The text to turn into an image. | Picture of a dog | -| `image_filename` | yes | List of file names for images to include in the prompt. | /tmp/image.jpg | +| Service data attribute | Optional | Description | Example | +| ---------------------- | -------- | ------------------------------------------------------- | -------------------- | +| `config_entry` | no | Integration entry ID to use. | | +| `prompt` | no | The text to generate content from. | Describe the weather | +| `image_filename` | yes | List of file names for images to include in the prompt. | /tmp/image.jpg | {% raw %} + ```yaml service: openai.generate_content data: @@ -184,6 +185,7 @@ data: - /tmp/doorbell_snapshot.jpg response_variable: generated_content ``` + {% endraw %} The response data field `text` will contain the generated content. @@ -191,6 +193,7 @@ The response data field `text` will contain the generated content. Another example with multiple images: {% raw %} + ```yaml service: openai.generate_content data: @@ -204,4 +207,5 @@ data: - /tmp/driveway_snapshot4.jpg response_variable: generated_content ``` -{% endraw %} \ No newline at end of file + +{% endraw %} From ee63e4780433554a4b5b71408d229d74d52a51c1 Mon Sep 17 00:00:00 2001 From: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> Date: Tue, 18 Mar 2025 07:12:18 +0100 Subject: [PATCH 8/8] convert table to list --- .../openai_conversation.markdown | 19 ++++++++++++++----- 1 file changed, 14 insertions(+), 5 deletions(-) diff --git a/source/_integrations/openai_conversation.markdown b/source/_integrations/openai_conversation.markdown index b46af7edfc4..34e0607a7c1 100644 --- a/source/_integrations/openai_conversation.markdown +++ b/source/_integrations/openai_conversation.markdown @@ -165,11 +165,20 @@ Allows you to ask OpenAI to generate a content based on a prompt. This service populates [Response Data](/docs/scripts/service-calls#use-templates-to-handle-response-data) with the response from OpenAI. -| Service data attribute | Optional | Description | Example | -| ---------------------- | -------- | ------------------------------------------------------- | -------------------- | -| `config_entry` | no | Integration entry ID to use. | | -| `prompt` | no | The text to generate content from. | Describe the weather | -| `image_filename` | yes | List of file names for images to include in the prompt. | /tmp/image.jpg | +- **Service data attribute**: `config_entry` + - **Description**: Integration entry ID to use. + - **Example**: + - **Optional**: no + +- **Service data attribute**: `prompt` + - **Description**: The text to generate content from. + - **Example**: Describe the weather + - **Optional**: no + +- **Service data attribute**: `image_filename` + - **Description**: List of file names for images to include in the prompt. + - **Example**: /tmp/image.jpg + - **Optional**: yes {% raw %}