Netatmo

Netatmo 集成平台是将所有与 Netatmo 相关平台集成的主要集成。

目前 Home Assistant 支持以下设备类型：

• 二进制传感器
• 按钮
• 摄像头
• 气候
• 遮阳
• 风扇
• 照明
• 传感器
• 开关
• Webhook 事件

配置

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

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

集成的额外配置

Netatmo 公共气象站的配置可以从前端进行。进入 Netatmo 集成并按 “配置”，然后为新区域设置 “区域名称”。

在对话框中，可以创建、编辑和删除公共气象传感器。对于每个区域，必须设置一个唯一的名称，以及要覆盖的区域并选择是否显示平均、最大或最小值。

要编辑现有区域，输入其名称并按照对话框进行操作。

二进制传感器

netatmo 二进制传感器平台显示 Netatmo 智能家居气象站 的连接状态。

按钮

netatmo 按钮传感器平台支持将兼容的百叶窗移动至首选位置。 并非所有遮阳设备都支持此功能，我们也无法自动确定其能力，因此这些实体默认被禁用。

摄像头

netatmo 摄像头平台使用 Netatmo 智能室内摄像头、户外摄像头 和 Netatmo 智能视频门铃 提供的信息。此集成允许您查看摄像头创建的当前实时流（例外：视频门铃）。

门铃当前不支持 Home Assistant 云链接模式（在集成中配置）。请使用 Netatmo 开发者账号。注意：如果您已经创建了 Netatmo 集成，必须将其移除并根据之前链接中的说明使用 Netatmo 开发者账号进行配置。然后，您将看到一个带有摄像头传感器的智能门铃设备。

气候

netatmo 温控器平台使用 Netatmo 智能温控器、智能调制温控器 和 Netatmo 智能散热器阀 提供的信息。此集成允许您查看当前温度并控制设定点。

遮阳

netatmo 遮阳平台支持 Bubendorff 百叶窗。

风扇

netatmo 风扇平台支持 Legrand 中央通风控制。

照明

netatmo 照明平台使用 Netatmo 智能户外摄像头 提供的信息，并需要一个活动的 webhook。此集成允许您打开/关闭泛光灯。 它进一步支持 Legrand/BTicino 调光器。

传感器

netatmo 传感器平台使用 Netatmo 智能家居气象站、Netatmo 智能室内空气质量监测器 或 Netatmo 公共气象站 提供的信息。

开关

netatmo 开关平台支持 Legrand/BTicino 开关和电源插座。

操作

设置户外摄像头照明模式

set_camera_light_mode

设置户外摄像头照明模式。

设置日程

set_schedule

设置供暖日程。

设置带结束日期和时间的预设模式

set_preset_mode_with_end_datetime

为 Netatmo 气候设备设置预设模式。预设模式必须与 Netatmo 中配置的预设模式匹配。

设置带结束日期和时间的温度

set_temperature_with_end_datetime

为 Netatmo 气候设备设置目标温度，并指定结束日期和时间。

设置带时间段的温度

set_temperature_with_time_period

为 Netatmo 气候设备设置目标温度以及适用的时间段。

清除温度设置

clear_temperature_setting

清除任何 Netatmo 气候设备的温度设置，恢复为当前预设或日程。

设置在家的人员

set_persons_home

设置一组人员为在家。人员姓名必须与 Netatmo 智能室内摄像头已知的姓名相匹配。

设置外出的人员

set_person_away

设置某个外出人员。如果没有设置人员，则将家庭标记为空。人员姓名必须与 Netatmo 智能室内摄像头已知的姓名相匹配。

（注册/取消注册）Webhook

register_webhook 和 unregister_webhook

手动注册和取消注册 webhook 的操作。

Webhook 事件

Netatmo 后端通过使用 webhook 向 Home Assistant 发送即时事件，这增强了大多数设备的响应能力，除 Netatmo 智能家居气象站、Netatmo 智能室内空气质量监测器 或 Netatmo 公共气象站 外。

为了能够接收来自 Netatmo 的事件，您的 Home Assistant 实例需要通过 443 端口从网络中可访问。您可以使用 Nabu Casa 账户或 Duck DNS（Home Assistant 指令）来实现。您还需要在 Home Assistant 的 配置 中配置外部 URL。

来自 Netatmo 的事件将在 Home Assistant 中作为 netatmo_event 事件可用，并发送其数据。您可以使用这些事件触发自动化。

您可以在 官方 Netatmo API 文档 中找到可用的事件类型。

示例：

# 基于 webhook 的 Netatmo 事件示例自动化
- alias: "Netatmo 事件示例"
  description: "计数所有由 Netatmo API 推送的事件"
  triggers:
    - trigger: event
      event_type: netatmo_event
  actions:
    - action: counter.increment
      entity_id: counter.event_counter

示例：

# Netatmo Welcome 的示例自动化
- alias: "家中检测到运动"
  description: "家中检测到运动"
  triggers:
    - trigger: event
      event_type: netatmo_event
      event_data:
        type: movement
  actions:
    - action: persistent_notification.create
      data:
        message: >
          {{ trigger.event.data["data"]["message"] }}  
          在 {{ trigger.event.data["data"]["home_name"] }}
        title: "Netatmo 事件"

示例：

# Netatmo Presence 的示例自动化
- alias: "家中检测到运动"
  description: "家中检测到运动"
  triggers:
    - trigger: event
      event_type: netatmo_event
      event_data:
        type: human # 其他可能的类型：animal, vehicle
  actions:
    - action: persistent_notification.create
      data:
        message: >
          {{ trigger.event.data["data"]["message"] }}  
          在 {{ trigger.event.data["data"]["home_name"] }}
        title: Netatmo 事件

示例：

# 示例自动化
- alias: "门或窗打开或有运动"
  description: "通知哪个门或窗打开或移动"
  triggers:
    - trigger: event
      event_type: netatmo_event
      event_data:
        type: tag_open
    - trigger: event
      event_type: netatmo_event
      event_data:
        type: tag_big_move
    - trigger: event
      event_type: netatmo_event
      event_data:
        type: tag_small_move
  actions:
    - action: persistent_notification.create
      data:
        message: >
          {{ trigger.event.data["data"]["message"] }}
        title: "Netatmo 事件"

使用自己客户端 ID 的开发/测试

要使用自己的开发凭证启用 Netatmo 集成，您必须在 Netatmo 开发者页面 中声明一个新应用程序。

使用您常规 Netatmo 账户的用户名和密码登录。

查看 应用程序凭证 以获取有关如何配置您的 Client ID 和 Client Secret 的说明，然后通过集成页面启用 Netatmo。

菜单：设置 > 设备与服务。

单击 + 符号以添加集成，然后单击 Netatmo。 完成配置流程后，Netatmo 集成将可用。

故障排除

接收事件

要确认您的 Home Assistant 实例是否通过 webhook 接收事件，您可以在 开发者工具 -> 事件 中监听 netatmo_event。

照明

如果灯光显示为不可用，通常问题是 webhook 被 Netatmo 禁止。要解决此问题，请 取消注册 webhook，前往 Netatmo 开发者页面 以解禁您的 webhook，然后 注册 webhook。