2024.12.5
Home ▸ Integrations ▸

eQ-3 MAX!

eQ-3 MAX! integration for Home Assistant allows you to connect eQ-3 MAX! components via the eQ-3 MAX! Cube. The components connects to the eQ-3 MAX! Cube via TCP and automatically makes all supported integrations available in Home Assistant. The name for each device is created by concatenating the MAX! room and device names.

There is currently support for the following device types within Home Assistant:

  • Binary sensor
  • Climate

Limitations:

  • Configuring weekly schedules is not possible.
  • Implementation is based on the reverse engineered MAX! protocol.

Supported Devices:

  • MAX! Radiator Thermostat (tested)
  • MAX! Radiator Thermostat+
  • MAX! Window Sensor (tested)
  • MAX! Wall Thermostat (tested)

One gateway

A maxcube section must be present in the configuration.yamlThe configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI. [Learn more] file and contain the following options as required: After changing the configuration.yamlThe configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI. [Learn more] file, restart Home Assistant to apply the changes. The integration is now shown on the integrations page under Settings > Devices & services. Its entities are listed on the integration card itself and on the Entities tab.

# Example configuration.yaml entry
maxcube:
  gateways:
    - host: 192.168.0.20

Multiple gateways 

# Example configuration.yaml entry
maxcube:
  gateways:
    - host: 192.168.0.20
      port: 62910
    - host: 192.168.0.21
      port: 62910

Configuration Variables

Looking for your configuration file?
host string Required

The IP address of the eQ-3 MAX! Cube to use.

port integer (Optional, default: 62910)

The UDP port number.

scan_interval integer (Optional, default: 300)

The update interval in seconds

Problems connecting or setting up

Due to the connection limits of the eQ-3 MAX! Cube, Home Assistant will not be able to connect to the gateway if another application is still connected. It may result in timeout errors like Error: timed out You will need to restart Home Assistant after fixing. and The following integrations and platforms could not be set up: maxcube Please check your configuration.

To prevent these issues, ensure all other applications connecting to the gateway are closed, e.g., the mobile app or the MAX! desktop app (On Windows machines, close from the status bar, it keeps running when you close the browser window).

Related topics