homematic.html

<script type="text/x-red" data-template-name="homematic">
	<div class="form-row" id="node-form-_method">
        <label for="node-input-_method"><i class="fa fa-list"></i> Method</label>
		<select id="node-input-_method">
			<option value="Session.login">Session.login</option>
			<option value="Session.logout">Session.logout</option>
            <option value="Interface.setValue">Interface.setValue</option>
			<option value="Interface.getValue">Interface.getValue</option>
			<option value="Interface.init">Interface.init</option>
			<option value="Device.listAllDetail">Device.listAllDetail</option>
			<option value="Device.listAll">Device.listAll</option>
			<option value="Event.poll">Event.poll</option>
			<option value="Event.subscribe">Event.subscribe</option>
			<option value="Event.unsubscribe">Event.unsubscribe</option>
        </select>
    </div>
	<div class="form-row hidden" id="node-form-_interface">
        <label for="node-input-_interface"><i class="fa fa-globe"></i> Interface</label>
		<select id="node-input-_interface">
			<option value=""></option>
            <option value="BidCos-RF">BidCos-RF</option>
        </select>
    </div>
	<div class="form-row" id="node-form-_device">
        <label for="node-input-_device"><i class="fa fa-dot-circle-o"></i> Device</label>
        <input type="text" id="node-input-_device">
    </div>
	<div class="form-row" id="node-form-_valueKey">
        <label for="node-input-_valueKey"><i class="fa fa-list"></i> ValueKey</label>
		<select id="node-input-_valueKey">
			<option value=""></option>
            <option value="ACTUAL_TEMPERATURE">ACTUAL_TEMPERATURE</option>
			<option value="ACTUAL_HUMIDITY">ACTUAL_HUMIDITY</option>
			<option value="SET_TEMPERATURE">SET_TEMPERATURE</option>
			<option value="MANU_MODE">MANU_MODE</option>
			<option value="AUTO_MODE">AUTO_MODE</option>
			<option value="BOOST_MODE">BOOST_MODE</option>
			<option value="COMFORT_MODE">COMFORT_MODE</option>
			<option value="LOWERING_MODE">LOWERING_MODE</option>
			<option value="PARTY_MODE_SUBMIT">PARTY_MODE_SUBMIT</option>
			<option value="PARTY_TEMPERATURE">PARTY_TEMPERATURE</option>			
			<option value="LEVEL">LEVEL</option>
			<option value="STATE">STATE</option>
        </select>
    </div>
	<div class="form-row" id="node-form-_type">
        <label for="node-input-_type"><i class="fa fa-bookmark"></i> Type</label>
		<select id="node-input-_type">
			<option value=""></option>
            <option value="boolean">boolean</option>
			<option value="string">string</option>
        </select>
    </div>
	<div class="form-row" id="node-form-_username">
        <label for="node-input-_username"><i class="fa fa-tag"></i> Username</label>
        <input type="text" id="node-input-_username" placeholder="Username">
    </div>
		<div class="form-row" id="node-form-_password">
        <label for="node-input-_password"><i class="fa fa-tag"></i> Password</label>
        <input type="password" id="node-input-_password" placeholder="Password">
    </div>
	<div class="form-row" id="node-form-_url">
        <label for="node-input-_url"><i class="fa fa-tag"></i> URL</label>
        <input type="text" id="node-input-_url" placeholder="URL">
    </div>
	<div class="form-row" id="node-form-_interfaceId">
        <label for="node-input-_interfaceId"><i class="fa fa-tag"></i> InterfaceId</label>
        <input type="text" id="node-input-_interfaceId" placeholder="InterfaceId">
    </div>
	<div class="form-row" id="node-form-_value">
        <label for="node-input-_value"><i class="fa fa-sign-out"></i> Value</label>
        <input type="text" id="node-input-_value" placeholder="Value">
    </div>
	<div class="form-row" id="node-form-_topic">
        <label for="node-input-_topic"><i class="fa fa-tasks"></i> Topic</label>
        <input type="text" id="node-input-_topic" placeholder="Leave blank for auto generated">
    </div>
<div class="form-row" id="node-form-_name">
<label for="node-input-_name"><i class="fa fa-tag"></i> Name</label>
<input type="text" id="node-input-_name" placeholder="Leave blank for auto generated">
</div>
</script>

