跳转到内容

通过串口的 Improv

ESPHome 中的 improv_serial 组件实现了开源 Improv 标准 用于通过串行连接(例如 USB)在 ESPHome 设备上配置 Wi-Fi。

improv_serial 组件需要配置串行 logger

improv_serial 组件将在可用时使用项目名称和版本,而不是 ESPHome 的版本。

# 示例配置条目
wifi:
# ...
improv_serial:
  • next_url (可选, url): 使用 improv 设置凭据后可用于转发用户的 URL。

可以在 URL 中插入替换变量,例如项目名称和版本,还有一些特殊替换 可以由 ESPHome 在双大括号 {{ }} 中执行:

  • device_name: 这将替换设备名称(包括 MAC 地址后缀)。
  • ip_address: 这将替换设备的 IP 地址。
  • esphome_version: 这将替换设备上运行的 ESPHome 版本。
# 示例 next_url
improv_serial:
next_url: http://example.com/?device_name={{device_name}}&ip_address={{ip_address}}&esphome_version={{esphome_version}}