INSTAR Deutschland GmbH

INSTAR MQTT Server with homee



Node-RED Configuration

If you aren't using Node-RED already please follow our tutorials on how to set up the program under Windows, LINUX Debian or on a Homematic CCU3. If you are using a Raspberry Pi to run Node-RED, you can use the official installation script to have the program set up automatically for you.

You can follow our tutorial on how to connect Node-RED to your INSTAR Full HD camera MQTT interface.

Connecting the homee Gateway

Using homee Environment Variables

First we are going to use the homee Webhook service to trigger a Node-RED Flow for us. As a trigger I want to use the homee system variables, like away, home, vacation. Let's start by creating a webhook in Node-RED that we can contact from the homee gateway:


homee Node-RED MQTT connection to your INSTAR IP Camera


You can import this flow to your Node-RED panel with the following JSON code:

[{"id":"181fefd6.961e6","type":"http in","z":"4ea30e4c.29d4","name":"homee env","url":"/homee/environment/","method":"post","upload":false,"swaggerDoc":"","x":80,"y":340,"wires":[["405534e7.66348c","bec44bcd.5eb548"]]},{"id":"405534e7.66348c","type":"http response","z":"4ea30e4c.29d4","name":"Webhook","statusCode":"","headers":{"content-type":"application/json"},"x":228,"y":340,"wires":[]},{"id":"bec44bcd.5eb548","type":"debug","z":"4ea30e4c.29d4","name":"","active":true,"tosidebar":true,"console":false,"tostatus":false,"complete":"false","x":240,"y":299,"wires":[]}]

The webhook we created will wait to receive a POST request on the URL /homee/environment/:


homee Node-RED MQTT connection to your INSTAR IP Camera


Great! Now we can switch to the home dashboard and create a automation that is able to utilize this webhook. Click to create a new Homeegram:


homee Node-RED MQTT connection to your INSTAR IP Camera


Click on When to set the condition that should be met for the action to be triggered and select Mode:


homee Node-RED MQTT connection to your INSTAR IP Camera


Select Mode is set to Home and click on done to save the condition:


homee Node-RED MQTT connection to your INSTAR IP Camera


Now we need to add an Then action we want to be triggered when the condition is met:


homee Node-RED MQTT connection to your INSTAR IP Camera


Here we will choose the Webhook and type in the URL of the hook we just created in Node-RED. We set this to be /homee/environment/. So if your Node-RED installation is running on a computer with the IP 192.168.2.48 and is using the default port 1880 the complete URL is:

http://192.168.2.48:1880/homee/environment/

Select the POST method and add a JSON body payload {"val":"home"}. This way we can reuse the webhook for all environment variables and add different actions in Node-RED depending on what value was posted - home, away, sleeping, vacation.


homee Node-RED MQTT connection to your INSTAR IP Camera


After saving our Homeegram we can now give it a test run. The webhook we created in Node-RED had a debug node connected. So if you switch on the debug panel in Node-RED (small bug icon in the top right) we should be able to our POST request come in when we change our homee variable to home:


homee Node-RED MQTT connection to your INSTAR IP Camera


Now we can repeat those steps to create Homeegrams for every environment variable we want to use in Node-RED. To differentiate between those cases we will use a switch node in Node-RED and attach it to our webhook node (the complete flow can be downloaded below and imported to Node-RED):


homee Node-RED MQTT connection to your INSTAR IP Camera


The switch node will check the message that was send and look for the value val. If it is home the message will be forwarded through exit 1 and every message that carries an away will leave the node through exit 2.

And the rest can be copy&pasted from our Node-RED MQTT Tutorial. We need to set the message to the value that we need and connect it to a MQTT Out node for the command topic we want to update:


homee Node-RED MQTT connection to your INSTAR IP Camera


In this example we want to disable the motion detection area 1 when the home environment variable is activated. This is done by sending {"val":"0"} to the alarm/area1/enable topic.


homee Node-RED MQTT connection to your INSTAR IP Camera


Flow Download