<script type="text/x-red" data-help-name="homematic">
    <p>This Node provides predefined commands to control homematic devices 
       using the JSON-RPC API.</p>
    <p>Select a method and fill in the required fields.</p>
	<p></p>
	<p>To use JSON-RPC with your ccu your need to optain a SessionId using
	the "Session.Login" method. You can save the SessionId to "context.global.currentSessionid"
	and each msg you create using this node will use this SessionId automatically.</p>
    <p>Add currentSessionid: "" to functionGlobalContext in settings.js</p>
	<p>After some time your SessionId will expire so you need to create some logic to optian a new one.</p>
	<p>In order to communicate with your homematic device you need to find out the serialnumber.
	An easy way to find out the serialnumber of your device is using the homematic ccu webui.</p>
	<p>XML-API addon provided by <a href="http://www.homematic-inside.de/software/addons/item/xmlapi" target="_blank">homematic inside</a>
	gives you additional information about which values you can set. (You can for example use statelist.cgi and search for your serialnumber)</p>
	<p><b>Input:</b>you can input "msg.payload.value" and it will be used as value</p>
    <p><b>Outputs:</b> a msg object containing remote procedure calls which can be send using the http-request node</p>
	<p></p>
	<p>API Documentation: ipofyourcc/api/homematic.cgi</p>
	<p></p>
	<p>You can easily extend this module to fit your needs
	by editing the html file.</p> 
	<p>Pull requests are welcome
	<a href="https://github.com/firsttris/node-red-contrib-homematic" target="_blank">Github</a>
	</p>
</script>

