分享 ESPHome 设备

我们在 ESPHome 中添加了配置选项，使创建、配置、安装和分发运行 ESPHome 的设备更加容易。

“模板”配置的任何部分都不应包含对密钥的引用，也不应预先设置密码。ESPHome 让最终用户能够在他们将设备纳入自己的 ESPHome 仪表板后自行添加这些信息。

示例配置

# 这些替换允许最终用户覆盖某些值
substitutions:
  name: "project-template"
  friendly_name: "Project Template"

esphome:
  name: "${name}"
  # 友好名称在 Home Assistant 的适当位置使用
  friendly_name: "${friendly_name}"
  # 自动将 MAC 地址添加到名称中
  # 这样你就可以为所有设备使用单一固件
  name_add_mac_suffix: true

  # 这将允许（未来的）项目识别、
  # 配置和更新。
  project:
    name: esphome.project-template
    version: "1.0"

# 通过串口和 API 获取设备日志
logger:

# API 是仪表板导入的必需条件
api:

# OTA 是无线更新的必需条件
ota:
  platform: esphome

# 这应指向此 yaml 文件的公开位置
dashboard_import:
  package_import_url: github://esphome/esphome-project-template/project-template-esp32.yaml@v6
  import_full_config: false # or true

wifi:
  # 设置一个 Wi-Fi 接入点
  ap:
    password: "12345678"

# 结合 `ap`，这允许用户
# 向设备提供 Wi-Fi 凭据
captive_portal:

# 设置蓝牙 LE（仅限 ESP32）以允许用户
# 向设备提供 Wi-Fi 凭据
esp32_improv:
  authorizer: none

# 设置通过串行客户端的 improv 进行 Wi-Fi 配置
improv_serial:
  next_url: https://example.com/project-template/manual?ip={{ip_address}}&name={{device_name}}&version={{esphome_version}}

分享 ESPHome 设备

示例配置

相关文档