akenza.io
Search…
⌃K

Integrate a MClimate Vicki LoRaWAN Radiator Thermostat on akenza

In this tutorial you will learn how to integrate the Vicki LoRaWAN radiator thermostat on akenza
Applications:
  • Comfortable adjustment of radiator heaters
  • Retrofit manually operated thermostats
  • Save energy by turning the temperature down during absences.
Product features:
  • Mountable on the majority of radiator valves, adapters available
  • Non-technical usage with the mobile app
  • Mobile app or enterprise platform can manage multiple thermostats
  • Ability to manage schedules, child lock, open window detection
You will find more information about the MClimate Vicki LoRaWAN thermostat here.

How it works

The MClimate Vicki LoRaWAN thermostat requires a network connection over a LoRaWAN network. The network server can be configured to forward all data coming from the device to the MClimate service. A mobile app and an enterprise solution can then be used to claim a device registered on the network. Several thermostat can then be controlled and observed in a simple manner using a mobile phone or a computer.
Registering a Vicki LoRaWAN thermostat on akenza brings freedom to use the LoRaWAN network provider of choice. Currently, the following networks are tested and supported:
Network managed by akenza
Supported
Swisscom
yes
Loriot
yes
TTN
yes

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.
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.
Use the search field to search for Vicki in the Device Type library, Select Vicki by MClimate. Proceed further to the Output Connector.
Add the first output connector to store the data coming from Vicki in the internal database where it can be used to observe key data and to send manual downlink commands on the akenza platform. Choose akenza Database to do so. Click on the filter icon and add or select the topic default. This results in the topic default being saved into the akenza Database.
The akenza Database output connector
Add another output connector and choose Webhook from the list. Give the webhook a name, e.g., 'mclimate'.
Method: POST
Content Type: JSON
Auth Type: Headers
Auth headers: api-key and the API Key previously generated.
Press Save Connector and Save Data Flow.
Not all data needs to be forwarded to MClimate, so click the filter icon on the webhook connector and select the topic mclimate.
Data Flow with the two output connectors

2. Create the Vickidevice (tbd)

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 Mu
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

3. Connect the mobile app

See documentation MClimate

3. Adjust the Vicki

  • manually on the device: set setting 'manual'
  • in the app
  • in the enterprise platform
Keep in mind:
  • Adjustments from the app or enterprise platform can take 10-20 minutes to take effect. This is because downlinks are only processed when the Vicki is sending data.
  • When adjusting manually on the thermostat, changes can take a few minutes to show up in the app or on the enterprise platform.