Component to integrate with Saleryd HRV unit

⚠️ Disclaimer

🤓 This integration has been developed for my HRV unit for personal use.

☣️ Be careful when altering settings on your ventilation system. Improper settings on your ventilation system can over time damage your house and personal health.

💣 Use at own risk.

❕ I am in no way affiliated with Saleryd. All trademarks belong to their respective owners.

Motivation

Monitor and control Saleryd HRV units from Home Assistant.

Ideas for automations

• airflow/temperature/cooling based on presence/schedule.
• cooling/temperature mode based on external temperature/humidity sensors or alarm system state
• energy price integration
• remote control using dashboard or physical controls
• ...

Integration features

Sensors

Name	Description	Unit	State attributes
boost_mode_minutes_left	minutes left until boost mode expires	min
extract_fan_speed	fan speed	%
filter_months_left	filter months left	m
fireplace_mode_minutes_left	minutes left until fireplace mode expires	min
heat_exchanger_rotor_speed_percent	rotor speed of heat exchanger	%
heat_exchanger_rotor_speed	rotor speed of heat exchanger	rpm
heater_active	auxillary heater active	boolean
heater_air_temperature	air temperature at heater	°C
heater_power	auxillary heater power	W
heater_power_percent	auxillary heater power	%
product_number	product number	str
supply_air_temperature	supply air temperature	°C
supply_fan_speed	fan speed	%
system_active	status of the system	On | Off | Reset
system_name	control system name	str
system_version	control system version	str
system_warning	system warning	boolean	raw system error/warning codes
target_temperature	target air temperature	°C
temperature_mode	current temperature mode setting	str
ventilation_mode	current ventilation mode setting	str

Switches

Switch	Description	State attributes
home_mode	Turn home ventilation mode on/off
away_mode	Turn away ventilation mode on/off
boost_mode	Turn boost ventilation mode on/off	minutes left
cooling_mode	Turn cooling mode on/off
fireplace_mode	Turn fireplace mode on/off	minutes left

Services

Normal operation

Control normal operation of the unit

Name	Description	Fields
set_cooling_mode	Set cooling mode	device: str target device, value: integer (0=On, 1=Off)
set_fireplace_mode	Set fireplace mode	device: str target device, value: integer (0=On, 1=Off)
set_temperature_mode	Set temperature mode	device: str target device, value: integer (0=Normal,1=Economy,2=Cool)
set_ventilation_mode	Set ventilation mode	device: str target device, value: integer (0=Home,1=Away,2=Boost)

Installer settings

Alter installer settings of the unit, Installer settings must be enabled.

Name	Description	Fields
set_system_active_mode	Set system active mode*	device: str target device, value: integer (0=Off,1=On,2=Reset)
set_target_temperature_normal	Set target temperature for normal temperature mode*	device: str target device, value: number (temperature 10-30 degrees celcius)
set_target_temperature_cool	Set target temperature for cool temperature mode*	device: str target device, value: number (temperature 10-30 degrees celcius)
set_target_temperature_economy	Set target temperature for economy temperature mode*	device: str target device, value: number (temperature 10-30 degrees celcius)

Experimental features

Switches

Switch	Description	State attributes
cooking_mode	Turn cooking mode on/off. Emulates cooking mode when fireplace mode is active. When cooking mode is active, automatically deactivates fireplace mode before timer expires. This will reset rotary heat exchanger to normal operation as is desirable in warm weather.

Supported devices

Model	Confirmed supported control system versions	Unsupported control system versions
LOKE01/LOKE BASIC/LS-01	4.1.5	<4.1.5*

* connectivity issues in versions below 4.1.5

Installation

HACS Install

1. In Home Assistant go to HACS -> Integrations and add this repository as a custom repository.
2. In Home Assistant go to Configuration -> Integrations click + and search for Saleryd HRV.
3. Click install.
4. Restart Home Assistant.

Manual ZIP install

1. Download release .zip file from releases page.
2. Copy the saleryd_hrv directory from the release archive to the /custom_components directory in your Home Assistant server.
3. Restart Home Assistant.

Configuration

Prequisites

1. Connect HRV system to your local WIFI network. See instructions in user manual.
2. Take note of the assigned IP adress of the system

YAML Configuration

Configuration in congfiguration.yaml is not supported

UI Configuration

• Add Intergration to Home Assistant.

Setting	Description	Default
Name	System name. Must be unique.
Websocket IP	IP adress of the HRV system on the local WIFI network
Port	Port number for websocket connection	3001
Enable installer settings	Altering HRV system configuration set by the installer from Home Assistant. Don't alter these settings unless you know what you are doing	False
Installer password	Installer password. Required for installer settings

Troubleshooting

I can't connect to HRV system

• Check the Home Assitant logs
• Confirm system is connected and the UI portal is reachable on the local network. Follow steps in the manual.
• Confirm websocket port by connecting to the UI using a browser and take note of websocket port using debug console in browser.
• The system HRV can only handle a few connected clients. Shut down any additional clients/browsers and try again.

I can't modify installer settings

• Ensure installer settings are enabled in integration configuration
• Ensure installer password is correct

Contributing

Issues and PRs welcome!

See CONTRIBUTING.md

Enable debug logging

Add component to the logger section of homeassistant configuration.yaml.

logger:
  logs:
    custom_components.saleryd_hrv: debug

Related projects

https://github.com/bj00rn/pysaleryd