pdf-icon

StamPLC Home Assistant 集成

StamPLC 是一款物联网可编程逻辑控制器,专为工业自动化与远程监控设计。产品采用 Stamp-S3A 控制模组,不仅提供强大的处理能力,还实现了高效的无线连接。本文介绍如何将 StamPLC 集成至 Home Assistant。

Note
非常感谢来自 ESPHome 社区贡献者 @Beormund 提供的配置文件,如需参考更多,可以访问 https://github.com/Beormund/esphome-m5stamplc

准备工作

提示
本教程中,套件在 ESPHome 2025.10.3 下编译和上传,如果遇见编译/上传问题,考虑将ESPHome切换至此版本

在 Home Assistant 中打开 ESPHome Builder,创建一个空的配置文件

  • 点击右下角的 NEW DEVICE 按钮

  • 弹出框单击 CONTINUE

  • 选择 Empty Configuration

  • 为文件命名 (可选)

  • 在新生成的配置文件处点击 EDIT

之后,复制 configurations.yaml 的内容到配置文件中

根据需要,更改网络配置或者是 API 信息等,比如创建一个 API Encryption Key 用于认证:

yaml
1 2 3
api:
  encryption:
    key: "Your_Encryption_Key"
提示
如果需要一个 Key,可以访问 native api 生成一个 (在 encryption 下)

或者是更改时区设置:

yaml
1
timezone: Europe/London

改为合适的时区:

yaml
1
timezone: Asia/Shanghai

之后,依次点击右上角 SAVEINSTALL,选择 Manual download

此时会生成代码并且编译工程

提示
如果是第一次编译,可能会需要较长时间;具体取决于 Home Assistant 主机性能和网络连接情况

当编译完成后,选择 Factory format 下载固件

上传固件

打开浏览器,访问 ESPHome Web 上传固件

使用 USB-C 数据线将 StamPLC 连接至主机, 点击 CONNECT ,选择设备连接

之后,点击 INSTALL,选择之前下载的固件上传,再次点击 INSTALL,将固件烧录至设备。

当烧录完成后,设备会自动重置

添加设备至 Home Assistant 集成

当设备重启后,会自动连接之前配置的网络,正常情况下可以在 Settings -> Devices & services 发现设备

点击 Add 将 StamPLC 集成进入 Home Assistant,如果此前设置了 API Encryption Key ,此处可能需要填入 API Encryption Key 验证

StamPLC 的 Dashboard 示例

实机运行

相关视频

On This Page