From a8762cd17550909e33880508a20a290ef9966db1 Mon Sep 17 00:00:00 2001
From: Gord <31004434+googanhiem@users.noreply.github.com>
Date: Mon, 2 Sep 2024 08:21:16 +0100
Subject: [PATCH] Small additions to beta release notes (#34510)
---
.../_posts/2024-09-04-release-20249.markdown | 57 ++++++------------
source/images/blog/2024-09/social.jpg | Bin 0 -> 235066 bytes
2 files changed, 18 insertions(+), 39 deletions(-)
create mode 100644 source/images/blog/2024-09/social.jpg
diff --git a/source/_posts/2024-09-04-release-20249.markdown b/source/_posts/2024-09-04-release-20249.markdown
index bad3e1dbe4c..ceae017e03d 100644
--- a/source/_posts/2024-09-04-release-20249.markdown
+++ b/source/_posts/2024-09-04-release-20249.markdown
@@ -9,7 +9,7 @@ comments: true
categories:
- Release-Notes
- Core
-og_image: /images/blog/2024-09/social.png
+og_image: /images/blog/2024-09/social.jpg
---
@@ -68,11 +68,16 @@ Don't forget to [join our release party live stream on YouTube](https://www.yout
Home Assistant 2024.9! 🎉
+For many of us in the community based in the northern hemisphere we've been taking advantage of the nicer weather to take a little time off. Home Assistant releases have continued to grow for some time, and this one might not be as gargantuan in size as previous releases, but it still packs some really cool features and announcements.
+
+This release includes bigger sections, smarter energy monitoring, and a new LLM option. We’ve added [five](#new-integrations) new integrations, along with [one](#now-available-to-set-up-from-the-ui) existing integration being added to the UI. On top of all that, we’ve announced a new Works with Home Assistant partner, and the culmination of a project to ensure our project is truly open source.
+
+We hope you've been able to enjoy some time in, and away, from your smart home this month as well.
+
Enjoy the (beta) release!
-- [Home Assistant 2024.9](#home-assistant-20249)
- [Sections go BIG](#sections-go-big)
- [Wider sections](#wider-sections)
- [Full span cards](#full-span-cards)
@@ -89,20 +94,9 @@ Enjoy the (beta) release!
- [Backward-incompatible changes](#backward-incompatible-changes)
- [All changes](#all-changes)
-## Home Assistant 2024.9
-
-For many of us in the community based in the northern hemisphere we've been taking advantage of the nicer weather to take a little time off.
-
-Our releases have continued to grow in size for some time, and this one might not be as gargantuan in size, but it still packs some really cool features and announcements.
-
-This release includes bigger sections, smarter energy monitoring, and new LLM options. We also have a couple other exciting new announcements.
-
-We hope you've been able to enjoy some time in, and away, from your smart home this month as well.
-
-
## Sections go BIG
-In the drive to give our users more customization and organization options for their dashboards, we've added some new options to our Sections view that really lets us take big advantage of [resizable cards](https://www.home-assistant.io/blog/2024/07/03/release-20247/#resize-the-cards-on-your-dashboard). These powerful customization features can affect the [predictability of where cards or sections will go](https://www.home-assistant.io/blog/2024/03/04/dashboard-chapter-1/#drag-and-drop-rearrangement-of-cards-and-sections), especially when switching between desktop and mobile views, and we have found it works best with large cards. As always, the choice of how to use it is up to you.
+In the drive to give our users more customization and organization options for their dashboards, we've added some new options to our Sections view that really lets us take big advantage of [resizable cards](/blog/2024/07/03/release-20247/#resize-the-cards-on-your-dashboard). These powerful customization features can affect the [predictability of where cards or sections will go](/blog/2024/03/04/dashboard-chapter-1/#drag-and-drop-rearrangement-of-cards-and-sections), especially when switching between desktop and mobile views, and we have found it works best with large cards. As always, the choice of how to use it is up to you.
@@ -110,7 +104,9 @@ In the drive to give our users more customization and organization options for t
Sections can be expanded to span multiple sections. Now you can, for example, have your security camera feed span two sections or have a massive three-section wide map.
-Cards and sections will continue to follow the [Z-Grid rules](https://www.home-assistant.io/blog/2024/03/04/dashboard-chapter-1/#drag-and-drop-rearrangement-of-cards-and-sections), which can lead to blank spaces if the new wider sections don't fit on a specific part of the screen. When switching to smaller screens, these larger sections will revert to one section wide (if this causes issues for certain big cards, we would recommend using our device [visibility settings](https://www.home-assistant.io/blog/2024/06/05/release-20246/#control-visibility-of-cards)).
+Cards and sections will continue to follow the [Z-Grid rules](/blog/2024/03/04/dashboard-chapter-1/#drag-and-drop-rearrangement-of-cards-and-sections), which can lead to blank spaces if the new wider sections don't fit on a specific part of the screen. If you don't like those blank spaces between sections, you can choose a _dense_ layout. A dense section layout option will attempt to follow the Z-Grid rules, but will fill blank spaces whenever possible. This can affect the order and predictability of your sections, but will maximize screen real estate.
+
+When switching to smaller screens, these larger sections will revert to one section wide (if this causes issues for certain big cards, we would recommend using our device [visibility settings](/blog/2024/06/05/release-20246/#control-visibility-of-cards)).
### Full span cards
@@ -118,24 +114,24 @@ Larger sections mean larger cards. Instead of just stretching out the layout of
## Tracking your untracked energy
-In April, we introduced a [new energy graph for individual devices](https://www.home-assistant.io/blog/2024/03/06/release-20243/#new-energy-graph-for-individual-devices) in our energy dashboard. This allows you to aggregate all your energy monitoring into one graph, giving you a quick way to see your house's biggest energy-using devices. Big thanks to [@karwosts](https://github.com/karwosts), the original creator of this graph, who has now updated it.
+In April, we introduced a [new energy graph for individual devices](/blog/2024/03/06/release-20243/#new-energy-graph-for-individual-devices) in our energy dashboard. This allows you to aggregate all your energy monitoring into one graph, giving you a quick way to see your house's biggest energy-using devices. Big thanks to [@karwosts](https://github.com/karwosts), the original creator of this graph, who has now updated it.
-We can't all have energy tracking for every device, and if you have whole-home energy tracking (like a smart meter or [something more DIY](https://www.home-assistant.io/home-energy-management)) the updated graph will calculate the difference and show your home's untracked usage. So hop onto your [energy dashboard](https://my.home-assistant.io/redirect/energy/) and start to tackle your phantom energy load.
-
-
+We can't all have energy tracking for every device, and if you have whole-home energy tracking (like a smart meter or [something more DIY](/home-energy-management)) the updated graph will calculate the difference and show your home's untracked usage. So hop onto your [energy dashboard](https://my.home-assistant.io/redirect/energy/) and start to tackle your phantom energy load.
## LLM agent options grow
-When we added the ability to use [Large Language Models (LLMs)](https://www.home-assistant.io/blog/2024/06/05/release-20246/#dipping-our-toes-in-the-world-of-ai-using-llms) in our Voice Assistant, it began with a limited number of conversation agents. These included the cloud-based [OpenAI](https://www.home-assistant.io/components/openai_conversation/) and [Google AI](https://www.home-assistant.io/components/google_generative_ai_conversation/) integrations, along with the locally-run [Ollama](https://www.home-assistant.io/integrations/ollama/) integration. All three can now control the devices in your home. [@Shulyaka](https://github.com/Shulyaka) has now added another cloud option with [Anthropic](https://deploy-preview-34194--home-assistant-docs.netlify.app/integrations/anthropic) - thanks again for giving us another option for experimenting with AI in Home Assistant.
+When we added the ability to use [Large Language Models (LLMs)](/blog/2024/06/05/release-20246/#dipping-our-toes-in-the-world-of-ai-using-llms) in our Voice Assistant, it began with a limited number of conversation agents. These included the cloud-based [OpenAI](/components/openai_conversation/) and [Google AI](/components/google_generative_ai_conversation/) integrations, along with the locally-run [Ollama](/integrations/ollama/) integration. All three can now control the devices in your home.
+
+[@Shulyaka](https://github.com/Shulyaka) has now added another cloud option with [Anthropic](/integrations/anthropic) - thanks again for giving us another option for experimenting with AI in Home Assistant. Setting it up can be a little different than other conversation agents so take a look at the [documents](/integrations/anthropic) if you're interested.
## Open source compliance
+
We have put a lot of work into making sure that Home Assistance is truly open source, from top to bottom. This means ensuring that every library our integrations rely on uses the compliant license. We're now at more than 2,800 integrations, so as you can imagine, this was not a small task. Working with code owners and library developers, we have painstakingly checked that every library is now using an [OSI-approved license](https://opensource.org/license).
This might seem like a small procedural thing, but it is critical to keep integrations and Home Assistant functional far into the future. If you're not aware, libraries are what many device and service integrations rely on to function, by calling in additional protocol specific code that [purposely](https://developers.home-assistant.io/docs/api_lib_index/) sits outside of the Home Assistant project. If an individual or corporation can no longer maintain libraries, a proper open source license allows it to be picked up and continued by others.
-
## Integrations
Thanks to our community for keeping pace with the new {% term integrations %}
@@ -171,7 +167,6 @@ We welcome the following new integrations in this release:
[@tl-sl]: https://github.com/tl-sl
[@jnsgruk]: https://github.com/jnsgruk
-
This release also has a new virtual integration. Virtual integrations
are stubs that are handled by other (existing) integrations to help with
discoverability. These ones are new:
@@ -241,7 +236,6 @@ of this release:
deprecated and now removed. They have been using a deprecated mailbox feature
that is no longer available.
-
## Other noteworthy changes
There are many more improvements in this release; here are some of the other
@@ -287,8 +281,7 @@ possible for you. This release has the following backward-incompatible changes:
{% details "Proximity" %}
In [2024.2 we introduced new sensor entities](/blog/2024/02/07/release-20242/#revamped-proximity-integration)
-to the [Proximity](/integrations/proximity) {% term integration %} andÂ
-therefore deprecated the `proximity` entity.
+to the [Proximity](/integrations/proximity) {% term integration %} and therefore deprecated the `proximity` entity.
Now this deprecated `proximity` entity has been removed.
@@ -313,7 +306,6 @@ Remove deprecated asterisk_mbox integration ([@joostlek] - [#123180])
[#123180]: https://github.com/home-assistant/core/pull/123180
-
{% enddetails %}
{% details "Lutron" %}
@@ -322,7 +314,6 @@ Remove deprecated fan as light in lutron ([@gjohansson-ST] - [#123607]) ([lutron
[#123607]: https://github.com/home-assistant/core/pull/123607
-
{% enddetails %}
{% details "Lupusec" %}
@@ -331,7 +322,6 @@ Remove deprecated yaml import from lupusec ([@gjohansson-ST] - [#123606]) ([lupu
[#123606]: https://github.com/home-assistant/core/pull/123606
-
{% enddetails %}
{% details "Starline" %}
@@ -340,7 +330,6 @@ Remove deprecated horn switch in starline ([@gjohansson-ST] - [#123608]) ([starl
[#123608]: https://github.com/home-assistant/core/pull/123608
-
{% enddetails %}
{% details "System monitor" %}
@@ -349,7 +338,6 @@ Remove deprecated process sensor from System monitor ([@gjohansson-ST] - [#12361
[#123616]: https://github.com/home-assistant/core/pull/123616
-
{% enddetails %}
{% details "Ecovacs" %}
@@ -358,7 +346,6 @@ Remove deprecated yaml import from Ecovacs ([@gjohansson-ST] - [#123605]) ([ecov
[#123605]: https://github.com/home-assistant/core/pull/123605
-
{% enddetails %}
{% details "Logi circle" %}
@@ -375,7 +362,6 @@ Remove deprecated yaml import for gpsd ([@gjohansson-ST] - [#123725]) ([gpsd doc
[#123725]: https://github.com/home-assistant/core/pull/123725
-
{% enddetails %}
{% details "Velux" %}
@@ -384,7 +370,6 @@ Remove deprecated yaml import for velux ([@gjohansson-ST] - [#123724]) ([velux d
[#123724]: https://github.com/home-assistant/core/pull/123724
-
{% enddetails %}
{% details "Mailbox" %}
@@ -393,7 +378,6 @@ Remove demo mailbox ([@gjohansson-ST] - [#123741]) ([demo docs]) (breaking-chang
[#123741]: https://github.com/home-assistant/core/pull/123741
-
{% enddetails %}
{% details "KNX" %}
@@ -402,7 +386,6 @@ Rename KNX Climate preset modes according to specification ([@farmio] - [#123964
[#123964]: https://github.com/home-assistant/core/pull/123964
-
{% enddetails %}
{% details "Sensibo" %}
@@ -411,7 +394,6 @@ Fix Pure AQI value sensor in Sensibo ([@gjohansson-ST] - [#124151]) ([sensibo do
[#124151]: https://github.com/home-assistant/core/pull/124151
-
{% enddetails %}
{% details "Overkiz" %}
@@ -420,7 +402,6 @@ Update overkiz Atlantic Water Heater operation mode switching ([@ALERTua] - [#12
[#124619]: https://github.com/home-assistant/core/pull/124619
-
{% enddetails %}
{% details "Sisyphus" %}
@@ -429,7 +410,6 @@ Disable sisyphus integration ([@bdraco] - [#124742]) ([sisyphus docs]) (breaking
[#124742]: https://github.com/home-assistant/core/pull/124742
-
{% enddetails %}
{% details "MQTT" %}
@@ -438,7 +418,6 @@ Cleanup removed `schema` option from mqtt vacuum platform ([@jbouwh] - [#124722]
[#124722]: https://github.com/home-assistant/core/pull/124722
-
{% enddetails %}
If you are a custom integration developer and want to learn about changes and
diff --git a/source/images/blog/2024-09/social.jpg b/source/images/blog/2024-09/social.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..2d2603aeff72d55faf8d9baca4814510c4bf02ad
GIT binary patch
literal 235066
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 M(0*eJ2kd?&-`Flo_46YmL<;e{N
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