ESPHome 快速上手30 分钟把温湿度传感器数据送进 Home Assistant【免费下载链接】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想把一颗 DHT22 温湿度计的数据显示在手机的家庭自动化 App 里又不想碰 C 和 CMakeESPHome 是一条 30 分钟能走完的路它用一份 YAML 配置文件控制 ESP32/ESP8266/BK72xx/RP2040 等开发板自动完成生成 C 代码 → 编译 → 烧录再把设备数据推给 Home Assistant。全程耗时大致是环境 5 分钟、首次烧录 5 分钟、接传感器 10 分钟、平台集成 10 分钟。1. 装环境跑一条脚本大约 5 分钟克隆仓库后运行官方安装脚本它会建虚拟环境、装依赖、下载 PlatformIO 工具链git clone https://gitcode.com/GitHub_Trending/es/esphome cd esphome ./script/setup source venv/bin/activate脚本跑完后用esphome version验证能看到版本号即环境就绪。⚠️ 坑位首次编译还会额外下载交叉编译工具链网速差的话可以提前跑一次esphome compile my_esp.yaml把它缓存下来后面编译会快很多。2. 写第一份配置文件最简单的路径是交互向导esphome wizard my_esp.yaml它会依次问设备名、板型、WiFi、密码然后直接生成文件。想手写的话下面这份约 15 行的文件就是一个可运行的最小配置esphome: name: my-esp esp8266: board: nodemcuv2 logger: wifi: ssid: 你的WiFi名 password: 你的WiFi密码 ap: # WiFi 连不上时开救援热点 ssid: my-esp-fallback password: rescue123456 api: password: api密码 ota: password: ota密码 captive_portal:每项各司其职logger打开串口日志方便排错api是 Home Assistant 通信通道ota让固件以后可以走 WiFi 升级captive_portal保证设备连不上 WiFi 时你用手机连上救援热点能立刻被引导到配置页面。⚠️ 坑位ESP8266 只收 2.4GHz 信号。路由器若把 2.4G/5G 合并成同一个名字设备大概率连不上——把两个频段拆开命名最省事。3. 3 分钟烧录第一个固件板子 USB 接上电脑执行esphome run my_esp.yaml它先编译再烧录中途会提示选择串口选刚才插板后新出现的那个Linux 一般是/dev/ttyUSB0或/dev/ttyACM0。烧录成功后设备自动重启并尝试连网路由器里能看到它上线。✅两个高频翻车点Windows 下选不到端口通常要先装 CP210x/CH340 驱动一直连上的是救援热点而非家里 WiFi先核对 SSID/密码的大小写和特殊字符。连不上时设备会反复重启esphome logs my_esp.yaml随时能看到串口实时输出这是后面最重要的排错手段。4. 5 行配置接入 DHT22接线很简单DHT22 的 DATA 接 NodeMCU 的 D4GPIO2VCC 接 3.3VGND 接地。配置文件末尾追加sensor: - platform: dht pin: D4 model: DHT22 temperature: name: 室温 id: room_temp humidity: name: 室内湿度这个dht平台定义在 esphome/components/dht/会按默认 60 秒周期生成温度和湿度两个实体。重新run一次设备重启后串口日志里就能看到周期性读数如果数值一直是nan九成是 DATA 线虚接。ESPHome 内置了数百个类似组件全部集中在 组件目录接法基本一致指定platform、引脚或地址、name。5. 数据上手机Home Assistant 原生集成因为配置里已有api集成只需填表Home Assistant 进入 设置 → 设备与服务 → 添加集成搜索ESPHome输入设备名或 IP如my-esp.local填入配置里api的密码添加后第 4 步的两个传感器即刻出现还能直接画曲线、做联动。 到这里数据出现在手机里的目标已达成。6. 本地自动化不依赖云端也能动ESPHome 的规则直接跑在设备本地。例如温度超过 30 度就鸣 5 秒先加一个用模板计算的虚拟二态传感器binary_sensor: - platform: template name: 高温警报 id: high_temp_alert lambda: |- return id(room_temp).state 30.0;再用state触发器挂上动作序列automation: - trigger: - state: id: high_temp_alert to: on action: - switch.turn_on: alarm - delay: 5s - switch.turn_off: alarm注意room_temp用的是第 4 步给温度传感器起的id动作里引用的alarm则是一个gpio开关实体。完整的触发器与动作清单可以看 自动化模块。接下来可以做的两件事试一次 OTA设备上线后改一个配置再esphome run它会自动走 WiFi 推送固件USB 线从此可以拔掉。换一颗传感器练手把platform: dht换成bme280_i2c需补一段i2c:总线配置体会改 5 行配置 换一颗芯片的体验。【免费下载链接】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），仅供参考