moritzf/homeeup

homeeUp镜像说明

镜像概述

homeeUp是一款用于智能家居中枢homee的工具，通过模拟Homematic CCU（无需物理设备）暴露虚拟设备，支持插件扩展，帮助用户自定义智能家居控制逻辑。

核心功能

1. 模拟多种虚拟设备类型：开关（HM-LC-Sw1-FM）、运动传感器（HM-Sec-MDIR-2）、门磁（HM-Sec-SC-2）、遥控器（HM-RC-4-2）
2. 提供丰富插件支持：
   • SimpleHTTPPlugin：通过HTTP请求控制开关
   • SimpleCMDPlugin：执行命令行指令控制开关并同步状态
   • FritzBoxPlugin：控制FritzBox Guest Wifi开关
   • VorwerkKoboldPlugin：控制Vorwerk Kobold VR200机器人（启动/停止、显示dock状态）
   • SimpleMQTTPlugin（待完善）

使用场景

• 智能家居设备集成：将非Homematic设备通过虚拟设备接入homee
• 自定义控制逻辑：通过HTTP/CMD插件实现远程控制或自动化
• 第三方设备扩展：集成FritzBox Guest Wifi、Vorwerk机器人等设备控制

配置说明

Docker部署示例

Docker Run命令

bash
docker run -d \
  --name homeeup \
  -v ~/.homeeup:/root/.homeeup \  # 映射本地配置目录到容器
  -p 2001:2001 \  # 暴露Homematic CCU模拟端口
  moritzf/homeeup

（注：需提前在本地~/.homeeup目录创建config.json配置文件）

配置文件示例（config.json）

json
{
  "hostAddress": "你的homeeUp运行设备IP",
  "plugins": [
    {
      "deviceName": "HTTPSwitch",
      "type": "SimpleHTTPPlugin",
      "pluginParams": {
        "onUrl": "http://example.com/device/on",
        "offUrl": "http://example.com/device/off"
      }
    },
    {
      "deviceName": "CMDSwitch",
      "type": "SimpleCMDPlugin",
      "pluginParams": {
        "onCmd": "touch /tmp/switch_active",
        "offCmd": "rm /tmp/switch_active",
        "statusCmd": "ls /tmp/switch_active >> /dev/null; echo $?",
        "checkInterval": 2000
      }
    }
  ]
}

故障排除

若出现问题，可使用LOG=debug homeeup启动以生成调试日志，并在提交issue时附上该日志以便排查。

许可证

本软件遵循MIT许可证，详细条款见原项目说明。