跳转到内容
ESPHome - 让智能家居更简单2026.7.0

理解 ESPHome 中的板子

板子（电路板）是您的 ESPHome 智能家居设备的基础。它作为连接电子元件的基石。板子的主要作用是为元件提供结构支撑，并促进这些元件之间的电气连接。

您可以在维基百科的”印刷电路板”页面上了解更多关于电路板的基本知识。

每块板子都有一个众所周知的名称，通常直接印在板子的某个部分。这个名称/板子类型可能因板子的类型/尺寸而位于不同位置，或者根本不存在。如果您无法在板子上或关于板子的信息中找到板子名称，那么您需要在 ESPHome Device Builder 中构建项目时使用合适的数据线连接您的板子，或者选择一个板子变体来开始构建。

如何识别您的板子

Section titled “如何识别您的板子”

  • 检查板子的每一面。您需要寻找 ESP、BK、RP、RTL、LN 或 nRF 以及其后的其他数字/字母。还有其他受支持的板子，您可以了解更多信息；对于 ESP32，请参阅 ESP32 变体。

    ESP 板子的两个相对面，显示应检查每一面以寻找印字名称。
    检查板子的每一面以寻找印字；细节可能隐藏在背面。

  • 您的板子上有文字标明名称/变体。要阅读非常小的文字，请使用放大镜，或用相机拍照后放大查看。

    板子特写，显示印制的变体名称 ESP32-S2。
    示例显示了一个 ESP32-S2 变体；板子之间的间距和连字符可能不同。

  • 或者，如果您无法在板子上找到变体信息，并且连接板子自动检测也不是选项，您可以查看购买板子的详细信息或收到的任何随附文档。

    购买收据列出了板子变体名称，旁边是 ESPHome 板子选择界面。
    显示板子变体名称的发票或收据，旁边是选择该板子的 UI。

我还没有板子

Section titled “我还没有板子”

如果您想为一个项目启动配置文件，或探索构建 ESPHome 智能家居设备的可能性，您可以启动一个空配置项目，这将创建一个空白 YAML 文件，可以在高级设置选项下找到。

创建新项目界面，高级选项已展开以到达空配置。
在创建新项目界面上展开高级选项，选择空配置。

或者，您可以选择任何板子的通用变体（如下所示：ESP32、ESP32-S2、ESP32-S3、ESP32-C3、ESP32-C6、ESP32-H2、ESP8266、RP2040/RP2350、BK72xx、RTL87xx、LN882x、nRF52 以及更多可能可用的板子变体）来开始使用并测试可能性，之后可以通过界面更改板子或在 YAML 文件中重新定义。更换板子时请谨慎。

ESPHome 界面中显示为可选择的药丸状标签的通用板子变体列表。
上面的示例显示了一些通用变体的列表。其他通用板子也可能与 ESPHome 兼容。
ESPHome 中选择板子的界面，显示示例通用板子变体，带有搜索和过滤器。
开始新项目时的板子选择视图；使用搜索和过滤器来查找变体。

要更改您在设置时选择的板子，首先需要在设备导航器菜单中找到并选择 [Board name] Platform（[板子名称] 平台）。然后在带有输入字段的中央部分，您应该会找到一个下拉菜单，允许您选择其他变体。

设备导航器，已选择板子平台，并显示用于选择另一个变体的下拉菜单。
在设备导航器中选择板子平台，然后使用下拉菜单选择另一个变体。

也可以直接编辑 YAML 文件来更改平台变体。YAML 和输入字段会相互反映，因此更改其中一个也会更改另一个。

当您从板子平台下拉菜单中选择新变体时，YAML 代码会发生变化。
当您从板子平台下拉菜单中选择新变体时，YAML 会更新。

另请参阅

Section titled “另请参阅”