Fork me on GitHub

pimatic-homegear by Dominik Meyer (meyerd) | github | npm

Pimatic Homegear Plugin

Plugin to interface with homegear (https://www.homegear.eu) to control MAX! and Homematic thermostats.

Based on pimatic-max (https://github.com/pimatic/pimatic-max) and homematic-manager (https://github.com/hobbyquaker/homematic-manager).

Configuration

You can load the plugin by editing your config.json to include (host = Homegear IP port=Homegear Port (default:2001)). The local ip and rpc port are required for the RPC server, to establish a connection from homegear back to pimatic and receive events:

{
   "plugin": "homegear",
   "host": "127.0.0.1",
   "port": 2001,
   "localIP": "127.0.0.1",
   "localRPCPort": 2015
}

Use the debug output in pimatic to find out the peerID and channel of the devices.

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

{
  "id": "bathroomLeft",
  "class": "HomematicHeatingThermostat",
  "name": "Bathroom Radiator left",
  "peerID": 2,
  "channel": 4,
  "comfyTemp": 23.0,
  "ecoTemp": 17.5,
}

Additionally, to see the current room temperature a HomematicThermostat with the same peerID and channel has to be added

{
  "id": "temperatureBathroomLeft",
  "class": "HomematicThermostat",
  "name": "Bathroom Temperature Radiator left",
  "peerID": 2,
  "channel": 4,
}

Plugin Config Options

homegear config
OptionDescriptionDefault
host
string
IP of homegear
"127.0.0.1"
port
integer
Homegear port (Default: 2001)
2001
localIP
string
Local IP of pimatic installation for RPC connection from Homegear
"127.0.0.1"
localRPCPort
integer
Local port for RPC connection from Homegear
2015
debug
boolean
Output update message from homegear and additional infos
true

Device Config Options

homematic device config schemas

HomematicHeatingThermostat

HomematicHeatingThermostat config options
OptionDescriptionDefault
peerID
number
The Device PeerID
2
channel
number
The Device channel
4
comfyTemp
number
The defined comfy temperature
21
ecoTemp
number
The defined eco mode temperature
17
vacTemp
number
The defined vacation mode temperature
14
guiShowModeControl
boolean
Show the mode buttons in the gui
true
guiShowPresetControl
boolean
Show the preset temperatures in the gui
true
guiShowTemperatureInput
boolean
Show the temperature input spinbox in the gui
true

HomematicContactSensor

HomematicContactSensor config options
OptionDescriptionDefault
rfAddress
string
The Device RF address
""

HomematicThermostat

HomematicThermostat config options
OptionDescriptionDefault
peerID
number
The Device PeerID
2
channel
number
The Device Channel
4

Homegear

Homegear config options
pimatic-homegear is written by Dominik Meyer (meyerd)