home-assistant.io/source/_integrations/maxcube.markdown

title	description	ha_category	ha_release	ha_iot_class	ha_domain	ha_platforms	ha_integration_type
eQ-3 MAX!	Instructions on how to integrate eQ-3 MAX! components with Home Assistant via eQ-3 MAX! Cube.	Binary Sensor Climate	0.40	Local Polling	maxcube	binary_sensor climate	integration

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.yaml file and contain the following options as required:

# 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 %} host: description: The IP address of the eQ-3 MAX! Cube to use. required: true type: string port: description: The UDP port number. required: false type: integer default: 62910 scan_interval: description: The update interval in seconds required: false type: integer default: 300 {% endconfiguration %}

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).