akenza.io
WebsiteAPI DocumentationWhat's newLogin
  • Overview
  • Getting Started
    • Connect a Device
  • Changelog
  • General
    • Applications
    • Organization context
    • Workspace Context
    • Users
      • User Roles
  • Device Management
    • Managing an organization
      • API keys
      • Users (Organization)
        • Add & removing users from your organization
    • Managing a workspace
      • General Settings
        • Device Lifecycle Reports
        • Workspace properties
        • Occupancy settings
        • Device Setup Assistant
      • Custom fields
      • Tags
      • Users (Workspace)
    • Devices
      • Device
      • Device Simulator
      • Bulk actions
      • Bulk import CSV templates
    • Rules
      • Input
      • Logic blocks
        • Comparison
        • Custom Logic
          • Logic Block Scripting
      • Timed Rules
      • Rule Actions
        • Downlink
    • Data Flows
      • Device Connectors
        • Device Security
          • Using Device Credentials
            • Creating Public/Private Key Pairs
            • Using JSON Web Tokens (JWTs)
              • Python
              • Java
        • HTTP
        • MQTT
        • CoAP
        • LoRaWAN
          • Connectivity Management
          • Swisscom LoRaWAN
          • The Things Network
          • Loriot
          • Actility’s ThingPark Wireless
          • EWZ
          • Cibicom
          • Helium
          • ChirpStack
        • NB-IoT
        • mioty
        • Disruptive Technologies
        • VergeSense
        • Spaceti
        • Haltian
      • Device Types
        • Custom Device Types
          • Uplink
          • Downlink
          • Scripting
        • Library
      • Output Connectors
        • Databases
          • akenza DB
          • InfluxDB
          • SQL Databases
        • Streaming
          • Webhook
          • Azure IoT Hub
          • AWS Kinesis
          • Google Cloud Pub/Sub
          • Apache Kafka
        • Notifications
          • E-Mail
          • SMS
          • Microsoft Teams
          • Slack
    • Custom Components
    • Integrations
    • Reference
      • REST API
        • Filtering
        • Querying Device Data
      • WebSocket API
      • Scripting
        • Stateful Operations
        • Utility Functions
      • Payload Templating
  • Reference
  • Dashboard Builder
    • Managing Dashboards
      • Embedding dashboards
    • Components
      • Map
      • Floorplan
  • Device Setup Assistant
    • Device Setup Assistant - Overview
  • Tutorials
    • BI Tools
      • Grafana Data Source Plugin
      • How to build a dashboard with Retool
      • How to analyze data with AWS QuickSight
    • Devices
      • How to integrate the XDK device from Legic via MQTT on akenza
      • How to connect the Disruptive Technologies-cloud on akenza
      • How to send Downlinks to the Kuando Busylight device
      • How to integrate an Arduino device via MQTT on akenza
      • Integrate a MClimate Vicki LoRaWAN Radiator Thermostat on akenza
      • How to integrate an ERS Elsys device with Loriot on akenza
      • How to integrate the IAM Decentlab device with TTN on akenza
      • How to integrate the Seeed SenseCAP T1000 tracker on akenza
      • How to integrate a Swisscom Multisense device on akenza
    • Notifications
      • How to send SMS notifications
      • How to send notifications to Slack
      • How to send notifications to Microsoft Teams
    • Enterprise solutions
      • How to send data to Azure IoT Hub
      • How to send data to the Google Cloud Pub/Sub
      • How to send data to InfluxDB
      • How to send data to AWS Kinesis
      • How to send data to Azure Event Hubs with Apache Kafka
    • IoT Starter Kits
      • How to integrate the IAQ Kit with Actility on akenza
      • How to integrate the CoWork Kit with Actility on akenza
      • How to integrate the Smart Building Kit with Actility on akenza
      • How to integrate the Pepperl+Fuchs Kit with Actility on akenza
  • Support Center
    • FAQ
    • Status Page
    • Service Desk
    • Request a feature
  • Deprecated
    • SIM-Cards
    • Everynet
    • Sigfox
    • How to connect the Yanzi Lifecycle cloud on akenza
Powered by GitBook
On this page
  • How it works
  • 1. Preparations
  • 2. Create a Data Flow
  • 3. Create the device
  • 4. Use the MClimate Enterprise platform and the mobile app
  • 5. Using the Vicki

