Airobot

The Airobot integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] allows you to control and monitor Airobot smart thermostats for intelligent floor heating control via the local REST API. The thermostat uses adaptive learning with a TPI algorithm to maintain stable temperatures and optimize energy efficiency. Optional built-in carbon dioxide and humidity sensors monitor indoor air quality for a healthier living environment.

Supported devices

The following devices are supported by the integration:

• Airobot Smart Thermostat TE1 with firmware version 1.8 or later

Prerequisites

Before setting up the integration, ensure your Airobot thermostat is properly configured:

1. Verify your thermostat has firmware version 1.8 or later. You can check the firmware version in the thermostat settings menu.
2. Connect the thermostat to your local Wi-Fi or Ethernet network.
3. Connect to the internet at least once to register with the Airobot server. During this initial connection, the thermostat receives its Device ID (username) and password.
4. In the thermostat settings menu, navigate to Connectivity > Local API > Enable to enable the local REST API (disabled by default).
5. Note your Device ID and password from the thermostat menu under Connectivity > Mobile app screen. You will need these during setup. These are the same credentials used to pair the mobile app.

After initial setup, the thermostat does not require internet connectivity to function with Home Assistant.

Configuration

To add the Airobot device to your Home Assistant instance, use this My button:

Airobot can be auto-discovered by Home Assistant. If an instance was found, it will be shown as Discovered. You can then set it up right away.

The integration can be automatically discovered via DHCP when the thermostat is on the same network. If automatic discovery does not work, you can manually add the integration.

Reconfiguration

If you need to update the connection settings for your thermostat (such as changing the IP address, Device ID, or password), you can reconfigure the integration without removing and re-adding it:

1. Go to Settings > Devices & services.
2. On the Airobot integration, select the three-dot menu and choose Reconfigure.
3. Update the connection settings as needed.
4. Select Submit to save the new settings.

This is useful when:

• Your thermostat’s IP address has changed (for example, after a router restart or a DHCP lease renewal).
• You need to update the Device ID or password.
• You want to switch between IP address and hostname.

Supported functionality

The Airobot integration provides the following entities.

Climate

The thermostat is represented as a climate entityAn entity represents a sensor, actor, or function in Home Assistant. Entities are used to monitor physical properties or to control other entities. An entity is usually part of a device or a service. [Learn more] with the following capabilities.

• Current temperature

  • Description: Displays the measured temperature in the room.
  • Remarks: If a floor temperature sensor is connected, displays the floor temperature (for floor heating control). Otherwise, displays the air temperature.

• Current humidity

  • Description: Displays the measured relative humidity in the room.

• Target temperature

  • Description: Shows and allows you to set the desired temperature (5°C to 35°C range).
  • Remarks: In HOME mode, controls the HOME temperature setpoint. In AWAY mode, controls the AWAY temperature setpoint.

• HVAC mode

  • Description: Always set to Heat for this heating-only thermostat.

• HVAC action

  • Description: Shows whether the thermostat is actively heating or idle.

• Preset modes

  • Description: Select the operating mode for the thermostat.
  • Options: Home (use the HOME temperature setpoint), Away (use the AWAY temperature setpoint, typically lower for energy savings), Boost (temporarily boost heating for 1 hour, then return to the previous mode).

Sensors

The integration provides the following sensor entities to monitor your thermostat and environment.

Environmental sensors

• Air temperature

  • Description: The measured air temperature in the room.
  • Unit: °C

• Floor temperature

  • Description: The measured floor temperature.
  • Unit: °C
  • Remarks: Only available if a floor temperature sensor is connected to the thermostat.

• Humidity

  • Description: The measured relative humidity in the room.
  • Unit: %

• Carbon dioxide

  • Description: The measured carbon dioxide concentration in the room.
  • Unit: ppm
  • Remarks: Only available if the thermostat has the optional carbon dioxide sensor.

• Air quality index

  • Description: The calculated air quality index based on carbon dioxide levels.
  • Remarks: Only available if the thermostat has the optional carbon dioxide sensor.

Diagnostic sensors

The following diagnostic sensors are disabled by default. You can enable them in the entity settings if needed.

• Device uptime

  • Description: The timestamp when the thermostat was last restarted.

• Heating uptime

  • Description: The cumulative time the heating has been active since the thermostat was last restarted.
  • Unit: hours

System sensors

• Errors
  • Description: The current error count on the thermostat. A value of 0 indicates normal operation.

Number

The integration provides a configuration entity to adjust advanced thermostat settings:

