跳转到内容

Made for ESPHome

ESPHome 拥有一个精彩而活跃的社区,大家热爱创建和分享项目。 你可以申请你的项目获得 Made for ESPHome 认可徽章。 这可以确保你的项目由 ESPHome 驱动,并向用户保证最低限度的可定制性。

你的项目必须满足一系列要求。具体可能因设计而异。包括:

Wi-Fi 非常常见,但需要配置 SSID 和密码。 因此,为了便于最终用户完成配置,你的配置必须包含:

  • 如 Esp32 Improv 中所述的 esp32_improv
  • 如果提供 USB 连接(推荐),如 Improv Serial 中所述的 improv_serial

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

  • 你的项目由 ESPHome 驱动(以 ESPHome 作为其固件运行)

  • 你的项目由 ESP32 或 支持的 ESP32 变体(如 S2、S3、C3 等)驱动

  • 你的 ESPHome 配置是开源的,可供最终用户修改/更新

  • 如果你的项目销售成品设备,用户应能够应用更新

  • 使用的所有组件/平台都必须指定 id,以便用户方便引用、扩展 和/或删除 配置变量,如果他们选择 “接管控制”

  • 你的项目支持通过 ESPHome 的 dashboard_import 功能进行采用(请参阅 分享)。特别是:

    • 没有任何对密钥或密码的引用
    • 网络配置必须采用默认设置(不配置静态 IP 或 DNS)
    • 配置必须有效,并且在采用之后无需用户做任何更改即可编译并成功运行。
    • 只有在满足上述条件的情况下,才允许在 YAML 中使用远程包。
  • 你的产品名称不能包含“ESPHome”,除非以“for ESPHome”结尾

  • 在我们的 devices.esphome.io 仓库中创建一个新的拉取请求(pull request),将你的设备添加到 设备网站。我们会在确认你的项目满足上述所有要求后审查并合并此 PR。

  • 通过发送邮件至 esphome@openhomefoundation.org 申请使用徽标的许可 — 请附上你创建的 PR 的链接(如上所述), 以便我们将你的申请与你的 PR 和(多个)设备关联起来。

  • 我们将审查你的申请并通过邮件回复。如果我们发现你的项目不完全满足上述一项或多项要求,我们可能会要求你对项目进行修改。 如果一切符合要求,我们将批准你的项目。

项目获批后,你可以在产品及其包装上使用这些徽标。

Made with ESPHome 徽标 - 黑底白字

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

Made with ESPHome 徽标 - 白底黑字

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

Made with ESPHome 徽标 - 黑底透明背景

Made with ESPHome 黑底透明背景(svg、png)

Made with ESPHome 徽标 - 白底透明背景

Made with ESPHome 白底透明背景(svg、png)