Skip to content

spawnegit/salus-it500-extended

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Salus IT500 Extended Integration for Home Assistant

Based on the original work by @floringhimie
This fork adds extended controls for the Salus IT500 thermostat — developed for personal use and contributed back to the community.


Background

The original salus_mk_test integration by @floringhimie provides excellent basic control of the Salus IT500 thermostat in Home Assistant. This fork extends it with additional button entities and coordinator logic to support day-to-day heating management features that are not exposed by the standard integration.

The additions were developed and tested on a Salus IT500 in a single-zone CH + hot water setup, running Home Assistant on Unraid.

The original IT500 hardware has since died and been replaced, so this fork is contributed back as-is in the hope that others find it useful. It is not actively maintained.


What This Fork Adds

New Button Entities

Button Description
Heating Boost Activates boost for a configurable number of hours at a configurable temperature
Cancel Heating Boost Cancels an active boost and returns to Schedule mode
Advance Heating Jumps to the next scheduled temperature immediately (useful for "warm up now")
Cancel Heating Override Cancels a TEMP_HOLD override and returns to the schedule
Delay Heating Program Holds the current temperature and delays the next schedule change by a configurable number of hours
Skip Heating Program Skips the next scheduled change, applying the one after it instead
Hot Water Boost Activates hot water boost for a configurable number of hours (CH1+HW systems only)
Cancel Hot Water Boost Cancels an active hot water boost

Zone 2 equivalents are created automatically on CH1+CH2 systems.

New Number Entities (configurable values for the buttons above)

Entity Description Default
Boost Duration Hours for heating boost 1
Boost Temperature Target temperature during boost 21.0°C
Delay Duration Hours to delay next program change 1
Hot Water Boost Duration Hours for HW boost 1

New Services

Service Description
salus_mk.set_schedule Set the heating schedule for a specific zone and day
salus_mk.copy_schedule Copy a schedule from one day to another
salus_mk.set_schedule_type Set schedule type (all / 5+2 / independent)

How Skip and Delay Work

These features are implemented entirely in Home Assistant — no firmware changes are needed on the thermostat.

  • Skip reads the current day's schedule, identifies the next scheduled change, and applies a TEMP_HOLD at the current temperature until the entry after the skipped one. The coordinator monitors the time and clears the override automatically.
  • Delay works similarly, but instead of skipping the next entry entirely it pushes it back by the configured delay duration.

Both features store their state in the coordinator and are cleared automatically when the target time is reached.


Installation

  1. Copy the custom_components/salus_mk folder into your Home Assistant config/custom_components/ directory.
  2. Restart Home Assistant.
  3. Go to Settings → Devices & Services → Add Integration and search for Salus-MK.
  4. Enter your Salus cloud credentials (same username/password as the Salus app).

Note: This integration uses the Salus cloud API, the same as the original. Your IT500 must be connected to the Salus cloud.


Example Dashboard

See examples/dashboards/salus_full_dashboard.yaml for the complete Lovelace dashboard.

Dashboard Screenshot

Entity IDs will vary — find yours at Settings → Devices & Services → your Salus device.


Example Automations

See examples/automations/advance_heating_example.yaml for voice-triggered automation examples.


Credits

All core integration code, the pyit500 library, config flow, and platform setup are the work of @floringhimie.

The following files contain meaningful additions or modifications by this fork:

  • button.py — all new button entities
  • coordinator.py — boost/skip/delay state management
  • number.py — configurable values for boost/delay duration and temperature

Everything else is either unchanged from the original or contains only minor fixes.


Licence

This project inherits the licence of the original repository. Please refer to @floringhimie's repo for licence terms.

About

Extended IT500 features contributed back — boost, skip, delay, advance

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages