ESPHome 完整上手指南30 分钟用 ESP8266 从 0 到 1 做出温湿度采集节点【免费下载链接】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 是一套把 YAML 配置文件直接编译成固件并烧进开发板的系统。对第一次碰 ESP8266 的人来说它省掉的是最烦的三件事装工具链、写底层驱动、手动管理构建脚本。设备行为全部用配置文件描述C 代码由它自动生成。这篇文章按「先看结果、再装环境、写配置、烧固件、加传感器、远程监控、本地自动化」的顺序带你完整走一遍。成品效果这个节点最终能干什么动手之前先把目标摆出来。跟着做完全文你手里会有一块能跑这三件事的 ESP8266每 60 秒把 DHT22 的温度、湿度读数推送到 Home Assistant温度超过 30°C 时D1 引脚上的蜂鸣器本地鸣响 5 秒断网也能触发之后升级固件走 WiFi 的 OTA 通道不再插 USB 线。准备工作安装 ESPHome 并确认环境ESPHome 本身是命令行工具官方推荐的用法是从源码环境里跑。从源码安装获取代码并初始化环境只需要三条命令git clone https://gitcode.com/GitHub_Trending/es/esphome cd esphome ./script/setup⚙️ 初始化脚本 script/setup 会替你完成创建 Python 虚拟环境、装依赖、配置 pre-commit 钩子、拉取 PlatformIO 编译工具链。确认安装成功source venv/bin/activate esphome version输出里出现版本号说明环境就绪可以开始写设备。写第一份配置YAML 字段逐项拆解用向导生成骨架esphome wizard my_esp8266.yaml向导按顺序提问设备名称、芯片平台、开发板型号、WiFi 凭据、访问密码最后替你落盘一份能直接编译的文件。更想手写的话整个文件的骨架只有几个小节。平台与网络部分esphome: name: my_esp8266 esp8266: board: nodemcuv2 logger: wifi: ssid: 你的网络名 password: 你的WiFi密码 ap: ssid: 备用热点名 password: 备用热点密码再加上两个受密码保护的服务和一个兜底页面api: password: API访问密码 ota: password: OTA升级密码 captive_portal:小节承担的职责细节提醒esphome设备身份name即设备域名friendly_name是可选的昵称esp8266声明平台与开发板nodemcuv2对应常见 NodeMCU 开发板logger打开串口日志留空即可无需参数wifiWiFi 凭据ap是连不上网时自动开的备用热点api / otaHome Assistant 接入与远程升级两处密码各自独立captive_portal备用热点的捕获页面手机连上热点后方便拿到 SSID编译与烧录的完整命令先只编译、不烧录esphome compile my_esp8266.yaml这条命令按顺序做三件事校验 YAML、生成 C 源码、产出固件文件。报错基本都出在配置层面先在这里把它消掉。编译、烧录一次到位用 USB 线把开发板接上电脑然后执行esphome run my_esp8266.yamlrun 会先编译随后自动发现接在电脑上的板子让你确认串口再写入固件并回报结果。之后每次改动配置再烧录它只重建有变化的部分明显快于第一次。接入 DHT22接线对照与配置片段DHT22 接线对照表传感器引脚ESP8266 引脚作用VCC3.3V供电GNDGND共地DATAD4即 GPIO2单总线数据配置里加传感器给温度通道一个稳定的id后面的自动化才能引用它sensor: - platform: dht pin: D4 temperature: name: 室内温度 id: indoor_temp humidity: name: 室内湿度 update_interval: 60sdht平台默认覆盖 DHT22 这一类传感器DHT11 也可通过model字段指定。保存后重新执行 run 命令烧录Home Assistant 里就能看到温湿度两个实体。远程监控与排查问题接入 Home Assistant在 Home Assistant 中进入「设置 设备与服务 集成」添加 ESPHome 集成填入my_esp8266.local之类的域名用配置里 api 小节的密码完成配对设备卡片和传感器实体随即出现在列表中。打开内置 Web 服务器可选不想依赖 Home Assistant 时给配置追加两行web_server: port: 80烧录后用浏览器打开板子 IP同样能查看状态。查看设备实时日志esphome logs my_esp8266.yaml 启动过程、读数刷新、报错信息都在这里。出了问题先看日志再动手改配置。常见故障排查表现象排查方向连不上网核对 SSID 与密码确认网络处于 2.4 GHz 频段这颗芯片连不了 5 GHz必要时在wifi小节调整reboot_timeout的等待时长OTA 升级失败两端是否同一网络、密码是否正确闪存吃紧时精简配置减小固件体积读数异常核对接线、传感器型号与平台是否匹配把采样间隔拉长降低干扰进阶玩法本地自动化与更多组件温度过高时本地触发蜂鸣器自动化逻辑跑在设备内部不依赖任何外部系统binary_sensor: - platform: template name: 高温警报 id: high_temp_alert state: |- return id(indoor_temp).state 30; switch: - platform: gpio name: 警报蜂鸣器 pin: D1 id: alarm_buzzer automation: - trigger: platform: state entity_id: binary_sensor.high_temp_alert to: on action: - switch.turn_on: alarm_buzzer - delay: 5s - switch.turn_off: alarm_buzzer整条链路是闭环的模板传感器持续比对温度值超过 30°C 时状态翻成 on自动化随即打开蜂鸣器等 5 秒后关闭然后回到常态监控。继续往下走的方向支持哪些芯片看组件目录 esphome/components/每个目录对应一类硬件自动化可用的触发器与动作关键字查 esphome/automation.py想换 ESP32 开发板YAML 里只改平台小节其余流程不变。去 Home Assistant 确认温湿度卡片在按间隔刷新这个从 0 到 1 的 ESP8266 节点就算真正跑起来了。【免费下载链接】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 完整上手指南：30 分钟用 ESP8266 从 0 到 1 做出温湿度采集节点
ESPHome 完整上手指南30 分钟用 ESP8266 从 0 到 1 做出温湿度采集节点【免费下载链接】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 是一套把 YAML 配置文件直接编译成固件并烧进开发板的系统。对第一次碰 ESP8266 的人来说它省掉的是最烦的三件事装工具链、写底层驱动、手动管理构建脚本。设备行为全部用配置文件描述C 代码由它自动生成。这篇文章按「先看结果、再装环境、写配置、烧固件、加传感器、远程监控、本地自动化」的顺序带你完整走一遍。成品效果这个节点最终能干什么动手之前先把目标摆出来。跟着做完全文你手里会有一块能跑这三件事的 ESP8266每 60 秒把 DHT22 的温度、湿度读数推送到 Home Assistant温度超过 30°C 时D1 引脚上的蜂鸣器本地鸣响 5 秒断网也能触发之后升级固件走 WiFi 的 OTA 通道不再插 USB 线。准备工作安装 ESPHome 并确认环境ESPHome 本身是命令行工具官方推荐的用法是从源码环境里跑。从源码安装获取代码并初始化环境只需要三条命令git clone https://gitcode.com/GitHub_Trending/es/esphome cd esphome ./script/setup⚙️ 初始化脚本 script/setup 会替你完成创建 Python 虚拟环境、装依赖、配置 pre-commit 钩子、拉取 PlatformIO 编译工具链。确认安装成功source venv/bin/activate esphome version输出里出现版本号说明环境就绪可以开始写设备。写第一份配置YAML 字段逐项拆解用向导生成骨架esphome wizard my_esp8266.yaml向导按顺序提问设备名称、芯片平台、开发板型号、WiFi 凭据、访问密码最后替你落盘一份能直接编译的文件。更想手写的话整个文件的骨架只有几个小节。平台与网络部分esphome: name: my_esp8266 esp8266: board: nodemcuv2 logger: wifi: ssid: 你的网络名 password: 你的WiFi密码 ap: ssid: 备用热点名 password: 备用热点密码再加上两个受密码保护的服务和一个兜底页面api: password: API访问密码 ota: password: OTA升级密码 captive_portal:小节承担的职责细节提醒esphome设备身份name即设备域名friendly_name是可选的昵称esp8266声明平台与开发板nodemcuv2对应常见 NodeMCU 开发板logger打开串口日志留空即可无需参数wifiWiFi 凭据ap是连不上网时自动开的备用热点api / otaHome Assistant 接入与远程升级两处密码各自独立captive_portal备用热点的捕获页面手机连上热点后方便拿到 SSID编译与烧录的完整命令先只编译、不烧录esphome compile my_esp8266.yaml这条命令按顺序做三件事校验 YAML、生成 C 源码、产出固件文件。报错基本都出在配置层面先在这里把它消掉。编译、烧录一次到位用 USB 线把开发板接上电脑然后执行esphome run my_esp8266.yamlrun 会先编译随后自动发现接在电脑上的板子让你确认串口再写入固件并回报结果。之后每次改动配置再烧录它只重建有变化的部分明显快于第一次。接入 DHT22接线对照与配置片段DHT22 接线对照表传感器引脚ESP8266 引脚作用VCC3.3V供电GNDGND共地DATAD4即 GPIO2单总线数据配置里加传感器给温度通道一个稳定的id后面的自动化才能引用它sensor: - platform: dht pin: D4 temperature: name: 室内温度 id: indoor_temp humidity: name: 室内湿度 update_interval: 60sdht平台默认覆盖 DHT22 这一类传感器DHT11 也可通过model字段指定。保存后重新执行 run 命令烧录Home Assistant 里就能看到温湿度两个实体。远程监控与排查问题接入 Home Assistant在 Home Assistant 中进入「设置 设备与服务 集成」添加 ESPHome 集成填入my_esp8266.local之类的域名用配置里 api 小节的密码完成配对设备卡片和传感器实体随即出现在列表中。打开内置 Web 服务器可选不想依赖 Home Assistant 时给配置追加两行web_server: port: 80烧录后用浏览器打开板子 IP同样能查看状态。查看设备实时日志esphome logs my_esp8266.yaml 启动过程、读数刷新、报错信息都在这里。出了问题先看日志再动手改配置。常见故障排查表现象排查方向连不上网核对 SSID 与密码确认网络处于 2.4 GHz 频段这颗芯片连不了 5 GHz必要时在wifi小节调整reboot_timeout的等待时长OTA 升级失败两端是否同一网络、密码是否正确闪存吃紧时精简配置减小固件体积读数异常核对接线、传感器型号与平台是否匹配把采样间隔拉长降低干扰进阶玩法本地自动化与更多组件温度过高时本地触发蜂鸣器自动化逻辑跑在设备内部不依赖任何外部系统binary_sensor: - platform: template name: 高温警报 id: high_temp_alert state: |- return id(indoor_temp).state 30; switch: - platform: gpio name: 警报蜂鸣器 pin: D1 id: alarm_buzzer automation: - trigger: platform: state entity_id: binary_sensor.high_temp_alert to: on action: - switch.turn_on: alarm_buzzer - delay: 5s - switch.turn_off: alarm_buzzer整条链路是闭环的模板传感器持续比对温度值超过 30°C 时状态翻成 on自动化随即打开蜂鸣器等 5 秒后关闭然后回到常态监控。继续往下走的方向支持哪些芯片看组件目录 esphome/components/每个目录对应一类硬件自动化可用的触发器与动作关键字查 esphome/automation.py想换 ESP32 开发板YAML 里只改平台小节其余流程不变。去 Home Assistant 确认温湿度卡片在按间隔刷新这个从 0 到 1 的 ESP8266 节点就算真正跑起来了。【免费下载链接】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），仅供参考