ESPHome 完整指南:4 步让 ESP8266 说出温湿度数据

ESPHome 完整指南:4 步让 ESP8266 说出温湿度数据 ESPHome 完整指南4 步让 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抽屉里那块吃灰的 NodeMCU加上不到 50 行的 YAML几分钟之后它的温湿度读数就会出现在你的 Home Assistant 面板里——全程不写一行 C。这套东西叫 ESPHome一个用配置文件控制 ESP8266 / ESP32 / BK72xx / RP2040 的系统负责编译、烧录、OTA 升级并天然对接家庭自动化平台。对新手来说它省掉的是三件事驱动适配、工具链配置、C 工程骨架你只需要声明哪块板子、哪根引脚、什么行为。把 ESPHome 装好最短的安装路径就两条命令git clone https://gitcode.com/GitHub_Trending/es/esphome cd esphome ./script/setupscript/setup会创建 Python 虚拟环境并装齐依赖包括编译用的 PlatformIO 工具链。做完这步激活环境并验证source venv/bin/activate esphome version成功标志终端打印出一行版本号说明 CLI 已经可用。生成第一份配置文件与其手写 YAML不如先跑交互式向导它会把骨架替你填好esphome wizard my_esp8266.yaml向导依次问你设备名 → 平台选 esp8266→ 板子型号 → WiFi SSID 和密码 → 加密口令。结束后你会得到一份能直接编译的配置。把各模块的职责捋一遍改配置时就知道手该往哪伸esphome设备命名决定固件文件名和主机名esp8266声明芯片平台和board型号选错型号后面的引脚和分区都会对不上wifi核心网络配置ssid/password必须换成你自己家的连不上时自动开的 fallback 热点也在这里控制api与 Home Assistant 通信的接口带一个访问密码ota空中升级通道密码要和 api 的区分开两处占位密码都要替换这是新手最常见的疏漏成功标志文件保存后在编辑器里没有语法报错且能进入下一步的编译。烧录固件并确认设备活着esphome run my_esp8266.yaml一条命令 编译 烧录。USB 线接上板子后终端会列出检测到的串口用方向键选中正确的那个回车。判断烧录成功看 3 个信号编译阶段结尾出现固件大小统计text/data 字节数没有红色报错烧录阶段出现擦除/写入进度末尾打印Hard resetting via RTS pin...一类复位提示设备重启后esphome logs my_esp8266.yaml里出现 WiFi 连接成功和 IP 获取成功的日志行成功标志日志里能看到设备拿到 IP 地址。拿不到 IP 就跳到文末的排查顺序。让温湿度每 60 秒上报一次DHT22 是入门温湿度的标准件三根线的接法DHT22ESP8266VCC3V3DATAD4GPIO2GNDGND配置里追加这一段sensor: - platform: dht pin: D4 model: DHT22 temperature: name: 室内温度 id: indoor_temperature humidity: name: 室内湿度 update_interval: 60smodel按你手上的实际型号写DHT11、AM2302 都支持不写则自动检测id给自动化规则引用用。改完再执行一次esphome run把新固件刷进去。成功标志esphome logs中出现DHT: Got temperaturexx.x°C humidityxx.x%这样的读数行读到failed to receive或数值卡死按文末第 3 条排查。让数据出现在面板和浏览器里数据回传有两条互相独立的路可以只走一条也可以双开。路线一Home Assistant 原生集成。在 HA 的设备与服务 → 添加集成里找到 ESPHome用my_esp8266.local或设备 IP 配上 api 里那把密码传感器会自动出现在面板上OTA 升级也能从 HA 里直接触发。路线二内置 web 页面。配置里加一行web_server: port: 80重新烧录后浏览器访问设备 IP 即可打开一个自带设备列表和控制按钮的页面无需任何账号系统适合临时查看或没有 HA 的场景。成功标志两条路任选其一——HA 面板出现室内温度/室内湿度两个实体或浏览器里能看到设备状态页。在设备上跑一段本地自动化最短的本地自动化温度越限 → 响蜂鸣器 → 5 秒后自动停。触发、动作、延时全部跑在芯片本地断网照常工作。假设蜂鸣器接在 D1switch: - platform: gpio name: 警报器 pin: D1 id: alarm_buzzer automation: - trigger: - platform: threshold id: hot_trigger above: 30 sensor: indoor_temperature action: - switch.turn_on: alarm_buzzer - delay: 5s - switch.turn_off: alarm_buzzerabove是阈值温度sensor引用前面给温度实体起的id。成功标志编译通过把 DHT22 靠近热源让读数过 30°C蜂鸣器响 5 秒后自动停。出问题时的三条排查顺序WiFi 连不上先核对 SSID/密码是否含特殊字符且没多打空格 → 确认路由器开了 2.4GHzESP8266 不支持 5GHz 频段→esphome logs观察是找不到网络还是认证失败前者查 2.4GHz 广播后者基本就是密码问题。OTA 升级失败先确认电脑和设备在同一网段、信号正常 → 核对 ota 密码是否与配置一致 → 固件接近 Flash 上限时先精简配置再升级。传感器读数异常先查硬件——VCC/GND 是否接反、DATA 线是否松脱 → 核对model与实际芯片一致 → 把update_interval调大一些降低干扰再观察是否恢复。下一步想换别的传感器或加开关、显示屏直接翻 esphome/components/ 里的目录名找同名组件自动化支持延时、窗口时间、时间触发等多种组合可查 esphome/automation.py 了解全部可用动作想自己写组件扩展入口在 esphome/components/custom_component/装好、连上、跑起来——剩下的就是往 YAML 里加东西的事了。【免费下载链接】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),仅供参考