From ad1103c46df358fc69c6018eb4733da154699e51 Mon Sep 17 00:00:00 2001
From: dotvav <dotvav@users.noreply.github.com>
Date: Wed, 8 Jan 2025 08:17:53 +0100
Subject: [PATCH] Palazzetti doc improvement (#36599)

* Palazzetti doc improvement

* tiny tweaks

* Update source/_integrations/palazzetti.markdown

---------

Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
---
 source/_integrations/palazzetti.markdown | 66 ++++++++++++++++++++++++
 1 file changed, 66 insertions(+)

diff --git a/source/_integrations/palazzetti.markdown b/source/_integrations/palazzetti.markdown
index f3b415d8493..6024b4e408c 100644
--- a/source/_integrations/palazzetti.markdown
+++ b/source/_integrations/palazzetti.markdown
@@ -18,12 +18,26 @@ ha_integration_type: device
 ha_dhcp: true
 ---
 
+## Prerequisites
+
+- You need the Connection Box bridge to be added to a network accessible to Home Assistant.
+- You either need to:
+  - know the IP address or hostname of the Connection Box on the network.
+  - or configure the Connection Box with DHCP on the same network as Home Assistant.
+
 The **Palazzetti** {% term integration %} integrates the [Palazzetti](https://palazzettigroup.com/)
 stoves equipped with a [Connection Box](https://palazzettigroup.com/research-and-development/app/).
 It is accessing the device's local API.
 
 {% include integrations/config_flow.md %}
 
+{% configuration_basic %}
+Host:
+  description: "The IP address or hostname of your Connection Box. You can find it in your router or in the Palazzetti app under **Settings** > **Diagnostic information** > **Ethernet** or **Wifi**."
+  required: true
+  type: string
+{% endconfiguration_basic %}
+
 ## Climate
 
 The Palazzetti integration offers a climate entity that allows you to read the
@@ -102,3 +116,55 @@ Fuel Sensors:
 
 - Pellet quantity (kg - cumulative quantity consumed)
 - Pellet level (cm - current level)
+
+## Possible use-cases
+
+- Control the operations, temperature, and fans.
+- Get alerts when the pellet level is low or empty, or on stove errors.
+- Auto start or stop the stove based on presence.
+
+## Automations
+
+Get started quickly with these automation examples.
+
+### Automatically lower the temperature when the last person leaves home
+
+{% details "Example YAML configuration" %}
+
+{% raw %}
+
+```yaml
+alias: "Lower the temperature when last person leaves"
+description: "Lower the temperature when last person leaves the home"
+mode: single
+triggers:
+  - trigger: state
+    entity_id:
+      - zone.home
+    to: 0
+actions:
+  - action: climate.set_temperature
+    data:
+      temperature: 16
+    target:
+      entity_id: climate.my_stove
+```
+
+{% endraw %} {% enddetails %}
+
+## Known limitations
+
+This integration does **not** yet support the following features and sensors:
+
+- Light and Door entities on stove models equipped with them.
+- Fan control other than the main one.
+- Combustion power control.
+
+## Troubleshooting
+
+{% details "On and off switch does not always work" %}
+During certain operations, it is not possible to turn the stove on or off. This action is available
+only when the status of the stove is in one of the following states: `off`, `off_timer`, `burning`, `burning_mod`, `cool_fluid`,
+`clean_fire`, `cooling`, `ecomode`, `firewood_finished`.
+{% enddetails %}
+