MQTT climate preset_mode rework (#21547)

source/_integrations/climate.mqtt.markdown

@@ -79,18 +79,6 @@ availability_topic:
   description: The MQTT topic subscribed to receive availability (online/offline) updates. Must not be used together with `availability`.
   required: false
   type: string
-away_mode_command_topic:
-  description: The MQTT topic to publish commands to change the away mode.
-  required: false
-  type: string
-away_mode_state_template:
-  description: A template to render the value received on the `away_mode_state_topic` with.
-  required: false
-  type: template
-away_mode_state_topic:
-  description: The MQTT topic to subscribe for changes of the HVAC away mode. If this is not set, the away mode works in optimistic mode (see below).
-  required: false
-  type: string
 current_temperature_template:
   description: A template with which the value received on `current_temperature_topic` will be rendered.
   required: false
@@ -176,26 +164,6 @@ fan_modes:
   required: false
   default: ['auto', 'low', 'medium', 'high']
   type: list
-hold_command_template:
-  description: A template to render the value sent to the `hold_command_topic` with.
-  required: false
-  type: template
-hold_command_topic:
-  description: The MQTT topic to publish commands to change the hold mode.
-  required: false
-  type: string
-hold_state_template:
-  description: A template to render the value received on the `hold_state_topic` with.
-  required: false
-  type: template
-hold_state_topic:
-  description: The MQTT topic to subscribe for changes of the HVAC hold mode. If this is not set, the hold mode works in optimistic mode (see below).
-  required: false
-  type: string
-hold_modes:
-  description: A list of available hold modes.
-  required: false
-  type: list
 initial:
   description: Set the initial target temperature.
   required: false
@@ -280,6 +248,27 @@ precision:
   required: false
   type: float
   default: 0.1 for Celsius and 1.0 for Fahrenheit.
+preset_mode_command_template:
+  description: Defines a [template](/docs/configuration/templating/#processing-incoming-data) to generate the payload to send to `preset_mode_command_topic`.
+  required: false
+  type: template
+preset_mode_command_topic:
+  description: The MQTT topic to publish commands to change the preset mode.
+  required: false
+  type: string
+preset_mode_state_topic:
+  description: The MQTT topic subscribed to receive climate speed based on presets. When preset 'none' is received or `None` the `preset_mode` will be reset.
+  required: false
+  type: string
+preset_mode_value_template:
+  description: Defines a [template](/docs/configuration/templating/#processing-incoming-data) to extract the `preset_mode` value from the payload received on `preset_mode_state_topic`.
+  required: false
+  type: string
+preset_modes:
+  description: List of preset modes this climate is supporting. Common examples include `eco`, `away`, `boost`, `comfort`, `home`, `sleep` and `activity`.
+  required: false
+  type: [list]
+  default: []
 qos:
   description: The maximum QoS level to be used when receiving and publishing messages.
   required: false
@@ -434,7 +423,12 @@ climate:
       - "high"
       - "medium"
       - "low"
+    preset_modes:
+      - "eco"
+      - "sleep"
+      - "activity"
     power_command_topic: "study/ac/power/set"
+    preset_mode_command_topic: "study/ac/preset_mode/set"
     mode_command_topic: "study/ac/mode/set"
     temperature_command_topic: "study/ac/temperature/set"
     fan_mode_command_topic: "study/ac/fan/set"