home-assistant.io/source/_integrations/palazzetti.markdown
dotvav ad1103c46d
Palazzetti doc improvement (#36599)
* Palazzetti doc improvement

* tiny tweaks

* Update source/_integrations/palazzetti.markdown

---------

Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
2025-01-08 08:17:53 +01:00

5.1 KiB

title, description, ha_category, ha_release, ha_iot_class, ha_config_flow, ha_codeowners, ha_domain, ha_platforms, ha_integration_type, ha_dhcp
title description ha_category ha_release ha_iot_class ha_config_flow ha_codeowners ha_domain ha_platforms ha_integration_type ha_dhcp
Palazzetti Instructions on how to integrate Palazzetti within Home Assistant.
Climate
2024.11 Local Polling true
@dotvav
palazzetti
climate
diagnostics
number
sensor
device 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 stoves equipped with a Connection Box. 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 room temperature, start and stop the stove, set the target temperature, and set the fan speed.

Integration actions

This integration supports the following actions (see Climate).

  • set_temperature
  • set_hvac_mode
    • heat for heating mode
    • off to turn the stove off
  • set_fan_mode
    • Silent let the stove run in silent mode
    • 1 to 5 increasing fan speeds
    • High the highest available fan speed
    • Auto let the stove set the optimal fan speed

Numbers

The Palazzetti integration offers control over the combustion power of the stove on a scale from 1 to 5.

Sensors

The Palazzetti integration offers the following sensors, for the products that provide them:

State sensors:

  • Status (current operational state) can take the following values:
    • off: Off
    • off_timer: Timer-regulated switch off
    • test_fire: Ignition test
    • heatup: Pellet feed
    • fueling: Ignition
    • ign_test: Fuel check
    • burning: Operating
    • burning_mod: Operating - Modulating
    • unknown: Unknown
    • cool_fluid: Stand-by
    • fire_stop: Switch off
    • clean_fire: Burn pot cleaning
    • cool: Cooling in progress
    • cleanup: Final cleaning
    • ecomode: Ecomode
    • chimney_alarm: Chimney alarm
    • grate_error: Grate error
    • pellet_water_error: Pellet probe or return water error
    • t05_error: T05 error disconnected or faulty probe
    • hatch_door_open: Feed hatch or door open
    • pressure_error: Safety pressure switch error
    • main_probe_failure: Main probe failure
    • flue_probe_failure: Flue gas probe failure
    • exhaust_temp_high: Too high exhaust gas temperature
    • pellet_finished: Pellets finished or ignition failed
    • firewood_finished: Firewood finished
    • cooling: Cooling
    • general_error: General error
    • door_open: Door open
    • temp_too_high: Temperature too high
    • cleaning_warning: Cleaning warning
    • fuel_error: Fuel error

Temperature sensors:

  • Outlet air temperature (°C)
  • Wood combustion temperature (°C)
  • Room temperature (°C)
  • Return water temperature (°C)
  • Tank water temperature (°C)
  • Hydro temperature 1 (°C)
  • Hydro temperature 2 (°C)

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 %}

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 %}