MAX!CubeMigrationToFHEM

Todo: Fertigstellung des Artikels oder zumindest Löschung der ADD Me-Einträge

WORK IN PROGRESS / NOT FINISHED: HowTo Migrate from MAX!Cube to FHEM

Summary: This pages describes the steps required to migrate a house installation from MAX!Cube solution (using a Cube and MAX! Software from ELV/EQ-3) to FHEM on a Raspberry Pi combined with a CUL. The benefit of such a migration is to gain better logfiles, to get graphs (Desired vs. Actual temperature and Valve position) and more reliable software.

---

Initial situation

The appartment has 125 sqm and five rooms (child 1, child 2, livingroom, bedroom, working room), one bathroom, a kitchen and a toilette. Each room has one heater below the window, the living room has two heaters. Two rooms require multiple window shutter contacts: bedroom and living room due to the amount of windows. MAX!Cube software is running since a year controlling all heaters, all windows and in combination with one wall thermostat in the living room and one ECO-switch at the main door to bring the full house to ECO mode when leaving.

Desired situation

MAX!Cube software was unstable and the update to v1.3.10 triggered the decision to move to a new setup: keep the MAX system, but control it via FHEM. Have the ability to add more sensors, more actors from other brands than MAX (looking for Homematic due to the amount of different sensors and 1-Wire to avoid the unreliable radio transmission). Have the ability to better see what the system is doing (logfiles) and graph it out (diagrams for each room). Get some more flexibility for home-cinema setup, for light controls, etc. Increase the WAF (Women's Acceptance Factor) for the wife who was complaining about the MAX!Cube solution.

Procurement list

While it is possible to use the existing MAX Cube with FHEM certain features would not be available. Therefore I decided to go with a Rasperry Pi and a CUL. Here is the shopping list:

1. Rasperry Pi from G3 with cooling kit for enhanced reliability ([1])
2. 32 GB SDHX Card Class 10 from SANDisk
3. CC1101-USB-Lite 868MHz ([2]) with 36cm antenna (+8dBi) for MAX protocol
4. 8 Channel 1-Wire Daughterboard without RTC with some sensors for testing ([3])

(Note: The 1-Wire board has not yet arrived and may not fit into the supplied case - but I am too lazy to attach the cooling modules myself).

Installation of Raspberry Pi

Please follow one of the many documentations how to install Linux on your Raspberry Pi - a good starting point would be [4]. I tried to install Raspbian using the advanced method of copying the image directly to the SD-card but it did not worked out well as many perl/python-modules were missing, had to be identified and installed to use FHEM.

For my second approach I used the provided image from busware.de, which also includes drivers for their COC daughter board. Available for download here [5]. Unfortunately this has a slightly outdated FHEM installation, but works for all other parts. Please note that there is no HDMI output enabled during the first boot. Just use ssh pi@fhem or ssh pi@<IP-address> to login and use raspi-config for initial setup of passwords, timezone and disk size. Do not forget to install an ntp-client using apt-get install ntp-client, an editor of your choice (I selected vim apt-get install vim) and edit /etc/ntp.conf to adjust ntpservers and select a country-pool (see [6]).

Upgrade of FHEM

Once the initial setup is completed reboot your Raspberry and login into FHEM using your web browser at <IP-address>:8083. Enter the upgrade command to upgrade your FHEM-installation to the latest revision. Use shutdown restart to start the new code version.

CUL firmware flashing

Login using ssh and become root using su - or sudo -i to flash the empty CUL. This only works as root from the directory /opt/fhem using the command string

dfu-programmer atmega32u4 erase && dfu-programmer atmega32u4 flash ./FHEM/CUL_V3.hex && dfu-programmer atmega32u4 start

If the application dfu-programmer is not installed, install using apt-get install dfu-programmer.

Migration Preparation

ADD ME

Documentation

If you have not done it before now it's a good start to document your existing MAX!Cube solution. Room for room write each device, the MAX address, location and intended profile into an Excel file. It could look like

Roomname DeviceName DeviceAddress Location WeekDayProfile WeekendProfile Dependencies

where WeekDayProfile and WeekendProfile only make sense for actors like Heaters within the MAX-solution. Dependencies can indicate Window Contacts to Heater actors or Wall Thermostat to Heater actors. Document as well your current heating profile configuration with MAX!Cube.

Make a backup.

Selecting the right time of the year

ADD ME

What do you want to archive

ADD ME

Migration Execution

ADD ME

MAX!Cube Configuration

ADD ME

fhem Configuration

CUL Setup

First step to setup FHEM is to define the protocol and adaptor FHEM should use. You need one CUL for each protocol (e.g. FS20, Homematic and MAX) as the CUL can listen to the same frequency, but does not understand multiple protocols. The <fhem.cfg> comes pre-installed with some default configuration. At the end add

#### CUL Definition, MAX!Cube
define CUL0 CUL /dev/ttyACM0@9600 1234
attr CUL0 rfmode MAX
define cm CUL_MAX 123456

and save fhem.cfg. After a reload FHEM will start to listen to MAX-commands sent by your still active MAX-Cube.

Find MAX devices

As each MAX device communicates with the MAX!Cube over the time of two-three days, FHEM will detect in use MAX-devices like Heaters, Thermostats and WindowsContacts (but not the ECO wall switch) and create alias definitions within the fhem.cfg file. To get all devices including addresses in use let FHEM listen for a two-three days while the MAX!Cube is still in use and working.

Identify MAX devices

Login into MAX!Cube using one browser window (or tab) and into FHEM using a second browser window (or tab). For each room change the temperature within the MAX!Software to an unsual value (like 27.5), change to the FHEM window and identify the change in FHEM. This allows you to detect one heater actor by the other.

To identify the Window Contacts just open one window, swap to FHEM and see which contact reports an Open status.

Define alias names

Open a third browser window (or tab), login to FHEM webpage and select Edit Files, fhem.cfg. You can now add the alias by adding lines like

define MAX_Bathroom_Heating MAX HeatingThermostat 05615b
define MAX_Bathroom_WindowSensor MAX ShutterContact 053767

room by room, one by one. Just identify the fhem-name in the "MAX"-room in FHEM and adjust the address (last hex-number in the line).

If you already have meaningfull names in the MAX-Software you can try to use the code from this forum post to automaticaly use these as the alias names for all MAX devices.

Assigning a room name

For better structure create and assign devices of one physical room into one room within FHEM. Rooms are managed by the attribute room for a specific device. Each defined devices require one or more room attributes:

attr MAX_Bedroom_Heating room Bedroom

Understanding the setup

The rooms are still controlled from the MAX!Cube and MAX-software. FHEM only listens and has useable names. FHEM does not communicate with the devices and it cannot configure devices. However you have useable and human-understandable names instead of hex-codes.

Migration

As MAX!Cube will interfere with CUL (both sending the same protocol on the same frequency) and due to the sending restrictions (1%-rule) we need to

1. Remove all rooms in MAX!Cube (which deletes the devices in MAX!Cube)
2. Reset all heaters and window contacts to factory settings
3. Pair the device to FHEM
4. Define the week heating program
5. Define the connectivity between heater and window sensors

Make a backup of your MAX!Cube configuration in case something goes seriously wrong. Have the family out of the house for 1-2 days while you run around to re-pair devices. While resetting the devices the PI-learned heating curves will be lost and the heaters need to adopt again to your house-specific heating curves.

Re-setting devices

Remove batteries and wait 45 seconds. For

1. Heater actors: Press all three buttons at the same time, insert battery until reS is displayed. Press Boost for installation menu
2. Window contacts: Press button while inserting battery and keep pressed until LED is flashing again
3. ECO-Wallcontact: Press Eco or AUTO button while inserting battery and keep pressed until LED is flashing again
4. Wallthermostats: Press "Moon", "OK" and "-" at the same time, then insert the battery [7]

Pairing devices with FHEM

Enter

set cm pairmode 45

into the command field on top of the FHEM page to configure the CUL into pairing mode for 45 seconds. Initiate the pair sequence on the device by:

1. Heater actors: Pressing Boost for about 3 seconds until 30 is displayed. The pairing succeeded when the timer is gone.
2. Window contacts: Press button, LED starts flashing. Success is reported by one last long LED signal.
3. ECO-Wallcontact: Press one button three seconds, LED starts flashing. Success is reported by one last long LED signal
4. Wallthermostat: First click several times "OK" to set a random date and time until you see the temperature again. Then press OK button three seconds until 30 is displayed. The pairing succeeded when the timer is gone.

FHEM One-Time Device-specific configuration

Certain information about FHEM are stored in the fhem.cfg which you can edit using a text editor and ssh or using the webfront. A big other, device-specific part is entered as part of commands into the webfrontend, but not documented and not stored within fhem.cfg. You will end up in a documented, structure information stored in fhem.cfg (like any other UNIX related configuration file in /etc) and a un-documented part which is stored within the devices of your appartment only.

My solution for this was to add the relevant commands into fhem.cfg as comments, so after a multiple month pause on playing with FHEM I do still see which commands belonged into which room and what I have done. However if you follow this route is important to understand that changes to these comments will never take place and change your configuration unless you copy and paste them into the command-field and execute your change.

The information stored in devices and not in fhem.cfg are

1. Heating weekProfiles - which temperature you want when
2. Associations between WindowContacts and Heaters to detect open windows.

Within the FHEM forums you find a longer discussion if windows sensors really make sense. The statement there is as the heaters have a decreasing temperature sensor they are not. It is hard for me to follow this argumentation as:

1. The heating water temperature will be impacted when it keep running while windows is open
2. The WAF (Women's Acceptance Factor) is lowered as the house should be smart
3. You may wish to have open windows longer than 10-15 minutes
4. I can document the time of getting fresh air into the rooms (for any discussions with the landlord in a rented appartment)

Window Contacts and Heaters

To connect a window contact with a heater to decrease the temperature they need to be associated to each other:

set MAX_Bedroom_WindowSensor1 associate MAX_Bedroom_Heating
set MAX_Bedroom_Heating associate MAX_Bedroom_WindowSensor1

As you can see the associations is called twice for both directions and you need to call both commands for each Window Contact in the room. FHEM will ask you in the logfile for each command to press the MAX Window Contact button when you open the Window Contact. If you have (against advice) already configured the graphing you need to disable the graphing to get the command being transmitted.

Open Window Temperature

Configure the desired Open Window temperature for that room using

set MAX_Bedroom_Heating windowOpenTemperature 5.5

You may have to wait a couple of minutes until the command has been transmitted.

Test your room by opening each Window with a Window Contact, the heater should immediately change temperature in both directions.

The Heating Profile

Device-specific configuration also includes the weekProfile, e.g. the desired temperature for each day and each hour. The format is quite simple and starts with an implicit 00:00 (midnight) and ends with an implicit 24:00 (midnight next day). In between desired temperatures are specificed interleaving with hours, seperated by ,s. Temperature is specific in degrees celsius. Example:

17,06:00,21,20:00,17

will set 17 degrees from midnight to 06:00am, 21 degrees 06:00am to 20:00 (8:00pm) and then again 17 degrees until midnight. Such profiles are defined for each day (Mon, Tue, Wed, Thu, Fri, Sat, Sun) and set with the weekProfile command:

set MAX_Child1_Heating weekProfile Mon 17,05:00,19,06:00,22,07:15,19,15:30,21,19:00,19,21:00,17 Tue 17,05:00,19,06:00,22,07:15,19,15:30,21,19:00,19,21:00,17 Wed 17,05:00,19,06:00,22,07:15,19,15:30,21,19:00,19,21:00,17 Thu 17,05:00,19,06:00,22,07:15,19,15:30,21,19:00,19,21:00,17 Fri 17,05:00,19,06:00,22,07:15,19,15:30,21,19:00,19,21:00,17 Sat 17,06:00,21,20:00,17 Sun 17,06:00,21,20:00,17

Do not attempt to break this line into multiple lines for better reading. Just one single long line. Transmission may take a couple of minutes.

Testing and Verifying

ADD ME

Add-Ons

ADD ME

Graphs using 99_UtilsMaxScan.pm

There is a Wiki-articel how to use the MAX! Temperatur-Scanner with FHEM. At the time of writing this article v1.05a has been published.

Few people have published changes to this version within the forum, which enables the use of ECO wall button and multiple WindowShutter contacts.

If you consider to create graphs for your installation your migration (as outlined above) should 'work stable, e.g.

1. week programs for all rooms are active and working
2. open windows are detected and the desired temperature is decreased
3. you do not face any logfile entries like: CUL_MAX_SendQueueHandler: Not enough credit! credit10ms is 101, but we need 110. Waiting 9 seconds.
4. you do not face any logfile entries like: CUL_MAX_SendQueueHandler: Missing ack from 020341 for 0f010403123456020341000e18003655
5. you do not plan any changes to week programs any time soon.

Do not even think about starting to graph out heaters and rooms while migration is still in progress.

Do download the Scanner Module you need to register and login into the forum. The Scanner Module is attached to the post linked at MAX! Temperatur-Scanner. Copy this file to /opt/fhem/FHEM and change ownership to fhem.

(Original Articles: Beitrag und Beitrag)

ECO-Wallswitch

According to an extensive Google search it is currently not possible to group all Heater actors and send a single command to the group to save communication credits.

A workaround is to define a FHEM structure with a speaking name and type which includes all Heaters, assign it to a new room labelled "House" and add a web control button to FHEM:

# Define House to control all Heaters at once
define AllHeaters structure AllMyHeaters MAX_Child2_Heating MAX_Workingroom_Heating MAX_Child1_Heating MAX_Livingroom_THSensor MAX_Bedroom_Heating MAX_Toilette_Heating MAX_Kitchen_Heating MAX_Bathroom_Heating
attr AllHeaters room House
attr AllHeaters webCmd desiredTemperature

The ECO Wall button has a type PushButton and is easily defined using (you have to update the address of course):

### 9.1 ECO-Wallbutton
define MAX_WallButton MAX PushButton 0521c4

To set all heaters into ECO mode until the AUTO mode is pressed on the button or the AUTO mode is called from the webpage use:

define MAX_HouseECOHeating notify MAX_WallButton:(onoff).* { if ($EVTPART1 eq 0) { Log(3,"Setting ECO-Mode") && fhem("set AllHeaters desiredTemperature eco");;} else { Log(3,"Setting AUTO-Mode") && fhem("set AllHeaters desiredTemperature auto");;}} 

(Original discussion: Beitrag)

Full fhem.cfg file (all rooms)

This is the full example of all discussed settings for the specific outlined room. If you want to adopt this setup you need to replace all MAX addresses with the addresses of your devices.

attr global autoload_undefined_devices 1
attr global logfile ./log/fhem-%Y-%m.log
attr global modpath .
attr global motd Remember to set passwords
attr global statefile ./log/fhem.save
attr global userattr MAX_Child2_Heating MAX_Child2_Heating_map devStateIcon devStateStyle icon sortby webCmd
attr global verbose 3

#### Telnet
define telnetPort telnet 7072 global

#### Screen setup
define WEB FHEMWEB 8083 global
attr WEB stylesheetPrefix dark

define WEBphone FHEMWEB 8084 global
attr WEBphone stylesheetPrefix smallscreen 

define WEBtablet FHEMWEB 8085 global
attr WEBtablet stylesheetPrefix touchpad 

#### Logfile
# Fake FileLog entry, to access the FHEM log from FHEMWEB 
define Logfile FileLog ./log/fhem-%Y-%m.log Logfile

#### Autocreate
define autocreate autocreate
attr autocreate autosave 1
attr autocreate device_room %TYPE
attr autocreate filelog ./log/%NAME-%Y.log
attr autocreate weblink 1
attr autocreate weblink_room Plots 

# Disable this to avoid looking for new USB devices on startup
define initialUsbCheck notify global:INITIALIZED usb create 

#### CUL Definition, MAX!Cube
define CUL0 CUL /dev/ttyACM0@9600 1234
attr CUL0 rfmode MAX
define cm CUL_MAX 123456 

####
#### Room Definitions
#### Heating Control = MAX
####

## 1.1 Bathroom (Heating Thermostat)
define MAX_Bathroom_Heating MAX HeatingThermostat 05615b
attr MAX_Bathroom_Heating MAX_Child2_Heating AllHeaters
attr MAX_Bathroom_Heating room Bathroom
attr MAX_Bathroom_Heating scanTemp 1
define FileLog_MAX_Bathroom_Heating FileLog ./log/MAX_Bathroom_Heating-%Y.log MAX_Bathroom_Heating
attr FileLog_MAX_Bathroom_Heating icon heizung.0
attr FileLog_MAX_Bathroom_Heating logtype text
attr FileLog_MAX_Bathroom_Heating room MAX

### 1.2 Bathroom (Window Sensor)
define MAX_Bathroom_WindowSensor MAX ShutterContact 053767
attr MAX_Bathroom_WindowSensor room Bathroom
define FileLog_MAX_Bathroom_WindowSensor FileLog ./log/MAX_Bathroom_WindowSensor-%Y.log MAX_Bathroom_WindowSensor
attr FileLog_MAX_Bathroom_WindowSensor logtype text
attr FileLog_MAX_Bathroom_WindowSensor room MAX

### 1.3 One-Time Configuration (only stored in actors, not in fhem.cfg) - commented just to document
# Activate Open Window detection
# set MAX_Bathroom_WindowSensor associate MAX_Bathroom_Heating
# set MAX_Bathroom_Heating associate MAX_Bathroom_WindowSensor
#
# Define Week Profile
# set MAX_Bathroom_Heating weekProfile Mon 17,05:00,19,06:00,22,07:15,21,08:30,17,19:00,21,20:45,17 Tue 17,05:00,19,06:00,22,07:15,21,08:30,17,19:00,21,20:45,17 Wed  17,05:00,19,06:00,22,07:15,21,08:30,17,19:00,21,20:45,17 Thu 17,05:00,19,06:00,22,07:15,21,08:30,17,19:00,21,20:45,17 Fri 17,05:00,19,06:00,22,07:15,21,08:30,17,19:00,21,20:45,17 Sat  17,06:00,21,10:00,19,19:00,21,20:45,17 Sun 17,06:00,21,10:00,19,19:00,21,20:45,17
#
# Temperatur Scanner (Graphical)
# attr MAX_Bathroom_Heating scanTemp 1
# attr MAX_Bathroom_Heating userReadings onlyAutoMode { return "1";;}
# attr MAX_Bathroom_Heating userReadings watchShutter { return "MAX_Bathroom_WindowSensor";;}
#
# WindowOpenTemperature (4.5 = OFF, No Window Detection)
# set MAX_Bathroom_Heating windowOpenTemperature 5.5
 

### 2.1 Bedroom (Heating Thermostat)
define MAX_Bedroom_Heating MAX HeatingThermostat 020341
attr MAX_Bedroom_Heating MAX_Child2_Heating AllHeaters
attr MAX_Bedroom_Heating room Bedroom
attr MAX_Bedroom_Heating scanTemp 1
attr MAX_Bedroom_Heating userReadings onlyAutoMode { return "1";;}
define FileLog_MAX_Bedroom_Heating FileLog ./log/MAX_Bedroom_Heating-%Y.log MAX_Bedroom_Heating
attr FileLog_MAX_Bedroom_Heating icon heizung.0
attr FileLog_MAX_Bedroom_Heating logtype text
attr FileLog_MAX_Bedroom_Heating room MAX 

### 2.2 Bedroom (Window Sensor)
define MAX_Bedroom_WindowSensor1 MAX ShutterContact 053fdd
attr MAX_Bedroom_WindowSensor1 room Bedroom
define FileLog_MAX_Bedroom_WindowSensor1 FileLog ./log/MAX_Bedroom_WindowSensor1-%Y.log MAX_Bedroom_WindowSensor1
attr FileLog_MAX_Bedroom_WindowSensor1 logtype text
attr FileLog_MAX_Bedroom_WindowSensor1 room MAX

### 2.3 One-Time Configuration (only stored in actors, not in fhem.cfg) - commented just to document
# Activate Open Window detection
# set MAX_Bedroom_WindowSensor1 associate MAX_Bedroom_Heating
# set MAX_Bedroom_Heating associate MAX_Bedroom_WindowSensor1
#
# Define Week Profile
# set MAX_Bedroom_Heating weekProfile Mon 17,05:00,19,06:00,21,07:15,17,19:00,19,21:00,17 Tue 17,05:00,19,06:00,21,07:15,17,19:00,19,21:00,17 Wed 17,05:00,19,06:00,21,07:15,17,19:00,19,21:00,17 Thu 17,05:00,19,06:00,21,07:15,17,19:00,19,21:00,17 Fri 17,05:00,19,06:00,21,07:15,17,19:00,19,21:00,17 Sat 17,07:00,19,09:00,21,10:00,17 Sun 17,07:00,19,09:00,21,10:00,17
#
# Temperatur Scanner (Graphical)
# attr MAX_Bedroom_Heating scanTemp 1
# attr MAX_Bedroom_Heating userReadings onlyAutoMode { return "1";;}
# attr MAX_Bedroom_Heating userReadings watchShutter { return "MAX_Bedroom_WindowSensor1";;}
#
# WindowOpenTemperature (4.5 = OFF, No Window Detection)
# set MAX_Bedroom_Heating windowOpenTemperature 5.5


### 3.1 Child 1 (Heating Thermostat)
define MAX_Child1_Heating MAX HeatingThermostat 05034f
attr MAX_Child1_Heating MAX_Child2_Heating AllHeaters
attr MAX_Child1_Heating room Child1
attr MAX_Child1_Heating scanTemp 1
attr MAX_Child1_Heating userReadings onlyAutoMode { return "1";;}
define FileLog_MAX_Child1_Heating FileLog ./log/MAX_Child1_Heating-%Y.log MAX_Child1_Heating
attr FileLog_MAX_Child1_Heating icon heizung.0
attr FileLog_MAX_Child1_Heating logtype text
attr FileLog_MAX_Child1_Heating room MAX 

### 3.2 Child 1 (Window Sensor)
define MAX_Child1_WindowSensor MAX ShutterContact 053f76
attr MAX_Child1_WindowSensor room Child1
define FileLog_MAX_Child1_WindowSensor FileLog ./log/MAX_Child1_WindowSensor-%Y.log MAX_Child1_WindowSensor
attr FileLog_MAX_Child1_WindowSensor logtype text
attr FileLog_MAX_Child1_WindowSensor room MAX 

### 3.3 One-Time Configuration (only stored in actors, not in fhem.cfg) - commented just to document
# Activate Open Window detection
# set MAX_Child1_WindowSensor associate MAX_Child1_Heating
# set MAX_Child1_Heating associate MAX_Child1_WindowSensor
#
# Define Week Profile
# set MAX_Child1_Heating weekProfile Mon 17,05:00,19,06:00,22,07:15,19,15:30,21,19:00,19,21:00,17 Tue 17,05:00,19,06:00,22,07:15,19,15:30,21,19:00,19,21:00,17 Wed  17,05:00,19,06:00,22,07:15,19,15:30,21,19:00,19,21:00,17 Thu 17,05:00,19,06:00,22,07:15,19,15:30,21,19:00,19,21:00,17 Fri 17,05:00,19,06:00,22,07:15,19,15:30,21,19:00,19,21:00,17 Sat 17,06:00,21,20:00,17 Sun 17,06:00,21,20:00,17
#
# Temperatur Scanner (Graphical)
# attr MAX_Child1_Heating scanTemp 1
# attr MAX_Child1_Heating userReadings onlyAutoMode { return "1";;}
# attr MAX_Child1_Heating userReadings watchShutter { return "MAX_Child1_WindowSensor";;}
#
# set MAX_Child1_Heating windowOpenTemperature 5.5 


### 4.1 Child 2 (Heating Thermostat)
define MAX_Child2_Heating MAX HeatingThermostat 050352
attr MAX_Child2_Heating room Child2
attr MAX_Child2_Heating scanTemp 1
attr MAX_Child2_Heating userReadings onlyAutoMode { return "1";;}
define FileLog_MAX_Child2_Heating FileLog ./log/MAX_Child2_Heating-%Y.log MAX_Child2_Heating
attr FileLog_MAX_Child2_Heating icon heizung.0
attr FileLog_MAX_Child2_Heating logtype text
attr FileLog_MAX_Child2_Heating room MAX
define SVG_FileLog_MAX_Child2_Heating_1 SVG FileLog_MAX_Child2_Heating:SVG_FileLog_MAX_Child2_Heating_1:CURRENT
attr SVG_FileLog_MAX_Child2_Heating_1 room Child2

### 4.2 Child 2 (Window Sensor)
define MAX_Child2_WindowSensor MAX ShutterContact 053fce
attr MAX_Child2_WindowSensor room Child2
define FileLog_MAX_Child2_WindowSensor FileLog ./log/MAX_Child2_WindowSensor-%Y.log MAX_Child2_WindowSensor
attr FileLog_MAX_Child2_WindowSensor logtype text
attr FileLog_MAX_Child2_WindowSensor room MAX 

### 4.3 One-Time Configuration (only stored in actors, not in fhem.cfg) - commented just to document
# Activate Open Window detection
# set MAX_Child2_WindowSensor associate MAX_Child2_Heating
# set MAX_Child2_Heating associate MAX_Child2_WindowSensor
#
# Define Week Profile
# set MAX_Child2_Heating weekProfile Mon 17,05:00,19,06:00,22,07:15,19,15:30,21,19:00,19,21:00,17 Tue 17,05:00,19,06:00,22,07:15,19,15:30,21,19:00,19,21:00,17 Wed 17,05:00,19,06:00,22,07:15,19,15:30,21,19:00,19,21:00,17 Thu 17,05:00,19,06:00,22,07:15,19,15:30,21,19:00,19,21:00,17 Fri 17,05:00,19,06:00,22,07:15,19,15:30,21,19:00,19,21:00,17  Sat 17,06:00,21,20:00,17 Sun 17,06:00,21,20:00,17
#
# Temperatur Scanner (Graphical)
# attr MAX_Child2_Heating scanTemp 1
# attr MAX_Child2_Heating userReadings onlyAutoMode { return "1";;}
# attr MAX_Child2_Heating userReadings watchShutter { return "MAX_Child2_WindowSensor";;}
#
# set MAX_Child2_Heating windowOpenTemperature 5.5


### 5.1 Kitchen (Heating Thermostat)
define MAX_Kitchen_Heating MAX HeatingThermostat 06546c
attr MAX_Kitchen_Heating MAX_Child2_Heating AllHeaters
attr MAX_Kitchen_Heating room Kitchen
attr MAX_Kitchen_Heating scanTemp 1
attr MAX_Kitchen_Heating userReadings onlyAutoMode { return "1";;}
define FileLog_MAX_Kitchen_Heating FileLog ./log/MAX_Kitchen_Heating-%Y.log MAX_Kitchen_Heating
attr FileLog_MAX_Kitchen_Heating icon heizung.0
attr FileLog_MAX_Kitchen_Heating logtype text
attr FileLog_MAX_Kitchen_Heating room MAX

### 5.2 Kitchen (Window Sensor)
define MAX_Kitchen_WindowSensor MAX ShutterContact 0612ce
attr MAX_Kitchen_WindowSensor room Kitchen
define FileLog_MAX_Kitchen_WindowSensor FileLog ./log/MAX_Kitchen_WindowSensor-%Y.log MAX_Kitchen_WindowSensor
attr FileLog_MAX_Kitchen_WindowSensor logtype text
attr FileLog_MAX_Kitchen_WindowSensor room MAX

### 5.3 One-Time Configuration (only stored in actors, not in fhem.cfg) - commented just to document
# Activate Open Window detection
# set MAX_Kitchen_WindowSensor associate MAX_Kitchen_Heating
# set MAX_Kitchen_Heating associate MAX_Kitchen_WindowSensor
#
# Define Week Profile
# set MAX_Kitchen_Heating weekProfile Mon 17,05:00,19,06:00,21,07:30,19,19:00,21,20:00,17 Tue 17,05:00,19,06:00,21,07:30,19,19:00,21,20:00,17 Wed 17,05:00,19,06:00,21,07:30,19,19:00,21,20:00,17 Thu 17,05:00,19,06:00,21,07:30,19,19:00,21,20:00,17 Fri 17,05:00,19,06:00,21,07:30,19,19:00,21,20:00,17 Sat 17,07:00,21,20:00,17 Sun 17,07:00,21,20:00,17
#
# Temperatur Scanner (Graphical)
# attr MAX_Kitchen_Heating scanTemp 1
# attr MAX_Kitchen_Heating userReadings onlyAutoMode { return "1";;}
# attr MAX_Kitchen_Heating userReadings watchShutter { return "MAX_Kitchen_WindowSensor";;}
#
# set MAX_Kitchen_Heating windowOpenTemperature 5.5


### 6.1 Livingroom (Heating Thermostats - Two)
define MAX_Livingroom_Heating1 MAX HeatingThermostat 065531
attr MAX_Livingroom_Heating1 room Livingroom
define FileLog_MAX_Livingroom_Heating1 FileLog ./log/MAX_Livingroom_Heating1-%Y.log MAX_Livingroom_Heating1
attr FileLog_MAX_Livingroom_Heating1 icon heizung.0
attr FileLog_MAX_Livingroom_Heating1 logtype text
attr FileLog_MAX_Livingroom_Heating1 room MAX 

define MAX_Livingroom_Heating2 MAX HeatingThermostat 06563a
attr MAX_Livingroom_Heating2 room Livingroom
define FileLog_MAX_Livingroom_Heating2 FileLog ./log/MAX_Livingroom_Heating2-%Y.log MAX_Livingroom_Heating2
attr FileLog_MAX_Livingroom_Heating2 icon heizung.0
attr FileLog_MAX_Livingroom_Heating2 logtype text
attr FileLog_MAX_Livingroom_Heating2 room MAX 

### 6.2 Livingroom (Window Sensors - Two)
define MAX_Livingroom_WindowSensor_Balcony MAX ShutterContact 0618ce
attr MAX_Livingroom_WindowSensor_Balcony room Livingroom
define FileLog_MAX_Livingroom_WindowSensor_Balcony FileLog ./log/MAX_Livingroom_WindowSensor_Balcony-%Y.log MAX_Livingroom_WindowSensor_Balcony
attr FileLog_MAX_Livingroom_WindowSensor_Balcony logtype text
attr FileLog_MAX_Livingroom_WindowSensor_Balcony room MAX

### 6.3 Livingroom (Wall Thermostat)
define MAX_Livingroom_THSensor MAX WallMountedThermostat 01c93f
attr MAX_Livingroom_THSensor MAX_Child2_Heating AllHeaters
attr MAX_Livingroom_THSensor room Livingroom
define FileLog_MAX_Livingroom_THSensor FileLog ./log/MAX_Livingroom_THSensor-%Y.log MAX_Livingroom_THSensor
attr FileLog_MAX_Livingroom_THSensor logtype text
attr FileLog_MAX_Livingroom_THSensor room MAX

### 6.4 One-Time Configuration (only stored in actors, not in fhem.cfg) - commented just to document
# Activate Open Window detection
# set MAX_Livingroom_WindowSensor_Balcony associate MAX_Livingroom_Heating1
# set MAX_Livingroom_Heating1 associate MAX_Livingroom_WindowSensor_Balcony
# set MAX_Livingroom_WindowSensor_Balcony associate MAX_Livingroom_Heating2
# set MAX_Livingroom_Heating2 associate MAX_Livingroom_WindowSensor_Balcony
# set MAX_Livingroom_WindowSensor_Balcony associate MAX_Livingroom_THSensor
# set MAX_Livingroom_THSensor associate MAX_Livingroom_WindowSensor_Balcony
# set MAX_Livingroom_THSensor associate MAX_Livingroom_Heating1
# set MAX_Livingroom_Heating1 associate MAX_Livingroom_THSensor
# set MAX_Livingroom_THSensor associate MAX_Livingroom_Heating2
# set MAX_Livingroom_Heating2 associate MAX_Livingroom_THSensor
#
# Define Week Profile
# set MAX_Livingroom_THSensor weekProfile Mon 17,05:00,19,06:00,22,07:15,21,22:30,17 Tue 17,05:00,19,06:00,22,07:15,21,22:30,17 Wed 17,05:00,19,06:00,22,07:15,21,22:30,17 Thu 17,05:00,19,06:00,22,07:15,21,22:30,17 Fri 17,05:00,19,06:00,22,07:15,21,22:30,17 Sat 17,06:00,21,22:30,17 Sun 17,06:00,21,22:30,17
#
# Temperatur Scanner (Graphical)
# attr MAX_Livingroom_Heating1 scanTemp 1
# attr MAX_Livingroom_Heating2 scanTemp 1
# attr MAX_Livingroom_Heating1 userReadings onlyAutoMode { return "1";;}
# attr MAX_Livingroom_Heating1 userReadings watchShutter { return "MAX_Livingroom_WindowSensor_Balcony";;}
# attr MAX_Livingroom_Heating2 userReadings onlyAutoMode { return "1";;}
# attr MAX_Livingroom_Heating2 userReadings watchShutter { return "MAX_Livingroom_WindowSensor_Balcony";;}
# attr MAX_Livingroom_THSensor userReadings onlyAutoMode { return "1";;}
# attr MAX_Livingroom_THSensor scanTemp 1
#
# set MAX_Livingroom_Heating1 windowOpenTemperature 5.5
# set MAX_Livingroom_Heating2 windowOpenTemperature 5.5
# set MAX_Livingroom_THSensor windowOpenTemperature 5.5 


### 7.1 Toilette (Heating Thermostat)
define MAX_Toilette_Heating MAX HeatingThermostat 06b990
attr MAX_Toilette_Heating MAX_Child2_Heating AllHeaters
attr MAX_Toilette_Heating room Toilette
attr MAX_Toilette_Heating scanTemp 1
attr MAX_Toilette_Heating userReadings onlyAutoMode { return "1";;}
define FileLog_MAX_Toilette_Heating FileLog ./log/MAX_Toilette_Heating-%Y.log MAX_Toilette_Heating
attr FileLog_MAX_Toilette_Heating icon heizung.0
attr FileLog_MAX_Toilette_Heating logtype text
attr FileLog_MAX_Toilette_Heating room MAX

### 7.2 Toilette (Window Sensor)
define MAX_Toilette_WindowSensor MAX ShutterContact 053d50
attr MAX_Toilette_WindowSensor room Toilette
define FileLog_MAX_Toilette_WindowSensor FileLog ./log/MAX_Toilette_WindowSensor-%Y.log MAX_Toilette_WindowSensor
attr FileLog_MAX_Toilette_WindowSensor logtype text
attr FileLog_MAX_Toilette_WindowSensor room MAX

### 7.3 One-Time Configuration (only stored in actors, not in fhem.cfg) - commented just to document
# Activate Open Window detection
# set MAX_Toilette_WindowSensor associate MAX_Toilette_Heating
# set MAX_Toilette_Heating associate MAX_Toilette_WindowSensor
#
# Define Week Profile
# set MAX_Toilette_Heating weekProfile Mon 17,05:00,19,06:00,21,07:30,19,19:00,21,20:00,17 Tue 17,05:00,19,06:00,21,07:30,19,19:00,21,20:00,17 Wed 17,05:00,19,06:00,21,07:30,19,19:00,21,20:00,17 Thu 17,05:00,19,06:00,21,07:30,19,19:00,21,20:00,17 Fri 17,05:00,19,06:00,21,07:30,19,19:00,21,20:00,17 Sat 17,07:00,21,20:00,17 Sun 17,07:00,21,20:00,17
#
# Temperatur Scanner (Graphical)
# attr MAX_Toilette_Heating scanTemp 1
# attr MAX_Toilette_Heating userReadings onlyAutoMode { return "1";;}
# attr MAX_Toilette_Heating userReadings watchShutter { return "MAX_Kitchen_WindowSensor";;}
#
# set MAX_Toilette_Heating windowOpenTemperature 5.5


### 8.1 Working room (Heating Thermostat)
define MAX_Working_Heating MAX HeatingThermostat 020551
attr MAX_Working_Heating room Workingroom
attr MAX_Working_Heating scanTemp 1
attr MAX_Working_Heating userReadings onlyAutoMode { return "1";;}
define FileLog_MAX_Working_Heating FileLog ./log/MAX_Working_Heating-%Y.log MAX_Working_Heating
attr FileLog_MAX_Working_Heating icon heizung.0
attr FileLog_MAX_Working_Heating logtype text
attr FileLog_MAX_Working_Heating room MAX
define SVG_FileLog_MAX_Working_Heating_1 SVG FileLog_MAX_Working_Heating:SVG_FileLog_MAX_Working_Heating_1:CURRENT
attr SVG_FileLog_MAX_Working_Heating_1 room Workingroom

### 8.2 Working room (Window Sensor)
define MAX_Working_WindowSensor MAX ShutterContact 06102b
attr MAX_Working_WindowSensor room Workingroom
define FileLog_MAX_Working_WindowSensor FileLog ./log/MAX_Working_WindowSensor-%Y.log MAX_Working_WindowSensor
attr FileLog_MAX_Working_WindowSensor logtype text
attr FileLog_MAX_Working_WindowSensor room MAX 

### 8.3 One-Time Configuration (only stored in actors, not in fhem.cfg) - commented just to document
# Activate Open Window detection
# set MAX_Working_WindowSensor associate MAX_Working_Heating
# set MAX_Working_Heating associate MAX_Working_WindowSensor
#
# Define Week Profile
# set MAX_Working_Heating weekProfile Mon 17,05:00,19,06:00,21,07:15,19,15:30,21,19:00,19,21:00,17 Tue 17,05:00,19,06:00,21,07:15,19,15:30,21,19:00,19,21:00,17 Wed 17,05:00,19,06:00,21,07:15,19,15:30,21,19:00,19,21:00,17 Thu 17,05:00,19,06:00,21,07:15,19,15:30,21,19:00,19,21:00,17 Fri 17,05:00,19,06:00,21,07:15,19,15:30,21,19:00,19,21:00,17  Sat 17,06:00,21,09:00,19,16:00,21,20:00,17 Sun 17,06:00,21,09:00,19,16:00,21,20:00,17
#
# Temperatur Scanner (Graphical)
# attr MAX_Working_Heating scanTemp 1
# attr MAX_Working_Heating userReadings onlyAutoMode { return "1";;}
# attr MAX_Working_Heating userReadings watchShutter { return "MAX_Working_WindowSensor";;}
#
# set MAX_Working_Heating windowOpenTemperature 5.5 

define SVG_FileLog_MAX_Bedroom_Heating_1 SVG FileLog_MAX_Bedroom_Heating:SVG_FileLog_MAX_Bedroom_Heating_1:CURRENT
define SVG_FileLog_MAX_Child1_Heating_1 SVG FileLog_MAX_Child1_Heating:SVG_FileLog_MAX_Child1_Heating_1:CURRENT
define SVG_FileLog_MAX_Bedroom_Heating_2 SVG FileLog_MAX_Bedroom_Heating:SVG_FileLog_MAX_Bedroom_Heating_2:CURRENT 

### 9.1 ECO-Wallbutton
define MAX_WallButton MAX PushButton 0521c4
#
# Define House to control all Heaters at once
define AllHeaters structure AllMyHeaters MAX_Child2_Heating MAX_Workingroom_Heating MAX_Child1_Heating MAX_Livingroom_THSensor MAX_Bedroom_Heating MAX_Toilette_Heating MAX_Kitchen_Heating  MAX_Bathroom_Heating
attr AllHeaters room House
attr AllHeaters webCmd desiredTemperature
#
define MAX_HouseECOHeating notify MAX_WallButton:(onoff).* { if ($EVTPART1 eq 0) { fhem("set AllHeaters desiredTemperature eco") && Log(3,"===> ECO-Mode set");;} else {  fhem("set AllHeaters desiredTemperature auto") && Log(3,"===> AUTO-Mode set");;}}
#
#
define SVG_FileLog_MAX_Bathroom_Heating_1 SVG FileLog_MAX_Bathroom_Heating:SVG_FileLog_MAX_Bathroom_Heating_1:CURRENT
define SVG_FileLog_MAX_Bedroom_Heating_3 SVG FileLog_MAX_Bedroom_Heating:SVG_FileLog_MAX_Bedroom_Heating_3:CURRENT
define SVG_FileLog_MAX_Child1_Heating_2 SVG FileLog_MAX_Child1_Heating:SVG_FileLog_MAX_Child1_Heating_2:CURRENT
define SVG_FileLog_MAX_Child2_Heating_2 SVG FileLog_MAX_Child2_Heating:SVG_FileLog_MAX_Child2_Heating_2:CURRENT
define SVG_FileLog_MAX_Kitchen_Heating_1 SVG FileLog_MAX_Kitchen_Heating:SVG_FileLog_MAX_Kitchen_Heating_1:CURRENT
define SVG_FileLog_MAX_Livingroom_THSensor_1 SVG FileLog_MAX_Livingroom_THSensor:SVG_FileLog_MAX_Livingroom_THSensor_1:CURRENT
define SVG_FileLog_MAX_Toilette_Heating_1 SVG FileLog_MAX_Toilette_Heating:SVG_FileLog_MAX_Toilette_Heating_1:CURRENT
define SVG_FileLog_MAX_Working_Heating_2 SVG FileLog_MAX_Working_Heating:SVG_FileLog_MAX_Working_Heating_2:CURRENT

Planned changes

ADD ME