Add Air Purifier MA2 (zhimi.airpurifier.ma2) to xiaomi_miio

CODEOWNERS

@@ -72,7 +72,7 @@ source/_integrations/azure_event_hub.markdown @eavanvalkenburg
 source/_integrations/azure_service_bus.markdown @hfurubotten
 source/_integrations/backup.markdown @home-assistant/core
 source/_integrations/baf.markdown @bdraco @jfroy
-source/_integrations/balboa.markdown @garbled1
+source/_integrations/balboa.markdown @garbled1 @natekspencer
 source/_integrations/bayesian.markdown @HarvsG
 source/_integrations/beewi_smartclim.markdown @alemuro
 source/_integrations/binary_sensor.markdown @home-assistant/core
@@ -121,7 +121,7 @@ source/_integrations/compensation.markdown @Petro31
 source/_integrations/config.markdown @home-assistant/core
 source/_integrations/configurator.markdown @home-assistant/core
 source/_integrations/control4.markdown @lawtancool
-source/_integrations/conversation.markdown @home-assistant/core
+source/_integrations/conversation.markdown @home-assistant/core @synesthesiam
 source/_integrations/coolmaster.markdown @OnFreund
 source/_integrations/coronavirus.markdown @home-assistant/core
 source/_integrations/counter.markdown @fabaff
@@ -160,12 +160,14 @@ source/_integrations/dlna_dms.markdown @chishm
 source/_integrations/dnsip.markdown @gjohansson-ST
 source/_integrations/doorbird.markdown @oblogic7 @bdraco @flacjacket
 source/_integrations/dooya.markdown @starkillerOG
+source/_integrations/dormakaba_dkey.markdown @emontnemery
 source/_integrations/dsmr.markdown @Robbie1221 @frenck
 source/_integrations/dsmr_reader.markdown @depl0y @glodenox
 source/_integrations/dunehd.markdown @bieniu
 source/_integrations/dwd_weather_warnings.markdown @runningman84 @stephan192 @Hummel95
 source/_integrations/dynalite.markdown @ziv1234
-source/_integrations/ecobee.markdown @marthoc
+source/_integrations/easyenergy.markdown @klaasnicolaas
+source/_integrations/ecobee.markdown @marthoc @marcolivierarsenault
 source/_integrations/econet.markdown @vangorra @w1ll1am23
 source/_integrations/ecovacs.markdown @OverloadUT @mib1185
 source/_integrations/ecowitt.markdown @pvizeli
@@ -179,7 +181,7 @@ source/_integrations/elv.markdown @majuss
 source/_integrations/emby.markdown @mezz64
 source/_integrations/emoncms.markdown @borpin
 source/_integrations/emonitor.markdown @bdraco
-source/_integrations/emulated_hue.markdown @bdraco
+source/_integrations/emulated_hue.markdown @bdraco @Tho85
 source/_integrations/emulated_kasa.markdown @kbickar
 source/_integrations/energie_vanons.markdown @klaasnicolaas
 source/_integrations/energy.markdown @home-assistant/core
@@ -237,7 +239,7 @@ source/_integrations/gaviota.markdown @starkillerOG
 source/_integrations/gdacs.markdown @exxamalte
 source/_integrations/generic.markdown @davet2001
 source/_integrations/generic_hygrostat.markdown @Shulyaka
-source/_integrations/geniushub.markdown @zxdavb
+source/_integrations/geniushub.markdown @manzanotti
 source/_integrations/geo_json_events.markdown @exxamalte
 source/_integrations/geo_location.markdown @home-assistant/core
 source/_integrations/geo_rss_events.markdown @exxamalte
@@ -262,7 +264,7 @@ source/_integrations/gpsd.markdown @fabaff
 source/_integrations/gree.markdown @cmroche
 source/_integrations/greeneye_monitor.markdown @jkeljo
 source/_integrations/group.markdown @home-assistant/core
