这是一个个人的 Home Assistant 自定义集成合集，包含我日常使用和开发的各种集成插件。
通过 HTTP 协议直接与昌遂品牌 PDU 硬件通信，控制插座、查看实时功率、电流等信息。
主要功能:
- ✅ 支持通过 UI 配置登录信息与插座数量
- ✅ 直接控制 PDU 插座开关
- ✅ 实时监控整机电参数（电压、电流、总功率、功率因数、总能耗）
- ✅ 可选显示每个插座的功率和电流传感器
- ✅ 可配置轮询间隔（默认 30 秒），支持在"选项"中随时修改，无需删除重加
- ✅ 本地轮询，无需云服务
- ✅ 支持多台 PDU 设备（同一主机自动防重复添加）
- ✅ 添加时自动验证连接；设备暂时离线时自动重试加载
- ✅ 插座能耗统计（今日/昨日用电）持久化保存，重启不丢数据
- ✅ [优化] 解析逻辑重构，更加健壮
- ✅ [优化] 增强会话管理与错误恢复
集成域名: changsui_pdu
支持型号: 昌遂（CAN）系列，支持 16 孔和 20 孔型号
支持两种模式：
- 服务器模式：运行一个 TCP 服务器，接收 GWGJ 协议 PDU 的主动连接（无需 MQTT）。
- 客户端模式：通过 HTTP 协议主动轮询特定的 PDU 设备（适用于特定型号）。
主要功能:
- ✅ 监听 TCP 端口并解析 GWGJ 协议数据
- ✅ 支持 HTTP 轮询模式，主动获取设备状态
- ✅ 直接集成到 Home Assistant，无需 MQTT
- ✅ 自动注册新的 PDU 设备
- ✅ 动态创建开关和传感器实体
- ✅ 支持功率、电流、电压、总能耗传感器
- ✅ 支持日志等级配置
- ✅ 本地推送/轮询，实时响应
- ✅ [优化] 采用 aiohttp 异步请求，提升稳定性
- ✅ [优化] 正则表达式预编译，降低资源占用
集成域名: gwgj_pdu
支持型号: GWGJ 系列 PDU
- 打开 Home Assistant 中的 HACS
- 点击右上角的 三个点 ⋮，选择 自定义存储库
- 添加以下信息:
- 存储库 URL:
https://github.com/ZHonry/ziot - 类别:
Integration
- 存储库 URL:
- 点击 添加
- 在 HACS 中搜索 ZIoT
- 选择需要的集成并点击 下载
- 重启 Home Assistant
- 下载本仓库的最新版本
- 将
custom_components目录下你需要的集成复制到你的 Home Assistant 配置目录下的custom_components文件夹中 - 重启 Home Assistant
可用的集成:
changsui_pdu- 昌遂 PDU 集成gwgj_pdu- GWGJ PDU 网关/客户端
- 进入 设置 → 设备与服务
- 点击 添加集成
- 搜索 Changsui PDU
- 按照提示输入配置信息
📋 配置选项详情
- 主机地址: PDU 设备的 IP 地址
- 用户名: 登录用户名（默认
admin） - 密码: 登录密码（默认
admin） - 插座数量: PDU 的插座数量（16 或 20）
- PDU 名称: 自定义设备名称（默认 "昌遂PDU"）
- 显示插座电流传感器: 是否为每个插座创建电流传感器
- 显示插座功率传感器: 是否为每个插座创建功率传感器
- 显示负载上下限: 是否显示电流限制信息
- 轮询间隔: 数据更新间隔（秒，默认 30）
- 进入 设置 → 设备与服务
- 点击 添加集成
- 搜索 GWGJ PDU
- 按照提示选择模式并输入配置信息
📋 配置选项详情
服务器模式 (Server Mode):
- 监听地址: TCP 服务器监听地址（默认
0.0.0.0） - 监听端口: TCP 服务器端口（默认
4600）
客户端模式 (Client Mode):
- 主机地址: PDU 的 IP 地址
- 端口: HTTP 端口（默认
80） - 密码: 登录密码（默认
admin）
通用选项:
- 日志等级: 日志详细程度（可选，默认
info）
设备配置文件位置: <HA配置目录>/.storage/gwgj_pdu_data/<entry_id>/devices.json（设备自动注册后生成）
📌 Changsui PDU 实体列表
开关实体:
switch.{pdu_name}_outlet_{n}: 插座开关（n = 1-16 或 1-20）
传感器实体:
sensor.{pdu_name}_电压: 整机电压（V）sensor.{pdu_name}_电流: 整机电流（A）sensor.{pdu_name}_总功率: 整机总功率（W）sensor.{pdu_name}_功率因数: 功率因数sensor.{pdu_name}_总能耗: 总能耗（kWh）sensor.{pdu_name}_今日能耗: 今日能耗（kWh）sensor.{pdu_name}_outlet_{n}_功率: 插座功率（可选）sensor.{pdu_name}_outlet_{n}_电流: 插座电流（可选）
📌 GWGJ PDU 实体列表
开关实体:
switch.pdu_{device_id}_switch_{n}: 插座开关（n = 1-8）
传感器实体:
sensor.pdu_{device_id}_功率: 整机功率（W）sensor.pdu_{device_id}_电流: 整机电流（A）sensor.pdu_{device_id}_电压: 整机电压（V）sensor.pdu_{device_id}_总能耗: 总能耗（kWh）
❓ 两个 PDU 集成有什么区别？
Changsui PDU 通过 HTTP 主动轮询昌遂品牌 PDU，适合直接控制单台或多台昌遂设备；GWGJ PDU 作为 TCP 服务器被动接收 GWGJ 协议设备的连接，适合需要集中管理多台 GWGJ 设备的场景。两者使用不同的通信协议和品牌。
❓ 可以同时使用多个集成吗？
可以，所有集成都是独立的，互不影响。您可以根据需要安装和使用任意组合。
❓ 如何添加新的集成到这个仓库？
这是一个个人集成合集，如果您有好的集成想法或需求，欢迎提交 Issue 讨论！
- Changsui PDU 集成
- GWGJ PDU 集成
- 更多集成开发中...
欢迎提交 Issue 和 Pull Request！
如果您有好的集成想法或发现了 Bug，请随时提出。
本项目采用 MIT 许可证。
注: AI 辅助开发，持续更新中 😊