跳转到内容

Made for ESPHome

ESPHome 拥有一个热爱创建和分享项目的精彩活跃社区。您可以申请让您的项目获得 Made for ESPHome 认证印章。这确保您的项目由 ESPHome 驱动,并保证用户享有最低级别的可定制性。

您的项目必须满足一些要求。这些要求可能因其设计而异。它们是:

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

  • esp32_improv,如 ESP32 Improv 中所述
  • improv_serial,如 Improv Serial 中所述,如果有 USB 连接可用(推荐)

请注意,对于仅提供物理/有线以太网端口进行连接的项目,这些不是必需的。

  • 您的项目由 ESPHome 驱动(运行 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 和设备关联起来。

  • 我们将审核您的申请并回复您的邮件。如果我们发现您的项目不完全符合上述一个或多个要求,我们可能会要求您对项目进行更改。如果我们发现一切正常,我们将批准您的项目。

您的项目获得批准后,您可以在您的产品和/或其包装上使用这些徽标。

Made with ESPHome badge - black on white

Made with ESPHome 黑底白字 (svg, png)

Made with ESPHome badge - white on black

Made with ESPHome 白底黑字 (svg, png)

Made with ESPHome badge - black on transparent

Made with ESPHome 黑字透明背景 (svg, png)

Made with ESPHome badge - white on transparent

Made with ESPHome 白字透明背景 (svg, png)