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
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.
Make use of the Connectivity-as-a-Service that akenza offers. 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.
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.
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
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.
[PINCODE] = first 4 characters and last 4 characters of your Application key Port = 100
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.
This mode reports the temperature and relative humidity of the sensor in regular intervals.
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.
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.
This mode counts the number of times acceleration is detected above the defined threshold, no matter the directionality.
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.
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.