Skip to content

Configuration

Jump to bottom
remmob edited this page Jan 18, 2026 · 6 revisions

Configuration

This section explains how to install and configure the Itho Amber integration in Home Assistant using HACS.

Installation via HACS

  1. Open Home Assistant and go to HACS (Home Assistant Community Store).
  2. Click on "Integrations" in the HACS menu.
  3. Search for "Itho Amber" and select the integration from the list.
  4. Click "Install" and wait for the installation to complete.
  5. Restart Home Assistant to activate the integration.
  6. After restarting, go to "Settings" → "Devices & Services" and click on "Add Integration".
  7. Search for "Itho Amber" and follow the prompts to add your device.

Configuration Options

Once the integration is installed, you can configure it to suit your needs. The configuration screen allows you to:

  • Integration Name and Entity Prefix: The name you choose for the integration will be used as the prefix for all related entities. By default, entity names start with sensor.amber_, but you can customize this to fit your setup or to avoid conflicts with other devices.

  • IP Address and Communication Port: Enter the IP address of your Modbus gateway connected to the Itho Amber. Only TCP/IP Modbus is supported. The default communication port is 502, which is standard for Modbus TCP. Adjust the port only if your gateway uses a different one.

  • Polling Interval: Set how often (in seconds) the integration should poll the device for new data. A shorter interval provides more up-to-date information but may increase network or system load. Default is 10 seconds.

  • Send notifications for alarms (P/F/E/S): Enable this to receive notifications for alarms with type P, F, E, or S. When enabled, the integration will send a notification when such an alarm is triggered.

  • Notify services for alarm notifications: Enter a comma-separated list of Home Assistant notification services to use for alarm notifications (e.g., mobile_app_iphone, mobile_app_tablet).

  • Show persistent notifications for alarms: Enable this to show persistent notifications for alarms in the Home Assistant side menu. This ensures you always see important alerts.

  • Title for alarm notifications: Set the title that will be used for both the alarm notification and the persistent notification.

  • Alarm delay: Set the delay (in seconds) before the alarm notification and persistent notification are sent or shown. This can help prevent unnecessary alerts for short-lived alarms.

  • Send notifications for connection errors: Enable this to receive notifications when a connection error occurs. The integration will send a notification if it cannot communicate with the device.

  • Notify services for connection errors: Enter a comma-separated list of Home Assistant notification services to use for connection error notifications.

  • Title for connection error notifications: Set the title that will be used for both the connection error notification and the persistent notification.

Below is an example of the configuration screen:

configuration

Reconfigure settings and adding extra devices

Device

To access the reconfigure settings or add extra devices, go to Home Assistant, open "Settings" → "Devices & Services", and select your Itho Amber integration. Click on "Configure" to change settings or add new devices as needed. This allows you to update your configuration without reinstalling the integration.

you can add multiple entries (Amber heapumps) with each there own settings. Make sure you give each device a different (device) name.

Clone this wiki locally