Was this helpful?

  1. Tutorials
  2. Devices

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.

PreviousHow to integrate an Arduino device via MQTT on akenzaNextHow to integrate an ERS Elsys device with Loriot on akenza

Last updated 8 months ago

Was this helpful?

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 .

How it works

The MClimate Vicki LoRaWAN thermostat requires a 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 thermostats 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 LPN

yes

Loriot

yes

TTN

yes

1. Preparations

For this integration two keys are needed: The token to authenticate with the MClimate broker for uplinks and another key to authenticate with the akenza platform for downlinks:

  1. API key to authenticate downlinks coming from the MClimate broker on the akenza platform: Open the akenza platform. In the left menu, select Organisation and then API Keys. Create a new API key and give it at least Data Flow permissions.

2. Create a Data Flow

Select a workspace and 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 Type

Use the search field to search for Vicki in the Device Type library, Select Vicki (MClimate).

Output Connector 1: Akenza Database

Choose akenza Database as the first output connector to store the measurements and settings data coming from Vicki in the internal database on the platform. Click on the filter icon and select the topic default. This results in the topic default being saved into the akenza Database. The default topic contains the decoded data from the Vicki.

Output Connector 2: Webhook

Add another output connector and choose Webhook from the list. Give the webhook a name, e.g., 'MClimate'.

Method: POST

Headers: m-token ("key" field) and the token previously generated in MClimate Enterprise.

Content Type: JSON

Auth Type: Headers

Auth headers: api-key and the akenza API Key previously generated.

Press Save Connector.

Not all data needs to be forwarded to MClimate, so click the filter icon on the webhook connector and select the topic raw_payload.

Press Save Data Flow.

3. Create the device

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

Add a device name and choose the Data Flow of the Vicki that you just have created. Add a description or tags to your liking.

Choose the data flow just created to assign the device to it and select Next.

Fill in the LoRaWAN keys of the Vicki thermostat and the additional parameters. The keys are supplied by the manufacturer of the device.

Once created, the Vicki thermostat appears in the assets list.

Make the Vicki thermostat join the network now by inserting or shortly removing and reinserting the batteries. Attach it to your heater. Refer to the MClimate documentation on how to fit it to your specific heater. An adapter might be needed.

Click on the device to check the connection status and the measurement values it transmits. It might be necessary to wait 10-20min until the device transmits some data.

4. Use the MClimate Enterprise platform and the mobile app

The Vicki is now sending data to the MClimate Enterprise platform. You can now add the Vicki to the Enterprise platform to check the device status and to configure it.

Once registered, the device will be available to be read and controlled remotely using the platform or the mobile app.

Congratulations, you have now integrated the MClimate Vicki LoRaWAN thermostat with the connectivity of your choice on the akenza platform. Time to adjust your heaters and save some energy.

5. Using the Vicki

  • The temperature can be adjusted manually by rotating the thermostat. The new set target temperature will be transmitted to the akenza platform and the MClimate Enterprise platform when the next uplink happens.

  • The target temperature can be adjusted in the MClimate Enterprise platform by either entering a manual temperature value or by adding a schedule for automatic adjustment of the temperature.

  • The target temperature can also be adjusted in the mobile app.

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.

Support

First, check the for your heater and get it ready.

Token to authenticate uplinks on the MClimate broker: Open the MClimate Enterprise Platform: Signup on the platform if you don't have an account already. Click on the menu entry Integrations. Create a new token by clicking on "create a new M Token" and give it a name. This token will be needed in step 2.

Make use of the (CaaS) that akenza offers. Therefore you do not need to have a connectivity account from a network provider. You simply connect your LoRa device to a network provider which is then managed from akenza. Select Actility Swisscom -> Swisscom LPN, The Things Stack -> The Things Network or Loriot -> Loriot.

As the URL, enter

Refer to the MClimate Enterprise platform on how to register a device there.

MClimate compatibility tool:

MClimate Enterprise platform:

MClimate documentation for the right adapter
https://enterprise.mclimate.eu/
https://lorawan-broker.mclimate.eu/akenza
documentation
https://compatibility-tool.mclimate.eu/
https://enterprise.mclimate.eu/
here
Connectivity-as-a-Service
Output connector webhook to MClimate