INSTAR Deutschland GmbHINSTAR Deutschland GmbH

INSTAR MQTT on Android



Use your INSTAR cameras MQTT interface with your Android device. There are a couple of MQTT apps available on the Google Play Store that allow you to control your INSTAR Full HD IP camera.

They all offer, more or less, the same functions and similar interfaces. In the following we are going to take a look at two of them - the MQTT Dash (IoT, Smarthome) and MQTT Dashboard - IoT and Node-RED controller.

INSTAR MQTT on Android

MQTT Dash (IoT, Smarthome)

INSTAR MQTT on Android

Once you downloaded, installed and started the app click on the Plus icon in the top right to add your MQTT broker - in our case, our INSTAR Full HD camera.

INSTAR MQTT on Android

First, name your broker and type in the IP address of your camera. The default port to communicate with the MQTT Broker on your camera is 1883. Add the username and password you set for your broker.

INSTAR MQTT on Android

Once you saved your settings you will now see your new broker on the frontpage of your dashboard. Select it to continue.

INSTAR MQTT on Android

We can now add an UI element to interact with our camera. In this first example we will choose a Switch/Button.

INSTAR MQTT on Android

After naming your switch, you have to add the MQTT Topic that you want to update every time the switch is used. In this case we choose to activate/deactivate the Alarm Area 1 of our camera. The corresponding MQTT Topic for this function is alarm/area1/enable. To access this topic on our broker we have to add the keyword instar and the LAN MAC Address of our camera - in my case this is 000389888811 (you can find your cameras LAN MAC address in the Web User Interface).

Now we have to subscribe to the Status Topic and publish Updates to the Command Topic (every time an topic is updated and the function on our camera triggered we receive an status update from MQTT broker to see that everything had worked.) The resulting topics look the following:

  • Command Topic: instar/000389888811/alarm/area1/enable (for publishing)
  • Status Topic: instar/000389888811/status/alarm/area1/enable (for subscriptions)

In some cases we have to use a different Command Topic that allows us to send the message payload raw, without the JSON formating. So we are just sending 1 as the message payload instead of the {"val":"1"}. For this we have to add raw to the topic that we want to update:

  • Command Topic (RAW): instar/000389888811/alarm/area1/enable/raw (for publishing)

The switch now can have 2 states - the area 1 is either active or not. You can check what values are available for a specific MQTT topic in our MQTT API documentation. The topic alarm/area1/enable can either be {"val":"0"} or {"val":"1"}. We have to assign the first one to the OFF State of our switch and the second to the ON State.

INSTAR MQTT on Android

Save those settings and repeat it for all 4 areas (Tip: press & hold the switch for area 1 to clone it 3 times. Now you just have to edit each clone and replace every area1 with the area2, area3 or area4, respectively).

INSTAR MQTT on Android

To show a different UI element we now want to add the alarm detection area Sensitivity to our UI. For this click on Plus and select Range/progress.

INSTAR MQTT on Android

The sensitivity can be accessed by the MQTT Topic alarm/area1/sensitivity. The value here can be between {"val":"1"} and {"val":"100"}. To extract the number from this JSON expression we have to define the JSON Path $.val. Now add the minimal (1) and maximal (100) value and make sure that precision is set to 0!

Note that we are using the Status Topic instar/000389888811/status/alarm/area1/sensitivity, that will give use the current state in the JSON format. For the Command Topic we have to use instar/000389888811/alarm/area1/sensitivity/raw - the raw at the end means that we are able to send our data non-JSON formated.

INSTAR MQTT on Android

After saving your settings you can now again clone the UI element for all 4 areas.

INSTAR MQTT on Android

In a last step we can now add our cameras live image to our dashboard.

INSTAR MQTT on Android

Here we simply have to add our cameras snapshot path (just add your IP address and camera login):

  • http://IP-Address:Port/tmpfs/snap.jpg?usr=admin&pwd=instar Snapshot (1080p)
  • http://IP-Address:Port/tmpfs/auto.jpg?usr=admin&pwd=instar Snapshot (320p)
  • http://IP-Address:Port/tmpfs/auto2.jpg?usr=admin&pwd=instar Snapshot (160p)

INSTAR MQTT on Android

After setting the update interval and saving your settings, you should now be able to see your cameras live image on your MQTT dashboard. If you don't like the arrangement of the UI elements on your dash, click on the lock icon in the top right. When unlocked, you are able to rearrange each element.

Mqtt Dashboard IoT and Node-RED controller

INSTAR MQTT on Android

As mentioned above, the functions as well as the UI of all those MQTT apps is very similar. Just click to add your broker.

INSTAR MQTT on Android

Add your cameras MQTT service.

INSTAR MQTT on Android

Now add a switch (Toogle) to switch on/off your cameras alarm areas.

INSTAR MQTT on Android

Add the MQTT Topic and the available values this switch can have.

INSTAR MQTT on Android

For the Area sensitivity we can use the Progress UI element. And again, add the MQTT Topic and the available values this switch can have.

INSTAR MQTT on Android