Revision as of 21:33, 19 April 2012

The Danfoss European Radiator knob is different from any other Z-Wave device, and does not properly implement the required Z-Wave commands, so the process to use it is non-standard.

General Informations about Danfoss Thermostat

Pair the thermostat like normal. To get it to pair you may have to press the black button on the thermostat several times. It's not always easy to get it to pair. You may have to tap it several times in rapid succession. Sometimes you have to tap the black button 10 times or so, wait, tap it again 10 times or so, wait, try to tap it very fast 10 times, and so on. This is a problem with the Danfoss thermostat itself, but if you're patient it will generally always pair eventually.

It will probably appear first as a thermostat and marked as not yet being configured because it's a battery operated device and must wake up before it can be configured. So after it's paired and you set it in the UI, you can either wait about an hour and it will eventually wake up on it's own and get properly configured, or to wake it up immediately, you can press the activate button on the thermostat repeatedly in rapid succession, just like you did to pair it. Just like with pairing sometimes you have to repeat several times. When it's woken up, you'll see in the UI that it's being configured. The thermostat doesn't always stay awake long enough to complete the configuration process. If you wake it up and you see in Vera's UI an error, wait 45 minutes, and then wake it up again. Vera will then continue to configure it where Vera left off the last time. You may need to repeat this process a few times. You have to be patient. Do not click "Reconfigure" in Vera's UI. This causes the configuration to start all over again from the top at step #1. The key is to get the thermostat to wake up every 45 minutes or so until the configuration process is complete. This is a special process for the Danfoss thermostat.

According to the documentation it should only require a double-click to pair or wake up, and sometimes it does, but we've also seen thermostats that won't wakeup without several re-attempts, so just be patient. Once Vera is able to configure it, it will change in Vera's UI from a thermostat to a 'generic i/o device'. This is because the Danfoss isn't really a thermostat. It doesn't have temperature set points, or a thermometer, or heat/cool modes. It's just a 2 mode switch (daylight mode and energy saving mode), and 'off' puts it in Energy Saving Mode, and 'on' puts it in daylight mode.

When Vera shows the thermostat as a 'generic i/o' device with the description "Danfoss Radiator" it's ready to be used. Note that the thermostat only wakes up periodically to accept commands. So when you press off or on, the command is queued until the next time the thermostat wakes up. You can reduce the wakeup interval so it wakeups or more often (click the + button on Vera's device page), but note that it will reduce battery time. The minimum wakeup interval is 300 seconds (5 minutes), and the default is 1800 seconds (30 minutes). When done, click 'save'. It will probably have a message needing to be reconfigured again because every time you change something, Vera needs to re-configure it, but can only do that when you press the activate button. Again, press the activate button repeatedly to wake it up and confirm you get the green cog. Once you have the 'green cog', click the Save button again (even it's grayed out), to be sure the current configuration status is saved.

To use it: the 'Off' button puts the thermostat in 'energy saving' (ie night) mode, and the 'On' in 'normal' (ie day) mode. You can add the Danfoss thermostat to scenes like any other Z-Wave device. When you run the 'off' or 'on' commands, you will get a 'failure' because they failed as the Danfoss is asleep. But the next time the Danfoss wakes up, Vera will re-try the failed command and turn it on or off.

Manual Danfoss Thermostat inclusion in Scenes/Events

Since the Danfoss Thermostat it's just a 2 mode switch ('daylight mode and energy saving mode' or let's say On/Off mode) you can tweak it in order to include it in a Scene and add an Event. The procedure is this:

1. Go to Devices/Luup plugins. Note: On UI4 you will need to go to MiOS Developers > Luup Files
   
2. Press Luup Files
   
3. Press Download on the D_GenericIO1.xml file
4. Edit with Wordpad or an XML editor
5. Your current content of this file is something like this:

<?xml version="1.0"?>
<root xmlns="urn:schemas-upnp-org:device-1-0">
  <specVersion>
    <major>1</major>
    <minor>0</minor>
  </specVersion>
  <device>
    <deviceType>urn:schemas-micasaverde-com:device:GenericIO:1</deviceType>
    <serviceList>
      <service>
        <serviceType>urn:schemas-micasaverde-com:service:HaDevice:1</serviceType>
        <serviceId>urn:micasaverde-com:serviceId:HaDevice1</serviceId>
        <controlURL>/upnp/control/HaDevice1</controlURL>
        <eventSubURL>/upnp/event/HaDevice1</eventSubURL>
        <SCPDURL>S_HaDevice1.xml</SCPDURL>
      </service>
      <service>
        <serviceType>urn:schemas-upnp-org:service:SwitchPower:1</serviceType>
        <serviceId>urn:upnp-org:serviceId:SwitchPower1</serviceId>
        <SCPDURL>S_SwitchPower1.xml</SCPDURL>
      </service>
    </serviceList>
  </device>
</root>

6. Add the following code between </serviceList> and </device> lines

	<sceneList>

{
	"group_1":{
		"cmd_1": 
		{
			"label": "ON",
			"serviceId": "urn:upnp-org:serviceId:SwitchPower1",
			"action": "SetTarget",
			"arguments":
			{
				"newTargetValue": "1"
			}
		},
		"cmd_2": 
		{
			"label": "OFF",
			"serviceId": "urn:upnp-org:serviceId:SwitchPower1",
			"action": "SetTarget",
			"arguments":
			{
				"newTargetValue": "0"
			}
		}
	}
}	
	</sceneList>
 	<eventList>
{
	"event_1":{
		"label": "A device is turned on or off",
		"serviceId": "urn:upnp-org:serviceId:SwitchPower1",
		"argumentList" :
		{
			"argument_1" :
			{
				"dataType": "boolean",
				"defaultValue": "1",
				"allowedValueList" : 
				{
					"Off" : "0",
					"On" : "1"
				},
				"name": "Status",
				"comparisson": "=",
				"prefix": "Which mode",
				"suffix": ""
			}
		}
	}
}
  </eventList>	

7. Upload the new file called exactly D_GenericIO1.xml by pressing "Broswe", check the "Restart Luup after upload" and press "Go". The old file will be overwritten and the Luup will be restarted in order to load the new file.

Now you should be able to select the Generic I/O Danfoss Thermostat from the Commands list in the Scenes.