akenza.io
Search…
How to integrate a Swisscom Multisense button on akenza
In this tutorial you will learn how to integrate the Multisense button 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 here.

1. Create a Data Flow

Go to "Data Flow" in the left-side menu and select "Create Data Flow". As we have with the Multisense button a LoRa device, you select LoRaWAN as Device connector.
Device connectors on Data Flow
Make use of the Connectivity-as-a-Service that akenza offers. Therewith 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. To do so, select Swisscom LPN and proceed to the Device Type.
CaaS device connectors
Use the search field to search for Multisense in the Device Type library. In this tutorial, we choose the Multisense Button Device Type, as we only want to trigger a Service request when the Service button gets pressed. Select the Multisense Button device type and proceed further to the Output Connector.
Device Type selection of Multisense Button
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.
Akenza DB & E-Mail Output Connectors
To store all data on the Akenza DB, select "all" on the Akenza DB Topic. Select "All" on the E-Mail topic, as this Device Type only consists of the "Button" topic. 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 button Device.

2. Create the Multisense button device

To create a new device, select "Create Device" within the menu of Assets Inventory.
Add a device name and choose the Data Flow of the Multisense button that you just have created.
Create new device form
Fill in the Connectivity Parameters about your Multisense button and select "Create Device".
Enter connectivity parameters
You will see now your created Multisense device in the Asset Inventory Overview.
Connect now your 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 it with a downlink of your choice. Choose the downlink respective to the selected device type. If you are going with your own user-specific configuration, choose the general device type to fetch all data. In this tutorial, we use the Downlink HEX string of the Multisense button Device Type.
Device Types
Downlink Hex string
Swisscom Multisense Service Button
[PINCODE]b8a710030000000080817f7f000000000000
Swisscom Multisense Temperature & Humidity
[PINCODE]0827100300001e0130007f7f000000000000
Swisscom Multisense Workplace occupancy
[PINCODE]082710030100050607
Swisscom Multisense Reed (door) counter
[PINCODE]0827100300003c0140a17f7f000000000000
Swisscom Multisense Vibration
[PINCODE]0827100300003c0108007f7f0000000a2000
Swisscom Multisense 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 button device to see incoming data. Press the Service button and check if you receive the Service-Request as an E-Mail.
Message Logs on Asset Detail Page
Congratulations, you have successfully integrated your Multisense button device.
Last modified 1mo ago