Control

The Control panels contains two sections:

  • Basic

  • Advanced

Both are different depending on which MClimate device you choose, however there are similarities, especially in the Basic one.

We are going to take a look at each in turn.

Basic Control

The example we will look at is for a Vicki, perhaps the most wide-spread MClimate product, where the parameters are shared by a lot of the MClimate devices.

The following 3 common parameters are:

  1. Target Temperature

  2. Child lock

  3. Keepalive interval (minutes)

Basic Control

Target Temperature

This is the desired temperature for the space where the device is operating and/or the space where the device it is controlling is operating (for example a Wireless Thermostat can control the target temperature of Multiple Vickis in multiple rooms).

You can easily adjust the target temperature by hoovering over the box and pressing on the up or down arrows.

Target Temperature change

If your device is under a Heating Schedule it will go into Manual boost mode once you adjust the temperature. This boost length will depend on you Heating Profile settings .

You can also adjust the Boost timer manually from the field (refer to the image below).

Adjusting Boost time

Child Lock

This is an on/off functionality that can be adjusted by the toggle. If Child lock is ON, one would not be able to adjust the Target temperature manually from the device (in this example rotating the crown of Vicki will not change the temperature and a Lo symbol will be displayed instead of digits).

Child lock toggle

Keepalive interval (minutes)

The Keepalive interval determines how often the device will send its regular uplink messages, updating the Enterprise platform on its status. Depending on how often you want updates on the status of your devices, you can adjust this down to a minute accuracy.

Keepalive interval

Advanced Control

This portion of the Device Control panel is intended for advanced users only. Each and every of the settings discussed throughout this chapter has a default value that MClimate has pre-selected based on good operational practices. If you intend to change any of the settings make sure you go throughout this section beforehand and read the complete device documentation in the relevant Device documentation article in our Docs hub.

This section is separated in two sub sections:

  • Device specific controls - parameters that are individual (might be shared on some level between different devices) for the specific device in question that affect its operation. Changing this will affect its behavior as far as its main functionality goes, for example in the case of Vicki we will be discussing below it will impact how well it maintains the temperature in the room via adjusting the TRV openness.

  • General control - common settings for all MClimate devices that affect general operation in terms of network and connectivity. While related at some level, these do not impact the main functionality of the devices as far as what its intended use is.

Device specific controls

There are way too many settings to talk about into detail in this section, however we will give a brief explanation of the most important ones. Refer to the device specific documentation to learn more about a specific parameter/setting.

Device specific settings

We are going to discuss the following here:

  • Temperature range settings

  • Operational mode

  • Valve openness in percentage

  • Valve openness range in percentage

The rest are a more complex set that is intended to realize additional functionality and is best left for the device specific documentation you can find in the link -> Vicki Device Documentation.

Temperature range settings

This is an important parameter that limits the heating range of the device. It is especially useful in large buildings where you want to limit how much a tenant can increase/decrease the heating system output when manual control is enabled (Child lock is off).

Temperature range settings

The minimum permitted value for the Min parameter is 5.

The maximum permitted value for the Max parameter is 30.

This is also the Default range.

Operational Mode

You can control the main Operational Mode of Vicki via the drop down menu. It operates in Automatic mode by default however you can choose from 3 options:

  • Manual - the device is connected to the network; internal temperature control algorithm is disabled. Motor position is determined by the server. Default online mode for f.w. <= 3.4

    • Disable MCloud algorithm - this disables the control algorithm completely, adjusting the valve openness will entirely depend on sending custom commands to Vicki which would not be done automatically by Enterprise. You would have to do it manually or use a separate platform.

    • Online MCloud algorithm - utilize the Enterprise online algorithm

    • Proportional Control MCloud algorithm - a more advanced version of the Enterprise algorithm, using Proportional control that is in its beta stage

Manual sub-modes of operation
  • Automatic - the device is connected to the network; internal temperature control algorithm is enabled; Target temperature is determined by the server. Default online mode for f.w. >=3.5

  • Automatic with ext. temp sensor - the device is connected to the network; internal temperature control algorithms are enabled; internal temperature sensor is disabled; Target temperature and sensor reading is determined by the server.

Once you select this mode you also need to select the device to provide the External temperature readings. You need to have one of the following in the Building in order to take advantage of this feature: Vicki (another unit), CO2 Display, Wireless Thermostat, CO2 Sensor, HT Sensor.

Automatic with ext. temp sensor external sensor selection
Vicki Operational mode

Operational modes are quite complex and we advice you to delve deeper into their principles of operation. More information is available in Vicki's documentation in theOperational modes & temperature control algorithms chapter.

Valve openness in percentage

This will let you directly set how much you want the valve to be open via entering a value in percentage of it being completely open. For example entering 50 will open/close it half way through.

Valve openness in percentage

Valve openness range in percentage

The percentage range for the previous command. This will determine to what degree you will be allowed to open/close the valve.

For example setting Min % to 20 and Max % to 80 would meant that you can close the valve within 20% to its fully closed state and open it within 20% of its fully open state. Thus it will never be more than 80% open and 80% closed.

Valve openness range in percentage

General Control

A set of parameters that is common for the MClimate LoRaWAN device line. This do not impact the main functionality of the device in a way you will immediately notice (like changing the Target temperature for example), however they are important for the long term operation of the device.

General settings

Network join-retry period

This determines how often the device will try to join a network once it has been powered on. It is a setting we rarely recommend adjusting, however you could benefit from decreasing/increasing the interval in some cases. For example, if you want to make sure the device joins as soon as possible in case of network outage/instability. Keep in mind though that if there is no LoRaWAN coverage and this interval is high, you will incur battery life costs, so do not set this value too low.

Network join-retry period

Radio communication watch-dog parameters

This is another settings that has to do with network connectivity which sets 2 separate timers, one for confirmed uplink mode and one for unconfirmed uplink mode. When the timer for the current operational mode expires the device assumes it has been disconnected from the network and start attempting to rejoin (using the previously mentioned parameter to send regular join requests). This is a very important mechanic as it determines how quickly a disconnected device will re-join a network that has been down and has recovered.

Radio communication watch-dog parameters
  • Confirmed Uplinks - the number of confirmed keep-alive messages that would have to not receive a response from the LNS for the device to decide it has been disconnected. The device waits an additional 7 minutes and start attempting to reconnect. Example -> For a device with a default keep-alive (10 minutes) and default watch-dog parameter (2), it would take 2x10+7=27 minutes to decide it has been disconnected and start attempting to re-join.

  • Unconfirmed Uplinks - the number of hours that need to elapse with no response from the LNS for the device to decide it has been disconnected and start re-joining. We do not recommend reducing this value below 12 hours as it might cause unnecessary re-join cycling in unstable networks or limited range ones.

There are two separate values for confirmed/unconfirmed mode. The value to be used will be the one corresponding to the mode the device is currently working in.

This setting determines whether the device will send confirmed or unconfirmed uplinks (the default is unconfirmed and is also what we recommend unless you have a very specific requirement that enforces otherwise).

Uplink message type

HW/SF Version

  • This is simply a way of requesting the current Hardware and Firmware version of the device, it is mostly used for troubleshooting purposes and in normal conditions should be up to date as the device obtains these values on every network join. You need to check the box to initiate the update on the next "Send" event.

HW/SW Version

Send custom hex commands

This is a simplified way to send commands directly do the device via their HEX command codes. You can request one or more parameter updates, and/or change one or more parameters, commands can be queued in this way. You can create any combination of commands you required.

Send custom hex command

For details on command codes and additional settings please refer to the device documentation in the Device Documentation Center.

Last updated

Was this helpful?