How to integrate a Swisscom Multisense button on akenza

In this tutorial you will learn how to integrate the Multisense button of Swisscom
Multisense button of Swisscom

‚Äč

Applications:

  • Workplace occupancy and doorways

  • 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.

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.

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.

Device connector

Use the search field to search for Multisense in the Device Type library. In this tutorial we chose 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 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 Mailgun as output connectors.

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 the "Button" topic. Create 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.

Create the Multisense button Device

To create a new device, select "Create Device" within the menu of Assets Inventory.

Add a device name and optional a description. Choose the Data Flow of the Multisense button that you just have created.

Create new device

Before we proceed with the Connectivity Parameters, reset your device to connect to Swisscom LoRaWAN. To do so, press the Multisense button for three seconds. The green LED will flash accordingly. Your device is now ready to be integrated.

Fill in the following Connectivity Parameters about your Multisense button and select "Create Device".

Enter connectivity parameters

Now you will see your added Multisense device in the Asset Inventory Overview.

Asset Inventory Overview

Configure your device per downlink

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 Button

[PINCODE]b8a710030000000080817f7f000000000000

Swisscom Multisense Ambience

[PINCODE]0827100300001e0130007f7f000000000000

Swisscom Multisense Workplace

[PINCODE]082710030100050607

Swisscom Multisense Vibration

[PINCODE]0827100300003c0108007f7f0000000a2000

Swisscom Multisense General

[PINCODE]0880640300000001f8e17f7f0000000ae555

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

Swisscom Multisense 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 Ambience

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

Swisscom Multisense Workplace

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 Vibration

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

Swisscom Multisense General

This mode is only for demo purpose and enables all sensors for an immediate feedback on the device while demonstrating. The demo mode is not intended for a 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 Payload HEX as well Port 100 and select "Send message". You will get notified if the Downlink was sent successfully.

Downlink settings

Test your setup

Go to Message Logs on the Asset Detail View of your Multisense button device to see incoming data. Press also the Service button and check your mailbox, if you receive the Service-request-Mail.

Message Logs on Asset Detail Page

Congratulations, you have successfully integrated your Multisense button device.