ESPHome Docs

这是 ESPHome 顶层文档索引。请浏览下方的表格,使用侧边栏菜单,或使用搜索功能来查找你需要的信息。

帮助改进本说明文档

如果你在本网站中发现任何错误,欢迎指正。你可以在 GitHub 仓库 提交 Pull Request (PR) 进行修正。如果你不知道如何创建 PR,也可以直接点击页面上的 “Edit this page on GitHub” 链接,这会带你到该页面的源文件。

另外,你也可以在 Discord 服务器的 Documentation 频道发帖。

ESPHome 配置

ESPHome 通过 YAML 文件进行配置——请使用以下链接获取 ESPHome 配置文件的基础和高级信息。

支持的微控制器

微控制器外设

直接支持微控制器处理器运行的外设。

ESPHome 自动化

“当发生某事时,我希望它做某事……”

自动化让我们可以自定义 ESPHome 设备的响应/行为,完全按照你的需求。

ESPHome 组件

ESPHome 专用组件或支持 ESPHome 设备安装后配置的组件。

网络硬件

网络协议

蓝牙/BLE

管理与监控

更新安装

通过空中下载(OTA)安装更新。

更新管理

创建更新实体,简化 OTA 更新的管理。

硬件外设接口/总线

I/O 扩展器/多路复用器

1-Wire 总线

专门支持或扩展 1-Wire Bus 的平台,可与 1-Wire 设备通信。

CAN 总线

专门支持或扩展 CAN Bus 的平台,可与 CAN 设备通信。

传感器组件

传感器按类别组织;如果某个传感器属于多个类别,则会多次出现。

核心

空气质量

模拟量

蓝牙低功耗(BLE)

数字信号

距离

电力

环境

健康/安全

光照

磁性

其他

运动

热电偶

重量

想要查找输出为模拟电压的传感器?请查看 ADC Sensor,并结合类似 TEMT6000 配置 的公式。

二进制传感器组件

二进制传感器按类别组织;如果某个传感器属于多个类别,则会多次出现。

核心

电容触摸

机械类

NFC/RFID

在社区中通常被称为“标签”或“卡片”读卡器。

触摸屏

存在检测

其他

报警控制面板组件

音频 ADC 组件

音频 DAC 组件

按钮组件

空调组件

遮阳帘组件

日期时间组件

显示组件

显示硬件平台

机电类

能源/太阳能管理

事件组件

风扇组件

Home Assistant 组件

专用于与 Home Assistant 交互的组件。

灯光组件

想要查找 WS2811 及类似的可寻址灯带? 对于 ESP32 及其变种,推荐使用 ESP32 RMT LED StripSPI LED Strip Light;对于其他处理器,请查看 FastLED Light

门锁组件

媒体播放器组件

麦克风组件

数字量组件

输出组件

选择器组件

扬声器组件

开关组件

文本组件

文本传感器组件

时间组件

触摸屏组件

阀门组件

无线通信

用于创建红外(IR)或射频(RF)遥控发射器和/或接收器,或将 ESPHome 连接到蜂窝网络。不包括 Wi-Fi。

其他组件

Cookbook

贡献

ESPHome 依赖并欢迎社区成员的贡献。如果你想参与贡献,请访问我们的 开发者网站