Fork me on GitHub

pimatic-max by Oliver Schneider (sweetpi) | github | npm

pimatic max plugin

Plugin to control the MAX! Thermostat (http://www.eq-3.de)

Configuration

You can load the plugin by editing your config.json to include (host = Max!Cube IP port=Max!Cube Port (default:62910)):

{ 
   "plugin": "max",
   "host": "192.168.X.X",
   "port": 62910
}

Use the debug output in pimatic to find out the rfAddress of the devices. Sample debug output:

09:04:42.165 [pimatic-max] got update
09:04:42.168 [pimatic-max] { type: 'Heating Thermostat',
09:04:42.168 [pimatic-max]>  address: '12345cf', <-- rfAddress
09:04:42.168 [pimatic-max]>  serial: 'KEQ04116',
09:04:42.168 [pimatic-max]>  name: 'Heizung',
09:04:42.168 [pimatic-max]>  roomId: 1,
09:04:42.168 [pimatic-max]>  comfortTemperature: 23,
09:04:42.168 [pimatic-max]>  ecoTemperature: 16.5,
09:04:42.168 [pimatic-max]>  maxTemperature: 30.5,
09:04:42.168 [pimatic-max]>  minTemperature: 4.5,
09:04:42.168 [pimatic-max]>  temperatureOffset: 3.5,
09:04:42.168 [pimatic-max]>  windowOpenTemperature: 12,
09:04:42.168 [pimatic-max]>  valve: 0,
09:04:42.168 [pimatic-max]>  setpoint: 17,
09:04:42.168 [pimatic-max]>  battery: 'ok',
09:04:42.168 [pimatic-max]>  mode: 'manu' }

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

{ 
  "id": "BathroomHeatingThermostat",
  "class": "MaxHeatingThermostat", 
  "name": "Bathroom Radiator",
  "rfAddress": "12345cf",
  "comfyTemp": 23.0,
  "ecoTemp": 17.5,
},

The MaxWallThermostat device can be used to get the actual temperature from a MaxHeatingThermostat device.

  1. MAX Wall Thermostats actual temperature (maybe more precise due location)

  2. MAX Heating Thermostats actual temperature

Both MaxWallThermostat and MaxHeatingThermostat devices rfAddress can be used for actual temperature info:

    {
      "id": "BathroomThermostat",
      "class": "MaxWallThermostat",
      "name": "Bathroom Wall or Heat Thermostat",
      "rfAddress": "12345cf"
    },

For contact sensors add this config:

{ 
  "id": "window-bathroom",
  "class": "MaxContactSensor", 
  "name": "Bathroom Window",
  "rfAddress": "12345df"
},

Plugin Config Options

max-thermostat config
OptionDescriptionDefault
host
string
The IP of the MAX! Cube
"127.0.0.1"
port
integer
The port of the MAX! Cube (Default: 62910)
62910
debug
boolean
Output update message from cube and additional infos
true

Device Config Options

max-thermostat device config schemas

MaxHeatingThermostat

MaxHeatingThermostat config options
OptionDescriptionDefault
rfAddress
string
The Device RF address
""
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
guiShowValvePosition
boolean
Show the valve position in the gui
true

MaxContactSensor

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

MaxWallThermostat

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

MaxCube

MaxCube config options
pimatic-max is written by Oliver Schneider (sweetpi)