为 ESPHome 提供 支持

ESPHome 拥有一个非常棒且活跃的社区，他们热爱创建和分享项目。 您可以申请让您的项目获得 为 ESPHome 提供 支持 的认可印章。 这确保了您的项目是由 ESPHome 驱动的，并保证用户具备一定的可定制性。

要求

您的项目必须满足一系列要求。这些要求可能会根据其设计而有所不同。具体要求如下：

对于使用 Wi-Fi 的项目

Wi-Fi 非常常见，但需要配置 SSID 和密码。 因此，为了方便最终用户的设置，您的配置必须包括：

• esp32_improv，如 Improv via BLE 中所述
• improv_serial，如 Improv via Serial 中所述，如果提供 USB 连接（推荐）

请注意，仅提供物理/有线以太网端口的项目不需要这些要求。

对于所有项目

• 您的项目由 ESPHome 驱动（作为其固件运行）

• 您的项目由 ESP32 或 支持的 ESP32 变体（如 S2、S3、C3 等）驱动

• 您的 ESPHome 配置是开源的，可供最终用户修改和更新

• 如果您的项目销售预制的设备，用户应该能够应用更新

• 所有使用的组件/平台都必须指定 id，以便用户可以轻松引用， 扩展 和/或 移除 配置变量，如果他们选择“接管”

• 您的项目支持通过 ESPHome 的 dashboard_import 功能进行采用（参见 分享）。具体要求如下：

  • 不包含对秘密或密码的引用
  • 网络配置必须假设默认值（无静态 IP 或 DNS 配置）
  • 配置 必须 有效的、可编译的，并且在采用后 无需任何用户更改 即可成功运行。
  • 仅在满足上述条件的情况下，才允许在 YAML 中使用远程包。

• 您的产品名称不能包含 “ESPHome"，除非以 “for ESPHome” 结尾

当您的项目满足要求时

• 在我们的 esphome-devices 仓库中创建一个新的 pull request，以 在 设备网站 上添加您的设备。我们将审查并合并这个 PR，一旦确认您的项目满足上述所有要求。

• 申请使用标志的权限，通过电子邮件 esphome@openhomefoundation.org 发送申请——请包含您创建的 PR 的链接（如上所述），以便我们可以将您的申请与您的 PR 和设备关联起来。

• 我们将审查您的申请并通过电子邮件回复您。如果我们发现您的项目不完全符合上述一个或多个要求，我们可能会要求您对项目进行更改。如果一切顺利，我们将批准您的项目。

标志

您的项目获得批准后，您可以在您的产品及其包装上使用这些标志。