Fork me on GitHub

pimatic-homegear-ws by Pascal Heinrich (pheinrich) | github | npm

Pimatic Homegear WebSocket Plugin

Plugin to interface with homegear (https://www.homegear.eu) to control Homematic Switches/Thermostates.

Configuration

You can load the plugin by editing your config.json to include (host = Homegear IP port=Homegear Port (default:2001)).

{
   "plugin": "homegear-ws",
   "username": "your-username", // (blank string if auth none)
   "password": "your-password", // (blank string if auth none)
   "host": "127.0.0.1",
   "port": 2001
}

Use the debug output in pimatic to find out the peerId and channel of the devices. Or use homegear -r to bring up the homegear console, select the bidcosfamily families select 0 and show up your peers with peers list.

Switches can be defined by adding them to the devices section in the config file. Set the class attribute to HomematicSwitch or HomematicPowerSwitch. For example:

{
  "id": "switch-1",
  "class": "HomematicSwitch",
  "name": "TV Switch",
  "peerId": 1
}
{
  "id": "power-switch-1",
  "class": "HomematicPowerSwitch",
  "name": "Light Power Switch",
  "peerId": 2
}

Thermostates also can be defined by adding them to the devices section in the config file. Set the class attribute to HomematicThermostate. For example:

{
  "id": "thermostate-1",
  "class": "HomematicThermostate",
  "name": "Thermostate kitchen",
  "peerId": 3
}

Plugin Config Options

homegear config
OptionDescriptionDefault
host
string
IP of homegear
"127.0.0.1"
port
integer
Homegear port (Default: 2001)
2001
username
string
Homegear username
""
password
string
Homegear password
""
reconnectInterval
number
Homegear Reconnect Interval (ms)
7500
reconnectAttempts
number
Homegear Reconnect Attempts
25
debug
boolean
Output update message from homegear and additional infos
true

Device Config Options

homematic device config schemas

HomematicPowerSwitch

HomematicPowerSwitch config options
OptionDescriptionDefault
peerId
number
The Device PeerID
1

HomematicSwitch

HomematicSwitch config options
OptionDescriptionDefault
peerId
number
The Device PeerID
1

HomematicThermostat

HomematicThermostat config options
OptionDescriptionDefault
peerId
number
The Device PeerID
1
guiShowModeControl
boolean
Show the mode buttons in the gui
true
guiShowPresetControl
boolean
Show the preset temperatures in the gui
false
guiShowTemperatureInput
boolean
Show the temperature input spinbox in the gui
true
pimatic-homegear-ws is written by Pascal Heinrich (pheinrich)