How to integrate a Swisscom Multisense device on akenza

In this tutorial you will learn how to integrate the Multisense device on akenza

Multisense of Swisscom

Applications:

• Workplace occupancy and doorways

• Temperature & Humidity

• General service button

Product features:

• A simple plug-and-play solution with a range of different sensors in a compact, battery-powered device

• Reduces the complexity of IoT projects and is quick to install without in-depth technical knowledge.

You will find more information about the Swisscom LoRaWAN Multisense device here.

1. Create a Data Flow

Go to Data Flow in the left-side menu and select Create Data Flow. As we have a LoRa device, select LoRa as a device connector.

Device connector

Make use of the akenza Connectivity-as-a-Service offer. Therefore you do not need to have an account ready from a network provider. You simply connect your LoRa device to a network provider which is hosted and managed from akenza. Select Swisscom LPN and proceed to the Device Type.

CaaS device connector

Use the search field to search for Multisense - General in the Device Type library. Proceed further to the Output Connector.

Device type Multisense - General

When the Service button gets pressed, an E-Mail shall be sent to a recipient. Sent data shall be also stored on the Akenza DB. Therefore select Akenza DB and E-Mail as output connectors.

Output connector Akenza DB & E-Mail

Create the following Mail notification:

• Name: Service on Demand

• Subject: Service request

• Message: You have a Service request.

• Recipients: Your mail address

Once your mail notification is created, proceed with Save Data Flow. Now you are ready to create the Multisense device in the Asset Inventory.

2. Create the Multisense device

To create a new device, select Create Device in the Asset Inventory.

Add a device name and choose the Data Flow of the Multisense that you just have created.

Create new device form

Fill in the Connectivity Parameters about your Multisense device and select Create Device.

Connectivity parameters

Once created, you will see now your Multisense device in the Asset Inventory Overview.

Connect now the Multisense device to join the network by pressing the Multisense button for three seconds. The green LED will flash accordingly. The device starts to join the network, which is indicated by a short blink sequence in green. If the join was successful, the sequence will be followed by a long green blink. If the join failed, this will be indicated with a red blink. With a button press of 3s or longer, a restart of the device can be initiated at any time.

Once the device has joined the network, the Connectivity Status on the Asset Inventory of your device will be displayed with a green icon.

Connectivity Status on Asset Inventory Overview

2.1 Configure your device mode per downlink

Now with your device up and running, you can configure different device modes with a downlink. In this tutorial, we use the Downlink HEX string of the Multisense button mode.

Device modes	Downlink Hex string
Service Button	[PINCODE]b8a710030000000080817f7f000000000000
Temperature & Humidity	[PINCODE]0827100300001e0130007f7f000000000000
Workplace occupancy	[PINCODE]082710030100050607
Reed (door) counter	[PINCODE]0827100300003c0140a17f7f000000000000
Vibration	[PINCODE]0827100300003c0108007f7f0000000a2000
General (all sensors on)	[PINCODE]0880640300000001f8e17f7f0000000ae555

[PINCODE] = first 4 characters and last 4 characters of your Application key Port = 100

Swisscom Multisense Service Button

This mode will trigger a network-confirmed uplink message for each button press. If the button isn't pressed within 24 hours, the device will trigger a life sign message to report it is still working and under network coverage.

Swisscom Multisense Temperature & Humidity

This mode reports the temperature and relative humidity of the sensor in regular intervals.

Swisscom Multisense Workplace occupancy

This mode will use the internal accelerometer to measure the occupation of a desk by the vibrations on that surface. The occupancy or usage of any other object could also be measured, however, the configuration of this mode is matched for the workplace occupancy.

Swisscom Multisense Reed (door) counter

This mode reports how often a magnet has approached the reed contact on the device sufficiently. With an appropriate installation on the door, this mode can be used eg. to count the number of times a door is opened. Use cases: Door counting, predictive maintenance, monitoring of moving parts etc.

Swisscom Multisense Vibration

This mode counts the number of times acceleration is detected above the defined threshold, no matter the directionality.

Swisscom Multisense General (all sensors on)

This mode is only for demo purposes and enables all sensors for immediate feedback on the device while demonstrating. The demo mode is not intended for productive use and might drain the battery quickly. After using the demo mode, please reset the device to a standard mode.

To send the downlink to your Multisense button device, go to Downlink on the Asset Detail View. Insert the Downlink HEX string as well Port 100 and press Send message. You will get notified if the Downlink was sent successfully.

Downlink settings

3. Test your setup

Go to Message Logs on the Device Detail View of your Multisense device to see incoming data. Press the Service button and check if you receive the Service-Request via E-Mail.

Congratulations, you have successfully integrated your Multisense button device.