https://github.com/remmob/itho_amber

Home Assistant Itho Daalderop Amber heatpump integration.
https://github.com/remmob/itho_amber

amber heatpump itho

Last synced: 4 months ago
JSON representation

Home Assistant Itho Daalderop Amber heatpump integration.

• Host: GitHub
• URL: https://github.com/remmob/itho_amber
• Owner: remmob
• Created: 2024-06-20T19:28:24.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2026-01-18T11:10:56.000Z (5 months ago)
• Last Synced: 2026-01-18T18:42:43.907Z (5 months ago)
• Topics: amber, heatpump, itho
• Language: Python
• Homepage:
• Size: 201 KB
• Stars: 12
• Watchers: 4
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
![Version](https://img.shields.io/github/v/release/remmob/itho_amber 'Release')

![Beta Release](https://img.shields.io/github/v/release/remmob/itho_amber?display_name=release&include_prereleases)

[![hacs_badge](https://img.shields.io/badge/HACS-Default-orange.svg 'Default Home Assistant community store')](https://github.com/custom-components/hacs)

[![total issues](https://img.shields.io/github/issues/remmob/itho_amber 'Total issues')](https://github.com/remmob/itho_amber/issues)

![Stars](https://img.shields.io/github/stars/remmob/itho_amber)

> ⚠️ **Modbus Gateway Parity Setting**

>

> With the latest software release for the *Itho Amber* by **Itho Daalderop**,  

> it may be necessary to set the **Modbus gateway Parity** to `"Even"` instead of `"None"`.  

> This ensures proper communication and avoids connection issues.

# Itho Daalderop Amber Heat pump integration

Home Assistant integration for Itho Daalderop Amber heat pump.
 

The Amber heat pump family contains 3 models.

- 65 (6,5Kw)

- 95 (9,5Kw)

- 120 (12Kw)

Although only tested with the Amber 95. It should work fine with the other two models.

The Itho Daalderop Amber is produced in Asia for the West European market.


Using a WIN CE as a controller with a custom version of the Heatstar software.

Although there are models/brands using the same controller it is not advisible

to use this integration with other than the three Itho Amber models.

Because of the custom version of the Heatstar software.
And

doing so can cause damage to your heat pump.

### Sensor Updates 

After changing a sensor value, it can take up sometime (poling time) before it updates.

### Modbus 

This integration uses the external Modbus connection on the back of the LCD controller.
Connections 1 (RS485B) & 2 (RS485A). 

![Modbus connections](images/Amber%20Modbus%20connection.png)

### Hardware 

For this Home Assistant integration, the RS485 serial Modbus connection must be converted to Modbus TCP/IP.


This can be done with standard of shelf modbus RTU RS485 to TCP/IP gateways.


[Waveshare](https://www.waveshare.com) as example, has afordable gateways.


Please make sure you order the right one that supports Modbus TCP, because not all do!


It is possible to use a Raspberry Pi 2 or higer as gateway with 

[this](https://github.com/3cky/mbusd) software.

# Installation

### HACS Custom Repository

On the HACS main page, hit the triple dots menu upper right corner.

click on custom repositories and add https://github.com/remmob/itho_amber as URL

the category must be integration. Click add to save.

### Manual 

Copy the `itho_amber` folder in the `custom_components` folder into your Home Assistant `config/custom_components` folder.


After rebooting Home Assistant, this integration can be configured through the integration setup UI.

## Settings

### Modbus settings

#### Serial: \[\gateway\]

- Baudrate: 19200 k/bits

- Databits: 8

- stopbit: 1

- flow control: none

- parity: none

#### TCP/IP: \[\gateway\]

- Device IP: \

- Subnet mask: \

- Device & destination port: \

- workmode: \

- device web port: \<80\>

- gateway: \

- multihost settings protocol: \

### Integration:

- prefix: used for the entity names. (default: amber)


    example: sensor.amber_ambient_temperture_ta

- IP-address: \

- port: \ 

- polling time: \

## Wiki

Visit the [wiki](https://github.com/remmob/itho_amber/wiki) for more information.

## Known issues

-   The first V2.29 software, released in 5-2024 contains a bug.


    When a Modbus value is written, the days when the legionella program 

    runs, get altered.


    This is known tot Itho and will be resolved in the next update.


    Please contact your installer for information about and how to get the software updates.

-   Settings M1.01, M1.20 and M9.05 have different bandwidth in the Modbus 

    than through the LCD controller.


    For example: M1.01 can be set in the LCD between 1-5°C, in the Modbus

    between 1-3°C. When set above 3°C in the LCD, will display correctly in the integration


    When you set it to 5 in the integration, it reverts back to max 3°C.

-   Some values are read-only. I do not understand why this choice was made by 

    Itho, I have asked them
 to make all settings writeable... To be continued... 

## Roadmap

- Adding Modbus RTU support