<script type="text/javascript">
    RED.nodes.registerType('homematic', {
	category : 'function',
	color : "#ecf0f1",
	defaults : {
	    _method : {
		value : "",
		required : true
	    },
	    _interface : {
		value : ""
	    },
	    _device : {
		type:"homematic-config"
	    },
	    _valueKey : {
		value : ""
	    },
	    _type : {
		value : ""
	    },
	    _url : {
		value : ""
	    },
	    _interfaceId : {
		value : ""
	    },
	    _value : {
		value : ""
	    },
	    _topic : {
		value : ""
	    },
	    _username : {
		value : ""
	    },
	    _password : {
		value : ""
	    },
	    _name : {
		value : ""
	    },
	},
	inputs : 1,
	outputs : 1,
	icon : "envelope.png",
	label : function() {
	    return this._name || "homematic";
	},
	labelStyle : function() {
	    return (this._name) ? "node_label_italic" : "";
	},
	oneditprepare : function() {

	    $("#node-input-_method").change(function() {
		var selectedMethod = $("#node-input-_method").val();
		clearValuesOnMethodChange(selectedMethod);
		hideAndShowOnMethodChange(selectedMethod);
	    });
	    $("#node-input-method").change();

	    function hideAndShowOnMethodChange(selectedMethod) {

		if (selectedMethod === "Session.login") {
		    hideFields(true, true, true, true, false, false, true, true, true);
		} else if (selectedMethod === "Session.logout") {
		    hideFields(true, true, true, true, true, true, true, true, true);
		} else if (selectedMethod === "Interface.setValue") {
		    hideFields(false, false, false, false, true, true, false, true, true);
		} else if (selectedMethod === "Interface.getValue") {
		    hideFields(false, false, false, true, true, true, true, true, true);
		} else if (selectedMethod === "Interface.init") {
		    hideFields(false, true, true, true, true, true, true, false, false);
		} else if (selectedMethod === "Device.listAllDetail") {
		    hideFields(true, true, true, true, true, true, true, true, true);
		} else if (selectedMethod === "Device.listAll") {
		    hideFields(true, true, true, true, true, true, true, true, true);
		}
	    }

	    function hideFields(_interface, _device, _valueKey, _type, _username, _password, _value, _url, _interfaceId) {
		if (_interface) {
		    $("#node-form-_interface").hide();
		} else {
		    $("#node-form-_interface").show();
		}

		if (_device) {
		    $("#node-form-_device").hide();
		} else {
		    $("#node-form-_device").show();
		}

		if (_valueKey) {
		    $("#node-form-_valueKey").hide();
		} else {
		    $("#node-form-_valueKey").show();
		}

		if (_type) {
		    $("#node-form-_type").hide();
		} else {
		    $("#node-form-_type").show();
		}

		if (_username) {
		    $("#node-form-_username").hide();
		} else {
		    $("#node-form-_username").show();
		}

		if (_password) {
		    $("#node-form-_password").hide();
		} else {
		    $("#node-form-_password").show();
		}

		if (_value) {
		    $("#node-form-_value").hide();
		} else {
		    $("#node-form-_value").show();
		}

		if (_url) {
		    $("#node-form-_url").hide();
		} else {
		    $("#node-form-_url").show();
		}

		if (_interfaceId) {
		    $("#node-form-_interfaceId").hide();
		} else {
		    $("#node-form-_interfaceId").show();
		}
	    }

	    function clearValuesOnMethodChange(selectedMethod) {

		if (selectedMethod === "Session.login") {
		    clearValueOnField(true, true, true, true, false, false, true, true, true);
		} else if (selectedMethod === "Session.logout") {
		    clearValueOnField(true, true, true, true, true, true, true, true, true);
		} else if (selectedMethod === "Interface.setValue") {
		    clearValueOnField(false, false, false, false, true, true, false, false, false);
		} else if (selectedMethod === "Interface.getValue") {
		    clearValueOnField(false, false, false, true, true, true, true, true, true);
		} else if (selectedMethod === "Interface.init") {
		    clearValueOnField(false, true, true, true, true, true, true, false, false);
		} else if (selectedMethod === "Device.listAllDetail") {
		    clearValueOnField(true, true, true, true, true, true, true, true, true);
		} else if (selectedMethod === "Device.listAll") {
		    clearValueOnField(true, true, true, true, true, true, true, true, true);
		} else if (selectedMethod === "Event.poll") {
		    clearValueOnField(true, true, true, true, true, true, true, true, true);
		} else if (selectedMethod === "Event.subscribe") {
		    clearValueOnField(true, true, true, true, true, true, true, true, true);
		} else if (selectedMethod === "Event.unsubscribe") {
		    clearValueOnField(true, true, true, true, true, true, true, true, true);
		}

	    }

	    function clearValueOnField(_interface, _device, _valueKey, _type, _username, _password, _value, _url, _interfaceId) {
		if (_interface)
		    $("#node-input-_interface").prop("selectedIndex", 0);
		if (_device)
		    $("#node-input-_device").prop("selectedIndex", 0);
		if (_valueKey)
		    $("#node-input-_valueKey").prop("selectedIndex", 0);
		if (_type)
		    $("#node-input-_type").prop("selectedIndex", 0);
		if (_username)
		    $("#node-input-_username").val("");
		if (_password)
		    $("#node-input-_password").val("");
		if (_value)
		    $("#node-input-_value").val("");
		if (_url)
		    $("#node-input-_url").val("");
		if (_interfaceId)
		    $("#node-input-_interfaceId").val("");
	    }

	},
	oneditsave : function() {
	    if($("#node-input-_name").val() === "") {
			var nameAndTopic = $("#node-input-_method").val().replace("Interface.","").replace("Session.","");
			if($("#node-input-_valueKey").val() != "") {
			    nameAndTopic = nameAndTopic + " " + $("#node-input-_valueKey").val();
			}
			if($("#node-input-_device option:selected").text() != "") {
			    nameAndTopic = nameAndTopic + " " + $("#node-input-_device option:selected").text();
			}
			
		    $("#node-input-_name").val(nameAndTopic);
		    $("#node-input-_topic").val(nameAndTopic);
	    } else {
			$("#node-input-_topic").val($("#node-input-_name").val());
	    }

	}
    });
</script>

<script type="text/x-red" data-template-name="homematic-config">
    <div class="form-row">
        <label for="node-config-input-device"><i class="fa fa-tag"></i> Device</label>
        <input type="text" id="node-config-input-device" placeholder="Device Name">
    </div>
    <div class="form-row">
        <label for="node-config-input-serial"><i class="fa fa-globe"></i> Serial#</label>
        <input type="text" id="node-config-input-serial" placeholder="Serial#">
    </div>
</script>

<script type="text/javascript">
    RED.nodes.registerType('homematic-config',{
        category: 'config',
        defaults: {
            device: {value:""},
            serial: {value:""},

        },
        label: function() {
            return this.device;
        }
    });
</script>