-source/_integrations/growatt_server.markdown @indykoning @muppet3000 @JasperPlant
+source/_integrations/growatt_server.markdown @muppet3000
 source/_integrations/guardian.markdown @bachya
 source/_integrations/habitica.markdown @ASMfreaK @leikoilja
 source/_integrations/hardware.markdown @home-assistant/core
@@ -392,6 +394,7 @@ source/_integrations/lyric.markdown @timmo001
 source/_integrations/marantz.markdown @ol-iver @starkillerOG
 source/_integrations/martec.markdown @starkillerOG
 source/_integrations/mastodon.markdown @fabaff
+source/_integrations/matter.markdown @home-assistant/matter
 source/_integrations/mazda.markdown @bdr99
 source/_integrations/meater.markdown @Sotolotl @emontnemery
 source/_integrations/media_player.markdown @home-assistant/core
@@ -568,7 +571,7 @@ source/_integrations/rtsp_to_webrtc.markdown @allenporter
 source/_integrations/ruckus_unleashed.markdown @gabe565
 source/_integrations/ruuvi_gateway.markdown @akx
 source/_integrations/ruuvitag_ble.markdown @akx
-source/_integrations/rympro.markdown @OnFreund
+source/_integrations/rympro.markdown @OnFreund @elad-bar @maorcc
 source/_integrations/sabnzbd.markdown @shaiu
 source/_integrations/safe_mode.markdown @home-assistant/core
 source/_integrations/saj.markdown @fredericvl
@@ -703,6 +706,7 @@ source/_integrations/tolo.markdown @MatthiasLohr
 source/_integrations/tomorrowio.markdown @raman325 @lymanepp
 source/_integrations/totalconnect.markdown @austinmroczek
 source/_integrations/tplink.markdown @rytilahti @thegardenmonkey
+source/_integrations/tplink_omada.markdown @MarkGodwin
 source/_integrations/traccar.markdown @ludeeus
 source/_integrations/tractive.markdown @Danielhiversen @zhulik @bieniu
 source/_integrations/trafikverket_ferry.markdown @gjohansson-ST

Gemfile.lock

@@ -82,7 +82,7 @@ GEM
       forwardable-extended (~> 2.6)
     public_suffix (5.0.1)
     racc (1.6.2)
-    rack (2.2.6.2)
+    rack (2.2.6.3)
     rack-protection (3.0.5)
       rack
     rake (13.0.6)

_config.yml

@@ -109,9 +109,9 @@ social:
 
 # Home Assistant release details
 current_major_version: 2023
-current_minor_version: 2
-current_patch_version: 5
-date_released: 2023-02-15
+current_minor_version: 3
+current_patch_version: 1
+date_released: 2023-03-02
 
 # Either # or the anchor link to latest release notes in the blog post.
 # Must be prefixed with a # and have double quotes around it.

source/_docs/automation/trigger.markdown

@@ -198,7 +198,12 @@ automation:
 
 ## Numeric state trigger
 
-Fires when the numeric value of an entity's state (or attribute's value if using the `attribute` property, or the calculated value if using the `value_template` property) **crosses** (and only when crossing) a given threshold. On state change of a specified entity, attempts to parse the state as a number and fires if the value is changing from above to below or from below to above the given threshold.
+Fires when the numeric value of an entity's state (or attribute's value if using the `attribute` property, or the calculated value if using the `value_template` property) **crosses** a given threshold. On state change of a specified entity, attempts to parse the state as a number and fires if the value is changing from above to below or from below to above the given threshold.
+
+<div class='note'>
+Crossing the threshold means that the trigger only fires if the state wasn't previously within the threshold.
+If the current state of your entity is `50` and you set the threshold to `below: 75`, the trigger would not fire if the state changed to e.g. `49` or `72` because the threshold was never crossed. The state would first have to change to e.g. `76` and then to e.g. `74` for the trigger to fire.
+</div>
 
 {% raw %}
 

source/_includes/asides/docs_navigation.html

@@ -42,7 +42,7 @@ <h1 class="title delta">Topics</h1>
       <li>
         <b>{% active_link /docs/assist/ Assist %}</b>
         <ul>
