NiRen Control (泥人继电器控制器) for Home Assistant

梅林听风

利用gemini3手搓了一个泥人继电器插件，自己用的，给大家看看

RS485这块目前只适用特定型号的松下新风和日立水墅适空调外机，并且需要在继电器内部设置，有需要的在整理了发出来。

这是一个用于 Home Assistant 的自定义集成，专为 泥人（NiRen）网络继电器板 设计。它通过 TCP/IP 协议（AT 指令集）与设备进行本地通讯，支持多通道继电器控制、干接点输入状态监控，以及通过板载 RS485 接口扩展控制新风或空调系统。

✨ 主要功能 (Features)

• ⚡ 多通道控制: 自动生成 Switch（继电器）实体，支持自定义通道数量。
• 💡 灯光模式: 可在配置时指定特定通道为 Light（灯光）实体，方便接入 HomeKit 等平台。
• 🔌 输入监控: 实时监控 DI（干接点）输入状态，支持 毫秒级主动上报 (Active Upload)，告别延迟。
• 🔄 RS485 外设扩展: 支持通过继电器的 RS485 接口透传控制第三方设备：
  
  
  • 新风系统: 生成 Fan 实体，支持开关、模式（热交换/普通）、风速（强/弱）及滤网计时。
  • 水墅适空调: 生成 Climate 实体，支持开关、模式（制冷/制热）、温度设定及回水温度监测。
    
    
• 🛡️ 高并发稳定: 内置错峰启动与随机延时机制，完美支持 10+ 台设备同时接入，避免 HA 重启时造成网络拥堵。
• 💾 配置备份: 支持将设备配置导出为 JSON 备份，或从 JSON 恢复配置（含外设参数）。
• ⚙️ 动态修改: 支持在不删除设备的情况下，动态修改通道数量、灯光类型及外设类型。
  
  

📦 安装步骤 (Installation)方法一：手动安装 (推荐)

• 下载本插件的压缩包。
• 解压后，将 niren_control 文件夹完整的复制到您的 Home Assistant 配置目录下的 custom_components 文件夹中。
  
  
  • 路径应为：/config/custom_components/niren_control/
    
    
• 重启 Home Assistant。
• 在添加设备里搜索泥人并安装
  
  

⚙️ 配置指南 (Configuration)1. 添加设备

• 在 Home Assistant 中点击 配置 -> 设备与服务 -> 添加集成。
• 搜索 NiRen Circuit Board Controller。
• 填写连接信息:
  
  
  • Host: 设备的 IP 地址（建议在路由器设置为静态 IP）。
  • Port: 端口号（默认为 12345）。
  • DO Count: 继电器输出通道数（如 8, 16, 32）。
  • IN Count: 输入通道数（如 4, 8）。
    
    
• 高级设置:
  
  
  • Light Channels: 输入需要识别为“灯”的通道号，用逗号分隔（例如 1,3,5）。未填写的通道将默认为“开关”。
  • External Device: 选择连接在 RS485 接口上的设备类型（无 / 新风系统 / 水墅适空调）。
    
    

2. 修改配置

如果需要增加通道或更换 RS485 外设：

• 在集成页面找到该设备，点击 配置 (Configure)。
• 选择 修改设备参数。
• 重新调整通道数或外设类型，点击提交。系统将自动清理旧实体并生成新实体。
  
  

3. 备份与恢复

在配置菜单中，选择 导出配置 可生成 JSON 代码；选择 导入配置 可将 JSON 代码应用到当前设备。

📝 注意事项 (Notes)

• 初始化机制:
  
  
  • 插件在首次连接时会自动下发优化指令（关闭回显、设置心跳、开启主动上报模式）。
  • DI 输入被配置为“触发上传模式”（Mode 2），确保物理开关动作能被 HA 即时捕获。
    
    
• 启动缓冲:
  
  
  • 为了防止多台设备同时上线导致系统卡顿，插件在 HA 启动时会有 0.5 ~ 5.0 秒的随机延时连接。
  • 连接建立后，会等待约 2 秒再同步 RS485 外设状态，以确保实体已完全加载。
    
    
• RS485 外设:
  
  
  • 松下新风系统: 故障代码 0 为正常。
  • 日立水墅适空调: 仅在 RS485 通讯使能开关开启时更新状态。支持手动关闭通讯开关以避免设备断电时 HA 报错。
  • 温度限制: 水机空调在制冷模式下限温 5-25℃，制热模式下限温 25-55℃。
    
    
• 网络建议: 强烈建议在路由器中为泥人继电器板绑定 静态 IP，以保证连接稳定性。
  
  

🛠️ 故障排查 (Troubleshooting)

• 状态不刷新: 点击设备页面中的 Refresh Status 按钮手动同步。
• RS485 无读数: 检查配置选项中是否选择了正确的外设类型，并确保 RS485 接线正确（A接A，B接B）。
• 日志排查: 如遇问题，可在 configuration.yaml 中开启调试日志：
  YAML
  
  logger:  default: info  logs:    custom_components.niren_control: debug