2025.3.4
首页 ▸ Integrations ▸

Tado

Tado集成平台用作my.tado.com网站的接口。

当前在Home Assistant中支持以下设备类型：

  • 二进制传感器 - 用于一些区域的附加信息。
  • 气候 - 用于每个Tado区域。
  • 热水器 - 用于热水器区域。
  • 存在检测
  • 传感器 - 用于一些区域的附加信息。
  • 天气 - 获取您Tado家中当前位置的当前天气信息。
  • 开关 - 控制受支持设备上的儿童锁

不支持的设备类型

新的Tado X设备不受此集成支持，它们必须通过Matter集成使用。

配置

要将 Tado integration 添加到您的 Home Assistant 实例中，请使用此 My 按钮：

Tado 可以被 Home Assistant 自动发现。如果发现了实例， 它将显示为 已发现。您可以立即进行设置。

手动配置步骤

如果没有自动发现，请不要担心！您可以设置一个 手动集成条目：

Tado恒温器是互联网连接的恒温器。在my.tado.com上存在一个非官方API，该API被他们的网站和现在的这个组件使用。

它当前支持展示当前温度、设定温度和当前操作模式。操作模式可以设置为手动、自动和关闭。如果没有用户在家，所有Tado区域将显示离家状态（仅在Tado助手模式下）。也支持手动切换家庭模式和离家模式。手动切换到自动模式仅在Tado助手模式下支持。任何Tado气候卡片都可以在这些存在模式之间切换，这会改变整个家庭的设置。

存在检测

Tado设备跟踪器使用Tado智能恒温器及其基于智能手机位置的人员存在检测。

这个跟踪器使用Tado API来确定移动设备是否在家。

默认情况下，Tado设备跟踪器将跟踪与您的家庭相关的所有已知设备。Tado应用需要启用地理位置权限才能跟踪设备。

您的设备必须至少在家一次，才能显示为在家或外出。 对Tado API进行存在信息的轮询最多每30秒进行一次。

请注意，Tado (v2) API不提供设备的GPS位置，仅提供方位，因此Home Assistant仅使用在家/不在家状态。

操作

操作 tado.set_climate_timer

您可以使用tado.set_climate_timer操作设置您的Tado气候设备，例如散热器阀门，以在设定时间段内开启。

数据属性 可选 描述
entity_id 是 字符串，实体的名称，例如climate.heating
temperature 否 字符串，需要的目标温度，例如20.5
time_period 是 时间段，增压应持续的时间段，例如01:30:00
overlay 是 重写您的默认设置。注意不要同时设置此项和时间段

操作 tado.set_water_heater_timer

您可以使用tado.set_water_heater_timer操作设置您的热水器在设定时间段内开启。

数据属性 可选 描述
entity_id 是 字符串，实体的名称，例如water_heater.hot_water
time_period 否 时间段，增压应持续的时间段，例如01:30:00
temperature 是 字符串，需要的目标温度，例如20.5

操作 tado.set_climate_temperature_offset

您可以使用tado.set_climate_temperature_offset操作设置Tado气候设备的温度偏移量。

数据属性 可选 描述
entity_id 是 字符串，实体的名称，例如climate.heating
offset 否 浮动，您希望设置的偏移量

示例：

# 示例脚本，在不指定温度的情况下设置热水器定时器
script:
  boost_heating:
    sequence:
      - action: tado.set_climate_timer
        target:
          entity_id: climate.heating
        data:
          time_period: "01:30:00"
          temperature: 25
      - action: tado.set_water_heater_timer
        target:
          entity_id: water_heater.hot_water
        data:
          time_period: "01:30:00"

# 示例自动化，根据另一个恒温器值设置温度偏移
automation:
    # 如果任一恒温器的状态变化，则触发
    triggers:
    - trigger: state
      entity_id:
        - sensor.temp_sensor_room
        - sensor.tado_temperature
    
    # 检查房间温度是否与tado恒温器读数相差超过0.5。传感器在读数出错时默认温度为房间温度(20)：
    conditions:
    - condition: template
      value_template: >
        {% set tado_temp = states('sensor.tado_temperature')|float(20) %}
        {% set room_temp = states('sensor.temp_sensor_room')|float(20) %}
        {{ (tado_temp - room_temp) | abs > 0.5 }}
    
    # 计算新的偏移量应为多少（tado温度减去房间温度再加上当前偏移值），并将其设为负值作为新的偏移量
    actions:
    - action: tado.set_climate_temperature_offset
      target:
        entity_id: climate.tado
      data:
        offset: >
          {% set tado_temp = states('sensor.tado_temperature')|float(20) %}
          {% set room_temp = states('sensor.temp_sensor_room')|float(20) %}
          {% set current_offset = state_attr('climate.tado', 'offset_celsius') %}
          {{ (-(tado_temp - room_temp) + current_offset)|round(1) }}

操作 tado.add_meter_reading

您可以使用tado.add_meter_reading操作将您的仪表读数添加到Tado Energy IQ中。通过Energy IQ，您可以跟踪您的能源消耗，并控制您的取暖费用。

数据属性 可选 描述
config_entry 否 字符串，添加仪表读数的配置项。
reading 否 整数，读数以立方米或千瓦时为单位，不带小数。

示例：

# 示例自动化，按日添加仪表读数。
automation:
    # 在指定时间触发。
    triggers:
      - trigger: time
        at: "00:00:00"

    # 将`sensor.gas_consumption`中的仪表读数添加到Tado。
    # 通过在UI模式下设置此自动化来检索您的`config_entry` ID。
    # 注意，您可能需要将读数转换为整数。
    actions:
      - action: tado.add_meter_reading
        data:
          config_entry: ef2e84b3dfc0aee85ed44ac8e8038ccf
          reading: "{{ states('sensor.gas_consumption')|int }}"