ESPHome 教程用一个 YAML 文件把 ESP32 变成会自己开风扇的气象站【免费下载链接】esphomeESPHome is a system to control your ESP32, ESP8266, BK72xx, RP2040 by simple yet powerful configuration files and control them remotely through Home Automation systems.项目地址: https://gitcode.com/GitHub_Trending/es/esphomeESPHome 是一个面向 ESP32、ESP8266、RP2040 等开发板的开源固件开发系统你只写一份 YAML 配置文件它就自动完成代码生成、编译、烧录和 OTA 升级最终把设备接入 Home Assistant 之类的智能家居平台。这篇 ESPHome 教程从一个马上能动手的小项目讲起把书桌上一块吃灰的 ESP32 开发板和一颗 BMP280 气压传感器改造成能远程看温湿度、天热自动开风扇的小气象站。全文按选型 → 工作流 → 完整实操 → 踩坑的顺序展开跟着做就能跑通。先把路选对ESPHome 和 Arduino、MicroPython、商业网关有什么区别同样是让 ESP32 干活常见路径其实有四条。下面这张表能帮你快速对号入座方案上手难度优点代价适合谁裸机 ArduinoC高自由度高、性能可控每个功能都手写WiFi、OTA、上报都要自己拼需要极致性能或复杂底层逻辑的人MicroPython中语法简单、可现场调试运行时代价大外设生态零散重启后脚本行为要自己保证快速原型、临时实验商业智能网关/涂鸦方案低开箱即用绑定厂商生态、数据上云、硬件不可替换不想碰任何代码的用户ESPHome低中声明式配置、组件生态全、OTA/HA 集成开箱即用强绑定 Home Assistant 生态纯 C 深度定制不方便家庭自动化玩家、想批量部署小设备的人一句话总结如果你的目标是家里多几个能远程管的设备且愿意用 Home AssistantESPHome 基本是最短路径如果你要做电机闭环控制、音频 DSP 这类重逻辑项目还是直接写 C 更踏实。看一眼主线一份 YAML 是怎么变成固件的动手前先知道 ESPHome 背后在做什么踩坑时心里才有数。整个流程可以概括为五步写配置在*.yaml里声明设备型号、WiFi、传感器、开关校验esphome/config.py 解析 YAMLesphome/config_validation.py 做类型和引脚合法性检查写错会直接报错而不是编译到一半才发现生成 Cesphome/codegen.py 按你的配置为每个组件拼出main.cpp和各组件初始化代码——你不需要碰这些生成的文件编译底层交给 PlatformIO / ESP-IDF 工具链实现见 esphome/build_gen/首次会拉取 SDK之后增量编译很快烧录 / OTA / 远程管理第一次用 USB 烧录之后通过ota组件远程刷固件api组件让 Home Assistant 发现并控制设备。ESPHome 从 YAML 配置到固件部署的完整流程图注意一点配置、生成、编译是一个命令串起来的后面实操里你会只用esphome run一条命令走完前四步。从零跑通完整设备气象站 自动风扇材料清单ESP32 开发板一块DevKit 系列均可BMP280 传感器模块I2C 接口测气压/温度5V 继电器模块一个控制小风扇USB 数据线 一个 USB 供电口接线BMP280 是 I2C 两线制继电器是高电平触发BMP280ESP32继电器ESP32GNDGNDINGPIO5VCC3V3VCC / GND5V / GNDSDAGPIO21SCLGPIO22提醒继电器控制的是风扇的市电/5V 回路接线前先断电GPIO5 只是发号施令的脚别直接拿它当电源。第 1 步装环境ESPHome 是 Python 项目环境搭建两条命令git clone https://gitcode.com/GitHub_Trending/es/esphome cd esphome ./script/setupscript/setup会自动建虚拟环境并装好全部依赖依赖清单在 pyproject.toml 和 requirements.txt。装完后记得激活虚拟环境之后所有esphome命令都在这个环境里执行。第 2 步写配置新建weather_station.yaml完整内容如下每一段都注释了作用esphome: name: weather-station # 设备名会出现在 HA 和日志里 esp32: board: esp32dev # 板子型号决定 Flash/分区策略 framework: type: arduino # 用 Arduino 框架组件兼容性最好 wifi: ssid: 你的WiFi名 password: 你的WiFi密码 # 连不上网时自动重启重试避免设备卡死 reboot_timeout: 5min api: # 对接 Home Assistant 的通道 logger: # 串口日志排错主力 level: INFO i2c: # 启用 I2C 总线BMP280 挂在上面 sda: GPIO21 scl: GPIO22 sensor: - platform: bmp280 # 组件目录esphome/components/bmp280/ address: 0x76 temperature: name: 客厅温度 # 阈值联动超过 30℃ 开风扇低于 28℃ 关风扇双阈值天然防抖 on_threshold_crossed_above: threshold: 30.0 then: - switch.turn_on: fan_relay on_threshold_crossed_below: threshold: 28.0 then: - switch.turn_off: fan_relay pressure: name: 气压 switch: - platform: gpio # 组件目录esphome/components/gpio/switch/ id: fan_relay name: 风扇继电器 pin: GPIO5 inverted: false # 如果你的继电器模块是低电平触发改为 true几个新手常问的点为什么framework写arduino而不是esp-idf绝大多数现成组件传感器、LED、音频都优先支持 Arduino 框架新手没理由冒风险。on_threshold_crossed_above是什么它是 sensor 平台内置的自动化动作底层在 esphome/automation.py 统一调度不用自己写if (x 30)的逻辑。inverted: false是干什么的不少继电器模块要低电平才吸合这个开关就是干这个的接反了现象是风扇常开。第 3 步校验 编译 烧录# 只校验不编译检查最快 esphome config weather_station.yaml # 一条命令生成代码 → 编译 → 烧录首次会下载工具链耐心等 esphome run weather_station.yaml看到OTA successful/Hard reset via esphome之类的字样就说明烧录成功。ESP32 第一次烧录后串口可能被占用拔掉 USB 再插上让它重启。第 4 步验证打开 Home Assistant设备页应出现weather-station传感器实体带数值在 HA 里手动切一下风扇继电器开关听继电器动作把风扇出风口怼近传感器或哈口气等温度爬到 30℃ 以上观察风扇是否自动启动——这就是联动生效了。想确认 I2C 上到底挂了什么芯片可以临时加一个esphome/components/i2c/支持的i2c.scan: true日志里会打印扫描结果。组件生态什么时候用现成的什么时候自己写ESPHome 的全部能力都放在 esphome/components/ 下每个子目录就是一个组件结构高度统一Python 文件如__init__.py、sensor.py定义 YAML 里能写哪些字段、字段什么类型、怎么把配置翻译成 C 代码C 文件.cpp/.h真正的硬件驱动和运行时逻辑编译进固件。以 BMP280 为例它的组件目录只有 esphome/components/bmp280/ 两个 Python 文件——因为底层寄存器操作复用了bmp280_base等公共部分。这正是配置驱动的含义你写的每个字段都对应某段 Python 校验 某段 C 行为。用现成组件的边界esphome/components/里目前有上千个传感器、执行器、通信协议组件I2C/SPI/UART/Modbus/MQTT/蓝牙都有家庭场景 95% 的硬件能直接命中。需要自己写的场景私有协议芯片、厂商没开源的模块。这时两条路YAML 内联custom在配置文件里直接嵌 C适合只此一台的临时方案custom_components/目录仿照现成组件写一套__init__.py C框架的注册、校验、代码生成机制由 esphome/components/custom/ 统一提供写好后可以在多台设备间复用。经验建议先全局搜esphome/components/里有没有近似的组件真有缺口再动刀写 C。进阶OTA 升级、深睡省电、多设备联动OTA 远程升级api组件已经内置了 OTA 通道实现见 esphome/components/ota/按平台切换 arduino/esp-idf 后端固件带 RSA 签名防篡改。升级方式在 HA 的设备 → 固件更新卡片点更新或命令行esphome run weather_station.yaml后会自动走 OTA设备在线时不需要 USB。注意改了wifi、esp32框架类型这类骨架字段后OTA 可能失败此时必须 USB 兜底刷一次。深睡省电电池供电设备可以加deep_sleep组件典型用法是睡 55 分钟、醒 5 分钟采一次数据deep_sleep: run_duration: 5min sleep_duration: 55min # 唤醒后上报一次然后继续睡代价是设备离线时间变长实时控制类设备别用。多设备联动单设备内联动用if 条件如上例的阈值跨设备联动交给 Home Assistant 的 automationESPHome 只负责上报和执行。比如任何一台设备报温度 30℃ → 所有房间的风扇开启在 HA 里写一条规则即可比在每台设备上抄一份逻辑干净得多。踩坑实录这三类问题你大概率会遇到1. WiFi 连上又掉、反复重启按顺序排查供电不足用电脑 USB 口或 5V/2A 电源劣质充电宝/线是头号嫌疑power_save_mode相关的驱动问题部分廉价 AP 下省电模式会掉线可先设power_save_mode: none观察加reboot_timeout: 5min让卡住的设备 5 分钟无网就自愈重启——生产环境强烈建议保留这个配置。2. 编译报 Flash 超限section .text will not fit三个立竿见影的办法砍组件每多一个组件多一份运行时web_server、mqtt、api同时开是很常见的凶手组合按实际需要留换分区表在esp32下用partition_table指到小应用分区如min_spiffs或给 app 分区扩容构建参数build_flags里加-Os相关优化项或在platformio_options里调整board_build.partitions让编译产物更紧凑。3. 传感器数据乱跳、漂移先在filters里加sliding_window_moving_average窗口 5 左右平滑噪声用lambda过滤物理上不可能出现的值比如温度 -20 或 80 直接丢弃数值整体偏了用offset单位换算用lambdaI2C 总线同时挂多个器件时检查地址是否冲突i2c.scan会列出来。适合谁以及它往哪走适合已经或打算用 Home Assistant 的人手里有一堆 ESP32/ESP8266/RP2040 开发板和传感器模块、想做批量家庭设备的玩家想给老家电加个遥控开关继电器 任意 220V 负载的极客。不适合需要毫秒级实时控制的产线设备、要跑大模型推理/图像处理的边缘盒子、必须私有化且不依赖任何生态的封闭产品。从仓库现状看ESPHome 的演进方向也挺清楚平台从 ESP32/ESP8266 扩展到 BK72xx、RP2040、ln882x 等新芯片组件生态持续膨胀毫米波雷达、激光雷达、各种新型显示驱动都是近半年新面孔与 Home Assistant 的边界继续加深provisioning、key_provider 这类配网 安全组件正在补齐。对新手来说它的核心承诺没有变把写固件变成填配置让你把时间花在设备该干什么上而不是寄存器怎么写上。【免费下载链接】esphomeESPHome is a system to control your ESP32, ESP8266, BK72xx, RP2040 by simple yet powerful configuration files and control them remotely through Home Automation systems.项目地址: https://gitcode.com/GitHub_Trending/es/esphome创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 ESPHome 教程：用一个 YAML 文件，把 ESP32 变成会自己开风扇的气象站
ESPHome 教程用一个 YAML 文件把 ESP32 变成会自己开风扇的气象站【免费下载链接】esphomeESPHome is a system to control your ESP32, ESP8266, BK72xx, RP2040 by simple yet powerful configuration files and control them remotely through Home Automation systems.项目地址: https://gitcode.com/GitHub_Trending/es/esphomeESPHome 是一个面向 ESP32、ESP8266、RP2040 等开发板的开源固件开发系统你只写一份 YAML 配置文件它就自动完成代码生成、编译、烧录和 OTA 升级最终把设备接入 Home Assistant 之类的智能家居平台。这篇 ESPHome 教程从一个马上能动手的小项目讲起把书桌上一块吃灰的 ESP32 开发板和一颗 BMP280 气压传感器改造成能远程看温湿度、天热自动开风扇的小气象站。全文按选型 → 工作流 → 完整实操 → 踩坑的顺序展开跟着做就能跑通。先把路选对ESPHome 和 Arduino、MicroPython、商业网关有什么区别同样是让 ESP32 干活常见路径其实有四条。下面这张表能帮你快速对号入座方案上手难度优点代价适合谁裸机 ArduinoC高自由度高、性能可控每个功能都手写WiFi、OTA、上报都要自己拼需要极致性能或复杂底层逻辑的人MicroPython中语法简单、可现场调试运行时代价大外设生态零散重启后脚本行为要自己保证快速原型、临时实验商业智能网关/涂鸦方案低开箱即用绑定厂商生态、数据上云、硬件不可替换不想碰任何代码的用户ESPHome低中声明式配置、组件生态全、OTA/HA 集成开箱即用强绑定 Home Assistant 生态纯 C 深度定制不方便家庭自动化玩家、想批量部署小设备的人一句话总结如果你的目标是家里多几个能远程管的设备且愿意用 Home AssistantESPHome 基本是最短路径如果你要做电机闭环控制、音频 DSP 这类重逻辑项目还是直接写 C 更踏实。看一眼主线一份 YAML 是怎么变成固件的动手前先知道 ESPHome 背后在做什么踩坑时心里才有数。整个流程可以概括为五步写配置在*.yaml里声明设备型号、WiFi、传感器、开关校验esphome/config.py 解析 YAMLesphome/config_validation.py 做类型和引脚合法性检查写错会直接报错而不是编译到一半才发现生成 Cesphome/codegen.py 按你的配置为每个组件拼出main.cpp和各组件初始化代码——你不需要碰这些生成的文件编译底层交给 PlatformIO / ESP-IDF 工具链实现见 esphome/build_gen/首次会拉取 SDK之后增量编译很快烧录 / OTA / 远程管理第一次用 USB 烧录之后通过ota组件远程刷固件api组件让 Home Assistant 发现并控制设备。ESPHome 从 YAML 配置到固件部署的完整流程图注意一点配置、生成、编译是一个命令串起来的后面实操里你会只用esphome run一条命令走完前四步。从零跑通完整设备气象站 自动风扇材料清单ESP32 开发板一块DevKit 系列均可BMP280 传感器模块I2C 接口测气压/温度5V 继电器模块一个控制小风扇USB 数据线 一个 USB 供电口接线BMP280 是 I2C 两线制继电器是高电平触发BMP280ESP32继电器ESP32GNDGNDINGPIO5VCC3V3VCC / GND5V / GNDSDAGPIO21SCLGPIO22提醒继电器控制的是风扇的市电/5V 回路接线前先断电GPIO5 只是发号施令的脚别直接拿它当电源。第 1 步装环境ESPHome 是 Python 项目环境搭建两条命令git clone https://gitcode.com/GitHub_Trending/es/esphome cd esphome ./script/setupscript/setup会自动建虚拟环境并装好全部依赖依赖清单在 pyproject.toml 和 requirements.txt。装完后记得激活虚拟环境之后所有esphome命令都在这个环境里执行。第 2 步写配置新建weather_station.yaml完整内容如下每一段都注释了作用esphome: name: weather-station # 设备名会出现在 HA 和日志里 esp32: board: esp32dev # 板子型号决定 Flash/分区策略 framework: type: arduino # 用 Arduino 框架组件兼容性最好 wifi: ssid: 你的WiFi名 password: 你的WiFi密码 # 连不上网时自动重启重试避免设备卡死 reboot_timeout: 5min api: # 对接 Home Assistant 的通道 logger: # 串口日志排错主力 level: INFO i2c: # 启用 I2C 总线BMP280 挂在上面 sda: GPIO21 scl: GPIO22 sensor: - platform: bmp280 # 组件目录esphome/components/bmp280/ address: 0x76 temperature: name: 客厅温度 # 阈值联动超过 30℃ 开风扇低于 28℃ 关风扇双阈值天然防抖 on_threshold_crossed_above: threshold: 30.0 then: - switch.turn_on: fan_relay on_threshold_crossed_below: threshold: 28.0 then: - switch.turn_off: fan_relay pressure: name: 气压 switch: - platform: gpio # 组件目录esphome/components/gpio/switch/ id: fan_relay name: 风扇继电器 pin: GPIO5 inverted: false # 如果你的继电器模块是低电平触发改为 true几个新手常问的点为什么framework写arduino而不是esp-idf绝大多数现成组件传感器、LED、音频都优先支持 Arduino 框架新手没理由冒风险。on_threshold_crossed_above是什么它是 sensor 平台内置的自动化动作底层在 esphome/automation.py 统一调度不用自己写if (x 30)的逻辑。inverted: false是干什么的不少继电器模块要低电平才吸合这个开关就是干这个的接反了现象是风扇常开。第 3 步校验 编译 烧录# 只校验不编译检查最快 esphome config weather_station.yaml # 一条命令生成代码 → 编译 → 烧录首次会下载工具链耐心等 esphome run weather_station.yaml看到OTA successful/Hard reset via esphome之类的字样就说明烧录成功。ESP32 第一次烧录后串口可能被占用拔掉 USB 再插上让它重启。第 4 步验证打开 Home Assistant设备页应出现weather-station传感器实体带数值在 HA 里手动切一下风扇继电器开关听继电器动作把风扇出风口怼近传感器或哈口气等温度爬到 30℃ 以上观察风扇是否自动启动——这就是联动生效了。想确认 I2C 上到底挂了什么芯片可以临时加一个esphome/components/i2c/支持的i2c.scan: true日志里会打印扫描结果。组件生态什么时候用现成的什么时候自己写ESPHome 的全部能力都放在 esphome/components/ 下每个子目录就是一个组件结构高度统一Python 文件如__init__.py、sensor.py定义 YAML 里能写哪些字段、字段什么类型、怎么把配置翻译成 C 代码C 文件.cpp/.h真正的硬件驱动和运行时逻辑编译进固件。以 BMP280 为例它的组件目录只有 esphome/components/bmp280/ 两个 Python 文件——因为底层寄存器操作复用了bmp280_base等公共部分。这正是配置驱动的含义你写的每个字段都对应某段 Python 校验 某段 C 行为。用现成组件的边界esphome/components/里目前有上千个传感器、执行器、通信协议组件I2C/SPI/UART/Modbus/MQTT/蓝牙都有家庭场景 95% 的硬件能直接命中。需要自己写的场景私有协议芯片、厂商没开源的模块。这时两条路YAML 内联custom在配置文件里直接嵌 C适合只此一台的临时方案custom_components/目录仿照现成组件写一套__init__.py C框架的注册、校验、代码生成机制由 esphome/components/custom/ 统一提供写好后可以在多台设备间复用。经验建议先全局搜esphome/components/里有没有近似的组件真有缺口再动刀写 C。进阶OTA 升级、深睡省电、多设备联动OTA 远程升级api组件已经内置了 OTA 通道实现见 esphome/components/ota/按平台切换 arduino/esp-idf 后端固件带 RSA 签名防篡改。升级方式在 HA 的设备 → 固件更新卡片点更新或命令行esphome run weather_station.yaml后会自动走 OTA设备在线时不需要 USB。注意改了wifi、esp32框架类型这类骨架字段后OTA 可能失败此时必须 USB 兜底刷一次。深睡省电电池供电设备可以加deep_sleep组件典型用法是睡 55 分钟、醒 5 分钟采一次数据deep_sleep: run_duration: 5min sleep_duration: 55min # 唤醒后上报一次然后继续睡代价是设备离线时间变长实时控制类设备别用。多设备联动单设备内联动用if 条件如上例的阈值跨设备联动交给 Home Assistant 的 automationESPHome 只负责上报和执行。比如任何一台设备报温度 30℃ → 所有房间的风扇开启在 HA 里写一条规则即可比在每台设备上抄一份逻辑干净得多。踩坑实录这三类问题你大概率会遇到1. WiFi 连上又掉、反复重启按顺序排查供电不足用电脑 USB 口或 5V/2A 电源劣质充电宝/线是头号嫌疑power_save_mode相关的驱动问题部分廉价 AP 下省电模式会掉线可先设power_save_mode: none观察加reboot_timeout: 5min让卡住的设备 5 分钟无网就自愈重启——生产环境强烈建议保留这个配置。2. 编译报 Flash 超限section .text will not fit三个立竿见影的办法砍组件每多一个组件多一份运行时web_server、mqtt、api同时开是很常见的凶手组合按实际需要留换分区表在esp32下用partition_table指到小应用分区如min_spiffs或给 app 分区扩容构建参数build_flags里加-Os相关优化项或在platformio_options里调整board_build.partitions让编译产物更紧凑。3. 传感器数据乱跳、漂移先在filters里加sliding_window_moving_average窗口 5 左右平滑噪声用lambda过滤物理上不可能出现的值比如温度 -20 或 80 直接丢弃数值整体偏了用offset单位换算用lambdaI2C 总线同时挂多个器件时检查地址是否冲突i2c.scan会列出来。适合谁以及它往哪走适合已经或打算用 Home Assistant 的人手里有一堆 ESP32/ESP8266/RP2040 开发板和传感器模块、想做批量家庭设备的玩家想给老家电加个遥控开关继电器 任意 220V 负载的极客。不适合需要毫秒级实时控制的产线设备、要跑大模型推理/图像处理的边缘盒子、必须私有化且不依赖任何生态的封闭产品。从仓库现状看ESPHome 的演进方向也挺清楚平台从 ESP32/ESP8266 扩展到 BK72xx、RP2040、ln882x 等新芯片组件生态持续膨胀毫米波雷达、激光雷达、各种新型显示驱动都是近半年新面孔与 Home Assistant 的边界继续加深provisioning、key_provider 这类配网 安全组件正在补齐。对新手来说它的核心承诺没有变把写固件变成填配置让你把时间花在设备该干什么上而不是寄存器怎么写上。【免费下载链接】esphomeESPHome is a system to control your ESP32, ESP8266, BK72xx, RP2040 by simple yet powerful configuration files and control them remotely through Home Automation systems.项目地址: https://gitcode.com/GitHub_Trending/es/esphome创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考