Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Section
Align
alignright

Valid for:

N610

N670

N870

N870E

Embedded Integrator

Virtual Integrator

#F85404
Panel
Panel
titleColor
titleBGColor#F0F0F0
titleIntroductionValid for N670 / N870 / N870E, but not supported by N610.

Application servers can communicate with the DECT system Alarming systems can connect to our Nx70 via the MQTT protocol.

This The MQTT interface will be License and Password protected.access can be configured via the:

  • Web-interface
  • Auto-provisioning

You can connect using:

Message flow examples can be found here: FAQ - Application servers, message flow examples

The following test environment is used for the documentation.

environment is used.

Ubuntu preparation

First we installed the mosquitto client: sudo apt install mosquitto-clients

Host file:

Add the N870 to your host file. (/etc/hosts)

Panel
titleColor#F85404
titleBGColor#F0F0F0
titleConfiguration

In the web-interface go to: SETTINGS - Online services - Application servers


Image Added


Create an Account for an

Since software 2.35, the MQTT interface is available for starting the first tests. It is not protected by a license but you need to enable it via auto-provisioning.

How to enable the application server web-page

You need to create the provisioning file below and start provisioning (Can be done via the web-interface)

Info
iconfalse
titleEnable MQTT web-page via provisioning

<?xml version="1.0" encoding="UTF-8"?>
<provisioning version="1.1" productID="e2">

<nvm>

<oper name="set_webui_visibility">

<param name="menu.settings/online-services/application-servers" value="visible" />

</oper>

</nvm>
</provisioning>

After the provisioning, the Application Servers page is now visible.

FAQ Nx70 - Application servers (Hidden)

Create an

Application server

You now can create an application server access.

  • Id: id for external clients are: "as1", "as2" ...
  • Application server name (username) (At least one character is needed)
  • Password (has to be at least 32 characters using hexadecimal digits only: 0 1 2 3 4 5 6 7 8 9 a b c d e f A B C D E F)

FAQ Nx70 - Application servers (Hidden)Image Added


Info
iconfalse
titleAdd MQTT client via Create an account via auto-provisioning

<?xml version="1.0" encoding="UTF-8"?>
<provisioning version="1.1" productID="e2">

<nvm>

<oper name="set_external_client">

<param name="Username" value="as1" />
<param name="Password" value="123456789012345678901234567890ab123456789012345678901234567890aB" />

</oper>

</nvm>
</provisioning>

Panel
titleColor#F85404
titleBGColor#F0F0F0
titleExample
draw.io Diagram
bordertrue
diagramNameMQTT_Test
simpleViewerfalse
width
linksauto
tbstyletop
lboxtrue
diagramWidth762
revision3
Code Block
127.0.0.1       localhost
127.0.1.1       eric-VirtualBox
192.168.178.192 int-589ec60e71c0

# The following lines are desirable for IPv6 capable hosts
::1     ip6-localhost ip6-loopback
fe00::0 ip6-localnet
ff00::0 ip6-mcastprefix
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters
Panel
titleColor#F85404
titleBGColor#F0F0F0
titleLocation service

With the following command you can ask for the location information from the handset with IPUI 029e74a599

Code Block
sudo mosquitto_pub -u as1 --psk-identity as1 --psk 123456789012345678901234567890ab -t 'as1/location/ipui/029e74a599/req/position' -m '{"msgId":"pos_2","params":{"ipui":"029e74a599","mode":"dps"}}' -p 8884 -h int-589ec60e71c0 
  • "as1" proper external_client id
  • "123456789012345678901234567890abEEEE" proper external client password
  • "{}" inside You can specify the message
  • "8884" messages can be only sent on port 8884

The following answer is received

Code Block
Location request using IPUI
as1/location/ipui/029e74a599/req/position {
											"msgId":"pos_2",
											"params":
											{
												"ipui":"029e74a599",
												"mode":"dps"
											}
										}

Positive response
dm2/029e74a599/as1/location/res/position
											{
												"msgId":"pos_2",
												"payload":{"ble":{},
												"dm_id":"dm2",
												"dps":
											{"bases":
												[{"fpn":"215","rpn":"66","rssi":"60"},
											 	 {"fpn":"215","rpn":"67","rssi":"59"}],
											"bs_fpn":"215",
											"bs_mac":"7c2f80e0d6d7",
											"bs_name":"BSDM2",
											"bs_rpn":"66",
											"time":"1593602403"},
											"ipui":"029e74a599",
											"sip_id":"1023"}}

dm2/1023/as1/location/res/position 
										{
											"msgId":"pos_2",
											"payload":{"ble":{},
											"dm_id":"dm2","dps":
											{"bases":
												[{"fpn":"215","rpn":"66","rssi":"60"},
												 {"fpn":"215","rpn":"67","rssi":"59"}],
											"bs_fpn":"215",
											"bs_mac":"7c2f80e0d6d7",
											"bs_name":"BSDM2",
											"bs_rpn":"66",
											"time":"1593602403"},
											"ipui":"029e74a599",
											"sip_id":"1023"}}
Code Block
Location request using IPUI as1/location/ipui/029e74a599/req/position { "msgId":"pos_2", "params": { "ipui":"029e74a599", "mode":"dps" } } Positive response dm1/029e74a599/as1/location/res/position { "msgId":"pos_2", "payload":{"ble":{}, "dm_id":"dm1", "dps": {"bases": [{"fpn":"215","rpn":"2","rssi":"58"}, {"fpn":"215","rpn":"67","rssi":"60"}, {"fpn":"215","rpn":"66","rssi":"60"}], "bs_fpn":"215", "bs_mac":"589ec60d8c73", "bs_name":"BSDM1", "bs_rpn":"2", "time":"1593602685"}, "ipui":"029e74a599", "sip_id":"1023"}} dm1/1023/as1/location/res/position { "msgId":"pos_2", "payload":{"ble":{}, "dm_id":"dm1", "dps": {"bases": [{"fpn":"215","rpn":"2","rssi":"58"}, {"fpn":"215","rpn":"67","rssi":"60"}, {"fpn":"215","rpn":"66","rssi":"60"}], "bs_fpn":"215", "bs_mac":"589ec60d8c73", "bs_name":"BSDM1", "bs_rpn":"2", "time":"1593602685"}, "ipui":"029e74a599", "sip_id":"1023"}}