Omicron KONTROLOG User Manual

Internet of things system for remote and real-time monitoring and control
Hide thumbs Also See for KONTROLOG:
Table of Contents

Advertisement

Quick Links

KONTROLOG
INTERNET OF THINGS SYSTEM FOR REMOTE AND
REAL-TIME MONITORING AND CONTROL
For LoRaWAN™, Sigfox, and Wi-Fi Networks
User's Manual
omicroniot.com
1
June 2023

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the KONTROLOG and is the answer not in the manual?

Questions and answers

Summary of Contents for Omicron KONTROLOG

  • Page 1 KONTROLOG INTERNET OF THINGS SYSTEM FOR REMOTE AND REAL-TIME MONITORING AND CONTROL For LoRaWAN™, Sigfox, and Wi-Fi Networks User’s Manual omicroniot.com June 2023...
  • Page 2: Version Control

    Version control The following table contains the record of changes per manual version. Version Date Description 15/03/2023 Format change. Extensive revision and correction of content. Technical background information update. 24/06/2023 Version control implemented. Device image changed. omicroniot.com June 2023...
  • Page 3: Contact Information

    If you encounter a problem with your Kontrolog, review the configuration information to verify that your selections are consistent with your application: input configurations; chosen limits;...
  • Page 4 Warning notice standard This manual contains notices that must be observed in order to ensure personal safety, prevent damage to properties, and guarantee proper installation, use and maintenance of the equipment. The notices referring to personal safety or the integrity of the device are highlighted in the manual by an alert symbol;...
  • Page 5: Table Of Contents

    Contents Section 1: Introduction 1.1 Product Recycling / Disposal 1.2 Storage and transport Section 2: Overview 2.1 Features 2.2 Device configuration 2.3 Synchronization of data frames lost due to network failures Section 3: Description of Sensors and Outputs 3.1 Description of Input Sensors 3.2 Description of the Control Outputs 3.2.1 Output controlled by remote commands 3.2.2 Output that follows the value of an associated input...
  • Page 6 5.1 Callback configuration for Uplink Messages on Sigfox 5.2 Callback configuration for Downlink Messages on Sigfox Section 6: Configuration on LoRaWAN™ TTN 6.1 Callback configuration for LoRaWAN™ Uplink Messages 6.1.1 Downlink API Key 6.2 Format for Uplink payload Section 7: Centriomega® Remote Control and Monitoring Platform 7.1 Access the Centriomega®...
  • Page 7 Failure to follow safe installation guidelines could result in death or serious injuries. ● Make sure the Kontrolog is installed by qualified personnel and in accordance with the applicable practice code. ● Use the device only as specified in this manual. Failure to do so may impair the protection provided by it.
  • Page 8: Section 1: Introduction

    Recycling of device components and packaging should be taken into consideration and disposed of in accordance with local and national legislation/regulations. 1.2 Storage and transport The Kontrolog is protected by a special packaging during transport and is guaranteed to handle normal loads during transport. omicroniot.com...
  • Page 9: Section 2: Overview

    There are two models of the Kontrolog device, designated by the names Kontrolog 9.3 and Kontrolog 9.2. The main difference between them is that the Kontrolog 9.3 has one output (No. 5) which is analog (4-20mA), while for the Kontrolog 9.2, all of the outputs are relay type.
  • Page 10: Device Configuration

    The Kontrolog is powered by a two-wire power cable, connecting its AC1 and AC2 inputs to the 110 - 220 VAC, 50/60 Hz lines. It can also be powered by a 6 or 12V battery. The system is delivered with the wireless communication modules ordered.
  • Page 11: Section 3: Description Of Sensors And Outputs

    Outputs 3.1 Description of Input Sensors A sensor connected to the Kontrolog measures a type of physical variable, analog or digital, that can be configured to read: temperature, humidity, voltage, current, etc. Each sensor has a description of registers given in Table 3-1.
  • Page 12: Description Of The Control Outputs

    Frequency Input (Input No. 5 only) 3.2 Description of the Control Outputs The Kontrolog 9.2 programmable controller has five (5) relay outputs and the Kontrolog 9.3 programmable controller has four (4) relay outputs and one (1) 4 - 20 mA analog output.
  • Page 13 0: Relay Open 1: Relay Closed Actual value Actual value of the current in the 4-20 mA range for output No. 5 of the Kontrolog 9.3. Type of Control Actuation for the Output, Selected Control Function See Tables 3-4.1 and 3-4.2.
  • Page 14 Time make Control Calculations for the PID Control PID Control: Proportional 0 to 50% Action PID Control: Integral Action 0 to 50 Control: Derivative 0 to 50 Action Control: Maximum Power to apply at the 10 to 100% Output The following figure shows the philosophy followed to activate the Outputs. Figure 3-1 Closed Loop Control System Control Signal: It is the Control Signal associated to activate the Control Function that affects the Output, this signal can be one of the five Inputs (IN1 to IN5).
  • Page 15: Output Controlled By Remote Commands

    In case the input is not associated as digital sensor, the output remains off; 2. or the 4-20 mA analog output (only for Kontrolog 9.3) follows the state of the associated analog input sensor, for which it will take as the lower limit of the input the value that the user configures in Parameter 6 of Table 3-1, and as the upper limit...
  • Page 16: On/Off Control Output Function

    3.2.3 On/Off Control Output Function This type of function allows an On/Off control with hysteresis for heating or cooling, the following parameters must be programmed in the output (Table 3-5) to correctly configure this control function. Table 3-5 Parameters to be configured for the On/Off Controlled Output Parameter Parameter Parameter Description...
  • Page 17: Timed Output Function

    1. Control Type = 1 → Heating 2. Hysteresis = 1.0 °C 3. Set-Point = 31.0 °C 4. When the temperature is greater than or equal to 31.0 + 1.0 = 32.0°C, output (OFF). 5. When the temperature is less than or equal to 31.0 - 1.0 = 30°C, output (ON). 3.2.4 Timed Output Function This type of function allows to activate the output according to a timer, which can operate in three ways:...
  • Page 18: Pulse Counter

    2. Control Type = 1 → The timer is triggered when the Control Signal is greater than 37.0°C. 3. Cycle Time ON = 3600 → The output is turned (ON) for 3600 Seconds. 4. Cycle time OFF = 900 → The output is turned (OFF) for 900 seconds. As long as the temperature is below 37.0°C, the output will remain OFF.
  • Page 19: Pid Control

    Assigned Control Assign an input signal for the Counter 1 to 5 Signal Set-Point Value to be counted 0 to 2047 Assign 0: If # Pulses < Set-Point ==> Output = OFF Control Type If # Pulses >= Set-Point ==> Output = ON 0 to 1 (Invert Output) Assign 1:...
  • Page 20: Calculation Performed By The Pid Control Algorithm

    3.2.6.2 Calculation performed by the PID control algorithm The Kontrolog performs a PID control algorithm to bring the process variable (Pv) to the desired value (Sp), expressed in the following formula for calculating the power to be supplied to the actuating elements: Pot = [100%(Error - Der/10*VEL + Int/1000 * ΣError)/Bp]...
  • Page 21: Practical Considerations

    ● Overdamped system: It has a slow response speed and after a disturbance occurs the system may take time to return to the Sp. The advantage is that it is very stable and does not acquire undesirable oscillatory behaviors. This condition occurs when the proportional band Bp is larger than necessary and when the derivative constant dEr is very large, since the derivative action tends to anticipate the response.
  • Page 22: Section 4: Graphical User Interface Hmi Screen Guide

    Section 4: Graphical User Interface HMI Screen Guide The HMI (Human Machine Interface) screen for device configuration was designed to make it easier for the users to compose commands, according to the hierarchical coding supported by the devices. It provides a great advantage in terms of ease of device configuration by technical personnel, because it simplifies complex control algorithms and does not require the use of any specific programming language.
  • Page 23: Device Name Configuration

    4.1.1 Device name configuration (1) By clicking on the device name (in the case of the example given in Figure 4-1, ), it is possible to change the name of the device and customize it. 4.1.2 Sensor name configuration (2) By clicking on the sensor name (in the case of the example given in Figure 4-1, ), it is possible to change the name of the device and customize it.
  • Page 24: Graphic Symbol Configuration

    4.1.4 Graphic symbol configuration (4) By clicking on the interactive graphic symbol, it is possible to choose another symbol among those that appear among the options, in order to interactively represent what the sensor measurement displayed on the screen corresponds to (e.g. the door symbol can be used for a digital door opening sensor).
  • Page 25: Time Zone Configuration

    4.1.6 Time zone configuration (6) By clicking on the time displayed on the screen (in the case of the example given in Figure 4-1, ), it is possible to change the current date and time according to the time zone where the device is installed.
  • Page 26: Sensor Configuration

    4.1.7.1 Sensor configuration 1. Input Selection (1) Here you can select the sensor you want to configure, from Input Ports 1 to 5, the 12 VDC Battery Voltage Sensor, AC Voltage Sensor or AC Current Sensor. 2. Parameters to configure (2) Pressing on (2) will display the options for configuring the sensor selected in (1), these parameters are explained in Table 3-1.
  • Page 27: Modbus Sensor Configuration

    Example 2: A water Ph sensor delivers the measurement in a range of 4 to 20 mA, where 4mA=0ph and 20mA=14ph. Then, it is configured: Offset = -4 Slope = 14pH/(20-4 mA) = Following the formula: Ph = (V. read [mA] - 4 [mA])*14/16 [ph/mA]. 3.
  • Page 28: General Settings

    NOTE: THE DEVICE CAN READ ONLY ONE MODBUS REGISTER PER ASSOCIATED INPUT, THAT IS, UP TO FIVE (5) DIFFERENT EXTERNAL SENSORS CAN BE CONNECTED THROUGH THE MODBUS INPUT PORT, BUT EACH ONE IS ASSOCIATED TO EACH OF THE MEMORY REGISTERS OF INPUTS S1-S5. 4.1.7.3 General Settings By clicking on the arrow at the bottom right of the screen in Section 4.1.7.2, you will find the General Settings.
  • Page 29: Description Of The Control Outputs

    NOTE: There are different Kontrolog models (Kontrolog 9.2 and Kontrolog 9.3. Refer to Section 2.1 for information on the features and differences between these models), which can be ordered with a WiFi communications module, or a dual Sigfox/LoRaWAN™ module. In turn, depending on your location, the Sigfox Zone and LoRaWAN™...
  • Page 30: Control Function

    4.2.4 Control Signal (4) This is the Control Signal associated to activate the Control Function that affects the output, this signal can be one of the five inputs (IN1 to IN5) of the Kontrolog, or a remote command. NOTE: If the input to be associated with the output is not configured correctly according to the type of sensor to be used, the output control will not function properly.
  • Page 31: Access To The Sensor Reading Graph

    1 : Inverted Output (Heating) For Timer Function: 0 : Timer is activated when the Control Signal is less than the Set-Point. 1 : The timer is activated when the Control Signal is greater than the Set-Point. For the Event Counter function: If # Pulses <...
  • Page 32: Section 5: Configuration On Sigfox Backend

    Section 5: Configuration on Sigfox Backend If Kontrolog devices are desired to work with the Omicron IoT Solutions Monitoring Platform using the Sigfox Telecommunications Network, the user can enable bidirectional communication with the platform by associating Callbacks to the devices' Uplink and Downlink messages on the Sigfox Backend.
  • Page 33 2. Create a new Callback by selecting the "New" option. 3. Select “Custom Callback”. 4. Configure the Callback as presented in the image below, and then press “OK”. omicroniot.com June 2023...
  • Page 34: Callback Configuration For Downlink Messages On Sigfox

    ● Use the URL pattern: https://parse.ubidots.com/prv/omicron/beta92_configurable ● Use the body: "data" : "{data}",  "ID" : "{device}", "timestamp" : {time} 5. Then, in the “Callbacks” section of the edited device type, you will see a Callback like the following one: 5.2 Callback configuration for Downlink Messages on Sigfox 1.
  • Page 35 ● Use the URL pattern: https://parse.ubidots.com/prv/omicron/downlink3?device=beta92-{device}&ack={ac 2. Then, in the Callbacks section of the edited device type, you will see a new Callback of type BIDIR like the following one: 3. You will notice that this Callback is accompanied by an unfilled circle in its Downlink category.
  • Page 36 5. Now you can select the new BIDIR callback available as a Callback to handle Downlink messages in the “CALLBACKS” section of the edited device type, by clicking on the unfilled circle (after selecting it, the circle will be filled): omicroniot.com June 2023...
  • Page 37: Section 6: Configuration On Lorawan™ Ttn

    Section 6: Configuration on LoRaWAN™ TTN If Kontrolog devices are desired to work with the Omicron IoT Solutions Monitoring Platform using the LoRaWAN™ telecommunications network, the user can enable bidirectional communication with the platform by associating Callbacks to the devices' Uplink and Downlink messages on The Things Network (TTN) platform or other.
  • Page 38 2. Create a new Webhook by selecting the "Add Webhooks" option. 3. Then select “Custom Webhook” 4. Configure the Webhook as presented in the following image, and then press “Save Changes”. omicroniot.com June 2023...
  • Page 39: Downlink Api Key

    ● Webhook ID: ID that the user wants to assign ● Webhook format: JSON ● Base URL: Base URL chosen by the user. In the case of the Omicron IoT Solutions monitoring platform: https://parse.ubidots.com/prv/omicron ● Downlink API Key: See section 6.1.1.
  • Page 40 2. Select the option “Add API Key”. 3. Configure the Webhook as presented in the following image and then press “Create API Key”. omicroniot.com June 2023...
  • Page 41: Format For Uplink Payload

    6.2 Format for Uplink payload 1. In The Things Network, enter the application to which you have associated the LoRaWAN™ modules used by your Kontrolog devices, and select “Uplink”, displaying the Payload Formatters menu located on the left side. omicroniot.com...
  • Page 42 2. Then, enter the following information in the corresponding fields: ● Formatter type: Custom Javascript formatter ● Formatter code: Copy and paste the next function code: function decodeUplink(input) { var data_payload = ""; for(i = 0; i < input.bytes.length; i++){ var chr = input.bytes[i].toString(16);...
  • Page 43: Section 7: Centriomega® Remote Control And Monitoring Platform

    Section 7: Centriomega® Remote Control and Monitoring Platform The Kontrolog works in conjunction with the Remote Monitoring WEB platform. Users can access the Remote Monitoring Platform via WEB, to perform, among other things: ● Remote monitoring and visualization of historical data records, in graphs and data tables, for up to 2 years.
  • Page 44: Reviewing Historical Data

    The platform uses some basic elements to organize the information it manages and facilitate interaction with users. These are: Dashboards, Devices, and Events. An introduction to the use of each of them will be offered in this guide. 7.2 Reviewing Historical Data Dashboards are interfaces where relevant data is presented to the users.
  • Page 45: Reviewing Devices, Their Variables, And Configuration

    Figure 7-3 Dashboard visualization example To learn how to modify said elements and how to configure a Dashboard, you can contact the manufacturer of the Kontrolog. Remember that the Contact Information is provided at the beginning of this document. 7.3 Reviewing Devices, their Variables, and Configuration A Device is a virtual representation of a physical device that takes data from sensors and transmits them through a particular network to the platform.
  • Page 46: Reviewing Alarms And Programmed Events

    properly, after entering the Device panel that should include it, its last activity period could be reviewed. Figure 7-5 Reviewing the Variables of a Device To review the historical data of a certain Variable, in a Device, select the Variable. Figure 7-6 Variable Historical Data 7.4 Reviewing Alarms and Programmed Events Events (or Incidents) are configurable conditions that activate the sending of alert messages...
  • Page 47 Inside the platform, users can find a link to the section that includes all the Events available to their accounts and locate the Event of their interest: Figure 7-7 Events Configuration To review the last activity of an Event (its log of updates, or the times in which one of its conditions where violated), the user can press the Log icon associated to any Event to see a table like the following one: Figure 7-8 Events historical record...
  • Page 48: Remote Configurator

    Figure 7-9 Events Dashboard To learn how to modify the configuration of an Event, you can contact the manufacturer of the Kontrolog. Remember that the Contact Information is provided at the beginning of this document. 7.5 Remote Configurator Centriomega® platform users have access to a Dashboard that allows them to set commands to remotely configure their devices (to find it, login to the remote monitoring...
  • Page 49: Elements Of The Remote Configurator

    7.5.1 Elements of the Remote Configurator 1. Field for the ID of the device to be configured In this field, users must specify the UID (or MAC, if the communication is Wi-Fi) of the device they wish to configure remotely. This ID is printed on the labels of the devices; or it can be checked in the ‘Device’...
  • Page 50 Remote Configurator, for what is shown in the following image (as an example), the Kontrolog device with ID 44aeaa will configure Sensor 2 to operate as a digital input 0/1: Figure 7-11 Example of the configuration made with the Remote Configurator omicroniot.com...
  • Page 51: Section 8: Troubleshooting Guide

    (as shown in Figure 8-1). Figure 8-1 Outliers associated with sensors that are not properly connected The following table summarizes some of the outliers that a Kontrolog can associate with each sensor, and what each of them can indicate: Table 8-1 Outliers associated with each sensor Predefined Kontrolog Abnormal Values...
  • Page 52: The Device Has Stopped Updating Data On The Monitoring Platform

    1. Verify that the device is in its Normal Operating State: The Normal Operating State of a Kontrolog can be recognized when the device presents on its display the different correct measurements taken by its sensors, as long as they are properly connected.
  • Page 53: When Trying To Save The Configuration With The Remote Configurator, I See The

    The API Label of each device is composed of its type, and its ID, separated by a hyphen (e.g. kontrolog-123abc). Once you have identified the ID of interest, you can use it to specify the device to be configured with the Remote Configurator.
  • Page 54 Figure 8-2 Device ID search on the remote monitoring platform omicroniot.com June 2023...
  • Page 55 Global Headquarters America Regional Office Omicron IoT Solutions Address: La Amalita Km4 Llanogrande-Rionegro Mall Plaza del Sol Off. 202 Rionegro, Antioquia, Colombia. Phone: +57 (604) 4087542 WhatsApp +57 (317)4365062 comercial@omicroning.co www.omicroniot.com omicroniot.com June 2023...
  • Page 56 © 2023 Omicron IoT Solutions. All rights reserved. omicroniot.com June 2023...

Table of Contents