ESPHome 是一款专为智能家居设计的开源固件生成框架，支持 ESP32 和 ESP8266 微控制器。它的核心目标是让用户无需编写复杂的代码，就能快速创建自定义的智能硬件。

ESPHome 只需要一个 简单的 YAML 配置文件，就可以让 ESP8266 自动生成固件，并原生接入 Home Assistant，无需手动实现 MQTT 通信逻辑。

换句话说，ESPHome 可以让你的 ESP8266 轻松变成一个 原生支持 Home Assistant 的智能设备。

本文将以一个简单的 ESP8266 继电器灯控项目为例，详细介绍如何使用 ESPHome 将 ESP8266 接入 Home Assistant，并实现无线升级（OTA）功能。

安装 ESPHome

在 Home Assistant 中，进入：Settings → Add-ons → Add-on Store 搜索并安装 ESPHome 插件。

 安装完成后，勾选 Show in sidebar 以便在侧边栏中快速访问。

创建 ESP8266 设备

安装完成后，进入 ESPHome 插件界面，点击 + New Device 创建一个新的 ESP8266 设备。

输入：

• 设备名称（例如 study_room_light）
• WiFi 名称
• WiFi 密码

选择设备类型

创建完成后，ESPHome 会自动生成一个设备配置文件：

配置灯开关

点击 Edit 编辑 YAML 配置文件，并添加继电器控制配置：

switch:
  - platform: gpio
    pin: GPIO4
    name: "书房灯"

• platform: gpio 表示通过 GPIO 控制设备

• pin: GPIO4 继电器连接的引脚

• name 在 Home Assistant 中显示的设备名称

保存配置后，点击右上角 Install，开始编译并安装固件。

首次烧录固件

第一次烧录需要使用 USB 数据线将 ESP8266 连接到电脑。在安装方式中选择：Plug into this computer。

随后按照提示操作：

• 点击 Download project 下载编译好的固件
• 点击 Open ESPHome Web

浏览器会跳转到 ESPHome Web 页面，选择 ESP8266 对应的 串口端口，然后上传固件并烧录到设备中。

OTA 无线升级

首次烧录完成后，后续升级就不需要再连接 USB 线了。

只需在 ESPHome 中选择：Wirelessly

ESPHome 会通过 WiFi 将新固件上传到 ESP8266，实现 无线升级（OTA）。

添加ESPHome集成

完成设备烧录后，返回 Home Assistant 主界面。进入：Settings → Devices & Services

点击右下角的 Add Integration 按钮，在弹出框中搜索并选择 ESPHome。

可以看到刚才创建的esp8266设备已经被自动发现了，点击它并Submit。

接下来就可以在概览页看到这个新的灯实体了。