How to setup the threshold actions in Intelligent Insights?

[#1]

Intelligent Insights support controlling Bosch IP cameras by Common Gateway Interface (CGI) commands over HTTP or HTTPS when a threshold of the area fill level, area fill level traffic light or occupancy use case is reached.

Follow the step-by-step guide below and find how you can to setup the threshold actions in Intelligent Insights.

Step-by-step guide

1. Enable the threshold action by selecting the checkbox
2. Click on the threshold level that you want to trigger the action with
3. Specify the complete URL of the command that is sent when the fill level of the area is above the warning value set
4. Type the user name and password of the camera / 3rd party device

General notes:

• Make sure  that "Basic authentication" is enabled in the camera security settings.
• Also cameras that are not added to Intelligent Insights can be used to send the CGI commands. There is no check if the camera exists in the configuration or not. The feature just sends the configured command to the configured camera IP address.
• Restful API call responses are not further processed.
• When using the CGI commands with Bosch cameras, the XML return message, when controlling, is not further processed.

Controlling Bosch IP devices by threshold actions:

Bosch IP video products can be controlled and managed using an enhanced version of Remote Control Protocol. This protocol defines commands and messages that allow to control the device, such as controlling a relay or moving the camera to a preposition. 

The command structure of RCP+ must be translated into parameters and values handed over to the unit’s XML-based CGI interpreter as a query string.

Using HTTP as transportation protocol, for example with a web browser, an URL may look like: 

•  HTTP://160.10.0.1/rcp.xml?<<query_string>>

Example where 10.120.22.214 is the IP address of a selected camera:

• For activating a camera relay by Alarm, add URL: http://10.120.22.214/rcp.xml? command=0x01c1&type=F_FLAG&direction=WRITE&num=1&payload=0x01
• For deactivation a camera relay by Normal, add URL: http://10.120.22.214/rcp.xml? command=0x01c1&type=F_FLAG&direction=WRITE&num=1&payload=0x00

Detailed information can be found here.

External signaling units can be connected to the Bosch camera relay, for example, to start a voice message or turn on lights.

Controlling 3rd party devices by threshold actions:

Next to controlling Bosch IP Camera devices it is also possible to send RESTFUL API Get calls to 3rd party devices.

In the version 1.0 of Intelligent Insights only RESTFUL GET commands are supported.

If the 3rd party device allows to control the device by GET commands, this functionality allows to control 3rd party devices.

Note:

Restful API calls can be send to devices that support

• basic authentication via https
• basic authentication via http

Only restful API GET commands are supported in Version 1.0