ESPHome

此集成允许 ESPHome 设备通过 原生 ESPHome API 直接连接到 Home Assistant。

配置

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

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

Home Assistant 操作

ESPHome 设备可以执行任何 Home Assistant 操作。此功能默认未启用，但可以在每个设备的选项流中打开。

选项

ESPHome 的选项可以通过用户界面设置，具体步骤如下：

• 浏览到您的 Home Assistant 实例。
• 转到 设置 > 设备与服务。
• 如果配置了多个 ESPHome 实例，请选择您想配置的实例。
• 选择集成，然后选择 配置。

实体命名和 ID

ESPHome 根据 ESPHome 设备的配置使用不同的命名和实体 ID 规则。建议在 ESPHome configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 中设置 friendly_name 以利用更新的命名结构，这与 Home Assistant 命名标准一致，并使辨别相似设备变得更容易。当 configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 中未设置 friendly_name 时，适用旧的命名规则。

友好命名

• 实体名称是友好名称和组件名称的组合
• 实体 ID 是从实体名称派生的，设备名称被添加在前面

示例：

esphome:
   name: "livingroomdesk"
   friendly_name: "客厅桌子"

sensor:
   name: "温度"

该实体将命名为 客厅桌子 温度，并默认为 sensor.livingroomdesk_temperature 的实体 ID。

旧命名

• 实体名称是组件名称
• 设备名称不添加到实体名称前
• 实体 ID 完全由实体名称派生

示例：

esphome:
   name: "livingroomdesk"

sensor:
   name: "温度"

该实体将命名为 温度，并默认为 sensor.temperature 的实体_id。

从设备获取日志

1. 要让设备将日志发送到 Home Assistant，请在 选项流 中启用 Subscribe to logs from the device。

   • 它们在 homeassistant.components.esphome 日志记录器下以相同级别记录。

2. 要调整日志记录级别，有两个选项：

   • 启用 调试日志，

   • 或使用 开发者工具 调用 logger.set_level 操作以指定所需级别：

     action: logger.set_level
     data:
       homeassistant.components.esphome: debug