• Hysteresis band: Configure the temperature hysteresis (dead band) for heating control (0.0-0.5°C range). This setting determines how much the temperature must drop below the setpoint before heating activates. A smaller value provides tighter temperature control but may cause more frequent heating cycles. A larger value reduces heating cycles but allows more temperature variation.

Button

The integration provides button entities for device management:

• Restart: Restart the thermostat device. This performs a soft restart of the thermostat, which can be useful for troubleshooting connectivity issues or applying configuration changes. The thermostat will be temporarily unavailable during the restart process (typically 5-10 seconds).
• Recalibrate CO₂: Initiates manual carbon dioxide sensor calibration by setting the current air as the new 400 ppm reference value. Only available if the thermostat has the optional carbon dioxide sensor. Not recommended for typical use as the carbon dioxide sensor has an auto-calibration algorithm enabled by default. Only activate this if the air is clean (fresh outdoor air) and auto-calibration needs to be manually overridden.

Switch

The integration provides switch entities for controlling thermostat features:

• Child lock: Enable or disable the child lock feature on the thermostat. When enabled, the physical buttons on the thermostat are locked to prevent accidental or unauthorized changes to settings.
• Actuator exercise disabled: Enable or disable the actuator exercise function. To prevent valve sticking, the actuator exercise periodically switches off the valve for 8 minutes at least every 96 hours. This entity is disabled by default.

Use cases

The Airobot integration enables intelligent floor heating control with practical automation opportunities. You can create presence-based heating automations that switch between HOME and AWAY presets based on occupancy, use BOOST to quickly warm rooms before arrival, monitor air quality to trigger ventilation alerts (with the optional carbon dioxide sensor), and track heating runtime patterns for energy optimization.

Automations

Examples of automations you can create using the Airobot integration.

Air quality alert

Send a notification when the air quality exceeds a specified threshold.

blueprint:
  name: Airobot Air Quality Alert
  description: Send notification when air quality exceeds threshold
  domain: automation
  input:
    air_quality_sensor:
      name: Air Quality Sensor
      selector:
        entity:
          filter:
            - domain: sensor
    threshold:
      name: Threshold
      description: Alert when value goes above this number
      default: 1000
      selector:
        number:
          min: 0
          max: 2000
    notify_device:
      name: Mobile Device
      description: Device to send notification to
      selector:
        device:
          filter:
            - integration: mobile_app
    notification_title:
      name: Notification Title
      description: Title of the notification
      default: "Poor Air Quality"
      selector:
        text:
    notification_message:
      name: Notification Message
      description: Message body (use {{ trigger.to_state.state }} for current value and {{ trigger.above }} for threshold)
      default: "Air quality in {{ area_name(trigger.entity_id) }} is {{ trigger.to_state.state }} (threshold: {{ trigger.above | int }})"
      selector:
        text:
          multiline: true

trigger:
  - platform: numeric_state
    entity_id: !input air_quality_sensor
    above: !input threshold

condition:
  - condition: template
    value_template: "{{ trigger.from_state.state | float(0) < trigger.to_state.state | float(0) }}"

action:
  - device_id: !input notify_device
    domain: mobile_app
    type: notify
    title: !input notification_title
    message: !input notification_message

Data updates

The Airobot integration pollsData polling is the process of querying a device or service at regular intervals to check for updates or retrieve data. By defining a custom polling interval, you can control how frequently your system checks for new data, which can help optimize performance and reduce unnecessary network traffic. [Learn more] data from the thermostat every 30 seconds. This interval matches the thermostat’s internal measurement cycle, ensuring efficient data synchronization without overwhelming the device.

Known limitations

• Local API only: The integration only supports the local REST API. Cloud-based control through the Airobot cloud service is not supported.
• Manual API enablement: The local REST API must be manually enabled on the thermostat before the integration can connect. It is disabled by default for security reasons.
• Firmware requirements: Only firmware version 1.8 or later is supported. Older firmware versions do not provide the local REST API.
• Heating only: The thermostat is designed for floor heating control only and does not support cooling modes.
• Optional sensors: Carbon dioxide and floor temperature sensors are only available if the corresponding hardware is installed in your thermostat model.

Troubleshooting

Removing the integration

This integration follows standard integration removal. No extra steps are required.

To remove an integration instance from Home Assistant

1. Go to Settings > Devices & services and select the integration card.
2. From the list of devices, select the integration instance you want to remove.
3. Next to the entry, select the three dots menu. Then, select Delete.

You can optionally disable the local API on the thermostat after removing the integration by navigating to Connectivity > Local API > Disable.