-          <li>{% active_link /docs/assist/android/ Assist for Android Wear %}</li>
+          <li>{% active_link /docs/assist/android/ Assist for Android %}</li>
           <li>{% active_link /docs/assist/apple/ Assist for Apple devices %}</li>
           <li>{% active_link /docs/assist/builtin_sentences/ Built-in sentences %}</li>
           <li>{% active_link /docs/assist/custom_sentences/ Custom sentences %}</li>

source/_integrations/balboa.markdown

@@ -12,6 +12,7 @@ ha_platforms:
   - climate
 ha_codeowners:
   - '@garbled1'
+  - '@natekspencer'
 ha_config_flow: true
 ha_integration_type: integration
 ---

source/_integrations/conversation.markdown

@@ -8,6 +8,7 @@ ha_quality_scale: internal
 ha_iot_class: Local Push
 ha_codeowners:
   - '@home-assistant/core'
+  - '@synesthesiam'
 ha_domain: conversation
 ha_integration_type: system
 ---

source/_integrations/default_config.markdown

@@ -39,6 +39,7 @@ This integration is a meta-component and configures a default set of integration
 - [Media Source](/integrations/media_source/) (`media_source`)
 - [Mobile App Support](/integrations/mobile_app/) (`mobile_app`)
 - [My Home Assistant](/integrations/my/) (`my`)
+- [Network](/integrations/network/) (`network`)
 - [Person](/integrations/person/) (`person`)
 - [Schedule](/integrations/schedule/) (`schedule`)
 - [Scene](/integrations/scene/) (`scene`)

source/_integrations/denonavr.markdown

@@ -3,7 +3,7 @@ title: Denon AVR Network Receivers
 description: Instructions on how to integrate Denon AVR Network Receivers into Home Assistant.
 ha_category:
   - Media Player
-ha_iot_class: Local Polling
+ha_iot_class: Local Push
 ha_release: 0.7.2
 ha_domain: denonavr
 ha_codeowners:

source/_integrations/derivative.markdown

@@ -18,9 +18,8 @@ ha_platforms:
 ha_integration_type: helper
 ---
 
