How to test WebSocket on DICENTIS wired: Conf Protocol & custom made platforms (Synoptic Webview)?

[#1]

Intro

The Conference protocol is a platform-independent protocol which is based on Web-Socket technology to enable scalability of the DICENTIS system and it connects with the DICENTIS web server.

This is a small introduction to test if the web socket is basically working and if the connection is right.

Step-by-step guide:

Conference Protocol Demonstrator

Please note that a web based demonstrator is available to assist developing and debug fixing for your own interface.

The documentation and how tow use it can be found at this link.

• https://licensing.boschsecurity.com/software/html/pages/home/
• https://licensing.boschsecurity.com/software/DICENTIS/ConferenceProtocol.chm

First test is to see if the port is available if not please check your IP settings.

Enter the following in your browser.

• https://<ipaddress>:31416/Demonstrator/ConferenceProtocolDemonstrator.html

In this example the server has the IP of 169.254.212.209 (due to a test without DHCP, not recommended to use this Link Local address for your server!) If you see this page you can reach the web server.

As next step we will show you a simple method to test the web socket and command the DICENTIS some tasks. If this is working, then the Dicentis web socket is fine.

First you have to install Weasel ADD-ONS in your browser.

Secondly you have to settle the connection with in Weasel. Please enter the following.

"URL:" wss://<dcnm_server_ipaddress>:31416/dicentis/api   (in this case = wss://169.254.212.209:31416/dicentis/api  )

and open "Protocol" DICENTIS_1_0

If you did everything right it will show you "CONNECTION READY"

 Next let's log in the DICENTIS.  The user name is "admin" and we have no password set ""

{

"messageId": 2,

"operation": "Login",

"parameters":

{"password":"", "user":"admin" }

}

You will get this response.

Now let's try to get some seats.

{

"messageId": 3,

"operation": "GetSeats",

"parameters": {}

}

Oh I forgot to switch the DICENTIS on.

{

"messageId": 4,

"operation": "GetSystemPowerMode",

"parameters": {}

}

Than lets switch it on now.

{

"messageId": 5,

"operation": "SetSystemPowerMode",

"parameters":

{ "powerMode": "poweredOn" }

With this short commands we were able to test the connection and control the DICENTIS.

If you need additional information please have a look at "ConferenceProtocol.chm" under Docs which is provided within the DCNM Software. Please always use the same .chm protocol as you are running right now. If you update your system don't use the old one anymore since were are for example some changes implemented from time to time. If you use a Crestron system in between please do first a backup so that you can easily switch back if needed. You will probably have to change your programming depending on your version. Please check History before you go for a higher version.

• https://licensing.boschsecurity.com/software/DICENTIS/DCNM.iso

With the Debugger you can look into the program code.

Please note that every command is described in the Conference Protocol Reference!

And you can check it with the Conference Protocol Demonstrator.

Please check the History before you update your system because it is steadily improving and some commands were changed.