目录
1. 安装 ESPHome 仪表板
2. 仪表板界面设置
3. 添加一些（基本）功能
4. 将您的设备连接到家庭助理
5. 总结
我们将介绍如何使用 ESPHome 仪表板在设备上安装 ESPHome，该仪表板作为 Home Assistant 插件安装。
但首先，这里快速介绍一下 ESPHome 的工作原理：ESPHome 是一个旨在让您的 ESP 板管理尽可能简单的工具。它读取 YAML 配置文件并创建安装在您的 ESP 设备上的自定义固件。ESPHome 配置中添加的设备或传感器将自动显示在 Home Assistant 的 UI 中。
1. 安装 ESPHome 仪表板
ESPHome Dashboard 可以作为 Home Assistant 插件安装，您可以在 Supervisor 面板的插件商店中找到该插件。使用以下按钮打开它，然后单击安装：
如果您没有添加官方的 ESPHome 附加存储库，您可以使用此链接添加：
GitHub - esphome/home-assistant-addon: ESPHome Hass.io addon files
如果您有存储库，则可以在此处链接安装插件：
Link to Add-on: Dashboard – My Home Assistant
之后，稍等片刻，直到安装完成（这可能需要一段时间）。单击“开始”，然后单击“打开 Web UI”。如果您看到“502：Bad Gateway”，它正在启动，您可以在几秒钟后刷新页面。
您现在应该会看到一个很好的介绍向导，它将引导您完成创建您的第一个配置。
该向导将指导您创建第一个配置，并根据您的浏览器将其安装到您的 ESP 设备上。您将需要命名您的配置并输入您的无线网络设置，以便 ESP 设备可以联机并可以与 Home Assistant 通信。
笔记
设置新的 ESPHome 设备最困难的部分是初始安装。安装要求您的 ESP 设备通过电缆连接到计算机。以后的更新可以无线安装。
有关进行首次连接的指导，请参阅物理连接到您的设备
2. 仪表板界面设置
假设您使用向导创建了第一个配置文件，让我们快速浏览一下 ESPHome Dashboard 界面
在首页上，您将看到您创建的节点的所有配置。对于每个文件，您可以执行一些基本操作：
-
更新：如果设备未安装当前运行的相同 ESPHome 版本，则会显示此按钮。
-
编辑：这将打开配置编辑器。
-
LOGS：使用此命令，您可以查看节点输出的所有日志。如果连接了 USB 设备，您可以选择使用串行连接。否则它将使用内置的 OTA 日志。
-
溢出菜单：这是一个下拉菜单，可让您执行更多操作。
-
Validate：这将验证配置文件。
-
安装：打开安装对话框。
-
Clean Build Files：这将删除所有生成的构建文件，并且是一个安全的操作。有时旧文件不会被删除，以后可能会导致编译问题。
-
删除：这将删除配置文件。
-
ESPHome 的配置文件可以在
现在继续使用设备指南之一来扩展您的配置。
3. 添加一些（基本）功能
所以现在你应该有一个名为/config/esphome/livingroom.yaml（或类似）的文件。打开该文件（在任何文本编辑器中）并添加一个简单的 GPIO 开关 到配置中，如下所示：
switch:
- platform: gpio
name: "Living Room Dehumidifier"
pin: 5
我采用的硬件是esp8266，板载灯是gpio2（D4)
esphome:
name: nodemcu
esp8266:
board: nodemcuv2
# Enable logging
logger:
# Enable Home Assistant API
api:
ota:
password: "73260d7b7227a21d2f841e7afb746e84"
wifi:
ssid: "J09 502"
password: "qwertyuiop111"
# Enable fallback hotspot (captive portal) in case wifi connection fails
ap:
ssid: "Nodemcu Fallback Hotspot"
password: "2RzZYd7gW4hb"
captive_portal:
# Enable switch gpio2(D4)
switch:
- platform: gpio
name: "Living Room Dehumidifier"
pin: 2
第一次握手需要数据线下载，下载软件是ESPHome-Flasher-1.3.0-Windows-x86，后期更改代码直接远程OTA
在上面的示例中，我们只是添加了一个名为“客厅除湿机”的开关（可以真正控制任何东西，例如灯）并连接到引脚GPIO2。
4. 将您的设备连接到家庭助理
一旦您的配置安装在您的 ESP 设备上并在线，它将被 Home Assistant 自动发现并提供在您的集成屏幕上进行设置：
Link to Integrations: Add integration – My Home Assistant
或者，您可以在 Home Assistant 集成页面上手动添加设备。点击“添加集成”按钮（右下角），搜索esphome，输入主机名，例如：“
太棒了！您现在已成功设置您的第一个 ESPHome 项目并将您的第一个 ESPHome 自定义固件安装到您的节点。您还学习了如何通过配置文件启用一些基本组件。
所以现在是查看组件索引的好时机。希望你能找到所有的传感器/输出/……你需要的。如果您有任何问题或想要新功能，请在GitHub 问题跟踪器上创建新问题或在Discord 聊天中找到我们 （也请务必阅读常见问题解答）。
5. 总结
本文学习了ESPHome 和 Home Assistant点灯握手，后期会分享更多有趣物联网的操作从而实现对外部世界进行感知，充分认识这个有机与无机的环境，科学地合理地进行创作和发挥效益，然后为人类社会发展贡献一点微薄之力。
参考文献：开始使用 ESPHome