-The derivative ([Wikipedia](https://en.wikipedia.org/wiki/Derivative)) integration creates a sensor that "smooths-out" another sensor (the **source sensor**). 
-Derivatives of the specified sensor will be averaged in a given time window with a Simple Moving Average algorithm weighted by time. This is, for instance, useful for a sensor that outputs discrete values or to filter out short-duration noise. 
-Derivative sensors are updated upon changes of the **source sensor**.
+The derivative ([Wikipedia](https://en.wikipedia.org/wiki/Derivative)) integration creates a sensor that estimates the derivative of the
+values provided by another sensor (the **source sensor**). Derivative sensors are updated upon changes of the **source sensor**.
 
 For sensors that reset to zero after a power interruption and need a "non-negative derivative", such as bandwidth counters in routers, or rain gauges, consider using the [Utility Meter](/integrations/utility_meter/) integration instead. Otherwise, each reset will register a significant change in the derivative sensor.
 
@@ -83,7 +82,7 @@ unit:
   required: false
   type: string
 time_window:
-  description: The time window in which to calculate the derivative. By default the derivative is calculated between two consecutive updates without any smoothing.
+  description: The time window in which to calculate the derivative. Derivatives in this window will be averaged with a Simple Moving Average algorithm weighted by time. This is for instance useful for a sensor that outputs discrete values, or to filter out short duration noise. By default the derivative is calculated between two consecutive updates without any smoothing.
   default: 0
   required: false
   type: time

source/_integrations/easyenergy.markdown

@@ -11,6 +11,7 @@ ha_codeowners:
   - '@klaasnicolaas'
 ha_domain: easyenergy
 ha_platforms:
+  - diagnostics
   - sensor
 ha_quality_scale: platinum
 ha_integration_type: integration
@@ -51,4 +52,4 @@ prices for electricity that you use (buy) or return (sell). Every day around
 
 For the dynamic gas prices, only entities are created that display the
 `current` and `next hour` price because the price is always fixed for
-24 hours; new prices are published every morning at **05:00 UTC time**.
+24 hours; new prices are published every morning at **05:00 UTC time**.

source/_integrations/ecobee.markdown

@@ -15,6 +15,7 @@ ha_iot_class: Cloud Polling
 ha_config_flow: true
 ha_codeowners:
   - '@marthoc'
+  - '@marcolivierarsenault'
 ha_domain: ecobee
 ha_platforms:
   - binary_sensor
@@ -227,4 +228,4 @@ Enable/disable Smart Home/Away and Follow Me modes.
 | ---------------------- | -------- | ------------------------------------------------- |
 | `entity_id`            | yes      | ecobee thermostat on which to set occupancy modes |
 | `auto_away`            | yes      | true or false                                     |
-| `follow_me`            | yes      | true or false                                     |
+| `follow_me`            | yes      | true or false                                     |

source/_integrations/emulated_hue.markdown

@@ -10,6 +10,7 @@ ha_domain: emulated_hue
 ha_integration_type: integration
 ha_codeowners:
   - '@bdraco'
+  - '@Tho85'
 ---
 
 <div class='note warning'>

source/_integrations/geniushub.markdown

@@ -10,7 +10,7 @@ ha_category:
 ha_release: 0.92
 ha_iot_class: Local Polling
 ha_codeowners:
-  - '@zxdavb'
+  - '@manzanotti'
 ha_domain: geniushub
 ha_platforms:
   - binary_sensor

source/_integrations/geo_json_events.markdown

@@ -10,7 +10,7 @@ ha_codeowners:
   - '@exxamalte'
 ha_platforms:
   - geo_location
-ha_integration_type: integration
+ha_integration_type: service
 ---
 
 The `geo_json_events` platform lets you integrate GeoJSON feeds. It retrieves events from a feed and shows information of those events filtered by distance to Home Assistant's location.

source/_integrations/google_assistant_sdk.markdown

@@ -12,6 +12,7 @@ ha_codeowners:
 ha_integration_type: service
 ha_platforms:
   - notify
+ha_quality_scale: platinum
 ---
 
 The Google Assistant SDK integration allows Home Assistant to interact with Google Assistant. If you want to use Google Assistant (for example, from your phone or Google Home device) to interact with your Home Assistant managed devices, then you want the [Google Assistant](/integrations/google_assistant) integration.

source/_integrations/google_mail.markdown

@@ -21,7 +21,8 @@ The Google Mail integration allows you to connect your [Google Mail](https://mai
 
 You need to configure developer credentials to allow Home Assistant to access your Google Account.
 These credentials are the same as the ones for [Nest](/integrations/nest) and [Google Sheets](/integrations/google_sheets).
-If you have already set up credentials, you can do step 1 and then skip to step 13 on the below instructions.
+These are not the same as the one for [Google Calendar](/integrations/google).
+If you have already set up the correct credentials, you can do step 1 and then skip to step 13 on the below instructions.
 
 {% details "Generate Client ID and Client Secret" %}
 
@@ -43,7 +44,7 @@ This section explains how to generate a Client ID and Client Secret on
 13. Make sure **Publishing status** is set to production.
 14. Click **Credentials** in the menu on the left-hand side of the screen, then click **Create credentials** (at the top of the screen), then select *OAuth client ID*.
 15. Set the Application type to *Web application* and give this credential set a name (like "Home Assistant Credentials").
-16. Add https://my.home-assistant.io/redirect/oauth to *Authorized redirect URIs* then click **Create**.
+16. Add https://my.home-assistant.io/redirect/oauth to *Authorized redirect URIs* then click **Create**. This is not a placeholder and is the URI that must be used.
 17. You will then be presented with a pop-up saying *OAuth client created* showing *Your Client ID* and *Your Client Secret*. Make a note of these (for example, copy and paste them into a text editor), as you will need these shortly. Once you have noted these strings, click **OK**. If you need to find these credentials again at any point, then navigate to *APIs & Services > Credentials*, and you will see *Home Assistant Credentials* (or whatever you named them in the previous step) under *OAuth 2.0 Client IDs*. To view both the *Client ID* and *Client secret*, click on the pencil icon; this will take you to the settings page for these credentials, and the information will be on the right-hand side of the page.
 18. Double-check that the *Gmail API* has been automatically enabled. To do this, select **Library** from the menu, then search for *Gmail API*. If it is enabled you will see *API Enabled* with a green tick next to it. If it is not enabled, then enable it.
 

source/_integrations/google_sheets.markdown

@@ -20,8 +20,9 @@ The integration currently only has access to that one document that is created d
 ## Prerequisites
 
 You need to configure developer credentials to allow Home Assistant to access your Google Account.
-These credentials are the same as the ones for [Nest](/integrations/nest).
-If you have already set up credentials, you can do step 1 and then skip to step 13 on the below instructions.
+These credentials are the same as the ones for [Nest](/integrations/nest) and [Google Mail](/integrations/google_mail).
+These are not the same as the one for [Google Calendar](/integrations/google).
+If you have already set up the correct credentials, you can do step 1 and then skip to step 13 on the below instructions.
 
 {% details "Generate Client ID and Client Secret" %}
 
@@ -43,7 +44,7 @@ This section explains how to generate a Client ID and Client Secret on
 13. Make sure **Publishing status** is set to production.
 14. Click **Credentials** in the menu on the left hand side of the screen, then click **Create credentials** (at the top of the screen), then select *OAuth client ID*.
 15. Set the Application type to *Web application* and give this credential set a name (like "Home Assistant Credentials").
-16. Add https://my.home-assistant.io/redirect/oauth to *Authorized redirect URIs* then click **Create**.
+16. Add https://my.home-assistant.io/redirect/oauth to *Authorized redirect URIs* then click **Create**. This is not a placeholder and is the URI that must be used.
 17. You will then be presented with a pop-up saying *OAuth client created* showing *Your Client ID* and *Your Client Secret*. Make a note of these (for example, copy and paste them into a text editor) as you will need these shortly. Once you have noted these strings, click **OK**. If you need to find these credentials again at any point then simply navigate to *APIs & Services > Credentials* and you will see *Home Assistant Credentials* (or whatever you named them in the previous step) under *OAuth 2.0 Client IDs*. To view both the *Client ID* and *Client secret*, click on the pencil icon, this will take you to the settings page for these credentials and the information will be on the right hand side of the page.
 18. Double check that the *Google Drive API* has been automatically enabled. To do this, select **Library** from the menu, then search for *Google Drive API*. If it is enabled you will see *API Enabled* with a green tick next to it. If it is not enabled, then enable it.
 

source/_integrations/growatt_server.markdown

@@ -7,9 +7,7 @@ ha_category:
 ha_release: 0.99
 ha_iot_class: Cloud Polling
 ha_codeowners:
-  - '@indykoning'
   - '@muppet3000'
-  - '@JasperPlant'
 ha_domain: growatt_server
 ha_platforms:
   - sensor

source/_integrations/home_connect.markdown

@@ -43,7 +43,10 @@ Note that it depends on the appliance and on API permissions which of the featur
 - OAuth Flow: Authorization Code Grant Flow
 - Redirect URI: `https://my.home-assistant.io/redirect/oauth`
 
-*Important*: after performing the steps above **log out** of your Home Connect Developer account. If you don't so this, the configuration steps below will fail during OAuth authentication with the message `“error”: “unauthorized_client”`.
+*Important*: 
+ - After performing the steps above **log out** of your Home Connect Developer account. If you don't do this, the configuration steps below will fail during OAuth authentication with the message `“error”: “unauthorized_client”`.
+ - The provided Home Connect User Account email address **must** be all lowercase otherwise it will result in authentication failures.
+ - All changes in the developer portal take 15 minutes before the change is implemented.
 
 {% details "I have manually disabled My Home Assistant" %}