[{"id":"181fefd6.961e6","type":"http in","z":"4ea30e4c.29d4","name":"homee env","url":"/homee/environment/","method":"post","upload":false,"swaggerDoc":"","x":80,"y":80,"wires":[["405534e7.66348c","97d88190.082db"]]},{"id":"405534e7.66348c","type":"http response","z":"4ea30e4c.29d4","name":"Webhook","statusCode":"","headers":{"content-type":"application/json"},"x":238,"y":40,"wires":[]},{"id":"97d88190.082db","type":"switch","z":"4ea30e4c.29d4","name":"","property":"payload.val","propertyType":"msg","rules":[{"t":"eq","v":"home","vt":"str"},{"t":"eq","v":"away","vt":"str"}],"checkall":"true","repair":false,"outputs":2,"x":229,"y":80,"wires":[["8a63a528.e6e3f8"],["80d7c418.063f58"]]},{"id":"8a63a528.e6e3f8","type":"change","z":"4ea30e4c.29d4","name":"home","rules":[{"t":"set","p":"payload","pt":"msg","to":"{\"val\":\"0\"}","tot":"str"}],"action":"","property":"","from":"","to":"","reg":false,"x":372,"y":54,"wires":[["e86399a7.4e76e8"]]},{"id":"80d7c418.063f58","type":"change","z":"4ea30e4c.29d4","name":"away","rules":[{"t":"set","p":"payload","pt":"msg","to":"{\"val\":\"1\"}","tot":"json"}],"action":"","property":"","from":"","to":"","reg":false,"x":372,"y":100,"wires":[["f96ffbe7.2eca78"]]},{"id":"e86399a7.4e76e8","type":"mqtt out","z":"4ea30e4c.29d4","name":"alarm/area1/enable","topic":"instar/000389888811/alarm/area1/enable","qos":"1","retain":"false","broker":"9e4e460d.640f18","x":529,"y":54,"wires":[]},{"id":"f96ffbe7.2eca78","type":"mqtt out","z":"4ea30e4c.29d4","name":"alarm/area1/enable","topic":"instar/000389888811/alarm/area1/enable","qos":"1","retain":"false","broker":"9e4e460d.640f18","x":527,"y":101,"wires":[]},{"id":"9e4e460d.640f18","type":"mqtt-broker","z":"","name":"IN-9010FHD","broker":"192.168.2.165","port":"8883","tls":"b55f9f2e.fe529","clientid":"","usetls":true,"compatmode":true,"keepalive":"60","cleansession":true,"birthTopic":"","birthQos":"0","birthPayload":"","closeTopic":"","closeQos":"0","closePayload":"","willTopic":"","willQos":"0","willPayload":""},{"id":"b55f9f2e.fe529","type":"tls-config","z":"","name":"","cert":"","key":"","ca":"","certname":"instar-cert.cert","keyname":"","caname":"","servername":"","verifyservercert":false}]
  • Note that this flow uses the MQTT topic instar/000389888811/alarm/area1/enable - you will have to swap 000389888811 with the MAC address of your camera to make this work. See the MQTT Introduction for more details.

Connecting a Sensor to your Camera

Start by creating a new Homeegram and defining the When condition:


homee Node-RED MQTT connection to your INSTAR IP Camera


This time we have to choose a Device as the trigger for our action:


homee Node-RED MQTT connection to your INSTAR IP Camera


We choose a ZigBee motion detector that has been connected to our homee gateway:


homee Node-RED MQTT connection to your INSTAR IP Camera


The action of this automation should trigger when the ZigBee sensor reports a motion:


homee Node-RED MQTT connection to your INSTAR IP Camera


As action we choose a webhook http://192.168.2.48:1880/homee/motionsensor/ and POST a {"val":"1"} to it:


homee Node-RED MQTT connection to your INSTAR IP Camera


The corresponding webhook in Node-RED is even simpler this time:


homee Node-RED MQTT connection to your INSTAR IP Camera


homee sends us a POST request with the payload {"val":"1"} through the webhook. All we need to do is to connect a MQTT Out node that updates the topic /alarm/pushalarm on our camera. Now every time the ZigBee sensor reports a motion an alarm will be triggered on our camera.


homee Node-RED MQTT connection to your INSTAR IP Camera


Flow Download

[{"id":"4080d8b0.359ba8","type":"http in","z":"4ea30e4c.29d4","name":"homee motion","url":"/homee/motionsensor/","method":"post","upload":false,"swaggerDoc":"","x":90,"y":220,"wires":[["a073e475.1c5da8","66f1a6a1.b59f78"]]},{"id":"a073e475.1c5da8","type":"http response","z":"4ea30e4c.29d4","name":"Webhook","statusCode":"","headers":{"content-type":"application/json"},"x":238,"y":180,"wires":[]},{"id":"66f1a6a1.b59f78","type":"mqtt out","z":"4ea30e4c.29d4","name":"alarm/pushalarm","topic":"instar/000389888811/alarm/pushalarm","qos":"1","retain":"false","broker":"9e4e460d.640f18","x":270,"y":220,"wires":[]},{"id":"9e4e460d.640f18","type":"mqtt-broker","z":"","name":"IN-9010FHD","broker":"192.168.2.165","port":"8883","tls":"b55f9f2e.fe529","clientid":"","usetls":true,"compatmode":true,"keepalive":"60","cleansession":true,"birthTopic":"","birthQos":"0","birthPayload":"","closeTopic":"","closeQos":"0","closePayload":"","willTopic":"","willQos":"0","willPayload":""},{"id":"b55f9f2e.fe529","type":"tls-config","z":"","name":"","cert":"","key":"","ca":"","certname":"instar-cert.cert","keyname":"","caname":"","servername":"","verifyservercert":false}]
  • Note that this flow uses the MQTT topic instar/000389888811/alarm/pushalarm - you will have to swap 000389888811 with the MAC address of your camera to make this work. See the MQTT Introduction for more details.