Made for ESPHome
ESPHome 拥有一个精彩而活跃的社区,大家热爱创建和分享项目。
你可以申请你的项目获得 Made for ESPHome 认可徽章。
这可以确保你的项目由 ESPHome 驱动,并向用户保证最低限度的可定制性。
你的项目必须满足一系列要求。具体可能因设计而异。包括:
对于使用 Wi-Fi 的项目
Section titled “对于使用 Wi-Fi 的项目”Wi-Fi 非常常见,但需要配置 SSID 和密码。 因此,为了便于最终用户完成配置,你的配置必须包含:
- 如 Esp32 Improv 中所述的
esp32_improv - 如果提供 USB 连接(推荐),如 Improv Serial 中所述的
improv_serial
请注意,对于仅提供物理/有线以太网端口进行连接的项目,不要求这些。
对于所有项目
Section titled “对于所有项目”-
你的项目由 ESPHome 驱动(以 ESPHome 作为其固件运行)
-
你的项目由 ESP32 或 支持的 ESP32 变体(如 S2、S3、C3 等)驱动
-
你的 ESPHome 配置是开源的,可供最终用户修改/更新
-
如果你的项目销售成品设备,用户应能够应用更新
-
你的项目支持通过 ESPHome 的
dashboard_import功能进行采用(请参阅 分享)。特别是:- 没有任何对密钥或密码的引用
- 网络配置必须采用默认设置(不配置静态 IP 或 DNS)
- 配置必须有效,并且在采用之后无需用户做任何更改即可编译并成功运行。
- 只有在满足上述条件的情况下,才允许在 YAML 中使用远程包。
-
你的产品名称不能包含“ESPHome”,除非以“for ESPHome”结尾
当你的项目满足要求时
Section titled “当你的项目满足要求时”-
在我们的 devices.esphome.io 仓库中创建一个新的拉取请求(pull request),将你的设备添加到 设备网站。我们会在确认你的项目满足上述所有要求后审查并合并此 PR。
-
通过发送邮件至 esphome@openhomefoundation.org 申请使用徽标的许可 — 请附上你创建的 PR 的链接(如上所述), 以便我们将你的申请与你的 PR 和(多个)设备关联起来。
-
我们将审查你的申请并通过邮件回复。如果我们发现你的项目不完全满足上述一项或多项要求,我们可能会要求你对项目进行修改。 如果一切符合要求,我们将批准你的项目。
项目获批后,你可以在产品及其包装上使用这些徽标。