2024.1: Beta release notes

source/_posts/2024-01-03-release-20241.markdown

@@ -2,7 +2,7 @@
 layout: post
 title: "2024.1: Beta release notes"
 description: "The beta release notes for Home Assistant 2024.1"
-date: 2023-12-07 00:00:00
+date: 2023-12-27 00:00:00
 date_formatted: "January 3, 2024"
 author: Franck Nijhof
 author_twitter: frenck
@@ -13,7 +13,7 @@ categories:
 og_image: /images/blog/2024-01/social.png
 ---
 
-<a href='/integrations/#version/2024.1'><img src='/images/blog/2023-01/social.png' style='border: 0;box-shadow: none;'></a>
+<a href='/integrations/#version/2024.1'><img src='/images/blog/2024-01/social.png' style='border: 0;box-shadow: none;'></a>
 
 <!-- BELOW NEEDS TO BE REMOVED BEFORE THE RELEASE -->
 
@@ -46,67 +46,254 @@ Enjoy the (beta) release!
 
 <!--more-->
 
-- [Lorem ipsum](#lorem-ipsum)
+- [Automation editor improvements](#automation-editor-improvements)
+- [New entity type: Valve](#new-entity-type-valve)
+- [Swappable](#swappable)
+- [New card features](#new-card-features)
 - [Other noteworthy changes](#other-noteworthy-changes)
 - [New integrations](#new-integrations)
 - [Integrations now available to set up from the UI](#integrations-now-available-to-set-up-from-the-ui)
 - [Need help? Join the community!](#need-help-join-the-community)
 - [Backward-incompatible changes](#backward-incompatible-changes)
-- [Farewell to the following](#farewell-to-the-following)
 - [All changes](#all-changes)
 
-Don't forget to [join our release party live stream on YouTube](https://www.youtube.com/watch?v=#)
+Don't forget to [join our release party live stream on YouTube](https://www.youtube.com/watch?v=dRwzSkKYIDs)
 3 January 2024, at 12:00 PST / 21:00 CET!
 
-<lite-youtube videoid="#" videotitle="Home Assistant 2024.1 Release Party"></lite-youtube>
+<lite-youtube videoid="dRwzSkKYIDs" videotitle="Home Assistant 2024.1 Release Party"></lite-youtube>
 
-## Lorem ipsum
+## Automation editor improvements
 
-Lorem ipsum
+The automation editor got some love this release, with a lot of small
+improvements to make it easier to use.
+
+If you start out with Home Assistant, visiting your automations page would
+result in an empty page. This is not very helpful if you see this for the first
+time.
+
+Instead, you are now greeted by the little automation robot and show
+an explaination of what automations are, and reference to the documentation
+that can help you get started.
+
+_TODO: Add screenshot_
+
+Once you start create a new integration, you will be greeted by some new
+terminolgy and description to help you understand what each section is about.
+
+<img class="no-shadow" src='https://user-images.githubusercontent.com/5662298/291381465-0766c064-d787-41e6-8349-0b56193ee526.png' alt='Temporary images that needs to be replaced.'>
+
+Don't worry, we'll hide the help text once you added elements to the section.
+The bigger change can be found in the buttons to add a trigger, condition or
+action to your automation.
+
+The first thing to notice, is that the conditions and actions have a new
+button next to them: "Add building block". Click this allows you to 
+add logicial elements to your automation, like "and", "or", "If", "choose", etc.
+
+These used to be mixed in with the conditions and actions, but now have their
+own dedicated button. This makes it easier to find them, and declutters the
+list of conditions and actions.
+
+_TODO: Add screenshot_
+
+All these buttons, used to give a dropdown that allowed you to select the
+type of trigger, condition or action you wanted to add. This dropdown has
+been replaced by a new dialog, including descriptions for each item and search.
+
+These descriptions are important, as they help you understand what the
+trigger, condition or action does, and what it is used for.
+
+_TODO: Add screenshot_
+
+If you add an element, we will show you the most commonly used
+trigger/condition/action first. All other are neatly categorized in the
+other sections.
+
+Last, but not least, the "service calls" are now merged with all other actions.
+Meaning, that if you add an action, you see all actions, including service
+calls. They are neatly grouped by entity type and the integration providing them,
+provide the descriptions on what they do, and are searchable as well.
+
+_TODO: Add screenshot_
+
+## Description & due support for todo list items
+
+This feature was already hinted in the last release, but now it is here!
+
+You can add due dates and description to each item in your todo list (if
+supported by the integration of course).
+
+<img class="no-shadow" src='https://user-images.githubusercontent.com/5662298/292194204-990069b1-e517-4b93-9190-c2beeb7f782a.png' alt='Temporary images that needs to be replaced.'>
+
+<img class="no-shadow" src='https://user-images.githubusercontent.com/5662298/292194141-1081eba6-9914-4f79-9d93-414b9fae91bd.png' alt='Temporary images that needs to be replaced.'>
+
+## New entity type: Valve
+
+A brand new entity type has been added to Home Assistant: Valve!
+
+This entity type can be used by integrations to expose valves, like for example
+a valve on a radiator, pool or sprinkler system.
+
+_TODO: Add screenshot_
+
+Currently, the Shelly integration supports it and now provides an `valve` entity
+for the Valve addon for Shelly Gas. Additionally, support for it has been
+added to MQTT, and the valve entities also work with Amazon Alexa
+and Google Assistant.
+
+## Swappable current/target on thermostat & humidifier cards
+
+By popular demand, the thermostat and humidifier cards now support setting 
+current temperature/humidity as the primary information to show in the
+card.
+
+Enabling this option, will result in the target temperature/humidity to be
+swapped.
+
+<img class="no-shadow" src='https://user-images.githubusercontent.com/5878303/291251306-f8765c74-ccd0-410d-be4d-1f1c1b93ffa3.png' alt='Temporary images that needs to be replaced.'>
+
+## New card features
+
+Last year, we have seen many new features added to the cards, so let's start
+the new year with some more!
+
+@Quentame added the climate fan mode card feature feature. This feature can be
+used with both the thermostat and the climate card.
+
+<img class="no-shadow" src='https://user-images.githubusercontent.com/14821482/291761102-2c5f60dd-5dfa-453e-ad5c-abd977601abd.png' alt='Temporary images that needs to be replaced.'>
+
+Also new, the update actions card feature. This addition by @piitaya allows
+you to add buttons to a card that can trigger update actions when pressed.
+
+<img class="no-shadow" src='https://user-images.githubusercontent.com/5878303/292223971-249333f8-627c-4124-9336-0b6ce83355e0.png' alt='Temporary images that needs to be replaced.'>
 
 ## Other noteworthy changes
 
 There are many more improvements in this release; here are some of the other
 noteworthy changes this release:
 
-- Lorem ipsum, thanks [@frenck]!
-
-[@frenck]: https://github.com/frenck
+- Move cloud stt engine to config entry ([@MartinHjelmare] - [#99608])
+- Add support for Shelly Gen3 devices ([@bieniu] - [#104874])
+- Add consider home interval to ping ([@jpbede] - [#104881])
+- Add preset modes to ESPHome fan entities ([@mill1000] - [#103781])
+- Add calendar entity to Radarr ([@tkdrob] - [#79077])
+- Add support for Happy Eyeballs to homekit_controller ([@bdraco] - [#105454])
+- Add France to picnic countries ([@slhad] - [#105722])
+- Rename zamg to GeoSphere Austria ([@killer0071234] - [#105494])
+- Make the minimum number of samples used by the trend sensor configurable ([@jpbede] - [#101102])
+- Add new price sensors with API token access to pvpc hourly pricing ([@azogue] - [#85769])
+- Add Starline Service Mode switch ([@Anonym-tsk] - [#105741])
+- Add Energyzero get_gas_prices and get_energy_price services ([@iamrgroot] - [#101374])
+- Add subwoofer crossover support to Sonos Amp devices ([@jjlawren] - [#106290])
+- Add alarm platform to Comelit ([@chemelli74] - [#104718])
+- Add Support for SleepIQ Foot Warmers ([@kbickar] - [#105931])
 
 ## New integrations
 
 We welcome the following new integrations in this release:
 
+- **[A. O. Smith]**, added by [@bdr99]<br />
+  Integrate and control your A. O. Smith water heater.
+- **[Blue Current]**, added by [@Floris272]<br />
+  Monitor your Blue Current EV charger charge point(s).
+- **[DROP]**, added by [@pfrazer]<br />
+  Manage your DROP Smart Water System with Home Assistant.
 - **[Flexit BACnet]**, added by [@lellky]<br />
   Control and monitor your Flexit Nordic series air handling units.
 - **[Holiday]**, added by [@jrieger]<br />
   Add holiday calendars to Home Assistant for powering automations.
+- **[Midea CCM15 AC Controller]**, added by [@ocalvo]<br />
+  Use your AC connected to an Midea CCM15 AC Controller.
+- **[OSO Energy]**, added by [@osohotwateriot]<br />
+  Use your OSO Energy water heater with Home Assistant.
+- **[Sun WEG]**, added by [@rokam]<br />
+  Collect and monitor energy production data from your Sun WEG inverter.
+- **[Tailwind]**, added by [@frenck]<br />
+  Operate your garage door openers connected to a Tailwind smart garage door controller.
+- **[Tessie]**, added by [@Bre77]<br />
+  Integrate, monitor and control your Tesla vehicle connected to the Tessie platform.
+- **[Refoss]**, added by [@ashionky]<br />
+  Use your Refoss smart devices directly with Home Assistant.
+- **[Valve]**, added by [@cibernox]<br />
+  An entity type for valves, which can be used by integrations to expose valves.
+- **[Vogel's MotionMount]**, added by [@RJPoelstra]<br />
+  Control the position of your Vogel's MotionMount TV mount.
 
+[@ashionky]: https://github.com/ashionky
+[@bdr99]: https://github.com/bdr99
+[@Bre77]: https://github.com/Bre77
+[@cibernox]: https://github.com/cibernox
+[@Floris272]: https://github.com/Floris272
+[@frenck]: https://github.com/frenck
 [@jrieger]: https://github.com/jrieger
 [@lellky]: https://github.com/lellky
+[@ocalvo]: https://github.com/ocalvo
+[@osohotwateriot]: https://github.com/osohotwateriot
+[@pfrazer]: https://github.com/pfrazer
+[@RJPoelstra]: https://github.com/RJPoelstra
+[@rokam]: https://github.com/rokam
+[A. O. Smith]: /integrations/aosmith
+[Blue Current]: /integrations/blue_current
+[DROP]: /integrations/drop
 [Flexit BACnet]: /integrations/flexit_bacnet
 [Holiday]: /integrations/holiday
+[Midea CCM15 AC Controller]: /integrations/ccm15
+[OSO Energy]: /integrations/osoenergy
+[Refoss]: /integrations/refoss
+[Sun WEG]: /integrations/sunweg
+[Tailwind]: /integrations/tailwind
+[Tessie]: /integrations/tessie
+[Valve]: /integrations/valve
+[Vogel's MotionMount]: /integrations/motionmount
 
 This release also has a new virtual integration. Virtual integrations are stubs
 that are handled by other (existing) integrations to help with findability.
 The following virtual integrations have been added:
 
+- **[AEP Ohio]**, provided by [Opower]
+- **[AEP Texas]**, provided by [Opower]
+- **[Appalachian Power]**, provided by [Opower]
 - **[Fujitsu anywAIR]**, provided by [Advantage Air]
+- **[Indiana Michigan Power]**, provided by [Opower]
+- **[Kentucky Power]**, provided by [Opower]
+- **[Public Service Company of Oklahoma (PSO)]**, provided by [Opower]
 - **[Seattle City Light]**, provided by [Opower]
+- **[Southwestern Electric Power Company (SWEPCO)]**, provided by [Opower]
 
 [Advantage Air]: /integrations/advantage_air
+[AEP Ohio]: /integrations/aepohio
+[AEP Texas]: /integrations/aeptexas
+[Appalachian Power]: /integrations/appalachianpower
 [Fujitsu anywAIR]: /integrations/fujitsu_anywair
+[Indiana Michigan Power]: /integrations/indianamichiganpower
+[Kentucky Power]: /integrations/kentuckypower
 [Opower]: /integrations/opower
+[Public Service Company of Oklahoma (PSO)]: /integrations/psoklahoma
 [Seattle City Light]: /integrations/scl
+[Southwestern Electric Power Company (SWEPCO)]: /integrations/swepco
 
 ## Integrations now available to set up from the UI
 
 The following integrations are now available via the Home Assistant UI:
 
-- **[Lorem ipsum]**, done by [@frenck]
+- **[Netgear LTE]**, done by [@tkdrob]
+- **[StreamLabs]**, done by [@joostlek]
+- **[Suez Water]**, done by [@joostlek]
+- **[Swiss public transport]**, done by [@miaucl]
+- **[System Monitor]**, done by [@gjohansson-ST]
+- **[Trend]**, done by [@jpbede]
 
-[@frenck]: https://github.com/frenck
-[Lorem ipsum]: /integrations/lorem_ipsum
+[@gjohansson-ST]: https://github.com/gjohansson-ST
+[@joostlek]: https://github.com/joostlek
+[@jpbede]: https://github.com/jpbede
+[@miaucl]: https://github.com/miaucl
+[@tkdrob]: https://github.com/tkdrob
+[Netgear LTE]: /integrations/netgear_lte
+[StreamLabs]: /integrations/streamlabswater
+[Suez Water]: /integrations/suez_water
+[Swiss public transport]: /integrations/swiss_public_transport
+[System Monitor]: /integrations/systemmonitor
+[Trend]: /integrations/trend
 
 ## Need help? Join the community!
 
@@ -151,24 +338,64 @@ it is identical to omitting it: `swap:`.
 
 {% enddetails %}
 
+{% details "PrusaLink" %}
+
+- The printer state now contains several new statuses, most importantly
+  "attention" which always needs your invention.
+- Firmware 4.7.0 is now the minimum version for Prusa XL and MK4.
+- Firmware 5.1.0 is now the minimum version for Prusa Mini since 4.7.x and 5.0.x
+  aren't available for the Mini
+
+([@Skaronator] - [#103396]) ([documentation](/integrations/prusalink))
+
+[@Skaronator]: https://github.com/Skaronator
+[#103396]: https://github.com/home-assistant/core/pull/103396
+
+{% enddetails %}
+
+{% details "Reolink" %}
+
+The Reolink `Infra red lights in night mode` entity has been migrated from
+the `light` to the `switch` domain.
+
+This means the entity ID also changed and automations and dashboards may need
+to be adjusted to use the new entity ID. 
+
+If you want to go back to the light domain, use the
+[switch_as_x "Show as" option](/integrations/switch_as_x/#change-device-type-of-a-switch-from-the-existing-entity)
+on the new `Infra red lights in night mode` switch entity and select light.
+
+([@starkillerOG] - [#104713]) ([documentation](/integrations/reolink))
+
+[@starkillerOG]: https://github.com/starkillerOG
+[#105916]: https://github.com/home-assistant/core/pull/105916
+
+{% enddetails %}
+
+{% details "Shelly" %}
+
+The minimum supported firmware version for generation 1 devices is 1.11.0 (2021-07-15).
+The minimum supported firmware version for generation 2 devices is 1.0.0 (2023-08-03).
+
+You must update your devices to the firmware versions listed or newer.
+
+([@bieniu] - [#105384]) ([documentation](/integrations/shelly))
+
+[@bieniu]: https://github.com/bieniu
+[#105384]: https://github.com/home-assistant/core/pull/105384
+
+{% enddetails %}
+
 If you are a custom integration developer and want to learn about breaking
 changes and new features available for your integration: Be sure to follow our
 [developer blog][devblog]. The following are the most notable for this release:
 
-- [Lorem ipsum](https://developers.home-assistant.io/blog)
+- [Changes to EntityDescription data classes](https://developers.home-assistant.io/blog/2023/12/11/entity-description-changes/)
+- [Config entry now supports minor versions](https://developers.home-assistant.io/blog/2023/12/18/config-entry-minor-version/)
+- [Deprecated constants create a log entry](https://developers.home-assistant.io/blog/2023/12/19/constant-deprecation/)
 
 [devblog]: https://developers.home-assistant.io/blog/
 
-## Farewell to the following
-
-The following integrations are also no longer available as of this release:
-
-- **Lorem ipsum** has been removed. Lorem slipsum might be a good replacement.
-  ([@frenck] - [#12345])
-
-[@frenck]: https://github.com/frenck
-[#12345]: https://github.com/home-assistant/core/pull/12345
-
 ## All changes
 
 Of course, there is a lot more in this release. You can find a list of