DeviceSupervisor Agent User's Manual

DeviceSupervisor Agent User's Manual

DeviceSupervisor Agent

User's Manual

(Applicable for IG & EC)

Based on device_supervisor V3.1.10, August 2024

www.inhand.com

The software described in this manual is according to the license agreement, can only be used in accordance with the terms of the agreement.

Copyright Notice

© 2024 InHand Networks All rights reserved.

Trademarks

The InHand logo is a registered trademark of InHand Networks.

All other trademarks or registered trademarks in this manual belong to their respective manufacturers.

Disclaimer

The company reserves the right to change this manual, and the products are subject to subsequent changes without prior notice. 9. We shall not be responsible for any direct, indirect, intentional or unintentional damage or hidden trouble caused by improper installation or use.


Getting Started

1.Introduction

1.1 Overview

DeviceSupervisor Agent (hereinafter referred to as DSA) is an industrial edge gateway software running on the gateway, providing convenient data acquisition, data processing, data to the cloud and protocol conversion. It is mainly deployed in industrial sites to achieve industrial equipment communication and industrial bus protocol acquisition, industrial system data integration, edge data filtering and analysis, as well as industrial IoT platform docking and integration, etc. It provides low-latency data access management and intelligent analysis services for industrial scenarios, helping users to quickly analyse business trends and improve operational efficiency and sustainability.

1.2 Product Advantages

  1. Rich southbound acquisition protocols

Provides data acquisition services to meet various industrial scenarios, real-time data acquisition and unified access for PLC, CNC, robot, Scada and intelligent instrumentation, etc. These acquisition services are widely used in building automation, CNC machine tools, robotics, electric power, and various PLC communications.

  1. Various protocol conversion functions

It supports to convert the data collected in the south direction to a specified industrial protocol, and then for the host computer or Scada software to collect, which is good to avoid the complexity of the collection problems caused by the diversity of industrial field protocols.

  1. Platform integration

It supports connecting to mainstream industrial IoT cloud platforms and integrating data into local data centres, industrial internet platforms or cloud services by interfacing with standard MQTT, MQTT SparkPlugB, AliCloud IOT, AWS IOT, Azure IOT and so on.

  1. Lightweight and flexible configuration

It has the characteristics of lightweight and low memory consumption; it can be installed or uninstalled in the form of APP (plug-in on EC products), which is easy to manage, and it can be used to meet various scenarios by modifying the DSA configuration.

  1. Edge Measurement Intelligent Analytics

Within DSA, it supports the addition of fast function scripts to handle edge measurement data processing; "publish" scripts can report the data to the platform after filtering and format conversion, "subscribe" scripts can handle the platform's control of the site, and "custom fast function" scripts can handle edge measurement data management and intelligent analysis.

1.3 List of functions

Function

Descriptions

Southbound data collection

Support nearly 100 kinds of industrial protocols for one-stop connection, data acquisition and device reverse control function. For the list of protocols, see "Southbound Acquisition Protocol List" below.

Realtime Communication Message viewing and downloading

The Southbound Controller supports online viewing and downloading of real-time communication messages, which can help users and O&M personnel quickly locate Southbound acquisition problems.

Historical data

In order to facilitate users to do data analysis and intelligent management at the cloud platform or the edge of the gateway, the collected data are supported to be saved in the database at the gateway at a specified frequency, so as to facilitate the analysis and processing of historical data.

Alarm handling

By setting the alarm rules, when the data reaches a certain threshold actively push the alarm message, the user can sense the abnormal situation on the scene in time.

Northbound Cloud Services

Supports the transmission of collected data via MQTT to mainstream IoT cloud platforms, as well as IoT cloud platforms provided by Enigma. For the list of protocols, please refer to "Northbound Cloud Service List" below.

Northbound protocol conversion

This function allows you to use the gateway as a protocol conversion gateway, and flexibly configure the acquisition points that need to be converted. For a list of protocols, see "Northbound Protocol Conversion List" below.

Fast Function Scripts

Data can be formatted and processed, and analysed and processed at the edge.

Third-party library management (IG Gateway support only)

Third-party libraries that need to be used are packaged and imported and installed at the gateway, and can be referenced in fast function scripts.

Protocol Name

Interface Type

note

EtherNet/IP (CompactLogix)

Ethernet

Docking with Rockwell Series PLCs

EtherNet/IP (Micro)

Ethernet

-

EtherNet/IP (MicroLogix)

Ethernet

-

EtherNet/IP (Unconnected)

Ethernet

-

*SLC Net

Ethernet

-

*ADS

Ethernet

Docking with Beckhoff series PLCs

CJT188-2004

Serial port

Docking with CJT188 Water Meter

Delta TCP

Ethernet

Docking with Delta Series PLCs

Delta Serial

Serial port

-

Delta Serial ASCII

Serial port

-

Delta Serial over TCP

Ethernet

-

*Euromap-63

-

Docking with injection moulding machines by means of FTP service

FATEK Programe Port (Programming Port)

Serial port

Docking with FATEK PLCs

FATEK Programe Port over TCP

Ethernet

-

*SPB

Serial port

Docking with Fuji PLCs

*SPB over TCP

Ethernet

-

*SPH Net

Ethernet

-

*SRTP

Ethernet

Docking with General Electric PLCs

*INOVANCE Serial

Serial port

Docking with Inovance PLC 

*INOVANCE TCP

Ethernet

-

*INOVANCE Serial over TCP

Ethernet

-

KEBA Socket

Ethernet

Docking with KEBA Controller

*KEYENCE MC 3E

Ethernet

Docking with Keyence PLCs

*Nano

Serial port

-

*Nano over TCP

Ethernet

-

Modbus ASCII

Serial port

Interfaces with all types of PLCs with Modbus protocol

Modbus RTU

Serial port

-

Modbus RTU over TCP

Ethernet

-

Modbus TCP

Ethernet

-

Modbus RTU Slave

Serial port

-

*FX Links

Serial port

Docking with Mitsubishi PLCs

*FX Links over TCP

Ethernet

-

*FX Serial over TCP

Ethernet

-

MC 1E

Ethernet

-

MC 3E

Ethernet

-

MC 3C

Serial port

-

MC 3C over TCP

Ethernet

-

*MC R

Ethernet

-

MITSUBISHI Programe Port (Programming Port)

Serial port

-

*C-Mode

Serial port

Docking with Omron PLCs

*C-Mode over TCP

Ethernet

-

EtherNet/IP (CompactLogix)

Ethernet

-

EtherNet/IP (Unconnected)

Ethernet

-

FINS TCP

Ethernet

-

FINS UDP

Ethernet

-

HostLink

Serial port

-

*HostLink over TCP

Ethernet

-

OPC DA

Ethernet

To collect OPCDA data from PC, you need to install OpenOpc software on PC.

OPC DA

Ethernet

-

*OPC UA PUBSUB

Ethernet

-

Mewtocol

Serial port

Docking with Panasonic PLCs

*Mewtocol over TCP

Ethernet

-

*Panasonic MC 3E

Ethernet

-

*Fetch/Write

Ethernet

-

ISO on TCP

Ethernet

Connecting PLCs of Siemens S200, S200smart, S1200, S1500 models

PPI

Serial port

-

*PPI over TCP

Ethernet

-

*WebApi

Ethernet

-

*VIGOR Serial

Serial port

Docking with VIGOR PLCs

*VIGOR Serial over TCP

Ethernet

-

*XINJE TCP (dedicated)

Ethernet

Docking with Xinjie PLCs

*XINJE TCP (Modbus)

Ethernet

-

*XINJE Serial

Serial port

-

*XINJE Serial over TCP

Ethernet

-

*Link TCP

Ethernet

Docking with Yokogawa PLCs


Electric power protocol

Protocol Name

Interface Type

note

DLT645-1997

Serial port

Chinese standards for electric power meters

DLT645-2007

Serial port

Chinese standards for electric power meters

DLT645-2007 over TCP

Ethernet

Chinese standards for electric power meters

*DLT698

Serial port

-

DNP3 TCP

Ethernet

-

DNP3 UDP

Ethernet

-

DNP3 RTU

Serial port

-

IEC 101

Serial port

-

IEC 103 (NR Electric)

Serial port

NR Electric

IEC 104

Ethernet

-

IEC61850
Ethernet
-






As shown in the figure above, DSA is mainly divided into functional modules such as southbound data acquisition, DataHub data processing, fast function processing module, northbound protocol conversion and northbound cloud service.

 Southbound data collection:

Support mainstream industrial protocols, power protocols, building protocols and environmental protection protocols for data acquisition, including Modbus, OPC UA, EtherNet/IP, IEC104, BACnet, Siemens PLC, Mitsubishi PLC and so on. It meets the data acquisition access requirements of various industries such as intelligent manufacturing, petroleum and petrochemical, iron and steel metallurgy, energy and power, and building automation.

DataHub Data Processing:

Receives southbound acquisition data and generates northbound messages and remote bus messages, stores acquired data in a historical database, and handles alarm messages.

Fast function processing module:

QuickFaaS is a lightweight FaaS (Function as a Service) that allows the user to customise a function for handling bus messages or events.

Northbound protocol conversion:

Receive measurement point data from the southbound message bus and convert it to some protocol specified in the northbound direction.

Northbound Cloud Services:

Receive messages from remote message buses and forward them to cloud connections; receive remote subscription requests and forward them to remote message buses; support offline data storage.

3 Installation

3.1 Hardware Wiring

Turn on the power to the gateway and connect the IG gateway to the PLC according to the topology using an Ethernet cable/serial cable.(The topology diagrams for the EC and IG series are the same, using the IG502 as an example.)


The wiring instructions for the IG502 serial port are as follows:


For details about the default IP address of the InGateway network port, see the IP address information on the nameplate. In order for the InGateway to access the Ethernet PLC through the network port, the network port must be in the same network segment as the PLC.

3.2 Software environment preparation

3.2.1 EC Series

When using DSA, the firmware version should be 'V2.0.10' or later for the EC942 and 'V2.0.1' or later for the EC312

Update the firmware version as shown in the figure (the firmware version will take effect after the firmware version is restarted):


3.3.2 IG Series

When using DSA, the SDK version should be py3sdk-V1.4.5 or later. Please refer to the table for the minimum firmware version requirements:

IG Series

The firmware version number of the lowest legacy naming convention

The firmware version number of the minimum new version of the naming convention

IG974

V2.0.0.r14106

V2.0.3

IG902

V2.0.0.r14047

V2.0.3

IG532

V2.0.0.r14238

V2.0.1

IG504

none

V2.0.5

IG502

V2.0.0.r14045

V2.0.5



Update the firmware version as shown in the image:


Update the SDK as shown in the image:


3.3 Install and run DSA

3.3.1 EC series

3.3.1.1 Installation and Running of DSA

Please refer to the following procedure to install and run DSA in EC series:

Click the "Add" button and select the DSA package file to be installed, then click Confirm.


After a successful import, you can view the imported App as shown in the following diagram:


3.3.1.2 Updating the DSA configuration file

If the installed App supports modifying the runtime method by importing a configuration file, you can follow the process below to update the App's runtime configuration: 


After a successful import, it will run according to the imported configuration file.


3.3.1.3 Updating the DSA version

To update the DSA version simply import the new version of the DSA package on the following page as shown below:


After the update is completed, it will appear as shown below:


3.3.1.4 View/Download Logs

View/download the logs during the DSA run in the screen shown:


After selecting the log level in "Level", logs lower than this level will not be displayed and saved. Log level sorting: ERROR>WARN>INFO>DEBUG>All.

To download the log, click the "Download" button.

3.3.2 IG Series

3.3.2.1 Installation and operation of the DSA

Refer to the following procedure to install and run DSA in IG Series:

You need to ensure that the Python SDK is installed and the Python Edge Engine is enabled before installing the DSA, as shown below:


Click the "Add" button and select the App package file you need to install, then click confirm.


After a successful import, you can view the imported DSA as shown in the diagram below:


Check the “Enable” box to run the App.


Once enabled, the App will run on IG series products and automatically run every time the device is powered on.


3.3.2.2 Updating the DSA configuration file

If you need to update the global configuration file of the DSA, you can refer to the following procedure:


Restart the DSA after a successful import and it will run according to the imported configuration file after the restart is complete.


3.3.2.3 Update the version of DSA

To update the version of DSA, you typically only need to import the new version of the App.


After the update is completed, the interface will appear as shown in the diagram below:


3.3.2.4 View/Download Logs

View/download the logs during the running of the DSA in the interface as shown:


After setting the log level, logs higher than this level will be displayed and saved. The log level is set in the Parameter Settings interface, and the log level is sorted: ERROR>WARN>INFO>DEBUG.



4. Quick start

This tutorial takes the Modbus TCP protocol as an example to get a quick start on the simple and practicalities of using the DSA to capture ModRSsim2 analogue device data and upload the data directly to the EMQX MQTT public cloud service and convert it to Modbus TCP slaves for Modbus poll collection, as well as edge measurement data processing. The overall flow of the configuration is shown below:


4.1 Install Modbus Simulator

The tutorial uses ModRSsim2 as the Modbus TCP Slave. Run the ModRSsim2.exe software and configure the port number as shown in the diagram:



4.2 Southbound Acquisition Configuration

4.2.1 Configuring the Southbound Controller

After running device_supervisor, add a southbound controller. In the controller protocol, select the Modbus TCP protocol and configure the relevant parameters.



  1. Name: Controller name, for example: Modbus TCP
  1. Controller Protocol: Select Modbus TCP
  1. IP Address: Fill in the IP address of the PC where the Modbus simulator is installed;
  1. Port Number: Default port 502;
  1. Slave Address: Default is 1


4.2.2 Add Measuring Point

In the list of measuring points, add the device measuring points needed for collection and configure the measuring point's name, address, data type, etc., as shown in the diagram below: 



Once configured, click “Confirm” to add the measuring points. After creating the measuring points, wait a few seconds; if the controller connection status is still disconnected, perform the following actions to find the reason:

  1. The IP address, port number, and slave were correct when the controller was created;
  2. Check if the gateway can access the IP and port of the simulator.

4.3 Viewing Acquisition Data

After the southbound acquisition configuration is complete, you can see the status and acquisition data of the controller and the measurement point in the measurement point monitoring page, as shown in the following figure:


4.4 Northbound Cloud Service Configuration

4.4.1 Configuring the MQTT Cloud Service

Enable the MQTT cloud service and configure the server address, MQTT client ID, port number, and other parameters as shown in the diagram:



  1. Server Address: MQTT server address, for example, EMQX MQTT public cloud server address broker.emqx.io
  1. Client ID: Custom client ID, which is the unique identifier for connecting to the server.
  1. Port Number: MQTT server port number, for example, EMQX MQTT public cloud server port 1883

Once configured, click submit and wait a few seconds. The MQTT connection status should be visible in the status bar as connected successfully. If it constantly shows as connecting, perform the following actions to find the reason:
  1. Check if the device can access the Internet;
  2. Check if the server address and port and other configuration information are correct.

If the connection drops after a while, check if the MQTT client ID has been used, or consider changing the client ID.

4.4.2 Configure MQTT Publish/Subscribe Scripts

After the MQTT connection is successful, add a publishing script as shown below:


  1. Name: Custom publishing script name
  1. Trigger Source Type: For example, select "Measuring Point Group"
  1. Group/Label: Select the group where the measuring point is located. The example uses the default group.
  1. Topic: Publish topic, the example uses inhand_pub
  1. Qos(MQTT): supports 0, 1, 2
  1. QuickFunction: Just use the default

As shown in the figure below, add a subscription script:



  1. Name: Custom publishing script name
  1. Topic: Publish topic, the example uses inhand_pub
  1. Qos(MQTT): supports 1
  1. Payload type: Select Plaintext in the tutorial
  1. QuickFunction:
# Enter your python code.
import json
from common.Logger import logger
from quickfaas.measure import write_plc_values


def write_callback(message, userdata):
    logger.debug("write plc response: %s, userdata:%s" % (message, userdata))


def main(topic, payload, cloudName):
    logger.debug("subscribe topic: %s, payload: %s, cloudName: %s" % (topic, payload, cloudName))
    write_plc_values(message=json.loads(payload), callback=write_callback, userdata="")

4.5View data/write values on EMQX public cloud client

The tutorial uses the client tool provided by the EMQX official website to connect to the public EMQX broker to view the data uploaded by the gateway to the MQTT Broker.

On the EMQX official website (https://www.emqx.com/en/mqtt/public-mqtt5-broker), choose to use the MQTT client tool online for testing

Click "New Connection" in the pop-up window that opens. After filling in the Name field in the pop-up interface, the rest of the configuration does not need to be modified. Finally, click "Connect".


In the MQTT client, write the value of the simulator collected by the gateway, as shown in the following figure, modify the value of the measurement point "WORD" collected by the gateway to 10, Paylaod:{"WORD": 10}

4.6 Northbound Protocol Conversion Configuration

4.6.1 Configuring the Modbus TCP Slave

Click Protocol Conversion, find the Modbus TCP Slave menu bar, select "Configuration", set the information and submit. As shown in the figure below:


4.6.2 Configuring the Modbus Mapping Table

Adopt the default slave address 1, click "Batch Add", set the starting mapping address, select the measurement point under the corresponding controller and click submit, as shown in the following figure:


When the addition is complete, it is shown in the following figure:


The Mapped Address column shows the register address information for the corresponding measurement point.

4.7 Collecting Gateway Data with Modbus Poll

Use Modbus Poll software as Master to collect the data from the gateway, set the connection information to the IP address and port number of the gateway, the slave address is set to 1, the start address of the register read is 40001, and the length of the register is 4, as shown in the following figure:


The data read after successful setup is the same as the data seen on the page of the Measure Monitor, as shown in the figure below:


4.8 Edge measurement data processing

4.8.1 Periodic trigger QuickFunctions

In the Custom QuickFunctions menu bar, click to add a "Periodic trigger" QuickFunctions, set to run in 10-second cycles, the function code for the recall of a southbound collection of data, as shown in the figure below:



# Enter your python code.
from common.Logger import logger
from quickfaas.measure import recall2

def recall2_callback(message, userdata):
    logger.info("recall2 response message: %s, userdata:%s" % (message, userdata))


def main():
    logger.info("Timer start")

    recall2(callback=recall2_callback, userdata="")

    logger.info("Timer end")
Once the setup is complete click submit and the script will run in 10 second cycles, each time it runs, recall2 is called to read the data collected from the southward direction.

4.8.2 Local Subscription Message Trigger QuickFunctions

In the Custom QuickFunctions menu bar, click to add a "Local Subscription Message Trigger" quickfunction, subscribe to the theme is: ds2/eventbus/south/read/+, the theme is the south to the driver to release the controller measurement point value of the message bus, used to get to the south of the cycle acquisition data, as follows shown in the figure:


After the settings are completed, submit. Each time a round of data is collected in the southward direction, this script will be triggered once and the collected data will be output to the log.

4.8.3 Power trigger QuickFunctions

In the Custom QuickFunctions menu, click to add a "Power trigger" quickfunction to indicate that the script will be triggered once when the DSA starts up, as shown in the following figure:

Once set up, the script is triggered to run once when the DSA starts.

5. Concept

Name

Description

Controller

The controller refers to the component on the gateway page that enables and manages various collection protocols.

(Southbound) Driver

The (southbound) driver refers to the software program in the gateway that communicates with PLC devices. It is usually developed specifically for certain manufacturers or device types and communicates using the device manufacturer's management protocols or APIs, such as Modbus, OPC, etc.

Measuring Point

A measuring point refers to a collection point for PLC devices configured on the gateway.

Grouping

Grouping refers to dividing measuring point data or alarm items into different groups within the gateway according to different needs and application scenarios for easier management.

Historical Database

Store the historical collected data of the measurement points in the sqlite3 database.

QuickFunction

The publishing, subscribing and custom quick functions configured in DSA are executed in the form of independent threads.

Protocol Conversion

Protocol conversion refers to forwarding data collected from the southbound direction through other protocols.

Alarm

An alarm refers to the configuration of alarm conditions for collected data within the gateway, which triggers an alarm when activated.

Event Bus

The event bus refers to the message channel used for communication between various services within the gateway using MQTT messages.

Data Transformation

The collected data can configure data operations and mapping values in the gateway. 

Functional characteristics

1. Measuring point monitoring

1.1 Monitoring list

In the "Monitoring List" interface, you can add controllers and measuring points to collect PLC data, and view the status and configuration information of the controller as well as data collection information.

On the current page, the controller can be edited, copied, deleted, etc.; the measuring points can be added, imported, exported, deleted, etc.

The page display of the monitoring list is as shown in the figure:

1.1.1 Add/Edit Controller

Click the "Add"/"Edit" button, select the controller protocol, such as Modbus RTU, and configure the controller's slave address, communication method, polling cycle and other parameters on the add controller page. Note: Controller names cannot be repeated.

In the advanced settings, the controller's message processing can be configured. For example, in the advanced settings of the Modbus RTU controller, parameters such as byte order, timeout time, and communication time can be configured.

1.1.2 Copy Controller

In industrial settings, there are often many similar PLC configuration parameters and measuring point configurations. To achieve rapid configuration, we have introduced the "Copy Controller" function. This feature allows us to quickly add controllers and measurement point configurations with similar settings, avoiding repetitive configuration tasks. Click on the "..." in the top right corner of the controller card to display more controller actions, then click "Copy". After configuring one controller, you can quickly add a second one; the copy controller will duplicate all the measurement points under the controller.



After clicking the "Copy" button, you can modify the differing configurations as needed, such as the controller name, slave address, etc., and then submit.



Upon completion of the copy, as shown in the diagram, the system will automatically generate measurement points and controller information identical to the first controller:


1.1.3 Disable/Enable Controller

When collecting data from multiple PLC devices and the gateway controller status or collected data is abnormal, we enable only the problematic controller for easy log viewing and real-time communication packet inspection. Click on the "..." in the top right corner of the controller card to display more controller actions, and select "Disable". After that, the controller will no longer perform data collection and reporting.


After disabling, the controller card will turn gray, as shown in the diagram.


When you want to re-enable the controller, click on the "..." in the top right corner of the controller card and select "Enable". The controller will then resume data collection and reporting.

1.1.4 Real-Time Communication Messages

When the controller status displays as abnormal or there is abnormal data collection, viewing the real-time communication messages between the gateway controller and the PLC devices becomes crucial. DSA supports displaying channel real-time communication messages. Select a controller at will, click "..." in the upper right corner of the controller card, and click "Real-time Communication Messages" to display all communication message interactions of the current channel.For example, if two Modbus RTU protocol controllers are enabled and both use an RS485 communication port, the real-time communication messages will show the communication messages of both controllers.

The display effect of real-time communication messages is as follows (Note: If you need to download communication messages, you need to enable "Store Communication Messages" in the advanced settings of the controller configuration before the "Download" button will be displayed. Communication messages of all controllers The text is displayed and saved in HEX format):

1.1.5 Add Measuring Point

In the "Measuring Point List," you can add measuring points to collect data from PLC devices. Click the "Add" button, and in the pop-up box, configure the measuring point parameters, such as adding a measurement point under a Modbus RTU protocol controller and configuring the measurement point name, address, data type, etc. (Note: The measurement point name must be unique within its controller).

In the "Measuring Point List," the "Import" button allows you to import the measurement points from a CSV file into the current gateway; the "Export" button enables you to export the current gateway's measurement point configurations to a CSV file. For details on the specific measurement point CSV file, refer to the Measuring Point CSV File Parameter Description.

1.2 Group

Group allows you to manage measuring points in the monitoring list by dividing them into groups. After the measuring points are grouped, the storage of historical data and measuring point reporting intervals are managed according to the configured groups. If you need to configure different reporting intervals for the measuring points or need to report corresponding data of the measuring points according to different MQTT topics, you can add a new group to manage the measuring points with different requirements. (Note: The default group cannot be deleted)

The group interface is shown in the figure:

For specific group CSV files, please refer to the Grouping CSV File Parameter Description

Add a new group on the group page. The interface is as follows:


Add group parameters Introduction:

  1. Name: Group name
  1. Reporting Interval: the reporting interval of the measuring point in the group.
  1. Periodically Upload Onchange Data :When enabled, Onchange data with unchanged values will also upload data according to the Onchange reporting cycle. The default is off.
  1. Onchange Reporting Interval: A fixed reporting interval for Onchange data.
               Historical Data is a data storage function provided by DSA. DSA can create data tables for measuring point groups and insert the grouped data into the database according to the specified storage strategy. It can be configured by the following parameters:
  1. Max Number: The maximum number of historical data stored in a single group.
  1. Storage policy: Storage interval of historical data
  1. Same AS the Reporting Interval: Store historical data according to reporting interval.
  1. Independent Storage Interval: customize the storage interval of historical data.
  1. Storage Method: The storage method of historical data. Switching the storage path will clear the stored historical data
  1. Gateway Storage: Historical data is stored in the storage space of the gateway itself.
  1. USB: Historical data is stored in a USB storage space external to the gateway.
  1. SD Card: Historical data is stored in the SD card storage space external to the gateway.

After adding a group, when adding a measuring point, you can choose to associate the measuring point with the group or select the measuring point in the list of measuring points to add to the specified group. The measuring points in the group will report data according to the reporting interval of the group.


Click "Export Historical Data" to export the group's historical data in CSV format


Click "Clear Historical Data" to clear the historical data stored in this group.

1.3 Historical Database

The historical database is used to store the historical data of the measuring points. After enabling the "Store Historical Data" function in the configuration of the measuring points, the data of the measuring points can be stored in the historical database. The historical data of measuring points is stored according to the groups they belong to. This arrangement makes it more convenient to locate and export historical data for specific measuring points.

2. Alarm

2.1 Real-time Alarms

After configuring alarm rules and when alarms are triggered, the real-time alarm page will display all triggered alarm items. 

In the real-time alarm table, some parameters from the alarm configuration, such as "Name," "Controller," "Alarm Level," etc., will be shown.

  1. Status: The current trigger status of the alarm item, displayed as "Triggered"
  2. Value: The value at the moment the alarm was triggered
  3. Time: The time when the alarm was triggered
  4. Action: An option to navigate to the "Historical Alarms" page for more details

Below is an example of a real-time alarm display interface.

2.2 Alarm Rules

Alarm rules can help us monitor the value of measuring points on the gateway side, and remind us in time when it exceeds the normal range. For example, in industrial scenarios, the range of voltage and current values and the start and stop status of some equipment need to be focused on. When we configure the alarm rules for collecting these data measuring points on the gateway side, if an alarm is triggered, the MQTT cloud service can be used to report the notification in time to avoid unnecessary losses.

On the alarm rules page, configure the alarm rules by clicking the "Add" button. In the pop-up box, set up the alarm rule parameters. The parameters include:

  1. Name: Alarm name
  2. Controller: The controller to which the alarm measuring point belongs
  3. Measuring point name: The name of the measuring point that triggered the alarm
  4. Alarm level: From low to high support "Remind", "Warning", "Secondary", "Important", "Serious"
  5. Alert Condition:
  1. Judgment condition: Support "=", "! = ", ">", "≥", "<", "≤"
  1. Logical conditions:
  1. No logic condition: The alarm is judged only by a single judgment condition
  1. && : Judging an alarm by two judging conditions
  1. | | : To determine an alarm, use a logical OR relationship between two conditions. This means that the alarm is triggered if either of the two conditions is met.
  1. Alarm content: the alarm content
  2. Alarm label: The alarm label is used to classify the alarm and facilitate quick selection when the alarm is uploaded to the cloud

The following picture shows an alarm with alarm level of alert, which belongs to the default tag. This alarm is generated when the value of the measuring point is >30 and <50; When it is not in this range, no alarm will be generated or the alarm will be eliminated.


In the "Alarm Rules" page, "Import" and "Export" CSV files of alarm rules refer to the Alarm Rules CSV file parameter description

The "Add to Label" function can help us quickly switch multiple alarm items to the alarm label. The following picture is the batch addition of alarm items to the "group_test" alarm label.

2.3 History Alarms

The historical alarms page can help us view the history of all alarm items, including triggered and recovered alarms. This function can help us understand the reason and time when the gateway side triggers/recovers the alarm items.

In the current page, you will see information about all the historical alarms that have been triggered and recovered.

The current page displays parameters that include those configured on the "Alarm Rules" page, such as "Name," "Controller," "Alarm Level," and "Alarm Content." Other parameters in the table are as follows:

  1. "Status" : There are two states, which are "triggered" and "Restored". "Triggered" means that the current alarm item is triggering an alarm; "Restored" means that the current alarm item has returned to normal.
  2. "Value" : The value of the alarm item at the moment the current state has been triggered or has been restored.
  3. "Time" : The time when the alarm was triggered or restored.
  4. "Operation" : Click the "Details" button to see the detailed information when the current alarm item is triggered or restored, and the "Delete" button can delete the current alarm item in the history of alarms.

2.4 Alarm Label

The alarm label can help us manage the alarm items. When the alarm item triggers an alarm, the MQTT message needs to be reported. Directly selecting the alarm label can quickly include all the alarm items under the alarm label. And when we need to report MQTT messages with different topics, we can add an alarm label to group different alarm items, and then select the corresponding label in different MQTT topics.

Go to the alarm label page to view the content of the alarm label.

In the table on the current page, there will be an alarm label named "default" by default (Note: this label cannot be deleted, and the rest of the added alarm labels can be deleted).

After clicking the "Add" button, configure the name of the alarm label in the pop-up box. (Note: This name is unique throughout the alarm label and cannot be repeated).


In the "Alarm Label" page, "Import" and "Export" Alarm rule CSV files, please refer to the Alarm label CSV file parameter introduction

Note: When deleting a label, the alarm items belonging to the current label in the "Alarm Rule" will be deleted together

3. Cloud

In industrial scenarios, the collected data needs to be reported to the cloud platform to help enterprises achieve centralized management, intelligent analysis and remote management of data. In DSA, we can enable and configure corresponding cloud services in the cloud service interface to help customers quickly connect to use mainstream cloud services.

3.1 MQTT Cloud Services

In the current page, you can view the connection status and configuration information of the current MQTT cloud service, and you can edit, import, export and other operations on the MQTT cloud service. Click the "Add" button to add a new MQTT cloud platform. For example, when we need to report data to multiple cloud platforms at the same time, we can add a new MQTT platform to connect to the cloud platform to report data. (Note: the name of the MQTT platform cannot be repeated, and the name of the default MQTT cloud platform is "Default"). As shown in the figure, add an MQTT platform with the name "test" :

The interface after adding is as shown in the figure:

After checking Enable cloud services, MQTT cloud services can be selected in the "Cloud Types" of the configuration interface. "Cloud Types" : The currently supported cloud platforms are "MQTT", "MQTT SparkPlugB", "iSCADA Cloud", "Eagle Energy Manager", "Alibaba Cloud", "AWS IoT", "Azure IoT".


  1. "Clear Offline Cache" : This function can clear MQTT messages that failed to be published after the MQTT Cloud service went offline. For example, when we debug the MQTT function and the offline data generated do not want to be reported to the cloud platform, we can use this function to clear the offline data (Note: only messages with Qos greater than or equal to 1 are cached).
  1. "Import" : Select the configuration file of the MQTT cloud service to import the MQTT configuration in the file and the script in the message management. This function can quickly configure and enable the cloud service. For example, when configuring the same cloud service on different gateways, the configuration file exported after configuring one gateway can be directly imported into other gateways for use.
  1. "Export" : Click to export the configuration of the cloud and the script in the message management to a "cloud.json" file.
In the "cloud measuring point Settings" interface, you can shield the measuring point (after shielding, the measuring point will not be reported), modify the name of the cloud measuring point and other operations.


  1. "Cloud Measuring Point Name" : The name of the measuring point reported to the cloud platform is reported with the name in the current configuration item
  1. "Mute" : After muted, the measuring point will no longer be reported to the cloud platform
  1. "Import" and "Export" can respectively import the configuration information of the upper cloud measuring point Settings to the current gateway, or export the upper cloud measuring point information of the current gateway (note: the CSV file in the upper cloud measuring point Settings only saves the change of the name of the upper cloud measuring point or the muted measuring point). For the specific introduction of CSV file parameters, please refer to the Description of CSV fileparameters for Settings of Upper cloud measuring points
  1. "Message Management" : Here you can add publish script and subscribe script. Only when the script is added, can the message be published to the cloud platform and subscribe to the message of the cloud platform (Note: after enabling the MQTT SparkPlugB cloud service, the message is added by default and cannot be added but can only be modified)

3.2 MindSphere IoT

4. Protocol

In industrial settings, data often exhibits diversity and complexity, and different application scenarios may require different communication protocols to meet their specific needs. DSA's protocol conversion functionality enables data to be uploaded in various application scenarios through different protocols. For example, using the Modbus TCP Slave protocol, data collected by controllers can be forwarded to SCADA servers.


The status page allows you to view the connection and running status of the current protocol (Note: not all protocols have status pages, such as BACnet Server protocol)


The configuration page can configure and view the connection parameters and add the mapping table function for the current protocol. For example, in the Modbus TCP Slave configuration interface, you can configure the Modbus TCP Slave port number, the maximum number of connections and other parameters. In the mapping table, you can perform add/edit, import/export and other operations.

For the specific mapping table CSV file, please refer to the Mapping table CSV file parameter introduction

For specific protocol configuration, please refer to the Appendix: Protocol conversion

5. Parameter Settings

In the parameter setting screen, you can configure the general Settings of the gateway. Such as setting gateway serial port parameters, storage configuration and custom parameters.

5.1Serial port Settings

In the serial port Settings page, you can configure the parameters of the serial port, such as the configuration of the serial port baud rate, data bits, etc.

The parameters of serial port Settings are shown in the figure:

The parameters are explained as follows (same for RS232 and RS485) :

  1. Baud Rate: support 300, 1200, 2400, 4800, 9600, 19200, 39400, 57600, 115200, 230400. The default is 9600
  1. Data Bits: 8 and 7 are supported. The default is 8
  1. Parity: supports no check, odd check and even check. The default is no parity
  1. Stop bit: 1 and 2 are supported. The default is 1

Click the "Submit" button to save your configuration after you've modified it.

5.2 Storage Configuration

In the storage configuration interface, you can configure the log storage of the gateway, the MQTT offline data storage and the communication packet storage of the controller.

The parameters of storage configuration are shown in the figure:


The parameters are explained as follows:

  • Log level: The log level of the log output, the log below this level will not be displayed in the log. The log level from lowest to highest supports DEBUG,INFO,WARNING,ERROR. The default is INFO
  • Historical alarm max: The maximum number of historical alarms in an alarm. Default 2000
  • Offline Data storage Method: Support USB,SD card, gateway storage. The default is gateway storage
  • Offline Data Max: The maximum number of offline data storage. Default 10000
  • Offline Data Upload Period: The frequency of offline data reporting after offline data and other MQTT connections. Default 200ms
  • Offline Data Report Timeout:When publishing a message, if no confirmation or reply is received, the waiting time by default is 1000ms.
  • Offline Data Report Strategy:It can be set as "Offline Data Priority" or "Realtime Data Priority", and the default is "Offline Data Priority".
  • Offline Data Retransmission Policy: Support "continuous retry" and "retry limit reached discard". The default is "continuous retry".
    • "Always retransmit" : The offline data will be retransmitted until the response from the server is received.
    • "retry limit reached discard" : After the specified number of retransmissions, if the response from the server is not received, the offline data will be discarded and the next one will be sent.
  • After selecting "retry limit reached discard", one option will appear:
    • Maximum retry count: The maximum number of times you can republish after a failure to publish. The default is 3
  • Communication Message Storage Method: Support USB,SD card, Gateway storage. The default is Gateway storage
  • Max Stored Communication Messages:2000 by default

After modifying the configuration, click the "Submit" button to save the configuration. If you do not want to save the current changes, click the "Reset" button to restore the last saved configuration

5.3 Custom Parameter

Custom parameters are to define some global parameters, which can be used in cloud service configuration, fast function scripts. Set a global parameter to use, you can modify it more conveniently and quickly. For example, when a parameter needs to be used in multiple custom fast functions, if a custom parameter is used, then when the parameter value is changed, only the parameter value of the custom parameter interface is changed.

5.3.1Configure custom parameters

The parameters for custom parameters look like this:

By default, there are two parameters (note: these two parameters cannot be deleted or modified) :

  1. SN: The SN code of the device
  1. MAC: The MAC address of the device

If you want to add custom parameters, click the "Add" button, fill in the "Parameters" and "Parameters value" in the pop-up window, and click the "Confirm" button to add the modified value.

The "Import" and "Export" buttons can import the custom parameter configuration file to the current gateway and export the custom parameter of the current gateway into a configuration file respectively. For the specific CSV file, please refer to: Custom parameters CSV file parameter introduction

5.3.2Use custom parameters

You can add your own common parameters in custom parameters to be used as wildcards in cloud services and custom fast functions. The method is ${parameter name}, as shown in the following figure:

Custom parameters can also be used in scripts to get all custom parameters via the get_global_parameter() function.

An example script is as follows: (This script can output all the custom parameters in a log)

from common.Logger import logger
from quickfaas.global_dict import get_global_parameter

def main():
    logger.debug('get global dict: %s' % get_global_parameter()) 

The output will be:

6. Custom QuickFunctions

In the custom quickfunctions screen, you can add Python scripts to implement private logic (new scripts are enabled in a threaded manner). Custom fast function scripts support three trigger modes: periodic trigger; Local Subscription Message Trigger; QuickFunction start trigger.

The custom quick function interface button is introduced as shown below:

6.1 Periodic Trigger

A period-triggered quickfunction will trigger the script to run after the period ends

Below is a custom quickfunction that adds a 10-second cycle trigger, using the default script. This script will log "Timer start" and "Timer end" every 10 seconds.

The instructions for each parameter are as follows:

  1. Name: Any non-repeating name
  1. Mode: Select periodic trigger
  1. Periodic: The period that triggers this quickfunction. Units can be chosen: hours, minutes, seconds, the default is seconds.
  1. Entry Function: Stay the same as the entry function name in the script
  1. QuickFunction: Use Python code to customize the task logic of this periodic trigger script.

6.2Local Subscription Message Trigger

Local subscribe message trigger triggers the run script once when subscribed to the Topic that needs to be subscribed. The Topic on the gateway Event Bus can be looked from the  Event BUS

Below is the local subscribe message fast function that adds a subscribe controller write value message. This script will be triggered when a value is written to the controller. With the default script, the write value message will be printed to the log

The parameters are described as follows:

  1. Name: Any non-repeating name
  1. Mode: Select local subscribe message to trigger
  1. Subscribe to Topic: Subscribe to the Topic of gateway internal messages
  1. Entry Function: Keep the same name as the entry function in the script
  1. Function code: Use Python code to customize the task logic of this periodic trigger script.

6.3QuickFunction start trigger

The QuickFunction start trigger, only when the fast function start is complete, triggers the run script once.

The diagram below shows how to add a quickfunction in the QuickFunction Start Trigger mode. Using the default script, "QuickFunction start" will be printed in the logs when the quickfunction is initiated.

The parameters are described as follows:

  1. Name: Any non-repeating name
  2. Mode: Select Quickfunction start trigger
  3. Entry Function: Keep the same name as the entry function in the script
  4. QuickFunction: Use Python code to customize the task logic of this periodic script.


7. Third-party library management

This feature is only supported on IG. The third-party libraries and the description file lib.info are packaged and compressed together on the IG gateway, and can be imported and installed at this page. lib.info describes the information of the library file in the format of json as follows:

{
  "name": "rsa", //library name
  "version": "4.9", //library version number
  "desc": "", //library descriptive information
  "files": "rsa" //library file paths, more than one separated by spaces
}

Then put the lib.info file and the library file information together in a compressed package as a .zip or .tar.gz file, and then import and install it.

Appendix: List of southbound drivers

ABB

*ABB Robot

ABB Robot is a range of industrial robotic products manufactured by ABB for use in a variety of applications on automated production lines.ABB Robot communicates with external devices, control systems or host computers via the TCP/IP protocol for data exchange, control and monitoring functions.

Adding a controller
  • Name: name of the controller, unique in the list of controllers across the gateway
  • Protocol: select *ABB Robot
  • IP address: IP address
  • Port: port information
  • Username: Login username information configured on the robot side
  • Password: Password information configured on the robot side
  • Polling Interval: the time interval (in seconds) for collecting data, for example, if it is set to 10S, all the measurement points under the controller will be polled every 10S.
  • Description: You can add comment information to this controller.
  • Advanced Settings:
  • Timeout Settings:
    • Timeout: When collecting measurement points, after initiating a read request to the device, the device responds to the timeout time, if the device does not respond to the read request within the set acquisition timeout time, it is still a failure of this acquisition.
    • Connect Timeout: Timeout time for establishing a connection.
  • Communication message settings:
    • Store Communication Message: Controllers with this function enabled will store communication messages, and the path and number of stored messages can be set in the "Default Parameters" on the "Parameter Settings" page. If you want to download the stored communication messages, you can go to the "Realtime communication messages" page of the specified controller in the "Measure Monitor" page, and then click the "Download" button to download the messages.
Adding measuring points
  • Measuring Point Name: the name of the measurement point (the name of the measurement point cannot be repeated under the same controller)
  • Read Type: read the specific parameter type of the robot, the following types are supported:
    • Current control status
    • current error state
    • Physical joint information
    • Speed ratio Information
    • Current working mode
    • Local input IO
    • Local output IO
    • Local input IO2
    • Local output IO2
    • Logging
    • System information
    • Target coordinate information
    • Servo enable State
    • Current program running status
    • Task list
  • Data Type: only STRING (8-bit string) is supported
  • Size: the length of the string for the point
  • Character Encoding Format: consistent with the robot side of the character encoding format, support: ASCII, UTF-8, UTF-16-LITTLE, UTF-16-BIG and GB2312 encoding.
  • Read/Write: only Read is supported
  • Mode:
    • Periodic: data is reported regularly according to the reporting cycle of the subgroup to which it belongs.
    • Onchange: data is reported regularly according to a grouped reporting cycle only when there is a change in the value of the measurement point.
    • Never: local use only, no need to upload data from the cloud

AllenBrandly (Rockwell)

EtherNet/IP (CompactLogix)

EtherNet/IP is an industrial Ethernet protocol, which is used to realize communication and data exchange between devices in industrial control systems. It is based on the standard TCP/IP protocol stack, and added to it the application layer protocol used in the field of industrial automation, providing the support of real-time, reliability and security.

Adding a controller
  1. Name: The name of the controller, which is unique in the controller list for the entire gateway
  2. Protocol: Select EtherNet/IP (CompactLogix)
  3. IP Address: IP address
  4. Port: Port information
  5. Polling Interval: the time interval of data collection (seconds), for example, set to 10S, then all the measuring points under the controller are polled every 10S
  6. Enable Multiple polling Interval: Once enabled, you can configure an additional polling interval and select certain measuring points under the controller to use the polling interval. This function can be used to distinguish the measuring points that need high frequency and low frequency acquisition, and make efficient use of gateway and PLC performance.
  7. Polling Interval 2: It is an additional polling interval (in seconds) that needs to be set after enabling multiple polling interval;
  8. Description: You can add comment information to this controller
Advanced Settings:
  1. Timeout Settings:
  1. Timeout: The timeout time for the device to respond after the reading request is initiated to the device when the measuring point is collected. If the device does not respond to the reading request within the set collection timeout time, it is still the failure of this collection.
  1. Connect Timeout: the timeout time for establishing the connection.
  1. Communication Message Settings:
  1. Store Communication Messages: The controller with this function enabled will store communication messages. The storage path and number can be set in the "Default Parameters" of the "Parameter Settings" page. If you need to download the stored communication message, you can enter the " Realtime Communication Message " page of the specified controller in the "Measure Monitor" page, and click the "Download" button to download.
Adding measuring points
  1. Measuring Point Name: The name of the measuring point (the name of the measuring point cannot be repeated under the same controller)
  2. Address: the address of the measuring point
  3. Data type: Measuring point data type, including:
    1. BIT: 0 or 1
    2. BYTE: An 8-bit unsigned number
    3. SINT: 8-bit signed number
    4. WORD: 16-bit unsigned integer
    5. INT: 16-bit signed integer
    6. DWORD: 32-bit unsigned integer
    7. DINT: 32-bit signed integer
    8. FLOAT: 32-bit floating point number
    9. STRING: 8-bit string
    10. BCD16:16-bit BCD code
  4. Read Bit Data: When the data type is selected other than BIT,FLOAT,STRING, the value of any bit data in the integer can be read when enabled.
  5. Register Bit: When the bitwise value is enabled, the bit offset of the measuring point when reading the bit data.
  6. Negative Value: When the bitwise value is enabled or the data type is BIT, you can choose whether to negate the result of the read.
  7. Decimal Places: The length of the data after the decimal point when the data type is FLOAT, the maximum is 6 digits
  8. Read and write permissions:
    1. Read: read-only, not writable
    2. Read/Write: Readable and writable
    3. Write: Only write, not read
  9. Mode:
    1. Periodic: Periodically reports data according to the reporting period of the group it belongs to
    2. Onchange: When the value of the measuring point changes, the data will be reported periodically according to the reporting period of the group
    3. Never: Only used locally, no need to upload data from the cloud
  10. Onchange Deadzone: When the upload mode is Onchange, you can set the value change within a certain range to be treated as no change. If the data has configuration data operation, the value after operation is used to detect whether the value change exceeds the dead zone.
  11. Unit: Measuring point unit
  12. Description: Description of the measuring point
  13. Group: The group to which the measuring point belongs
  14. Store Historical Data: When enabled, the historical data table will be generated with the name of the group to which the measuring point belongs, and the historical data will be stored according to the storage policy set by the group. The stored historical data can be exported as CSV files or obtained by calling Python API.
  15. Data Calculation: When the data type of the measuring point is not BIT or STRING, and the bitwise value is not enabled, it supports simple operation processing through data operation, and the processed data value can be reported to the cloud platform. The value mapped to the protocol conversion (Modbus Slave or OPC UA Server, etc.) defaults to the original data value collected rather than the calculated data value
  16. No: No computation is performed, the raw data value collected is used
  17. Ratio Conversion: the collected data value is mapped to a data value in the range of the upper and lower limits of the ratio in equal proportion to the data value, such as mapping the data collected in the sensor to the actual temperature and humidity. The calculation formula is the calculated data value = (upper limit of proportion - lower limit of proportion)/(upper limit of data - lower limit of data) * (original data value - lower limit of data) + lower limit of proportion
  18. Decimal Places: The number of decimal places that need to be retained after the operation
  19. Data High Limit: The upper limit of the data of the measuring point
  20. Data lower Limit: the lower limit of the data at the measuring point
  21. High Limit Of Proportion: the upper limit of the data after the proportion operation
  22. Lower Limit Of Proportion: The lower limit of the data after the scale operation
  23. Offset and Zoom: calculate the original data value according to the multiplier and offset. The formula is the calculated data value = (original data value * multiplier) + offset
  24. Decimal Places: The number of decimal places to be retained after the operation
  25. Magnification: The multiplier that needs to be scaled up or down
  26. Offset: The data value that needs to be increased or decreased after the multiplier operation
  27. Bit Trunction: Intercepts a segment of data in the original data as a data value. FLOAT type measuring points do not support this operation
  28. Start Bit: The bit offset at which the intercept of the original data begins
  29. End Bit: The bit offset that ends the interception of the original data
  30. PT/CT: Calculate the original data value according to the magnification, offset, PT and CT, the formula is [(original value * magnification)+ offset]*PT*CT
  31. Decimal Places: The number of decimal places that need to be retained after the operation
  32. Magnification: The multiplier that needs to be scaled up or down
  33. Offset: The data value that needs to be increased or decreased after the multiplier operation
  34. PT: Additional PT multiplier
  35. CT: Additional CT magnification
  36. Value mapping: Configurable measuring points for specific values converted to other values.
  37. Source Value: The raw value of the collected measuring point.
  38. Target Value: The expected value of the converted measuring point.
  39. Enable Package Reporting: This field is visible when the controller enables group packet reporting. When the measuring point is enabled, it will report data in accordance with the packet reporting logic set by the controller in addition to the group reporting data
  40. Example description of measuring point address:

A1: Consistent with the PLC address, pay attention to the data type should also be consistent;

Program:MainProgram.A1: If the variable is local, prefix it with the program name;

slot=2; A1: Addresses can also carry additional slot information;

i=A[0] : If A in PLC is based on A bool array of uint type, each bit in A can be accessed using this way;

B[0] : If B is an array, each element can be accessed using an index

EtherNet/IP (Micro)

EtherNet/IP (Micro) is a variant of the EtherNet/IP protocol designed for smaller devices and resource-constrained environments. Compared with the standard EtherNet/IP protocol, EtherNet/IP (Micro) uses a more simplified message format and lightweight communication mechanism in the communication process to reduce resource consumption and communication overhead.

Adding a controller
  1. Name: The name of the controller, which is unique in the controller list for the entire gateway
  1. Protocol: Select EtherNet/IP (MIcro)
  1. IP Address: IP address
  1. Port: Port information
  1. Polling Interval: the time interval of data collection (seconds), for example, set to 10S, then all the measuring points under the controller are polled every 10S
  1. Enable Multiple Polling Interval: Once enabled, you can configure an additional polling interval and select certain measuring points under the controller to use the polling interval. This function can be used to distinguish the measuring points that need high frequency and low frequency acquisition, and make efficient use of gateway and PLC performance.
  1. Polling Interval 2: It is an additional polling interval (in seconds) that needs to be set after enabling multiple polling interval;
  1. Description: You can add comment information to this controller
Advanced Settings:
  1. Timeout Settings:
  1. Timeout: The timeout time for the device to respond after the reading request is initiated to the device when the measuring point is collected. If the device does not respond to the reading request within the set collection timeout time, it is still the failure of this collection.
  1. Connect Timeout: the timeout time for establishing the connection.
  1. Slot:PLC slot
  1. Communication Message Settings:
  1. Store Communication Messages: The controller with this function enabled will store communication messages. The storage path and number can be set in the "Default Parameters" of the "Parameter Settings" page. If you need to download the stored communication message, you can enter the " Realtime Communication Message " page of the specified controller in the "Measure Monitor" page, and click the "Download" button to download.

Adding measuring points

  1. Measuring Point Name: The name of the measuring point (the name of the measuring point cannot be repeated under the same controller)
  2. Address: the address of the measuring point
  3. Data type: Measuring point data type, including:
    1. BIT: 0 or 1
    2. BYTE: An 8-bit unsigned number
    3. SINT: 8-bit signed number
    4. WORD: 16-bit unsigned integer
    5. INT: 16-bit signed integer
    6. DWORD: 32-bit unsigned integer
    7. DINT: 32-bit signed integer
    8. BCD16:16-bit BCD code
    9. FLOAT: 32-bit floating point number
    10. STRING: 8-bit string
    11. BCD16:16-bit BCD code
  4. Read Bit Data: When the data type is selected other than BIT,FLOAT,STRING, the value of any bit data in the integer can be read when enabled.
  5. Register Bit: When the bitwise value is enabled, the bit offset of the measuring point when reading the bit data.
  6. Negative Value: When the bitwise value is enabled or the data type is BIT, you can choose whether to negate the result of the read.
  7. Decimal Places: The length of the data after the decimal point when the data type is FLOAT, the maximum is 6 digits
  8. Read and write permissions:
    1. Read: read-only, not writable
    2. Read/Write: Readable and writable
    3. Write: Only write, not read
  9. Mode:
    1. Periodic: Periodically reports data according to the reporting period of the group it belongs to
    2. Onchange: When the value of the measuring point changes, the data will be reported periodically according to the reporting period of the group
    3. Never: Only used locally, no need to upload data from the cloud
  10. Onchange Deadzone: When the upload mode is Onchange, you can set the value change within a certain range to be treated as no change. If the data has configuration data operation, the value after operation is used to detect whether the value change exceeds the dead zone.
  11. Unit: Measuring point unit
  12. Description: Description of the measuring point
  13. Group: The group to which the measuring point belongs
  14. Store Historical Data: When enabled, the historical data table will be generated with the name of the group to which the measuring point belongs, and the historical data will be stored according to the storage policy set by the group. The stored historical data can be exported as CSV files or obtained by calling Python API.
  15. Data Calculation: When the data type of the measuring point is not BIT or STRING, and the bitwise value is not enabled, it supports simple operation processing through data operation, and the processed data value can be reported to the cloud platform. The value mapped to the protocol conversion (Modbus Slave or OPC UA Server, etc.) defaults to the original data value collected rather than the calculated data value
  16. No: No computation is performed, the raw data value collected is used
  17. Ratio Conversion: the collected data value is mapped to a data value in the range of the upper and lower limits of the ratio in equal proportion to the data value, such as mapping the data collected in the sensor to the actual temperature and humidity. The calculation formula is the calculated data value = (upper limit of proportion - lower limit of proportion)/(upper limit of data - lower limit of data) * (original data value - lower limit of data) + lower limit of proportion
  18. Decimal Places: The number of decimal places that need to be retained after the operation
  19. Data High Limit: The upper limit of the data of the measuring point
  20. Data lower Limit: the lower limit of the data at the measuring point
  21. High Limit Of Proportion: the upper limit of the data after the proportion operation
  22. Lower Limit Of Proportion: The lower limit of the data after the scale operation
  23. Offset and Zoom: calculate the original data value according to the multiplier and offset. The formula is the calculated data value = (original data value * multiplier) + offset
  24. Decimal Places: The number of decimal places to be retained after the operation
  25. Magnification: The multiplier that needs to be scaled up or down
  26. Offset: The data value that needs to be increased or decreased after the multiplier operation
  27. Bit Trunction: Intercepts a segment of data in the original data as a data value. FLOAT type measuring points do not support this operation
  28. Start Bit: The bit offset at which the intercept of the original data begins
  29. End Bit: The bit offset that ends the interception of the original data
  30. PT/CT: Calculate the original data value according to the magnification, offset, PT and CT, the formula is [(original value * magnification)+ offset]*PT*CT
  31. Decimal Places: The number of decimal places that need to be retained after the operation
  32. Magnification: The multiplier that needs to be scaled up or down
  33. Offset: The data value that needs to be increased or decreased after the multiplier operation
  34. PT: Additional PT multiplier
  35. CT: Additional CT magnification
  36. Value mapping: Configurable measuring points for specific values converted to other values.
  37. Source Value: The raw value of the collected measuring point.
  38. Target Value: The expected value of the converted measuring point.
  39. Enable Package Reporting: This field is visible when the controller enables group packet reporting. When the measuring point is enabled, it will report data in accordance with the packet reporting logic set by the controller in addition to the group reporting data
  40. Example description of measuring point address:
A1: Consistent with the PLC address, pay attention to the data type should also be consistent;
Program:MainProgram.A1: If the variable is local, prefix it with the program name;
slot=2; A1: Addresses can also carry additional slot information;
i=A[0] : If A in PLC is based on A bool array of uint type, each bit in A can be accessed using this way;
B[0] : If B is an array, each element can be accessed using an index

EtherNet/IP (MicroLogix)

EtherNet/IP (MicroLogix) refers to the use of EtherNet/IP protocol for communication in the MicroLogix controller family

Adding a controller
  1. Name: The name of the controller, which is unique in the controller list for the entire gateway
  1. Protocol: Select EtherNet/IP (MIcroLogix)
  1. IP Address: IP address
  1. Port: Port information
  1. Polling Interval: the time interval of data collection (seconds), for example, set to 10S, then all the measuring points under the controller are polled every 10S
  1. Enable Multiple polling Interval: Once enabled, you can configure an additional polling interval and select certain measuring points under the controller to use the polling interval. This function can be used to distinguish the measuring points that need high frequency and low frequency acquisition, and make efficient use of gateway and PLC performance.
  1. Polling Interval 2: It is an additional polling interval (in seconds) that needs to be set after enabling multiple polling interval;
  1. Description: You can add comment information to this controller
Advanced Settings:
  1. Timeout Settings:
  1. Timeout: The timeout time for the device to respond after the reading request is initiated to the device when the measuring point is collected. If the device does not respond to the reading request within the set collection timeout time, it is still the failure of this collection.
  1. Connect Timeout: the timeout time for establishing the connection.
  1. Communication Message Settings:

Store Communication Messages: The controller with this function enabled will store communication messages. The storage path and number can be set in the "Default Parameters" of the "Parameter Settings" page. If you need to download the stored communication message, you can enter the " Realtime Communication Message " page of the specified controller in the "Measure Monitor" page, and click the "Download" button to download.


Adding measuring points
Measuring Point Name: The name of the measuring point (the name of the measuring point cannot be repeated under the same controller)
  1. Address: the address of the measuring point
  2. Data type: Measuring point data type, including:
    1. BIT: 0 or 1
    2. BYTE: An 8-bit unsigned number
    3. SINT: 8-bit signed number
    4. WORD: 16-bit unsigned integer
    5. INT: 16-bit signed integer
    6. DWORD: 32-bit unsigned integer
    7. DINT: 32-bit signed integer
    8. FLOAT: 32-bit floating point number
    9. STRING: 8-bit string
  3. Read Bit Data: When the data type is selected other than BIT,FLOAT,STRING, the value of any bit data in the integer can be read when enabled.
  4. Register Bit: When the bitwise value is enabled, the bit offset of the measuring point when reading the bit data.
  5. Negative Value: When the bitwise value is enabled or the data type is BIT, you can choose whether to negate the result of the read.
  6. Decimal Places: The length of the data after the decimal point when the data type is FLOAT, the maximum is 6 digits
  7. Read and write permissions:
    1. Read: read-only, not writable
    2. Read/Write: Readable and writable
    3. Write: Only write, not read
  8. Mode:
    1. Periodic: Periodically reports data according to the reporting period of the group it belongs to
    2. Onchange: When the value of the measuring point changes, the data will be reported periodically according to the reporting period of the group
    3. Never: Only used locally, no need to upload data from the cloud
  9. Onchange Deadzone: When the upload mode is Onchange, you can set the value change within a certain range to be treated as no change. If the data has configuration data operation, the value after operation is used to detect whether the value change exceeds the dead zone.
  10. Unit: Measuring point unit
  11. Description: Description of the measuring point
  12. Group: The group to which the measuring point belongs
  13. Store Historical Data: When enabled, the historical data table will be generated with the name of the group to which the measuring point belongs, and the historical data will be stored according to the storage policy set by the group. The stored historical data can be exported as CSV files or obtained by calling Python API.
  14. Data Calculation: When the data type of the measuring point is not BIT or STRING, and the bitwise value is not enabled, it supports simple operation processing through data operation, and the processed data value can be reported to the cloud platform. The value mapped to the protocol conversion (Modbus Slave or OPC UA Server, etc.) defaults to the original data value collected rather than the calculated data value
  15. No: No computation is performed, the raw data value collected is used
  16. Ratio Conversion: the collected data value is mapped to a data value in the range of the upper and lower limits of the ratio in equal proportion to the data value, such as mapping the data collected in the sensor to the actual temperature and humidity. The calculation formula is the calculated data value = (upper limit of proportion - lower limit of proportion)/(upper limit of data - lower limit of data) * (original data value - lower limit of data) + lower limit of proportion
  17. Decimal Places: The number of decimal places that need to be retained after the operation
  18. Data High Limit: The upper limit of the data of the measuring point
  19. Data lower Limit: the lower limit of the data at the measuring point
  20. High Limit Of Proportion: the upper limit of the data after the proportion operation
  21. Lower Limit Of Proportion: The lower limit of the data after the scale operation
  22. Offset and Zoom: calculate the original data value according to the multiplier and offset. The formula is the calculated data value = (original data value * multiplier) + offset
  23. Decimal Places: The number of decimal places to be retained after the operation
  24. Magnification: The multiplier that needs to be scaled up or down
  25. Offset: The data value that needs to be increased or decreased after the multiplier operation
  26. Bit Trunction: Intercepts a segment of data in the original data as a data value. FLOAT type measuring points do not support this operation
  27. Start Bit: The bit offset at which the intercept of the original data begins
  28. End Bit: The bit offset that ends the interception of the original data
  29. PT/CT: Calculate the original data value according to the magnification, offset, PT and CT, the formula is [(original value * magnification)+ offset]*PT*CT
  30. Decimal Places: The number of decimal places that need to be retained after the operation
  31. Magnification: The multiplier that needs to be scaled up or down
  32. Offset: The data value that needs to be increased or decreased after the multiplier operation
  33. PT: Additional PT multiplier
  34. CT: Additional CT magnification
  35. Value mapping: Configurable measuring points for specific values converted to other values.
  36. Source Value: The raw value of the collected measuring point.
  37. Target Value: The expected value of the converted measuring point.
  38. Enable Package Reporting: This field is visible when the controller enables group packet reporting. When the measuring point is enabled, it will report data in accordance with the packet reporting logic set by the controller in addition to the group reporting data
  39. Example description of measuring point address:

A9:0: ASCII

B2:0: Bit

N2:0:Integer

L17:0:Long Integer

ST2:0:String

F8:5:Floating

S:1/15:Status

C2:0:Counter

T2:0:Timer

I:0/15:Input

O:0/15:Output


EtherNet/IP (Unconnected)

EtherNet/IP (Unconnected) refers to a method of communication used in the EtherNet/IP protocol. Unconnected means that there is no need to establish a persistent connection when communicating, and each communication is independent and immediate. This method is similar to the connectionless communication method in the UDP protocol, which is more lightweight and flexible, and is suitable for some scenarios with less stringent real-time requirements.

Adding a controller
  1. Name: The name of the controller, which is unique in the controller list for the entire gateway
  2. Protocol: Select EtherNet/IP (Unconnected)
  3. IP Address: IP address
  4. Port : Port information
  5. Polling Interval: the time interval of data collection (seconds), for example, set to 10S, then all the measuring points under the controller are polled every 10S
  6. Enable Multiple Polling Interval: Once enabled, you can configure an additional polling interval and select certain measuring points under the controller to use the polling interval. This function can be used to distinguish the measuring points that need high frequency and low frequency acquisition, and make efficient use of gateway and PLC performance.
  7. Polling Interval 2: It is an additional polling interval (in seconds) that needs to be set after enabling multiple polling interval;
  8. Description: You can add comment information to this controller
Advanced Settings:
  1. Timeout Settings:
  1. Timeout: The timeout time for the device to respond after the reading request is initiated to the device when the measuring point is collected. If the device does not respond to the reading request within the set collection timeout time, it is still the failure of this collection.
  1. Connect Timeout: the timeout time for establishing the connection.
  1.      Slot:PLC slot
  2. Communication Message Settings:
  1.     Store Communication Messages: The controller with this function enabled will store communication messages. The storage path and number can be set in the "Default Parameters" of the "Parameter Settings" page. If you need to download the stored communication message, you can enter the " Realtime Communication Message " page of the specified controller in the "Measure Monitor" page, and click the "Download" button to download.

Adding measuring points

Measuring Point Name: The name of the measuring point (the name of the measuring point cannot be repeated under the same controller)
  1. Symbol: the address of the measuring point
  2. Data type: Measuring point data type, including:
    1. BIT: 0 or 1
    2. BYTE: An 8-bit unsigned number
    3. SINT: 8-bit signed number
    4. WORD: 16-bit unsigned integer
    5. INT: 16-bit signed integer
    6. DWORD: 32-bit unsigned integer
    7. DINT: 32-bit signed integer
    8. FLOAT: 32-bit floating point number
    9. STRING: 8-bit string
  3. Read Bit Data: When the data type is selected other than BIT,FLOAT,STRING, the value of any bit data in the integer can be read when enabled.
  4. Register Bit: When the bitwise value is enabled, the bit offset of the measuring point when reading the bit data.
  5. Negative Value: When the bitwise value is enabled or the data type is BIT, you can choose whether to negate the result of the read.
  6. Decimal Places: The length of the data after the decimal point when the data type is FLOAT, the maximum is 6 digits
  7. Read and write permissions:
    1. Read: read-only, not writable
    2. Read/Write: Readable and writable
    3. Write: Only write, not read
  8. Mode:
    1. Periodic: Periodically reports data according to the reporting period of the group it belongs to
    2. Onchange: When the value of the measuring point changes, the data will be reported periodically according to the reporting period of the group
    3. Never: Only used locally, no need to upload data from the cloud
  9. Onchange Deadzone: When the upload mode is Onchange, you can set the value change within a certain range to be treated as no change. If the data has configuration data operation, the value after operation is used to detect whether the value change exceeds the dead zone.
  10. Unit: Measuring point unit
  11. Description: Description of the measuring point
  12. Group: The group to which the measuring point belongs
  13. Store Historical Data: When enabled, the historical data table will be generated with the name of the group to which the measuring point belongs, and the historical data will be stored according to the storage policy set by the group. The stored historical data can be exported as CSV files or obtained by calling Python API.
  14. Data Calculation: When the data type of the measuring point is not BIT or STRING, and the bitwise value is not enabled, it supports simple operation processing through data operation, and the processed data value can be reported to the cloud platform. The value mapped to the protocol conversion (Modbus Slave or OPC UA Server, etc.) defaults to the original data value collected rather than the calculated data value
  15. No: No computation is performed, the raw data value collected is used
  16. Ratio Conversion: the collected data value is mapped to a data value in the range of the upper and lower limits of the ratio in equal proportion to the data value, such as mapping the data collected in the sensor to the actual temperature and humidity. The calculation formula is the calculated data value = (upper limit of proportion - lower limit of proportion)/(upper limit of data - lower limit of data) * (original data value - lower limit of data) + lower limit of proportion
    1. Decimal Places: The number of decimal places that need to be retained after the operation
    2. Data High Limit: The upper limit of the data of the measuring point
    3. Data lower Limit: the lower limit of the data at the measuring point
    4. High Limit Of Proportion: the upper limit of the data after the proportion operation
    5. Lower Limit Of Proportion: The lower limit of the data after the scale operation
  17. Offset and Zoom: calculate the original data value according to the multiplier and offset. The formula is the calculated data value = (original data value * multiplier) + offset
    1. Decimal Places: The number of decimal places to be retained after the operation
    2. Magnification: The multiplier that needs to be scaled up or down
    3. Offset: The data value that needs to be increased or decreased after the multiplier operation
  18. Bit Trunction: Intercepts a segment of data in the original data as a data value. FLOAT type measuring points do not support this operation
    1. Start Bit: The bit offset at which the intercept of the original data begins
    2. End Bit: The bit offset that ends the interception of the original data
  19. PT/CT: Calculate the original data value according to the magnification, offset, PT and CT, the formula is [(original value * magnification)+ offset]*PT*CT
    1. Decimal Places: The number of decimal places that need to be retained after the operation
    2. Magnification: The multiplier that needs to be scaled up or down
    3. Offset: The data value that needs to be increased or decreased after the multiplier operation
    4. PT: Additional PT multiplier
    5. CT: Additional CT magnification
  20. Value mapping: Configurable measuring points for specific values converted to other values.
    1. Source Value: The raw value of the collected measuring point.
    2. Target Value: The expected value of the converted measuring point.
  21. Enable Package Reporting: This field is visible when the controller enables group packet reporting. When the measuring point is enabled, it will report data in accordance with the packet reporting logic set by the controller in addition to the group reporting data
  22. Example description of measuring point address:

A1: Consistent with the PLC address, pay attention to the data type should also be consistent;

Program:MainProgram.A1: If the variable is local, prefix it with the program name;

slot=2; A1: Addresses can also carry additional slot information;

i=A[0] : If A in PLC is based on A bool array of uint type, each bit in A can be accessed using this way;

B[0] : If B is an array, each element can be accessed using an index


*SLC Net

SLC Net stands for "Symbian Limited Compatibility Network" and it is the network communication protocol for Symbian OS. Symbian OS is a kind of operating system that has been widely used in smart phones and mobile devices. It provides a wealth of functions and application support.

Adding controllers
  1. Name: The name of the controller, which is unique in the controller list for the entire gateway
  2. Protocol: Select *SLC Net
  3. IP Address: IP address
  4. Port: Port information
  5. Polling Interval: the time interval of data collection (seconds), for example, set to 10S, then all the measuring points under the controller are polled every 10S
  6. Enable Multiple Polling Interval: Once enabled, you can configure an additional polling interval and select certain measuring points under the controller to use the polling interval. This function can be used to distinguish the measuring points that need high frequency and low frequency acquisition, and make efficient use of gateway and PLC performance.
  7. Polling Interval 2: It is an additional polling interval (in seconds) that needs to be set after enabling multiple polling interval;
  8. Description: You can add comment information to this controller
Advanced Settings:
  1. Timeout Settings:
  1. Timeout: The timeout time for the device to respond after the reading request is initiated to the device when the measuring point is collected. If the device does not respond to the reading request within the set collection timeout time, it is still the failure of this collection.
  1. Connect Timeout: the timeout time for establishing the connection.
  1. Communication Message Settings:
  1. Store Communication Messages: The controller with this function enabled will store communication messages. The storage path and number can be set in the "Default Parameters" of the "Parameter Settings" page. If you need to download the stored communication message, you can enter the " Realtime Communication Message " page of the specified controller in the "Measure Monitor" page, and click the "Download" button to download.


Adding measuring points

Measuring Point Name: The name of the measuring point (the name of the measuring point cannot be repeated under the same controller)
  1. Address: the address of the measuring point
  2. Data type: Measuring point data type, including:
    1. BIT: 0 or 1
    2. BYTE: An 8-bit unsigned number
    3. SINT: 8-bit signed number
    4. WORD: 16-bit unsigned integer
    5. INT: 16-bit signed integer
    6. DWORD: 32-bit unsigned integer
    7. DINT: 32-bit signed integer
    8. FLOAT: 32-bit floating point number
    9. STRING: 8-bit string
    10. BCD16:16-bit BCD code
  3. Read Bit Data: When the data type is selected other than BIT,FLOAT,STRING, the value of any bit data in the integer can be read when enabled.
  4. Register Bit: When the bitwise value is enabled, the bit offset of the measuring point when reading the bit data.
  5. Negative Value: When the bitwise value is enabled or the data type is BIT, you can choose whether to negate the result of the read.
  6. Decimal Places: The length of the data after the decimal point when the data type is FLOAT, the maximum is 6 digits
  7. Read and write permissions:
    1. Read: read-only, not writable
    2. Read/Write: Readable and writable
    3. Write: Only write, not read
  8. Mode:
    1. Periodic: Periodically reports data according to the reporting period of the group it belongs to
    2. Onchange: When the value of the measuring point changes, the data will be reported periodically according to the reporting period of the group
    3. Never: Only used locally, no need to upload data from the cloud
  9. Onchange Deadzone: When the upload mode is Onchange, you can set the value change within a certain range to be treated as no change. If the data has configuration data operation, the value after operation is used to detect whether the value change exceeds the dead zone.
  10. Unit: Measuring point unit
  11. Description: Description of the measuring point
  12. Group: The group to which the measuring point belongs
  13. Store Historical Data: When enabled, the historical data table will be generated with the name of the group to which the measuring point belongs, and the historical data will be stored according to the storage policy set by the group. The stored historical data can be exported as CSV files or obtained by calling Python API.
  14. Data Calculation: When the data type of the measuring point is not BIT or STRING, and the bitwise value is not enabled, it supports simple operation processing through data operation, and the processed data value can be reported to the cloud platform. The value mapped to the protocol conversion (Modbus Slave or OPC UA Server, etc.) defaults to the original data value collected rather than the calculated data value
  15. No: No computation is performed, the raw data value collected is used
  16. Ratio Conversion: the collected data value is mapped to a data value in the range of the upper and lower limits of the ratio in equal proportion to the data value, such as mapping the data collected in the sensor to the actual temperature and humidity. The calculation formula is the calculated data value = (upper limit of proportion - lower limit of proportion)/(upper limit of data - lower limit of data) * (original data value - lower limit of data) + lower limit of proportion
    1. Decimal Places: The number of decimal places that need to be retained after the operation
    2. Data High Limit: The upper limit of the data of the measuring point
    3. Data lower Limit: the lower limit of the data at the measuring point
    4. High Limit Of Proportion: the upper limit of the data after the proportion operation
    5. Lower Limit Of Proportion: The lower limit of the data after the scale operation
  17. Offset and Zoom: calculate the original data value according to the multiplier and offset. The formula is the calculated data value = (original data value * multiplier) + offset
    1. Decimal Places: The number of decimal places to be retained after the operation
    2. Magnification: The multiplier that needs to be scaled up or down
    3. Offset: The data value that needs to be increased or decreased after the multiplier operation
  18. Bit Trunction: Intercepts a segment of data in the original data as a data value. FLOAT type measuring points do not support this operation
    1. Start Bit: The bit offset at which the intercept of the original data begins
    2. End Bit: The bit offset that ends the interception of the original data
  19. PT/CT: Calculate the original data value according to the magnification, offset, PT and CT, the formula is [(original value * magnification)+ offset]*PT*CT
    1. Decimal Places: The number of decimal places that need to be retained after the operation
    2. Magnification: The multiplier that needs to be scaled up or down
    3. Offset: The data value that needs to be increased or decreased after the multiplier operation
    4. PT: Additional PT multiplier
    5. CT: Additional CT magnification
  20. Value mapping: Configurable measuring points for specific values converted to other values.
    1. Source Value: The raw value of the collected measuring point.
    2. Target Value: The expected value of the converted measuring point.
  21. Enable Package Reporting: This field is visible when the controller enables group packet reporting. When the measuring point is enabled, it will report data in accordance with the packet reporting logic set by the controller in addition to the group reporting data
  22. Example description of measuring point address:

A9:0: ASCII variable

B2:0: Bit variable

N2:0: Integer variables

F8:5: Floating point

S:1/15: Status variable

ST2:0: String

C2:0: Counter

I:0/15: Input

O:0/15: Output

R9:0: Control

T2:0: Timer

L9:0: Long Integer

BACnet

BACnet IP

BACnet is a communication protocol used in building automation and control systems for data communication and control between building devices. Communication is based on the Internet Protocol (IP).BACnet IP uses a standard IP network as the communication medium to connect building devices via network devices such as Ethernet or Wi-Fi for data exchange and control between devices.

Adding a controller
  • Name: name of the controller, unique in the list of controllers across the gateway
  • Protocol: select BACnet IP
  • IP address: IP address
  • Port: port information
  • Device ID: Bacnet ID of the captured device
  • Polling Interval: the time interval (in seconds) for collecting data, for example, if it is set to 10S, all the measurement points under the controller will be polled every 10S.
  • Enable Multiple Polling Interval: When enabled, you can configure an additional polling cycle and select certain points under the controller to use that polling cycle. This feature can be used to differentiate between measurement points that require high and low frequency acquisition, making efficient use of gateway and PLC performance.
  • Polling Interval 2: i.e. the additional polling cycle (in seconds) that needs to be set when multiple polling cycles are enabled
  • Description: You can add comment information to this controller.

Advanced Settings:

  • Timeout Settings:
    • Timeout: When collecting measurement points, after initiating a read request to the device, the device responds to the timeout time, if the device does not respond to the read request within the set acquisition timeout time, it is still a failure of this acquisition.
    • Open Continuous Collection: whether to collect measurement points under the controller in batch or not. When batch collection is enabled, it will read all the measurement points with consecutive addresses in one reading request, which can effectively improve the collection efficiency.
    • Continuous Collection Address: When batch acquisition is enabled, you need to configure the maximum number of measurement points allowed to be acquired at one time.
    • APDU Timeout: Application Protocol Data Unit (APDU) timeout period;
    • Continuous Collection Address: the number of times the communication fails and attempts to repeat the communication;
  • Communication time setting:
    • Communication Interval Time: The interval time between message interactions, i.e., after receiving a response from the device, it will wait for a communication interval time before sending the next request message.
  • Communication message settings:
    • Store Communication Message: Controllers with this function enabled will store communication messages, and the path and number of stored messages can be set in the "Default Parameters" on the "Parameter Settings" page. If you want to download the stored communication messages, you can go to the "Realtime communication messages" page of the specified controller in the "Measure Monitor" page, and then click the "Download" button to download the messages.
Adding measuring points
  • Measuring Point Name: the name of the measurement point (the name of the measurement point cannot be repeated under the same controller)
  • Object Type: the following types are supported
    • Analog Input
    • Analog Output
    • Analog Value
    • Binary Input
    • Binary Output
    • Binary Value
    • Multi-state Input
    • Multi-state Output
    • Multi-state Value
    • Loop
    • Trend Log
    • Proprietary Min
  • Instance Number: the example number of the corresponding object type
  • Data types: The following data types are supported
    • BIT: 0 or 1
    • BYTE: 8-bit unsigned integer
    • SINT: 8-bit signed integer
    • WORD: 16-bit unsigned integer
    • INT: 16-bit signed integer
    • DWORD: 32-bit unsigned integer
    • DINT: 32-bit signed integer
    • FLOAT: 32-bit floating point number
    • DOUBLE: 64-bit floating point number
    • STRING: 8-bit string
    • ULONG: 64-bit unsigned integer
    • LONG: 64-bit signed integer
  • Read Bit Data: When the data type selection is not FLOAT,STRING, you can read the value of any bit of data in the integer when it is enabled.
  • Register Bit: The bit offset of the measurement point when reading bit data after turning on value by bit.
  • Negative Value: When turn on value by bit, you can choose whether or not to invert the read result.
  • Decimal Places: the length of the data after the decimal point of the measurement point when the data type is FLOAT, maximum 6 digits
  • Read/Write:
    • Read: read only, not write
    • Read/Write: readable and writable
    • Write: Write only, not read
  • Mode:
    • Periodic: data is reported regularly according to the reporting cycle of the subgroup to which it belongs.
    • Onchange: data is reported regularly according to a grouped reporting cycle only when there is a change in the value of the measurement point.
    • Never: local use only, no need to upload data from the cloud
  • Onchange Deadzone: When the upload mode is Onchange, you can set the value change within a certain range to be considered as no change in the value. If the data has configured data operation, then according to the value after the operation to detect whether the value change exceeds the dead zone.
  • Unit: measurement point unit
  • Description: Description of the measurement point
  • Group: Subgroup to which the measurement point belongs
  • Store Historical Data: When enabled, a historical data table will be generated with the name of the group to which the measurement point belongs, and the historical data will be stored according to the storage policy set by the group. Stored historical data can be exported as CSV files or obtained by calling the Python API.
  • Data Calculation: If the data type of the measurement point is not BIT or STRING and bitwise value is not enabled, simple arithmetic processing is supported through data arithmetic, and the processed data values can be reported to the cloud platform. Values mapped to protocol conversions (Modbus Slave or OPC UA Server, etc.) are by default the raw data values collected rather than the calculated data values.
  • No: no arithmetic is performed, the collected raw data values are used
  • Ratio Conversion: The collected data value is mapped to a data value in the range of the upper and lower limits of the scale in equal proportions according to the range of the upper and lower limits of the data, such as mapping the data collected in the sensor to the actual temperature and humidity. Calculation formula for the calculated data value = (upper limit of the ratio - lower limit of the ratio) / (upper limit of the data - lower limit of the data) * (original data value - lower limit of the data) + lower limit of the ratio
    • Decimal Places: the number of decimal places to be retained after arithmetic operations
    • Data High Limit: the upper data limit for a measurement point
    • Data Lower Limit: lower data limit value for the measurement point
    • High Limit Of Proportion: the upper limit of the data after proportional operation
    • Lower Limit Of Proportion: the lower limit value of the data after proportional operation
  • Offset And Zoom: Calculate the original data value according to the multiplier and offset, the formula is calculated data value = (original data value * Magnification) + Offset
    • Decimal places: the number of decimal places to be retained after arithmetic operations
    • Magnification: the magnification needed to zoom in or out
    • Offset: the data value to be increased or decreased after the multiplier operation
  • Bit Truncation: Intercepts a segment of bit data from the original data as a data value; this operation is not supported for FLOAT-type points.
    • Start Bit: Bit offset to start intercepting the original data
    • End Bit: Bit offset to end the interception of the original data
  • PT/CT: Calculate the raw data value according to the magnification, offset, PT and CT, with the formula [(raw value*magnification)+offset]*PT*CT
    • Decimal Places: the number of decimal places to be retained after arithmetic operations
    • Magnification: the magnification needed to zoom in or out
    • Offset: the data value to be increased or decreased after the multiplier operation
    • PT: Additional PT multiplier
    • CT: additional CT magnification
  • Value Mapping: Configurable conversion of specific values of measurement points to other values.
    • Source Value: The original measured point value collected.
    • Target Value: the value of the measurement point after the conversion is expected.

BACnet MS/TP

BACnet MS/TP (Master-Slave/Token-Passing) is a variant of the BACnet protocol used to communicate in serial networks in building automation systems.MS/TP is a common BACnet physical layer protocol typically used to connect building devices such as sensors, actuators, and controllers via serial communication for data exchange and control.

Adding a controller
  • Name: name of the controller, unique in the list of controllers across the gateway
  • Protocol: select BACnet MS/TP
  • Communication Mode: support RS232 and RS485, default use RS485
  • Device ID: Bacnet ID of the captured device
  • Polling Interval: the time interval (in seconds) for collecting data, for example, if it is set to 10S, all the measurement points under the controller will be polled every 10S.
  • Enable Multiple Polling Interval: When enabled, you can configure an additional polling cycle and select certain points under the controller to use that polling cycle. This feature can be used to differentiate between measurement points that require high and low frequency acquisition, making efficient use of gateway and PLC performance.
  • Description: You can add comment information to this controller.

Advanced Settings:

  • Timeout Settings:
    • Timeout: When collecting measurement points, after initiating a read request to the device, the device responds to the timeout time, if the device does not respond to the read request within the set acquisition timeout time, it is still a failure of this acquisition.
    • Open Continuous Collection: whether to collect measurement points under the controller in batch or not. When batch collection is enabled, it will read all the measurement points with consecutive addresses in one reading request, which can effectively improve the collection efficiency.
    • Continuous Collection Address: When batch acquisition is enabled, you need to configure the maximum number of measurement points allowed to be acquired at one time.
    • APDU Timeout: Application Protocol Data Unit (APDU) timeout period;
    • Continuous Collection Address: the number of times the communication fails and attempts to repeat the communication;
  • Communication time setting:
    • Communication Interval Time: The interval time between message interactions, i.e., after receiving a response from the device, it will wait for a communication interval time before sending the next request message.
  • Communication message settings:
    • Store Communication Message: Controllers with this function enabled will store communication messages, and the path and number of stored messages can be set in the "Default Parameters" on the "Parameter Settings" page. If you want to download the stored communication messages, you can go to the "Realtime communication messages" page of the specified controller in the "Measure Monitor" page, and then click the "Download" button to download the messages.
Adding measuring points
  • Measuring Point Name: the name of the measurement point (the name of the measurement point cannot be repeated under the same controller)
  • Object Type: the following types are supported
    • Analog Input
    • Analog Output
    • Analog Value
    • Binary Input
    • Binary Output
    • Binary Value
    • Multi-state Input
    • Multi-state Output
    • Multi-state Value
    • Loop
    • Trend Log
    • Proprietary Min
  • Instance Number: the example number of the corresponding object type
  • Data types: The following data types are supported
    • BIT: 0 or 1
    • BYTE: 8-bit unsigned integer
    • SINT: 8-bit signed integer
    • WORD: 16-bit unsigned integer
    • INT: 16-bit signed integer
    • DWORD: 32-bit unsigned integer
    • DINT: 32-bit signed integer
    • FLOAT: 32-bit floating point number
    • DOUBLE: 64-bit floating point number
    • STRING: 8-bit string
    • ULONG: 64-bit unsigned integer
    • LONG: 64-bit signed integer
  • Read Bit Data: When the data type selection is not FLOAT,STRING, you can read the value of any bit of data in the integer when it is enabled.
  • Register Bit: The bit offset of the measurement point when reading bit data after turning on value by bit.
  • Negative Value: When turn on value by bit, you can choose whether or not to invert the read result.
  • Decimal Places: the length of the data after the decimal point of the measurement point when the data type is FLOAT, maximum 6 digits
  • Read/Write:
    • Read: read only, not write
    • Read/Write: readable and writable
    • Write: Write only, not read
  • Mode:
    • Periodic: data is reported regularly according to the reporting cycle of the subgroup to which it belongs.
    • Onchange: data is reported regularly according to a grouped reporting cycle only when there is a change in the value of the measurement point.
    • Never: local use only, no need to upload data from the cloud
  • Onchange Deadzone: When the upload mode is Onchange, you can set the value change within a certain range to be considered as no change in the value. If the data has configured data operation, then according to the value after the operation to detect whether the value change exceeds the dead zone.
  • Unit: measurement point unit
  • Description: Description of the measurement point
  • Group: Subgroup to which the measurement point belongs
  • Store Historical Data: When enabled, a historical data table will be generated with the name of the group to which the measurement point belongs, and the historical data will be stored according to the storage policy set by the group. Stored historical data can be exported as CSV files or obtained by calling the Python API.
  • Data Calculation: If the data type of the measurement point is not BIT or STRING and bitwise value is not enabled, simple arithmetic processing is supported through data arithmetic, and the processed data values can be reported to the cloud platform. Values mapped to protocol conversions (Modbus Slave or OPC UA Server, etc.) are by default the raw data values collected rather than the calculated data values.
  • No: no arithmetic is performed, the collected raw data values are used
  • Ratio Conversion: The collected data value is mapped to a data value in the range of the upper and lower limits of the scale in equal proportions according to the range of the upper and lower limits of the data, such as mapping the data collected in the sensor to the actual temperature and humidity. Calculation formula for the calculated data value = (upper limit of the ratio - lower limit of the ratio) / (upper limit of the data - lower limit of the data) * (original data value - lower limit of the data) + lower limit of the ratio
    • Decimal Places: the number of decimal places to be retained after arithmetic operations
    • Data High Limit: the upper data limit for a measurement point
    • Data Lower Limit: lower data limit value for the measurement point
    • High Limit Of Proportion: the upper limit of the data after proportional operation
    • Lower Limit Of Proportion: the lower limit value of the data after proportional operation
  • Offset And Zoom: Calculate the original data value according to the multiplier and offset, the formula is calculated data value = (original data value * Magnification) + Offset
    • Decimal places: the number of decimal places to be retained after arithmetic operations
    • Magnification: the magnification needed to zoom in or out
    • Offset: the data value to be increased or decreased after the multiplier operation
  • Bit Truncation: Intercepts a segment of bit data from the original data as a data value; this operation is not supported for FLOAT-type points.
    • Start Bit: Bit offset to start intercepting the original data
    • End Bit: Bit offset to end the interception of the original data
  • PT/CT: Calculate the raw data value according to the magnification, offset, PT and CT, with the formula [(raw value*magnification)+offset]*PT*CT
    • Decimal Places: the number of decimal places to be retained after arithmetic operations
    • Magnification: the magnification needed to zoom in or out
    • Offset: the data value to be increased or decreased after the multiplier operation
    • PT: Additional PT multiplier
    • CT: additional CT magnification
  • Value Mapping: Configurable conversion of specific values of measurement points to other values.
    • Source Value: The original measured point value collected.
    • Target Value: the value of the measurement point after the conversion is expected.

Beckhoff

*ADS

A communication protocol and communication mechanism commonly used in Beckhoff industrial automation systems, ADS is a high-performance, real-time communication protocol for communication between Beckhoff controllers, Engineering Stations and other ADS-enabled devices.

Adding a controller
  • Name: name of the controller, unique in the list of controllers across the gateway
  • Protocol: select *ADS
  • IP address: IP address information of the device
  • Port number: port information of the device
  • Polling Interval: the time interval (in seconds) for collecting data, for example, if it is set to 10S, all the measurement points under the controller will be polled every 10S.
  • Enable Multiple Polling Interval: When enabled, you can configure an additional polling cycle and select certain points under the controller to use that polling cycle. This feature can be used to differentiate between test points that require high and low frequency acquisition, making efficient use of gateway and PLC performance.
  • Polling Interval 2: i.e. the additional polling cycle (in seconds) that needs to be set when multiple polling cycles are enabled
  • AMS Port: port number of Ams router, TwinCAT2:801,811,831 TwinCAT3:851,852,853
  • Target Net Id: network ID number of the target, example: 192.168.100.1.1.1.
  • Sender Net Id: network ID number of the sender, example: 192.168.100.1.1.1, not the ip address. The actual value needs to be set on TwinCAT.
  • Description: You can add comment information to this controller.

Advanced Settings:

  • Timeout Settings:
    • Timeout: When collecting measurement points, after initiating a read request to the device, the device responds to the timeout time, if the device does not respond to the read request within the set acquisition timeout time, it is still a failure of this acquisition.
    • Connect Timeout: Timeout time for establishing a connection.
  • Communication Message Settings:
    • Store Communication Message: Controllers with this function enabled will store communication messages, and the path and number of stored messages can be set in the "Default Parameters" on the "Parameter Settings" page. If you want to download the stored communication messages, you can go to the "Realtime Communication Message" page of the specified controller in the "Measure Monitor" page, and then click the "Download" button to download the messages.
Adding measuring points
  • Measuring Point Name: the name of the measurement point (the name of the measurement point cannot be repeated under the same controller)
  • Address: Measurement point address
  • Data types: The following data types are supported
    • BIT: 0 or 1
    • BYTE: 8-bit unsigned integer
    • SINT: 8-bit signed integer
    • WORD: 16-bit unsigned integer
    • INT: 16-bit signed integer
    • DWORD: 32-bit unsigned integer
    • DINT: 32-bit signed integer
    • FLOAT: 32-bit floating point number
    • DOUBLE: 64-bit floating point number
    • STRING: 8-bit string
  • Read Bit Data: When the data type selection is not FLOAT,STRING, you can read the value of any bit of data in the integer when it is enabled.
  • Register Bit: The bit offset of the measurement point when reading bit data after turning on value by bit.
  • Negative Value: When turn on value by bit, you can choose whether or not to invert the read result.
  • Decimal Places: the length of the data after the decimal point of the measurement point when the data type is FLOAT, maximum 6 digits
  • Read/Write:
    • Read: read only, not write
    • Read/Write: readable and writable
  • Mode:
    • Periodic: data is reported regularly according to the reporting cycle of the subgroup to which it belongs.
    • Onchange: data is reported regularly according to a grouped reporting cycle only when there is a change in the value of the measurement point.
    • Never: local use only, no need to upload data from the cloud
  • Onchange Deadzone: When the upload mode is Onchange, you can set the value change within a certain range to be considered as no change in the value. If the data has configured data operation, then according to the value after the operation to detect whether the value change exceeds the dead zone.
  • Unit: measurement point unit
  • Description: Description of the measurement point
  • Group: Subgroup to which the measurement point belongs
  • Store Historical Data: When enabled, a historical data table will be generated with the name of the group to which the measurement point belongs, and the historical data will be stored according to the storage policy set by the group. Stored historical data can be exported as CSV files or obtained by calling the Python API.
  • Data Calculation: If the data type of the measurement point is not BIT or STRING and bitwise value is not enabled, simple arithmetic processing is supported through data arithmetic, and the processed data values can be reported to the cloud platform. Values mapped to protocol conversions (Modbus Slave or OPC UA Server, etc.) are by default the raw data values collected rather than the calculated data values.
  • No: no arithmetic is performed, the collected raw data values are used
  • Ratio Conversion: The collected data value is mapped to a data value in the range of the upper and lower limits of the scale in equal proportions according to the range of the upper and lower limits of the data, such as mapping the data collected in the sensor to the actual temperature and humidity. Calculation formula for the calculated data value = (upper limit of the ratio - lower limit of the ratio) / (upper limit of the data - lower limit of the data) * (original data value - lower limit of the data) + lower limit of the ratio
    • Decimal Places: the number of decimal places to be retained after arithmetic operations
    • Data High Limit: the upper data limit for a measurement point
    • Data Lower Limit: lower data limit value for the measurement point
    • High Limit Of Proportion: the upper limit of the data after proportional operation
    • Lower Limit Of Proportion: the lower limit value of the data after proportional operation
  • Offset And Zoom: Calculate the original data value according to the multiplier and offset, the formula is calculated data value = (original data value * Magnification) + Offset
    • Decimal places: the number of decimal places to be retained after arithmetic operations
    • Magnification: the magnification needed to zoom in or out
    • Offset: the data value to be increased or decreased after the multiplier operation
  • Bit Truncation: Intercepts a segment of bit data from the original data as a data value; this operation is not supported for FLOAT-type points.
    • Start Bit: Bit offset to start intercepting the original data
    • End Bit: Bit offset to end the interception of the original data
  • PT/CT: Calculate the raw data value according to the magnification, offset, PT and CT, with the formula [(raw value*magnification)+offset]*PT*CT
    • Decimal Places: the number of decimal places to be retained after arithmetic operations
    • Magnification: the magnification needed to zoom in or out
    • Offset: the data value to be increased or decreased after the multiplier operation
    • PT: Additional PT multiplier
    • CT: additional CT magnification
  • Value Mapping: Configurable conversion of specific values of measurement points to other values.
    • Source Value: The original measured point value collected.
    • Target Value: the value of the measurement point after the conversion is expected

CJT188

CJT188-2004

CJT188-2004 is a Chinese communication standard for data transmission and communication in monitoring and control systems. This standard is mainly applicable to monitoring and control systems in the fields of electric power systems, power transmission and distribution equipment, substations, etc., in order to realise data exchange, monitoring and control between equipment.

Adding a controller
  • Name: name of the controller, unique in the list of controllers across the gateway
  • Protocol: select CJT188-2004
  • Meter address: Meter number
  • Meter Type: select from drop-down box
    • 10: Cold water meter
    • 11: Domestic hot water meter
    • 12: Drinking water meters
    • 13 Central water meter
    • 20: Calorimeters (heat metering)
    • 21: Calorimeters (cooling capacity)
    • 22: Calorimeters (heat and cooling)
    • 30: Gas meters
    • 40: Customised meters
  • Endpoint: support RS232 and RS485, RS485 is used by default.
  • Polling Interval: the time interval (in seconds) for collecting data, for example, if it is set to 10S, all the measurement points under the controller will be polled every 10S.
  • Enable Multiple Polling Interval: When enabled, you can configure an additional polling cycle and select certain points under the controller to use that polling cycle. This feature can be used to differentiate between measurement points that require high and low frequency acquisition, making efficient use of gateway and PLC performance.
  • Polling Interval 2: i.e. the additional polling cycle (in seconds) that needs to be set when multiple polling cycles are enabled
  • Description: You can add comment information to this controller.

Advanced Settings:

  • Timeout Settings:
    • Timeout: When collecting measurement points, after initiating a read request to the device, the device responds to the timeout time, if the device does not respond to the read request within the set acquisition timeout time, it is still a failure of this acquisition.
  • Communication time setting:
    • Communication Interval Time: the interval between message interactions, i.e. after receiving a response from the device, it will wait for a communication interval before sending the next request message.
  • Communication Message Settings:
    • Store Communication Messages: The controller with this function enabled will store communication messages. The storage path and number can be set in the "Default Parameters" of the "Parameter Settings" page. If you need to download the stored communication message, you can enter the " Realtime Communication Message " page of the specified controller in the "Measure Monitor" page, and click the "Download" button to download.
Adding measuring points
  • Measuring Point Name: the name of the measurement point (the name of the measurement point cannot be repeated under the same controller)
  • Address: Please select from the drop down box
  • Data types: The following data types are supported
    • BYTE: 8-bit unsigned integer
    • SINT: 8-bit signed integer
    • WORD: 16-bit unsigned integer
    • INT: 16-bit signed integer
    • DWORD: 32-bit unsigned integer
    • DINT: 32-bit signed integer
    • FLOAT: 32-bit floating point number
    • DOUBLE: 64-bit floating point number
    • ULONG: 64-bit unsigned integer
    • LONG: 64-bit signed integer
  • Read Bit Data: When the data type selection is not FLOAT,STRING, you can read the value of any bit of data in the integer when it is enabled.
  • Register Bit: The bit offset of the measurement point when reading bit data after turning on value by bit.
  • Negative Value: When turn on value by bit, you can choose whether or not to invert the read result.
  • Decimal Places: the length of the data after the decimal point of the measurement point when the data type is FLOAT, maximum 6 digits
  • Read/Write:
    • Read: read only, not write
  • Mode:
    • Periodic: data is reported regularly according to the reporting cycle of the subgroup to which it belongs.
    • Onchange: data is reported regularly according to a grouped reporting cycle only when there is a change in the value of the measurement point.
    • Never: local use only, no need to upload data from the cloud
  • Onchange Deadzone: When the upload mode is Onchange, you can set the value change within a certain range to be considered as no change in the value. If the data has configured data operation, then according to the value after the operation to detect whether the value change exceeds the dead zone.
  • Unit: measurement point unit
  • Description: Description of the measurement point
  • Group: Subgroup to which the measurement point belongs
  • Store Historical Data: When enabled, a historical data table will be generated with the name of the group to which the measurement point belongs, and the historical data will be stored according to the storage policy set by the group. Stored historical data can be exported as CSV files or obtained by calling the Python API.
  • Data Calculation: If the data type of the measurement point is not BIT or STRING and bitwise value is not enabled, simple arithmetic processing is supported through data arithmetic, and the processed data values can be reported to the cloud platform. Values mapped to protocol conversions (Modbus Slave or OPC UA Server, etc.) are by default the raw data values collected rather than the calculated data values.
  • No: no arithmetic is performed, the collected raw data values are used
  • Ratio Conversion: The collected data value is mapped to a data value in the range of the upper and lower limits of the scale in equal proportions according to the range of the upper and lower limits of the data, such as mapping the data collected in the sensor to the actual temperature and humidity. Calculation formula for the calculated data value = (upper limit of the ratio - lower limit of the ratio) / (upper limit of the data - lower limit of the data) * (original data value - lower limit of the data) + lower limit of the ratio
    • Decimal Places: the number of decimal places to be retained after arithmetic operations
    • Data High Limit: the upper data limit for a measurement point
    • Data Lower Limit: lower data limit value for the measurement point
    • High Limit Of Proportion: the upper limit of the data after proportional operation
    • Lower Limit Of Proportion: the lower limit value of the data after proportional operation
  • Offset And Zoom: Calculate the original data value according to the multiplier and offset, the formula is calculated data value = (original data value * Magnification) + Offset
    • Decimal places: the number of decimal places to be retained after arithmetic operations
    • Magnification: the magnification needed to zoom in or out
    • Offset: the data value to be increased or decreased after the multiplier operation
  • Bit Truncation: Intercepts a segment of bit data from the original data as a data value; this operation is not supported for FLOAT-type points.
    • Start Bit: Bit offset to start intercepting the original data
    • End Bit: Bit offset to end the interception of the original data
  • PT/CT: Calculate the raw data value according to the magnification, offset, PT and CT, with the formula [(raw value*magnification)+offset]*PT*CT
    • Decimal Places: the number of decimal places to be retained after arithmetic operations
    • Magnification: the magnification needed to zoom in or out
    • Offset: the data value to be increased or decreased after the multiplier operation
    • PT: Additional PT multiplier
    • CT: additional CT magnification
  • Value Mapping: Configurable conversion of specific values of measurement points to other values.
    • Source Value: The original measured point value collected.
    • Target Value: the value of the measurement point after the conversion is expected.

Delta

Delta TCP

Delta TCP refers to the communication method based on the TCP/IP protocol used by Delta Electronics.Delta TCP can be used for data acquisition and processing applications. By connecting to a data acquisition device or database system, real-time acquisition, storage and analysis of equipment data can be achieved to monitor and optimise the production process.

Adding a controller
  • Name: name of the controller, unique in the list of controllers across the gateway
  • Protocol: Select Delta TCP
  • Station No: device identifier, consistent with the device, range 0-255
  • IP address: IP address information of the device
  • Port: information about the port number of the device
  • Polling Interval: the time interval (in seconds) for collecting data, for example, if it is set to 10S, all the measurement points under the controller will be polled every 10S.
  • PLC Type: Delta's series information, support DVP or AS series
  • Enable Multiple Polling Interval: When enabled, you can configure an additional polling cycle and select certain points under the controller to use that polling cycle. This feature can be used to differentiate between test points that require high and low frequency acquisition, making efficient use of gateway and PLC performance.
  • Polling Interval 2: i.e. the additional polling cycle (in seconds) that needs to be set when multiple polling cycles are enabled
  • Description: You can add comment information to this controller.

Advanced Settings:

  • Timeout Setting:
    • Timeout: When collecting measurement points, after initiating a read request to the device, the device responds to the timeout time, if the device does not respond to the read request within the set acquisition timeout time, it is still a failure of this acquisition.
    • Connect Timeout: Timeout time for establishing a connection.
  • Communication Message Settings:
    • Store Communication Message: Controllers with this function enabled will store communication messages, and the path and number of stored messages can be set in the "Default Parameters" on the "Parameter Settings" page. If you want to download the stored communication messages, you can go to the "Realtime communication messages" page of the specified controller in the "Measure Monitor" page, and then click the "Download" button to download the messages.
Adding measuring points
  • Measuring Point Name: the name of the measurement point (the name of the measurement point cannot be repeated under the same controller)
  • Address: Measurement point address
  • Data Type: The following data types are supported:
    • BIT: 0 or 1
    • BYTE: 8-bit unsigned integer
    • SINT: 8-bit signed integer
    • WORD: 16-bit unsigned integer
    • INT: 16-bit signed integer
    • DWORD: 32-bit unsigned integer
    • DINT: 32-bit signed integer
    • FLOAT: 32-bit floating point number
    • DOUBLE: 64-bit floating point number
    • STRING: 8-bit string
    • BCD16: 16-bit BCD code
  • Read Bit Data: When the data type selection is not FLOAT,STRING, you can read the value of any bit of data in the integer when it is enabled.
  • Register Bit: The bit offset of the measurement point when reading bit data after turning on value by bit.
  • Negative Value: When turn on value by bit, you can choose whether or not to invert the read result.
  • Decimal Places: the length of the data after the decimal point of the measurement point when the data type is FLOAT, maximum 6 digits
  • Read/Write:
    • Read: read only, not write
    • Read/Write: readable and writable
  • Mode:
    • Periodic: data is reported regularly according to the reporting cycle of the subgroup to which it belongs.
    • Onchange: data is reported regularly according to a grouped reporting cycle only when there is a change in the value of the measurement point.
    • Never: local use only, no need to upload data from the cloud
  • Onchange Deadzone: When the upload mode is Onchange, you can set the value change within a certain range to be considered as no change in the value. If the data has configured data operation, then according to the value after the operation to detect whether the value change exceeds the dead zone.
  • Unit: measurement point unit
  • Description: Description of the measurement point
  • Group: Subgroup to which the measurement point belongs
  • Store Historical Data: When enabled, a historical data table will be generated with the name of the group to which the measurement point belongs, and the historical data will be stored according to the storage policy set by the group. Stored historical data can be exported as CSV files or obtained by calling the Python API.
  • Data Calculation: If the data type of the measurement point is not BIT or STRING and bitwise value is not enabled, simple arithmetic processing is supported through data arithmetic, and the processed data values can be reported to the cloud platform. Values mapped to protocol conversions (Modbus Slave or OPC UA Server, etc.) are by default the raw data values collected rather than the calculated data values.
  • No: no arithmetic is performed, the collected raw data values are used
  • Ratio Conversion: The collected data value is mapped to a data value in the range of the upper and lower limits of the scale in equal proportions according to the range of the upper and lower limits of the data, such as mapping the data collected in the sensor to the actual temperature and humidity. Calculation formula for the calculated data value = (upper limit of the ratio - lower limit of the ratio) / (upper limit of the data - lower limit of the data) * (original data value - lower limit of the data) + lower limit of the ratio
    • Decimal Places: the number of decimal places to be retained after arithmetic operations
    • Data High Limit: the upper data limit for a measurement point
    • Data Lower Limit: lower data limit value for the measurement point
    • High Limit Of Proportion: the upper limit of the data after proportional operation
    • Lower Limit Of Proportion: the lower limit value of the data after proportional operation
  • Offset And Zoom: Calculate the original data value according to the multiplier and offset, the formula is calculated data value = (original data value * Magnification) + Offset
    • Decimal places: the number of decimal places to be retained after arithmetic operations
    • Magnification: the magnification needed to zoom in or out
    • Offset: the data value to be increased or decreased after the multiplier operation
  • Bit Truncation: Intercepts a segment of bit data from the original data as a data value; this operation is not supported for FLOAT-type points.
    • Start Bit: Bit offset to start intercepting the original data
    • End Bit: Bit offset to end the interception of the original data
  • PT/CT: Calculate the raw data value according to the magnification, offset, PT and CT, with the formula [(raw value*magnification)+offset]*PT*CT
    • Decimal Places: the number of decimal places to be retained after arithmetic operations
    • Magnification: the magnification needed to zoom in or out
    • Offset: the data value to be increased or decreased after the multiplier operation
    • PT: Additional PT multiplier
    • CT: additional CT magnification
  • Value Mapping: Configurable conversion of specific values of measurement points to other values.
    • Source Value: The original measured point value collected.
    • Target Value: the value of the measurement point after the conversion is expected.

Delta Serial

Delta Serial refers to the serial communication method used by Delta Electronics. It can be used for data acquisition and processing applications. By connecting with data acquisition equipment or database systems, real-time acquisition, storage and analysis of equipment data can be achieved to monitor and optimise production processes.

Adding a controller
  • Name: name of the controller, unique in the list of controllers across the gateway
  • Protocol: Select Delta Serial
  • Station No: device identifier, consistent with the device, range 0-255
  • Communication Mode: support RS232 and RS485, default use RS485
  • Polling Interval: the time interval (in seconds) for collecting data, for example, if it is set to 10S, all the measurement points under the controller will be polled every 10S.
  • PLC Type: Delta's series information, support DVP or AS series
  • Enable Multiple Polling Interval: When enabled, you can configure an additional polling cycle and select certain points under the controller to use that polling cycle. This feature can be used to differentiate between test points that require high and low frequency acquisition, making efficient use of gateway and PLC performance.
  • Polling Interval 2: i.e. the additional polling cycle (in seconds) that needs to be set when multiple polling cycles are enabled
  • Description: You can add comment information to this controller.
  • Advanced Settings:
  • Timeout Setting:
  • Timeout: When collecting measurement points, after initiating a read request to the device, the device responds to the timeout time, if the device does not respond to the read request within the set acquisition timeout time, it is still a failure of this acquisition.
  • Communication time setting:
    • Communication Interval Time: The interval time between message interactions, i.e., after receiving a response from the device, it will wait for a communication interval time before sending the next request message.
  • Communication Message Settings:
    • Store Communication Message: Controllers with this function enabled will store communication messages, and the path and number of stored messages can be set in the "Default Parameters" on the "Parameter Settings" page. If you want to download the stored communication messages, you can go to the "Realtime communication messages" page of the specified controller in the "Measure Monitor" page, and then click the "Download" button to download the messages.
Adding measuring points
  • Measuring Point Name: the name of the measurement point (the name of the measurement point cannot be repeated under the same controller)
  • Address: Measurement point address
  • Data Type: The following data types are supported:
    • BIT: 0 or 1
    • BYTE: 8-bit unsigned integer
    • SINT: 8-bit signed integer
    • WORD: 16-bit unsigned integer
    • INT: 16-bit signed integer
    • DWORD: 32-bit unsigned integer
    • DINT: 32-bit signed integer
    • FLOAT: 32-bit floating point number
    • DOUBLE: 64-bit floating point number
    • STRING: 8-bit string
    • BCD16: 16-bit BCD code
  • Read Bit Data: When the data type selection is not FLOAT,STRING, you can read the value of any bit of data in the integer when it is enabled.
  • Register Bit: The bit offset of the measurement point when reading bit data after turning on value by bit.
  • Negative Value: When turn on value by bit, you can choose whether or not to invert the read result.
  • Decimal Places: the length of the data after the decimal point of the measurement point when the data type is FLOAT, maximum 6 digits
  • Read/Write:
    • Read: read only, not write
    • Read/Write: readable and writable
  • Mode:
    • Periodic: data is reported regularly according to the reporting cycle of the subgroup to which it belongs.
    • Onchange: data is reported regularly according to a grouped reporting cycle only when there is a change in the value of the measurement point.
    • Never: local use only, no need to upload data from the cloud
  • Onchange Deadzone: When the upload mode is Onchange, you can set the value change within a certain range to be considered as no change in the value. If the data has configured data operation, then according to the value after the operation to detect whether the value change exceeds the dead zone.
  • Unit: measurement point unit
  • Description: Description of the measurement point
  • Group: Subgroup to which the measurement point belongs
  • Store Historical Data: When enabled, a historical data table will be generated with the name of the group to which the measurement point belongs, and the historical data will be stored according to the storage policy set by the group. Stored historical data can be exported as CSV files or obtained by calling the Python API.
  • Data Calculation: If the data type of the measurement point is not BIT or STRING and bitwise value is not enabled, simple arithmetic processing is supported through data arithmetic, and the processed data values can be reported to the cloud platform. Values mapped to protocol conversions (Modbus Slave or OPC UA Server, etc.) are by default the raw data values collected rather than the calculated data values.
  • No: no arithmetic is performed, the collected raw data values are used
  • Ratio Conversion: The collected data value is mapped to a data value in the range of the upper and lower limits of the scale in equal proportions according to the range of the upper and lower limits of the data, such as mapping the data collected in the sensor to the actual temperature and humidity. Calculation formula for the calculated data value = (upper limit of the ratio - lower limit of the ratio) / (upper limit of the data - lower limit of the data) * (original data value - lower limit of the data) + lower limit of the ratio
    • Decimal Places: the number of decimal places to be retained after arithmetic operations
    • Data High Limit: the upper data limit for a measurement point
    • Data Lower Limit: lower data limit value for the measurement point
    • High Limit Of Proportion: the upper limit of the data after proportional operation
    • Lower Limit Of Proportion: the lower limit value of the data after proportional operation
  • Offset And Zoom: Calculate the original data value according to the multiplier and offset, the formula is calculated data value = (original data value * Magnification) + Offset
    • Decimal places: the number of decimal places to be retained after arithmetic operations
    • Magnification: the magnification needed to zoom in or out
    • Offset: the data value to be increased or decreased after the multiplier operation
  • Bit Truncation: Intercepts a segment of bit data from the original data as a data value; this operation is not supported for FLOAT-type points.
    • Start Bit: Bit offset to start intercepting the original data
    • End Bit: Bit offset to end the interception of the original data
  • PT/CT: Calculate the raw data value according to the magnification, offset, PT and CT, with the formula [(raw value*magnification)+offset]*PT*CT
    • Decimal Places: the number of decimal places to be retained after arithmetic operations
    • Magnification: the magnification needed to zoom in or out
    • Offset: the data value to be increased or decreased after the multiplier operation
    • PT: Additional PT multiplier
    • CT: additional CT magnification
  • Value Mapping: Configurable conversion of specific values of measurement points to other values.
    • Source Value: The original measured point value collected.
    • Target Value: the value of the measurement point after the conversion is expected.

Delta Serial ASCII

Delta Serial refers to the serial communication method used by Delta Electronics. It uses ASCII code as the encoding format for data. It can be used for data acquisition and processing applications. By connecting to a data acquisition device or database system, real-time acquisition, storage and analysis of equipment data can be achieved to monitor and optimise the production process.

Adding a controller
  • Name: name of the controller, unique in the list of controllers across the gateway
  • Protocol: Select Delta Serial ASCII
  • Station No: device identifier, consistent with the device, range 0-255
  • Communication Mode: support RS232 and RS485, default use RS485
  • Polling Interval: the time interval (in seconds) for collecting data, for example, if it is set to 10S, all the measurement points under the controller will be polled every 10S.
  • PLC Type: Delta's series information, support DVP or AS series
  • Enable Multiple Polling Interval: When enabled, you can configure an additional polling cycle and select certain points under the controller to use that polling cycle. This feature can be used to differentiate between test points that require high and low frequency acquisition, making efficient use of gateway and PLC performance.
  • Polling Interval 2: i.e. the additional polling cycle (in seconds) that needs to be set when multiple polling cycles are enabled
  • Description: You can add comment information to this controller.
  • Advanced Settings:
  • Timeout Setting:
  • Timeout: When collecting measurement points, after initiating a read request to the device, the device responds to the timeout time, if the device does not respond to the read request within the set acquisition timeout time, it is still a failure of this acquisition.
  • Communication time setting:
    • Communication Interval Time: The interval time between message interactions, i.e., after receiving a response from the device, it will wait for a communication interval time before sending the next request message.
  • Communication Message Settings:
    • Store Communication Message: Controllers with this function enabled will store communication messages, and the path and number of stored messages can be set in the "Default Parameters" on the "Parameter Settings" page. If you want to download the stored communication messages, you can go to the "Realtime communication messages" page of the specified controller in the "Measure Monitor" page, and then click the "Download" button to download the messages.
Adding measuring points
  • Measuring Point Name: the name of the measurement point (the name of the measurement point cannot be repeated under the same controller)
  • Address: Measurement point address
  • Data Type: The following data types are supported:
    • BIT: 0 or 1
    • BYTE: 8-bit unsigned integer
    • SINT: 8-bit signed integer
    • WORD: 16-bit unsigned integer
    • INT: 16-bit signed integer
    • DWORD: 32-bit unsigned integer
    • DINT: 32-bit signed integer
    • FLOAT: 32-bit floating point number
    • DOUBLE: 64-bit floating point number
    • STRING: 8-bit string
    • BCD16: 16-bit BCD code
  • Read Bit Data: When the data type selection is not FLOAT,STRING, you can read the value of any bit of data in the integer when it is enabled.
  • Register Bit: The bit offset of the measurement point when reading bit data after turning on value by bit.
  • Negative Value: When turn on value by bit, you can choose whether or not to invert the read result.
  • Decimal Places: the length of the data after the decimal point of the measurement point when the data type is FLOAT, maximum 6 digits
  • Read/Write:
    • Read: read only, not write
    • Read/Write: readable and writable
  • Mode:
    • Periodic: data is reported regularly according to the reporting cycle of the subgroup to which it belongs.
    • Onchange: data is reported regularly according to a grouped reporting cycle only when there is a change in the value of the measurement point.
    • Never: local use only, no need to upload data from the cloud
  • Onchange Deadzone: When the upload mode is Onchange, you can set the value change within a certain range to be considered as no change in the value. If the data has configured data operation, then according to the value after the operation to detect whether the value change exceeds the dead zone.
  • Unit: measurement point unit
  • Description: Description of the measurement point
  • Group: Subgroup to which the measurement point belongs
  • Store Historical Data: When enabled, a historical data table will be generated with the name of the group to which the measurement point belongs, and the historical data will be stored according to the storage policy set by the group. Stored historical data can be exported as CSV files or obtained by calling the Python API.
  • Data Calculation: If the data type of the measurement point is not BIT or STRING and bitwise value is not enabled, simple arithmetic processing is supported through data arithmetic, and the processed data values can be reported to the cloud platform. Values mapped to protocol conversions (Modbus Slave or OPC UA Server, etc.) are by default the raw data values collected rather than the calculated data values.
  • No: no arithmetic is performed, the collected raw data values are used
  • Ratio Conversion: The collected data value is mapped to a data value in the range of the upper and lower limits of the scale in equal proportions according to the range of the upper and lower limits of the data, such as mapping the data collected in the sensor to the actual temperature and humidity. Calculation formula for the calculated data value = (upper limit of the ratio - lower limit of the ratio) / (upper limit of the data - lower limit of the data) * (original data value - lower limit of the data) + lower limit of the ratio
    • Decimal Places: the number of decimal places to be retained after arithmetic operations
    • Data High Limit: the upper data limit for a measurement point
    • Data Lower Limit: lower data limit value for the measurement point
    • High Limit Of Proportion: the upper limit of the data after proportional operation
    • Lower Limit Of Proportion: the lower limit value of the data after proportional operation
  • Offset And Zoom: Calculate the original data value according to the multiplier and offset, the formula is calculated data value = (original data value * Magnification) + Offset
    • Decimal places: the number of decimal places to be retained after arithmetic operations
    • Magnification: the magnification needed to zoom in or out
    • Offset: the data value to be increased or decreased after the multiplier operation
  • Bit Truncation: Intercepts a segment of bit data from the original data as a data value; this operation is not supported for FLOAT-type points.
    • Start Bit: Bit offset to start intercepting the original data
    • End Bit: Bit offset to end the interception of the original data
  • PT/CT: Calculate the raw data value according to the magnification, offset, PT and CT, with the formula [(raw value*magnification)+offset]*PT*CT
    • Decimal Places: the number of decimal places to be retained after arithmetic operations
    • Magnification: the magnification needed to zoom in or out
    • Offset: the data value to be increased or decreased after the multiplier operation
    • PT: Additional PT multiplier
    • CT: additional CT magnification
  • Value Mapping: Configurable conversion of specific values of measurement points to other values.
    • Source Value: The original measured point value collected.
    • Target Value: the value of the measurement point after the conversion is expected.

Delta Serial over TCP

Delta Serial over TCP is a method of transmitting Serial Communication over a TCP/IP network. Delta Electronics typically uses this method for remote monitoring, remote control, and data acquisition of its equipment.

Adding a controller
  • Name: name of the controller, unique in the list of controllers across the gateway
  • Controller Protocol: Select Delta Serial over TCP
  • Station number: device identifier, consistent with the device, range 0-255
  • IP address: IP address information of the device
  • Port number: information about the port number of the device
  • Polling period: the time interval (in seconds) for collecting data, for example, if it is set to 10S, all the measurement points under the controller will be polled every 10S.
  • PLC type: Delta's series information, support DVP or AS series
  • Enable Multiple Polling Cycles: When enabled, you can configure an additional polling cycle and select certain points under the controller to use that polling cycle. This feature can be used to differentiate between test points that require high and low frequency acquisition, making efficient use of gateway and PLC performance.
  • Polling Cycle 2: i.e. the additional polling cycle (in seconds) that needs to be set when multiple polling cycles are enabled
  • Description: You can add comment information to this controller.

Advanced Settings:

  • Timeout Time Setting
    • Acquisition timeout: When collecting measurement points, after initiating a read request to the device, the device responds to the timeout time, if the device does not respond to the read request within the set acquisition timeout time, it is still a failure of this acquisition.
    • Connection Timeout Time: Timeout time for establishing a connection.
  • Communication message settings:
    • Stored communication messages: Controllers with this function enabled will store communication messages, and the path and number of stored messages can be set in the "Default Parameters" on the "Parameter Settings" page. If you want to download the stored communication messages, you can go to the "Real-time communication messages" page of the specified controller in the "Monitoring" page, and then click the "Download" button to download the messages.
Adding measuring points
  • Measuring Point Name: the name of the measurement point (the name of the measurement point cannot be repeated under the same controller)
  • Address: Measurement point address
  • Data Type: The following data types are supported:
    • BIT: 0 or 1
    • BYTE: 8-bit unsigned integer
    • SINT: 8-bit signed integer
    • WORD: 16-bit unsigned integer
    • INT: 16-bit signed integer
    • DWORD: 32-bit unsigned integer
    • DINT: 32-bit signed integer
    • FLOAT: 32-bit floating point number
    • DOUBLE: 64-bit floating point number
    • STRING: 8-bit string
    • BCD16: 16-bit BCD code
  • Read Bit Data: When the data type selection is not FLOAT,STRING, you can read the value of any bit of data in the integer when it is enabled.
  • Register Bit: The bit offset of the measurement point when reading bit data after turning on value by bit.
  • Negative Value: When turn on value by bit, you can choose whether or not to invert the read result.
  • Decimal Places: the length of the data after the decimal point of the measurement point when the data type is FLOAT, maximum 6 digits
  • Read/Write:
    • Read: read only, not write
    • Read/Write: readable and writable
  • Mode:
    • Periodic: data is reported regularly according to the reporting cycle of the subgroup to which it belongs.
    • Onchange: data is reported regularly according to a grouped reporting cycle only when there is a change in the value of the measurement point.
    • Never: local use only, no need to upload data from the cloud
  • Onchange Deadzone: When the upload mode is Onchange, you can set the value change within a certain range to be considered as no change in the value. If the data has configured data operation, then according to the value after the operation to detect whether the value change exceeds the dead zone.
  • Unit: measurement point unit
  • Description: Description of the measurement point
  • Group: Subgroup to which the measurement point belongs
  • Store Historical Data: When enabled, a historical data table will be generated with the name of the group to which the measurement point belongs, and the historical data will be stored according to the storage policy set by the group. Stored historical data can be exported as CSV files or obtained by calling the Python API.
  • Data Calculation: If the data type of the measurement point is not BIT or STRING and bitwise value is not enabled, simple arithmetic processing is supported through data arithmetic, and the processed data values can be reported to the cloud platform. Values mapped to protocol conversions (Modbus Slave or OPC UA Server, etc.) are by default the raw data values collected rather than the calculated data values.
  • No: no arithmetic is performed, the collected raw data values are used
  • Ratio Conversion: The collected data value is mapped to a data value in the range of the upper and lower limits of the scale in equal proportions according to the range of the upper and lower limits of the data, such as mapping the data collected in the sensor to the actual temperature and humidity. Calculation formula for the calculated data value = (upper limit of the ratio - lower limit of the ratio) / (upper limit of the data - lower limit of the data) * (original data value - lower limit of the data) + lower limit of the ratio
    • Decimal Places: the number of decimal places to be retained after arithmetic operations
    • Data High Limit: the upper data limit for a measurement point
    • Data Lower Limit: lower data limit value for the measurement point
    • High Limit Of Proportion: the upper limit of the data after proportional operation
    • Lower Limit Of Proportion: the lower limit value of the data after proportional operation
  • Offset And Zoom: Calculate the original data value according to the multiplier and offset, the formula is calculated data value = (original data value * Magnification) + Offset
    • Decimal places: the number of decimal places to be retained after arithmetic operations
    • Magnification: the magnification needed to zoom in or out
    • Offset: the data value to be increased or decreased after the multiplier operation
  • Bit Truncation: Intercepts a segment of bit data from the original data as a data value; this operation is not supported for FLOAT-type points.
    • Start Bit: Bit offset to start intercepting the original data
    • End Bit: Bit offset to end the interception of the original data
  • PT/CT: Calculate the raw data value according to the magnification, offset, PT and CT, with the formula [(raw value*magnification)+offset]*PT*CT
    • Decimal Places: the number of decimal places to be retained after arithmetic operations
    • Magnification: the magnification needed to zoom in or out
    • Offset: the data value to be increased or decreased after the multiplier operation
    • PT: Additional PT multiplier
    • CT: additional CT magnification
  • Value Mapping: Configurable conversion of specific values of measurement points to other values.
    • Source Value: The original measured point value collected.
    • Target Value: the value of the measurement point after the conversion is expected.

DLT meter

DLT645-1997

    DLT645-1997 is a version of the Chinese national standard GB/T 645-1997 "Multi-function Meter Communication Protocol". This standard specifies the communication protocol and data format between the multi-function meter and the external equipment, which is used for data exchange and communication between the meter and the monitoring system.

Adding a controller
  1. Name: The name of the controller, which is unique in the controller list for the entire gateway
  2. Protocol: Select DLT645-1997
  3. Slave: Table Number
  4. Endpoint: Support RS485 and RS232
  5. Polling Interval: the time interval of data collection (seconds), for example, set to 10S, then all the measuring points under the controller are polled every 10S
  6. Enable Multiple Polling Interval: Once enabled, you can configure an additional polling interval and select certain measuring points under the controller to use the polling interval. This function can be used to distinguish the measuring points that need high frequency and low frequency acquisition, and make efficient use of gateway and PLC performance.
  7. Polling Interval 2: It is an additional polling interval (in seconds) that needs to be set after enabling multiple polling interval;
  8. Description: You can add comment information to this controller
Advanced Settings:
  1. Timeout Settings:
    1. Timeout: The timeout time for the device to respond after the reading request is initiated to the device when the measuring point is collected. If the device does not respond to the reading request within the set collection timeout time, it is still the failure of this collection.
  1. Communication time setting:
    1. Communication Interval Time: The interval time between message exchanges, i.e., after receiving a response from the device, it will wait for a communication interval before sending the next request message.
  1. Communication Message Settings:
    1. Store of Communication Message: The controller with this function enabled will store communication messages. The storage path and number can be set in the "Default Parameters" of the "Parameter Settings" page. If you need to download the stored communication message, you can enter the " Realtime Communication Message " page of the specified controller in the "Measure Monitor" page, and click the "Download" button to download.
Adding measuring points
  1. Measuring Point Name: The name of the measuring point (the name of the measuring point cannot be repeated under the same controller)
  2. Address: The address of the measuring point, the address format supports 0000 or 00-00.
  3. Data type: Measuring point data type, including:
    1. WORD: 16-bit unsigned integer
    2. INT: 16-bit signed integer
    3. DWORD: 32-bit unsigned integer
    4. DINT: 32-bit signed integer
    5. FLOAT: 32-bit floating point number
    6. DOUBLE: A 64-bit floating point number
    7. STRING: 8-bit string
  4. Read Bit Data: When the data type is selected other than FLOAT,STRING, the value of any bit data in the integer can be read when enabled.
  5. Register Bit: When the bitwise value is enabled, the bit offset of the measuring point when reading the bit data.
  6. Negative Value: When the bitwise value is enabled or the data type is BIT, you can choose whether to negate the result of the read.
  7. Decimal Places: The length of the data after the decimal point when the data type is FLOAT, the maximum is 6 digits
  8. Read and write permissions:
    1. Read: read-only, not writable
    2. Read/Write: Readable and writable
  9. Mode:
    1. Periodic: Periodically reports data according to the reporting period of the group it belongs to
    2. Onchange: When the value of the measuring point changes, the data will be reported periodically according to the reporting period of the group
    3. Never: Only used locally, no need to upload data from the cloud
  10. Onchange Deadzone: When the upload mode is Onchange, you can set the value change within a certain range to be treated as no change. If the data has configuration data operation, the value after operation is used to detect whether the value change exceeds the dead zone.
  11. Unit: Measuring point unit
  12. Description: Description of the measuring point
  13. Group: The group to which the measuring point belongs
  14. Store Historical Data: When enabled, the historical data table will be generated with the name of the group to which the measuring point belongs, and the historical data will be stored according to the storage policy set by the group. The stored historical data can be exported as CSV files or obtained by calling Python API.
  15. Data Calculation: When the data type of the measuring point is not BIT or STRING, and the bitwise value is not enabled, it supports simple operation processing through data operation, and the processed data value can be reported to the cloud platform. The value mapped to the protocol conversion (Modbus Slave or OPC UA Server, etc.) defaults to the original data value collected rather than the calculated data value
  16. No: No computation is performed, the raw data value collected is used
  17. Ratio Conversion: the collected data value is mapped to a data value in the range of the upper and lower limits of the ratio in equal proportion to the data value, such as mapping the data collected in the sensor to the actual temperature and humidity. The calculation formula is the calculated data value = (upper limit of proportion - lower limit of proportion)/(upper limit of data - lower limit of data) * (original data value - lower limit of data) + lower limit of proportion
    1. Decimal Places: The number of decimal places that need to be retained after the operation
    2. Data High Limit: The upper limit of the data of the measuring point
    3. Data lower Limit: the lower limit of the data at the measuring point
    4. High Limit Of Proportion: the upper limit of the data after the proportion operation
    5. Lower Limit Of Proportion: The lower limit of the data after the scale operation
  18. Offset and Zoom: calculate the original data value according to the multiplier and offset. The formula is the calculated data value = (original data value * multiplier) + offset
    1. Decimal Places: The number of decimal places to be retained after the operation
    2. Magnification: The multiplier that needs to be scaled up or down
    3. Offset: The data value that needs to be increased or decreased after the multiplier operation
  19. Bit Trunction: Intercepts a segment of data in the original data as a data value. FLOAT type measuring points do not support this operation
    1. Start Bit: The bit offset at which the intercept of the original data begins
    2. End Bit: The bit offset that ends the interception of the original data
  20. PT/CT: Calculate the original data value according to the magnification, offset, PT and CT, the formula is [(original value * magnification)+ offset]*PT*CT
    1. Decimal Places: The number of decimal places that need to be retained after the operation
    2. Magnification: The multiplier that needs to be scaled up or down
    3. Offset: The data value that needs to be increased or decreased after the multiplier operation
    4. PT: Additional PT multiplier
    5. CT: Additional CT magnification
  21. Value mapping: Configurable measuring points for specific values converted to other values.
    1. Source Value: The raw value of the collected measuring point.
    2. Target Value: The expected value of the converted measuring point.
    DLT645-2007

DLT645-2007 is a version of the Chinese national standard GB/T 645-2007 "Multi-function Meter Communication Protocol". This standard is an important version of the DLT645 series of standards, which is used to specify the communication protocol and data format between the multifunctional electric energy meter and the external equipment.

Adding a controller
  1. Name: The name of the controller, which is unique in the controller list for the entire gateway
  2. Protocol: Select DLT645-2007
  3. Slave: Table Number
  4. Endpoint: Support RS485 and RS232
  5. Polling Interval: the time interval of data collection (seconds), for example, set to 10S, then all the measuring points under the controller are polled every 10S
  6. Enable Multiple polling Interval: Once enabled, you can configure an additional polling interval and select certain measuring points under the controller to use the polling interval. This function can be used to distinguish the measuring points that need high frequency and low frequency acquisition, and make efficient use of gateway and PLC performance.
  7. Polling Interval 2: It is an additional polling interval (in seconds) that needs to be set after enabling multiple polling interval;
  8. Description: You can add comment information to this controller
Advanced Settings:
  1. Timeout Settings:
    1. Timeout: The timeout time for the device to respond after the reading request is initiated to the device when the measuring point is collected. If the device does not respond to the reading request within the set collection timeout time, it is still the failure of this collection.
  2. Communication time setting:
    1. Communication Interval Time: The interval time between message exchanges, i.e., after receiving a response from the device, it will wait for a communication interval before sending the next request message.
    2. Initialization on Open: Whether to perform the operation of activation command when opening the serial port. After opening, add FE FE FE FE to the packet frame header.
  1. Communication Message Settings:
    1. Store Communication Message: The controller with this function enabled will store communication messages. The storage path and number can be set in the "Default Parameters" of the "Parameter Settings" page. If you need to download the stored communication message, you can enter the " Realtime Communication Message " page of the specified controller in the "Measure Monitor" page, and click the "Download" button to download.
Adding measuring points
  1.      Measuring Point Name: The name of the measuring point (the name of the measuring point cannot be repeated under the same controller)
  1. Address: The address of the measuring point, the address format supports 0000 or 00-00.
  1. Data type: Measuring point data type, including:
  1. WORD: 16-bit unsigned integer
  1. INT: 16-bit signed integer
  1. DWORD: 32-bit unsigned integer
  1. DINT: 32-bit signed integer
  1. FLOAT: 32-bit floating point number
  1. DOUBLE: A 64-bit floating point number
  1. STRING: 8-bit string
  1. Read Bit Data: When the data type is selected other than FLOAT,STRING, the value of any bit data in the integer can be read when enabled.
  1. Register Bit: When the bitwise value is enabled, the bit offset of the measuring point when reading the bit data.
  1. Negative Value: When the bitwise value is enabled or the data type is BIT, you can choose whether to negate the result of the read.
  1. Decimal Places: The length of the data after the decimal point when the data type is FLOAT, the maximum is 6 digits
  1. Read and write permissions:
  1. Read: read-only, not writable
  1. Read/Write: Readable and writable
  1. Mode:
  1. Periodic: Periodically reports data according to the reporting period of the group it belongs to
  1. Onchange: When the value of the measuring point changes, the data will be reported periodically according to the reporting period of the group
  1. Never: Only used locally, no need to upload data from the cloud
  1. Onchange Deadzone: When the upload mode is Onchange, you can set the value change within a certain range to be treated as no change. If the data has configuration data operation, the value after operation is used to detect whether the value change exceeds the dead zone.
  1. Unit: Measuring point unit
  1. Description: Description of the measuring point
  1. Group: The group to which the measuring point belongs
  1. Store Historical Data: When enabled, the historical data table will be generated with the name of the group to which the measuring point belongs, and the historical data will be stored according to the storage policy set by the group. The stored historical data can be exported as CSV files or obtained by calling Python API.
  1. Data Calculation: When the data type of the measuring point is not BIT or STRING, and the bitwise value is not enabled, it supports simple operation processing through data operation, and the processed data value can be reported to the cloud platform. The value mapped to the protocol conversion (Modbus Slave or OPC UA Server, etc.) defaults to the original data value collected rather than the calculated data value
  1. No: No computation is performed, the raw data value collected is used
  1. Ratio Conversion: the collected data value is mapped to a data value in the range of the upper and lower limits of the ratio in equal proportion to the data value, such as mapping the data collected in the sensor to the actual temperature and humidity. The calculation formula is the calculated data value = (upper limit of proportion - lower limit of proportion)/(upper limit of data - lower limit of data) * (original data value - lower limit of data) + lower limit of proportion
  1. Decimal Places: The number of decimal places that need to be retained after the operation
  1. Data High Limit: The upper limit of the data of the measuring point
  1. Data lower Limit: the lower limit of the data at the measuring point
  1. High Limit Of Proportion: the upper limit of the data after the proportion operation
  1. Lower Limit Of Proportion: The lower limit of the data after the scale operation
  1. Offset and Zoom: calculate the original data value according to the multiplier and offset. The formula is the calculated data value = (original data value * multiplier) + offset
  1. Decimal Places: The number of decimal places to be retained after the operation
  1. Magnification: The multiplier that needs to be scaled up or down
  1. Offset: The data value that needs to be increased or decreased after the multiplier operation
  1. Bit Trunction: Intercepts a segment of data in the original data as a data value. FLOAT type measuring points do not support this operation
  1. Start Bit: The bit offset at which the intercept of the original data begins
  1. End Bit: The bit offset that ends the interception of the original data
  1. PT/CT: Calculate the original data value according to the magnification, offset, PT and CT, the formula is [(original value * magnification)+ offset]*PT*CT
  1. Decimal Places: The number of decimal places that need to be retained after the operation
  1. Magnification: The multiplier that needs to be scaled up or down
  1. Offset: The data value that needs to be increased or decreased after the multiplier operation
  1. PT: Additional PT multiplier
  1. CT: Additional CT magnification
  1. Value mapping: Configurable measuring points for specific values converted to other values.
  1. Source Value: The raw value of the collected measuring point.
  1. Target Value: The expected value of the converted measuring point.
    DLT645-2007 over TCP

DLT645-2007 over TCP refers to the DLT645-2007 communication protocol applied to TCP/IP network communication mode. DLT645-2007 is a version of the multi-function meter communication protocol, and TCP is a common transmission control protocol used to achieve reliable data transmission in the network. The communication mode of DLT645-2007 over TCP can make full use of the reliability and stability of TCP protocol to ensure the safe transmission and reliable reception of data. This method is suitable for remote monitoring and management of electric energy data scenarios, such as power system monitoring, energy management systems, etc.

Adding a controller
  1. Name: The name of the controller, which is unique in the controller list for the entire gateway
  1. Protocol: Select DLT645-2007 over TCP
  1. Station No: Table number
  1. IP Address: The IP address of the meter
  1. Port: The port information of the meter
  1. Polling Interval: It is the time interval of collecting data (seconds), for example, it is set to 10S, then all the measuring points under the controller are polled every 10S
  1. Enable Multiple Polling Interval: Once enabled, you can configure an additional polling cycle and select certain measurement points under the controller to use the polling cycle. This function can be used to distinguish the measurement points that need high frequency and low frequency acquisition, and make efficient use of gateway and PLC performance.
  1. Polling Interval 2: It is an additional polling cycle (in seconds) that needs to be set after enabling multiple polling cycles;
  1. Description: You can add comment information to this controller
Advanced Settings:
  1. Timeout Settings:
    1. Timeout: The timeout time for the device to respond after the reading request is initiated to the device when the measuring point is collected. If the device does not respond to the reading request within the set collection timeout time, it is still the failure of this collection.
    2. Connect Timeout: the timeout time for establishing the connection.
    3. Initialize activation: Whether to activate the command when opening the serial port. After opening, add FE FE FE FE to the packet frame header.
  1. Communication Timing Settings:
    1. Communication Interval: The interval time between message exchanges, i.e., after receiving a response from the device, it will wait for a communication interval before sending the next request message.
  1. Communication Message Settings:
    1. Storage of communication messages: The controller with this function enabled will store communication messages. The storage path and number can be set in the "Default Parameters" of the "Parameter Settings" page. If you need to download the stored communication message, you can enter the " Realtime Communication Message " page of the specified controller in the "Measure Monitor" page, and click the "Download" button to download.
Adding measuring points
  1. Measuring Point Name: The name of the measuring point (the name of the measuring point cannot be repeated under the same controller)
  2. Address: Address of measuring point, address format only supports 00-00 format (" - "must be added).
  3. Data type: Measuring point data type, including:
    1. BIT: 0 or 1
    2. BYTE: An 8-bit unsigned integer
    3. SINT: 8-bit signed integer
    4. WORD: 16-bit unsigned integer
    5. INT: 16-bit signed integer
    6. BCD16:16-bit BCD code
    7. DWORD: 32-bit unsigned integer
    8. DINT: 32-bit signed integer
    9. FLOAT: 32-bit floating point number
    10. DOUBLE: A 64-bit floating point number
    11. STRING: 8-bit string
  4. Read Bit Data: When the data type is selected other than FLOAT,STRING, the value of any bit data in the integer can be read when enabled.
  5. Register Bit: When the bitwise value is enabled, the bit offset of the measuring point when reading the bit data.
  6. Negative Value: When the bitwise value is enabled or the data type is BIT, you can choose whether to negate the result of the read.
  7. Decimal Places: The length of the data after the decimal point when the data type is FLOAT, the maximum is 6 digits
  8. Read and write permissions:
    1. Read: read-only, not writable
    2. Read/Write: Readable and writable
  9. Mode:
    1. Periodic: Periodically reports data according to the reporting period of the group it belongs to
    2. Onchange: When the value of the measuring point changes, the data will be reported periodically according to the reporting period of the group
    3. Never: Only used locally, no need to upload data from the cloud
  10. Onchange Deadzone: When the upload mode is Onchange, you can set the value change within a certain range to be treated as no change. If the data has configuration data operation, the value after operation is used to detect whether the value change exceeds the dead zone.
  11. Unit: Measuring point unit
  12. Description: Description of the measuring point
  13. Group: The group to which the measuring point belongs
  14. Store Historical Data: When enabled, the historical data table will be generated with the name of the group to which the measuring point belongs, and the historical data will be stored according to the storage policy set by the group. The stored historical data can be exported as CSV files or obtained by calling Python API.
  15. Data Calculation: When the data type of the measuring point is not BIT or STRING, and the bitwise value is not enabled, it supports simple operation processing through data operation, and the processed data value can be reported to the cloud platform. The value mapped to the protocol conversion (Modbus Slave or OPC UA Server, etc.) defaults to the original data value collected rather than the calculated data value
  16. No: No computation is performed, the raw data value collected is used
  17. Ratio Conversion: the collected data value is mapped to a data value in the range of the upper and lower limits of the ratio in equal proportion to the data value, such as mapping the data collected in the sensor to the actual temperature and humidity. The calculation formula is the calculated data value = (upper limit of proportion - lower limit of proportion)/(upper limit of data - lower limit of data) * (original data value - lower limit of data) + lower limit of proportion
    1. Decimal Places: The number of decimal places that need to be retained after the operation
    2. Data High Limit: The upper limit of the data of the measuring point
    3. Data lower Limit: the lower limit of the data at the measuring point
    4. High Limit Of Proportion: the upper limit of the data after the proportion operation
    5. Lower Limit Of Proportion: The lower limit of the data after the scale operation
  18. Offset and Zoom: calculate the original data value according to the multiplier and offset. The formula is the calculated data value = (original data value * multiplier) + offset
    1. Decimal Places: The number of decimal places to be retained after the operation
    2. Magnification: The multiplier that needs to be scaled up or down
    3. Offset: The data value that needs to be increased or decreased after the multiplier operation
  19. Bit Trunction: Intercepts a segment of data in the original data as a data value. FLOAT type measuring points do not support this operation
    1. Start Bit: The bit offset at which the intercept of the original data begins
    2. End Bit: The bit offset that ends the interception of the original data
  20. PT/CT: Calculate the original data value according to the magnification, offset, PT and CT, the formula is [(original value * magnification)+ offset]*PT*CT
    1. Decimal Places: The number of decimal places that need to be retained after the operation
    2. Magnification: The multiplier that needs to be scaled up or down
    3. Offset: The data value that needs to be increased or decreased after the multiplier operation
    4. PT: Additional PT multiplier
    5. CT: Additional CT magnification
  21. Value mapping: Configurable measuring points for specific values converted to other values.
    1. Source Value: The raw value of the collected measuring point.
    2. Target Value: The expected value of the converted measuring point.

*DLT698

DLT698 is an implementation of Chinese national standard GB/T 26880-2011 "Power information acquisition system communication protocol", it is based on the IEC 62056 series standard (DLT645) power information acquisition system communication protocol. DLT698 is mainly used for data acquisition, transmission and management in electric power information acquisition system. It is a general communication protocol in electric power industry.

Adding a controller
  1. Name: The name of the controller, which is unique in the controller list for the entire gateway
  2. Protocol: Select *DLT698
  3. Station No: Support RS485 and RS232
  4. Polling Interval: the time interval of data collection (seconds), for example, set to 10S, then all the measuring points under the controller are polled every 10S
  5. Enable Multiple Polling Interval: Once enabled, you can configure an additional polling interval and select certain measuring points under the controller to use the polling interval. This function can be used to distinguish the measuring points that need high frequency and low frequency acquisition, and make efficient use of gateway and PLC performance.
  6. Polling Interval 2: It is an additional polling interval (in seconds) that needs to be set after enabling multiple polling interval;
  7. Description: You can add comment information to this controller
Advanced Settings:
  1. Timeout Settings:
    1. Timeout: The timeout time for the device to respond after the reading request is initiated to the device when the measuring point is collected. If the device does not respond to the reading request within the set collection timeout time, it is still the failure of this collection.
  1. Communication Timing Settings:
    1. Communication Interval Time: The interval time between message exchanges, i.e., after receiving a response from the device, it will wait for a communication interval before sending the next request message.
  1. Communication Message Settings:
    1. Store Communication Message: The controller with this function enabled will store communication messages. The storage path and number can be set in the "Default Parameters" of the "Parameter Settings" page. If you need to download the stored communication message, you can enter the " Realtime Communication Message " page of the specified controller in the "Measure Monitor" page, and click the "Download" button to download.
Adding measuring points
  1. Measuring Point Name: The name of the measuring point (the name of the measuring point cannot be repeated under the same controller)
  2. Address: Address of measuring point, address format only supports 00-00 format (" - "must be added).
  3. Data type: Measuring point data type, including:
    1. BIT: 0 or 1
    2. BYTE: An 8-bit unsigned integer
    3. SINT: 8-bit signed integer
    4. WORD: 16-bit unsigned integer
    5. INT: 16-bit signed integer
    6. BCD16:16-bit BCD code
    7. DWORD: 32-bit unsigned integer
    8. DINT: 32-bit signed integer
    9. FLOAT: 32-bit floating point number
    10. DOUBLE: A 64-bit floating point number
    11. STRING: 8-bit string
  4. Read Bit Data: When the data type is selected other than FLOAT,STRING, the value of any bit data in the integer can be read when enabled.
  5. Register Bit: When the bitwise value is enabled, the bit offset of the measuring point when reading the bit data.
  6. Negative Value: When the bitwise value is enabled or the data type is BIT, you can choose whether to negate the result of the read.
  7. Decimal Places: The length of the data after the decimal point when the data type is FLOAT, the maximum is 6 digits
  8. Read and write permissions:
    1. Read: read-only, not writable
    2. Read/Write: Readable and writable
  9. Mode:
    1. Periodic: Periodically reports data according to the reporting period of the group it belongs to
    2. Onchange: When the value of the measuring point changes, the data will be reported periodically according to the reporting period of the group
    3. Never: Only used locally, no need to upload data from the cloud
  10. Onchange Deadzone: When the upload mode is Onchange, you can set the value change within a certain range to be treated as no change. If the data has configuration data operation, the value after operation is used to detect whether the value change exceeds the dead zone.
  11. Unit: Measuring point unit
  12. Description: Description of the measuring point
  13. Group: The group to which the measuring point belongs
  14. Store Historical Data: When enabled, the historical data table will be generated with the name of the group to which the measuring point belongs, and the historical data will be stored according to the storage policy set by the group. The stored historical data can be exported as CSV files or obtained by calling Python API.
  15. Data Calculation: When the data type of the measuring point is not BIT or STRING, and the bitwise value is not enabled, it supports simple operation processing through data operation, and the processed data value can be reported to the cloud platform. The value mapped to the protocol conversion (Modbus Slave or OPC UA Server, etc.) defaults to the original data value collected rather than the calculated data value
  16. No: No computation is performed, the raw data value collected is used
  17. Ratio Conversion: the collected data value is mapped to a data value in the range of the upper and lower limits of the ratio in equal proportion to the data value, such as mapping the data collected in the sensor to the actual temperature and humidity. The calculation formula is the calculated data value = (upper limit of proportion - lower limit of proportion)/(upper limit of data - lower limit of data) * (original data value - lower limit of data) + lower limit of proportion
    1. Decimal Places: The number of decimal places that need to be retained after the operation
    2. Data High Limit: The upper limit of the data of the measuring point
    3. Data lower Limit: the lower limit of the data at the measuring point
    4. High Limit Of Proportion: the upper limit of the data after the proportion operation
    5. Lower Limit Of Proportion: The lower limit of the data after the scale operation
  18. Offset and Zoom: calculate the original data value according to the multiplier and offset. The formula is the calculated data value = (original data value * multiplier) + offset
    1. Decimal Places: The number of decimal places to be retained after the operation
    2. Magnification: The multiplier that needs to be scaled up or down
    3. Offset: The data value that needs to be increased or decreased after the multiplier operation
  19. Bit Trunction: Intercepts a segment of data in the original data as a data value. FLOAT type measuring points do not support this operation
    1. Start Bit: The bit offset at which the intercept of the original data begins
    2. End Bit: The bit offset that ends the interception of the original data
  20. PT/CT: Calculate the original data value according to the magnification, offset, PT and CT, the formula is [(original value * magnification)+ offset]*PT*CT
    1. Decimal Places: The number of decimal places that need to be retained after the operation
    2. Magnification: The multiplier that needs to be scaled up or down
    3. Offset: The data value that needs to be increased or decreased after the multiplier operation
    4. PT: Additional PT multiplier
    5. CT: Additional CT magnification
  21. Value mapping: Configurable measuring points for specific values converted to other values.
    1. Source Value: The raw value of the collected measuring point.
    2. Target Value: The expected value of the converted measuring point.

DNP3

DNP3 TCP

DNP3 TCP (Distributed Network Protocol 3 over TCP/IP) is a reliable and efficient communication protocol for remote monitoring and control systems, and is oriented towards communication protocols for remote monitoring and control systems, which are applicable to the automation of infrastructure such as electric power systems and water systems.

Adding a controller
  • Name: name of the controller, unique in the list of controllers across the gateway
  • Protocol: select DNP3 TCP
  • IP address: IP address information of the device
  • Port: port information of the device
  • Master address: The master address is a unique identifier that identifies the location and identity of the master device in the communications network.
  • Slave: The slave address is the unique identifier of the slave device in the communication network, which is used to identify the identity and location of the slave device.
  • Polling Interval: the time interval (in seconds) for collecting data, for example, if it is set to 10S, all the measurement points under the controller will be polled every 10S.
  • class 1 Poll Interval: the time interval during which the master periodically sends Class 1 data requests to the slave
  • class 2 Poll Interval: the time interval during which the master periodically sends class 2 data requests to the slave
  • class 3 Poll Interval: the time interval during which the master periodically sends class 3 data requests to the slave
  • Description: You can add comment information to this controller.

Advanced Settings:

  • Timeout Settings:
    • Timeout: When collecting measurement points, after initiating a read request to the device, the device responds to the timeout time, if the device does not respond to the read request within the set acquisition timeout time, it is still a failure of this acquisition.
    • Max Timeouts: the number of times a failed capture was recaptured
    • Connect Timeout: Timeout time for establishing a connection.
    • Unsolicited Mode: Receive Active Reporting Messages is usually an event report or an exception report that is sent to the master by a slave on its own initiative. The gateway processes the unsolicited messages only after they are enabled.
    • Mode of Operation:
    • Direct Operate: The control commands sent by the master will be directly transmitted to the slave, which will immediately execute the corresponding operation and return the execution result to the master.
    • Select then Operate: The control commands sent by the master will be transmitted to the slave, which will execute the corresponding operation and return the execution result to the master. However, the slave will not complete the operation immediately, but wait for the master to send an acknowledgement signal or a selection signal. The slave will complete the operation only after the master sends an acknowledgement or selection signal.
  • Communication Message Settings:
    • Store Communication Message: Controllers with this function enabled will store communication messages, and the path and number of stored messages can be set in the "Default Parameters" on the "Parameter Settings" page. If you want to download the stored communication messages, you can go to the "Realtime communication messages" page of the specified controller in the "Measure Monitor" page, and then click the "Download" button to download the messages.
Adding measuring points
  • Measuring Point Name: the name of the measurement point (the name of the measurement point cannot be repeated under the same controller)
  • Register Type: select from the drop-down box
  • Register Address: address of the measurement point, range: integer 0-65535
  • Data Type: different data types are supported according to the selected address type, please select according to the supported data types in the drop-down box
  • Read Bit Data: When the data type selection is not FLOAT,STRING, you can read the value of any bit of data in the integer when it is enabled.
  • Register Bit: The bit offset of the measurement point when reading bit data after turning on value by bit.
  • Negative Value: When Negative Value and data type BIT are turned on, you can choose whether or not to invert the read result.
  • Decimal Places: the length of the data after the decimal point of the measurement point when the data type is FLOAT, maximum 6 digits
  • Read/Write:The read/write privilege is different according to the address type. After selecting the address type, please select the actual supported read/write permissions from the drop-down box.
  • Mode:
    • Periodic: data is reported regularly according to the reporting cycle of the subgroup to which it belongs.
    • Onchange: data is reported regularly according to a grouped reporting cycle only when there is a change in the value of the measurement point.
    • Never: local use only, no need to upload data from the cloud
  • Onchange Deadzone: When the upload mode is Onchange, you can set the value change within a certain range to be considered as no change in the value. If the data has configured data operation, then according to the value after the operation to detect whether the value change exceeds the dead zone.
  • Unit: measurement point unit
  • Description: Description of the measurement point
  • Group: Subgroup to which the measurement point belongs
  • Store Historical Data: When enabled, a historical data table will be generated with the name of the group to which the measurement point belongs, and the historical data will be stored according to the storage policy set by the group. Stored historical data can be exported as CSV files or obtained by calling the Python API.
  • Data Calculation: If the data type of the measurement point is not BIT or STRING and bitwise value is not enabled, simple arithmetic processing is supported through data arithmetic, and the processed data values can be reported to the cloud platform. Values mapped to protocol conversions (Modbus Slave or OPC UA Server, etc.) are by default the raw data values collected rather than the calculated data values.
  • No: no arithmetic is performed, the collected raw data values are used
  • Ratio Conversion: The collected data value is mapped to a data value in the range of the upper and lower limits of the scale in equal proportions according to the range of the upper and lower limits of the data, such as mapping the data collected in the sensor to the actual temperature and humidity. Calculation formula for the calculated data value = (upper limit of the ratio - lower limit of the ratio) / (upper limit of the data - lower limit of the data) * (original data value - lower limit of the data) + lower limit of the ratio
    • Decimal Places: the number of decimal places to be retained after arithmetic operations
    • Data High Limit: the upper data limit for a measurement point
    • Data Lower Limit: lower data limit value for the measurement point
    • High Limit Of Proportion: the upper limit of the data after proportional operation
    • Lower Limit Of Proportion: the lower limit value of the data after proportional operation
  • Offset And Zoom: Calculate the original data value according to the multiplier and offset, the formula is calculated data value = (original data value * Magnification) + Offset
    • Decimal places: the number of decimal places to be retained after arithmetic operations
    • Magnification: the magnification needed to zoom in or out
    • Offset: the data value to be increased or decreased after the multiplier operation
  • Bit Truncation: Intercepts a segment of bit data from the original data as a data value; this operation is not supported for FLOAT-type points.
    • Start Bit: Bit offset to start intercepting the original data
    • End Bit: Bit offset to end the interception of the original data
  • PT/CT: Calculate the raw data value according to the magnification, offset, PT and CT, with the formula [(raw value*magnification)+offset]*PT*CT
    • Decimal Places: the number of decimal places to be retained after arithmetic operations
    • Magnification: the magnification needed to zoom in or out
    • Offset: the data value to be increased or decreased after the multiplier operation
    • PT: Additional PT multiplier
    • CT: additional CT magnification
  • Value Mapping: Configurable conversion of specific values of measurement points to other values.
    • Source Value: The original measured point value collected.
    • Target Value: the value of the measurement point after the conversion is expected.

DNP3 UDP

DNP3 UDP is an application of the DNP3 protocol on the transport layer of the UDP network.UDP is a connectionless oriented transport protocol that provides simple data transfer services and is usually used in scenarios that require high real-time performance, small data transfer volumes, and low data reliability requirements. For example, in applications such as remote monitoring, telemetry, and remote control, DNP3 UDP can be used for data transmission for real-time monitoring and control.

Adding a controller
  • Name: name of the controller, unique in the list of controllers across the gateway
  • Protocol: select DNP3 UDP
  • IP address: IP address information of the device
  • Port: port information of the device
  • Master address: The master address is a unique identifier that identifies the location and identity of the master device in the communications network.
  • Slave: The slave address is the unique identifier of the slave device in the communication network, which is used to identify the identity and location of the slave device.
  • Polling Interval: the time interval (in seconds) for collecting data, for example, if it is set to 10S, all the measurement points under the controller will be polled every 10S.
  • class 1 Poll Interval: the time interval during which the master periodically sends Class 1 data requests to the slave
  • class 2 Poll Interval: the time interval during which the master periodically sends class 2 data requests to the slave
  • class 3 Poll Interval: the time interval during which the master periodically sends class 3 data requests to the slave
  • Description: You can add comment information to this controller.

Advanced Settings:

  • Timeout Settings:
    • Timeout: When collecting measurement points, after initiating a read request to the device, the device responds to the timeout time, if the device does not respond to the read request within the set acquisition timeout time, it is still a failure of this acquisition.
    • Max Timeouts: the number of times a failed capture was recaptured
    • Connect Timeout: Timeout time for establishing a connection.
    • Unsolicited Mode: Receive Active Reporting Messages is usually an event report or an exception report that is sent to the master by a slave on its own initiative. The gateway processes the unsolicited messages only after they are enabled.
    • Mode of Operation:
    • Direct Operate: The control commands sent by the master will be directly transmitted to the slave, which will immediately execute the corresponding operation and return the execution result to the master.
    • Select then Operate: The control commands sent by the master will be transmitted to the slave, which will execute the corresponding operation and return the execution result to the master. However, the slave will not complete the operation immediately, but wait for the master to send an acknowledgement signal or a selection signal. The slave will complete the operation only after the master sends an acknowledgement or selection signal.
  • Communication Message Settings:
    • Store Communication Message: Controllers with this function enabled will store communication messages, and the path and number of stored messages can be set in the "Default Parameters" on the "Parameter Settings" page. If you want to download the stored communication messages, you can go to the "Realtime communication messages" page of the specified controller in the "Measure Monitor" page, and then click the "Download" button to download the messages.
Adding measuring points
  • Measuring Point Name: the name of the measurement point (the name of the measurement point cannot be repeated under the same controller)
  • Register Type: select from the drop-down box
  • Register Address: address of the measurement point, range: integer 0-65535
  • Data Type: different data types are supported according to the selected address type, please select according to the supported data types in the drop-down box
  • Read Bit Data: When the data type selection is not FLOAT,STRING, you can read the value of any bit of data in the integer when it is enabled.
  • Register Bit: The bit offset of the measurement point when reading bit data after turning on value by bit.
  • Negative Value: When Negative Value and data type BIT are turned on, you can choose whether or not to invert the read result.
  • Decimal Places: the length of the data after the decimal point of the measurement point when the data type is FLOAT, maximum 6 digits
  • Read/Write:The read/write privilege is different according to the address type. After selecting the address type, please select the actual supported read/write permissions from the drop-down box.
  • Mode:
    • Periodic: data is reported regularly according to the reporting cycle of the subgroup to which it belongs.
    • Onchange: data is reported regularly according to a grouped reporting cycle only when there is a change in the value of the measurement point.
    • Never: local use only, no need to upload data from the cloud
  • Onchange Deadzone: When the upload mode is Onchange, you can set the value change within a certain range to be considered as no change in the value. If the data has configured data operation, then according to the value after the operation to detect whether the value change exceeds the dead zone.
  • Unit: measurement point unit
  • Description: Description of the measurement point
  • Group: Subgroup to which the measurement point belongs
  • Store Historical Data: When enabled, a historical data table will be generated with the name of the group to which the measurement point belongs, and the historical data will be stored according to the storage policy set by the group. Stored historical data can be exported as CSV files or obtained by calling the Python API.
  • Data Calculation: If the data type of the measurement point is not BIT or STRING and bitwise value is not enabled, simple arithmetic processing is supported through data arithmetic, and the processed data values can be reported to the cloud platform. Values mapped to protocol conversions (Modbus Slave or OPC UA Server, etc.) are by default the raw data values collected rather than the calculated data values.
  • No: no arithmetic is performed, the collected raw data values are used
  • Ratio Conversion: The collected data value is mapped to a data value in the range of the upper and lower limits of the scale in equal proportions according to the range of the upper and lower limits of the data, such as mapping the data collected in the sensor to the actual temperature and humidity. Calculation formula for the calculated data value = (upper limit of the ratio - lower limit of the ratio) / (upper limit of the data - lower limit of the data) * (original data value - lower limit of the data) + lower limit of the ratio
    • Decimal Places: the number of decimal places to be retained after arithmetic operations
    • Data High Limit: the upper data limit for a measurement point
    • Data Lower Limit: lower data limit value for the measurement point
    • High Limit Of Proportion: the upper limit of the data after proportional operation
    • Lower Limit Of Proportion: the lower limit value of the data after proportional operation
  • Offset And Zoom: Calculate the original data value according to the multiplier and offset, the formula is calculated data value = (original data value * Magnification) + Offset
    • Decimal places: the number of decimal places to be retained after arithmetic operations
    • Magnification: the magnification needed to zoom in or out
    • Offset: the data value to be increased or decreased after the multiplier operation
  • Bit Truncation: Intercepts a segment of bit data from the original data as a data value; this operation is not supported for FLOAT-type points.
    • Start Bit: Bit offset to start intercepting the original data
    • End Bit: Bit offset to end the interception of the original data
  • PT/CT: Calculate the raw data value according to the magnification, offset, PT and CT, with the formula [(raw value*magnification)+offset]*PT*CT
    • Decimal Places: the number of decimal places to be retained after arithmetic operations
    • Magnification: the magnification needed to zoom in or out
    • Offset: the data value to be increased or decreased after the multiplier operation
    • PT: Additional PT multiplier
    • CT: additional CT magnification
  • Value Mapping: Configurable conversion of specific values of measurement points to other values.
    • Source Value: The original measured point value collected.
    • Target Value: the value of the measurement point after the conversion is expected.

DNP3 RTU

In DNP3 RTU, RTU is a kind of remote terminal unit, which is used for tasks such as data acquisition, monitoring and control, etc. DNP3 RTU is an RTU device based on the DNP3 protocol, which is usually used for real-time monitoring and control of electric power systems, water systems, gas systems and other industrial control fields.

Adding a controller
  • Name: name of the controller, unique in the list of controllers across the gateway
  • Protocol: select DNP3 RTU
  • Endpoint:support RS232 and RS485, RS485 is used by default.
  • Master address: The master address is a unique identifier that identifies the location and identity of the master device in the communications network.
  • Slave: The slave address is the unique identifier of the slave device in the communication network, which is used to identify the identity and location of the slave device.
  • Polling Interval: the time interval (in seconds) for collecting data, for example, if it is set to 10S, all the measurement points under the controller will be polled every 10S.
  • class 1 Poll Interval: the time interval during which the master periodically sends Class 1 data requests to the slave
  • class 2 Poll Interval: the time interval during which the master periodically sends class 2 data requests to the slave
  • class 3 Poll Interval: the time interval during which the master periodically sends class 3 data requests to the slave
  • Description: You can add comment information to this controller.

Advanced Settings:

  • Timeout Settings:
    • Timeout: When collecting measurement points, after initiating a read request to the device, the device responds to the timeout time, if the device does not respond to the read request within the set acquisition timeout time, it is still a failure of this acquisition.
    • Max Timeouts: the number of times a failed capture was recaptured
    • Connect Timeout: Timeout time for establishing a connection.
    • Unsolicited Mode: Receive Active Reporting Messages is usually an event report or an exception report that is sent to the master by a slave on its own initiative. The gateway processes the unsolicited messages only after they are enabled.
    • Mode of Operation:
    • Direct Operate: The control commands sent by the master will be directly transmitted to the slave, which will immediately execute the corresponding operation and return the execution result to the master.
    • Select then Operate: The control commands sent by the master will be transmitted to the slave, which will execute the corresponding operation and return the execution result to the master. However, the slave will not complete the operation immediately, but wait for the master to send an acknowledgement signal or a selection signal. The slave will complete the operation only after the master sends an acknowledgement or selection signal.
  • Communication Message Settings:
    • Store Communication Message: Controllers with this function enabled will store communication messages, and the path and number of stored messages can be set in the "Default Parameters" on the "Parameter Settings" page. If you want to download the stored communication messages, you can go to the "Realtime communication messages" page of the specified controller in the "Measure Monitor" page, and then click the "Download" button to download the messages.
Adding measuring points
  • Measuring Point Name: the name of the measurement point (the name of the measurement point cannot be repeated under the same controller)
  • Register Type: select from the drop-down box
  • Register Address: address of the measurement point, range: integer 0-65535
  • Data Type: different data types are supported according to the selected address type, please select according to the supported data types in the drop-down box
  • Read Bit Data: When the data type selection is not FLOAT,STRING, you can read the value of any bit of data in the integer when it is enabled.
  • Register Bit: The bit offset of the measurement point when reading bit data after turning on value by bit.
  • Negative Value: When Negative Value and data type BIT are turned on, you can choose whether or not to invert the read result.
  • Decimal Places: the length of the data after the decimal point of the measurement point when the data type is FLOAT, maximum 6 digits
  • Read/Write:The read/write privilege is different according to the address type. After selecting the address type, please select the actual supported read/write permissions from the drop-down box.
  • Mode:
    • Periodic: data is reported regularly according to the reporting cycle of the subgroup to which it belongs.
    • Onchange: data is reported regularly according to a grouped reporting cycle only when there is a change in the value of the measurement point.
    • Never: local use only, no need to upload data from the cloud
  • Onchange Deadzone: When the upload mode is Onchange, you can set the value change within a certain range to be considered as no change in the value. If the data has configured data operation, then according to the value after the operation to detect whether the value change exceeds the dead zone.
  • Unit: measurement point unit
  • Description: Description of the measurement point
  • Group: Subgroup to which the measurement point belongs
  • Store Historical Data: When enabled, a historical data table will be generated with the name of the group to which the measurement point belongs, and the historical data will be stored according to the storage policy set by the group. Stored historical data can be exported as CSV files or obtained by calling the Python API.
  • Data Calculation: If the data type of the measurement point is not BIT or STRING and bitwise value is not enabled, simple arithmetic processing is supported through data arithmetic, and the processed data values can be reported to the cloud platform. Values mapped to protocol conversions (Modbus Slave or OPC UA Server, etc.) are by default the raw data values collected rather than the calculated data values.
  • No: no arithmetic is performed, the collected raw data values are used
  • Ratio Conversion: The collected data value is mapped to a data value in the range of the upper and lower limits of the scale in equal proportions according to the range of the upper and lower limits of the data, such as mapping the data collected in the sensor to the actual temperature and humidity. Calculation formula for the calculated data value = (upper limit of the ratio - lower limit of the ratio) / (upper limit of the data - lower limit of the data) * (original data value - lower limit of the data) + lower limit of the ratio
    • Decimal Places: the number of decimal places to be retained after arithmetic operations
    • Data High Limit: the upper data limit for a measurement point
    • Data Lower Limit: lower data limit value for the measurement point
    • High Limit Of Proportion: the upper limit of the data after proportional operation
    • Lower Limit Of Proportion: the lower limit value of the data after proportional operation
  • Offset And Zoom: Calculate the original data value according to the multiplier and offset, the formula is calculated data value = (original data value * Magnification) + Offset
    • Decimal places: the number of decimal places to be retained after arithmetic operations
    • Magnification: the magnification needed to zoom in or out
    • Offset: the data value to be increased or decreased after the multiplier operation
  • Bit Truncation: Intercepts a segment of bit data from the original data as a data value; this operation is not supported for FLOAT-type points.
    • Start Bit: Bit offset to start intercepting the original data
    • End Bit: Bit offset to end the interception of the original data
  • PT/CT: Calculate the raw data value according to the magnification, offset, PT and CT, with the formula [(raw value*magnification)+offset]*PT*CT
    • Decimal Places: the number of decimal places to be retained after arithmetic operations
    • Magnification: the magnification needed to zoom in or out
    • Offset: the data value to be increased or decreased after the multiplier operation
    • PT: Additional PT multiplier
    • CT: additional CT magnification
  • Value Mapping: Configurable conversion of specific values of measurement points to other values.
    • Source Value: The original measured point value collected.
    • Target Value: the value of the measurement point after the conversion is expected.

EFORT

*EFORT Robot

EFORT Robot is a series of industrial robots produced by EFORT Intelligent Equipment Co., Ltd. which can exchange data, control, monitor and access the robot remotely via TCP/IP protocol.

Adding a controller
  • Name: name of the controller, unique in the list of controllers across the gateway
  • Protocol: Select *EFORT Robot
  • IP address: IP address information of the device
  • Port: port information of the device
  • Polling Interval: the time interval (in seconds) for collecting data, for example, if it is set to 10S, all the measurement points under the controller will be polled every 10S.
  • Enable Multiple Polling Interval: When enabled, you can configure an additional polling cycle and select certain points under the controller to use that polling cycle. This feature can be used to differentiate between test points that require high and low frequency acquisition, making efficient use of gateway and PLC performance.
  • Polling Interval 2: i.e. the additional polling cycle (in seconds) that needs to be set when multiple polling cycles are enabled
  • Description: You can add comment information to this controller.

Advanced Settings:

  • Timeout Settings:
    • Timeout: When collecting measurement points, after initiating a read request to the device, the device responds to the timeout time, if the device does not respond to the read request within the set acquisition timeout time, it is still a failure of this acquisition.
    • Connect Timeout: Timeout time for establishing a connection.
  • Communication Message Settings:
    • Store Communication Message: Controllers with this function enabled will store communication messages, and the path and number of stored messages can be set in the "Default Parameters" on the "Parameter Settings" page. If you want to download the stored communication messages, you can go to the "Realtime Communication Message" page of the specified controller in the "Measure Monitor" page, and then click the "Download" button to download the messages.

Adding measuring points

  • Measuring Point Name: the name of the measurement point (the name of the measurement point cannot be repeated under the same controller)
  • Read Type: only robot details are supported
  • Data Type: only STRING type is supported
  • Size: the length of the string for the point
  • Character Encoding Format: consistent with the robot side of the character encoding format, support: ASCII, UTF-8, UTF-16-LITTLE, UTF-16-BIG and GB2312 encoding.
  • Read/Write: only Read is supported
  • Mode:
    • Periodic: data is reported regularly according to the reporting cycle of the subgroup to which it belongs.
    • Onchange: data is reported regularly according to a grouped reporting cycle only when there is a change in the value of the measurement point.
    • Never: local use only, no need to upload data from the cloud
  • Unit: measurement point unit
  • Description: Description of the measurement point
  • Goup: Group to which the measurement point belongs
  • Store Historical Data: When enabled, a historical data table will be generated with the name of the group to which the measurement point belongs, and the historical data will be stored according to the storage policy set by the group. Stored historical data can be exported as CSV files or obtained by calling the Python API.

Euromap

*Euromap-63

Euromap-63 is a standard protocol for communication between industrial robots and injection moulding machines. The injection moulding machine can send relevant data of the injection process to the industrial robot, such as information on mould opening and closing status, injection speed, temperature, etc. The industrial robot can perform corresponding actions based on these data, such as adjusting the gripping position and speed of action in time, in order to achieve efficient operation of the automated production line.

Adding a controller
  • Name: name of the controller, unique in the list of controllers across the gateway
  • Protocol: select *Euromap-63
  • Folder Name: ftp shared folder path of the gateway
  • Minimum Session Number: The smallest available session number value defined. It marks the beginning of the range of available session numbers.
  • Maximum Session Number: The maximum available session number value defined. It marks the end of the range of available session numbers.
  • Character Encoding: UTF8 only
  • Includes CYCLIC: when enabled, data is recorded cyclically, otherwise data is recorded only once
  • Polling Interval: the time interval (in seconds) for collecting data, for example, if it is set to 10S, all the measurement points under the controller will be polled every 10S.
  • Enable Multiple Polling Interval: When enabled, you can configure an additional polling cycle and select certain points under the controller to use that polling cycle. This feature can be used to differentiate between measurement points that require high and low frequency acquisition, making efficient use of gateway and PLC performance.
  • Polling Interval 2: i.e. the additional polling cycle (in seconds) that needs to be set when multiple polling cycles are enabled
  • Description: You can add comment information to this controller.

Advanced Settings:

  • Timeout Settings:
    • Timeout: When collecting measurement points, after initiating a read request to the device, the device responds to the timeout time, if the device does not respond to the read request within the set acquisition timeout time, it is still a failure of this acquisition.
    • Connect Timeout: Timeout time for establishing a connection.
Adding measuring points
  • Measuring Point Name: the name of the measurement point (the name of the measurement point cannot be repeated under the same controller)
  • Address: Measurement point address
  • Data types: The following data types are supported
    • BIT: 0 or 1
    • BYTE: 8-bit unsigned integer
    • SINT: 8-bit signed integer
    • WORD: 16-bit unsigned integer
    • INT: 16-bit signed integer
    • BCD16: 16-bit BCD code
    • DWORD: 32-bit unsigned integer
    • DINT: 32-bit signed integer
    • FLOAT: 32-bit floating point number
    • DOUBLE: 64-bit floating point number
    • STRING: 8-bit string
  • Read Bit Data: When the data type selection is not FLOAT,STRING, you can read the value of any bit of data in the integer when it is enabled.
  • Register Bit: The bit offset of the measurement point when reading bit data after turning on value by bit.
  • Negative Value: When turn on value by bit, you can choose whether or not to invert the read result.
  • Decimal Places: the length of the data after the decimal point of the measurement point when the data type is FLOAT, maximum 6 digits
  • Read/Write:
    • Read: read only, not write
    • Read/Write: readable and writable
  • Mode:
    • Periodic: data is reported regularly according to the reporting cycle of the subgroup to which it belongs.
    • Onchange: data is reported regularly according to a grouped reporting cycle only when there is a change in the value of the measurement point.
    • Never: local use only, no need to upload data from the cloud
  • Onchange Deadzone: When the upload mode is Onchange, you can set the value change within a certain range to be considered as no change in the value. If the data has configured data operation, then according to the value after the operation to detect whether the value change exceeds the dead zone.
  • Unit: measurement point unit
  • Description: Description of the measurement point
  • Group: Subgroup to which the measurement point belongs
  • Store Historical Data: When enabled, a historical data table will be generated with the name of the group to which the measurement point belongs, and the historical data will be stored according to the storage policy set by the group. Stored historical data can be exported as CSV files or obtained by calling the Python API.
  • Data Calculation: If the data type of the measurement point is not BIT or STRING and bitwise value is not enabled, simple arithmetic processing is supported through data arithmetic, and the processed data values can be reported to the cloud platform. Values mapped to protocol conversions (Modbus Slave or OPC UA Server, etc.) are by default the raw data values collected rather than the calculated data values.
  • No: no arithmetic is performed, the collected raw data values are used
  • Ratio Conversion: The collected data value is mapped to a data value in the range of the upper and lower limits of the scale in equal proportions according to the range of the upper and lower limits of the data, such as mapping the data collected in the sensor to the actual temperature and humidity. Calculation formula for the calculated data value = (upper limit of the ratio - lower limit of the ratio) / (upper limit of the data - lower limit of the data) * (original data value - lower limit of the data) + lower limit of the ratio
    • Decimal Places: the number of decimal places to be retained after arithmetic operations
    • Data High Limit: the upper data limit for a measurement point
    • Data Lower Limit: lower data limit value for the measurement point
    • High Limit Of Proportion: the upper limit of the data after proportional operation
    • Lower Limit Of Proportion: the lower limit value of the data after proportional operation
  • Offset And Zoom: Calculate the original data value according to the multiplier and offset, the formula is calculated data value = (original data value * Magnification) + Offset
    • Decimal places: the number of decimal places to be retained after arithmetic operations
    • Magnification: the magnification needed to zoom in or out
    • Offset: the data value to be increased or decreased after the multiplier operation
  • Bit Truncation: Intercepts a segment of bit data from the original data as a data value; this operation is not supported for FLOAT-type points.
    • Start Bit: Bit offset to start intercepting the original data
    • End Bit: Bit offset to end the interception of the original data
  • PT/CT: Calculate the raw data value according to the magnification, offset, PT and CT, with the formula [(raw value*magnification)+offset]*PT*CT
    • Decimal Places: the number of decimal places to be retained after arithmetic operations
    • Magnification: the magnification needed to zoom in or out
    • Offset: the data value to be increased or decreased after the multiplier operation
    • PT: Additional PT multiplier
    • CT: additional CT magnification
  • Value Mapping: Configurable conversion of specific values of measurement points to other values.
    • Source Value: The original measured point value collected.
    • Target Value: the value of the measurement point after the conversion is expected

FANUC

*FANUC Robot

FANUC Robot is a series of industrial robot products produced by Japan's FANUC company, its robot products are widely used in automotive manufacturing, electronics manufacturing, metal processing, logistics and other fields.

Adding a controller
  • Name: name of the controller, unique in the list of controllers across the gateway
  • Protocol: Select *FANUC Robot
  • IP address: IP address information of the device
  • Port: port information of the device
  • Polling Interval: the time interval (in seconds) for collecting data, for example, if it is set to 10S, all the measurement points under the controller will be polled every 10S.
  • Enable Multiple Polling Interval: When enabled, you can configure an additional polling cycle and select certain points under the controller to use that polling cycle. This feature can be used to differentiate between measurement points that require high and low frequency acquisition, making efficient use of gateway and PLC performance.
  • Polling Interval 2: i.e. the additional polling cycle (in seconds) that needs to be set when multiple polling cycles are enabled
  • Description: You can add comment information to this controller.

Advanced Settings:

  • Timeout Settings:
    • Timeout: When collecting measurement points, after initiating a read request to the device, the device responds to the timeout time, if the device does not respond to the read request within the set acquisition timeout time, it is still a failure of this acquisition.
    • Connect Timeout: Timeout time for establishing a connection.
  • Communication Message Settings:
    • Store Communication Message: Controllers with this function enabled will store communication messages, and the path and number of stored messages can be set in the "Default Parameters" on the "Parameter Settings" page. If you want to download the stored communication messages, you can go to the "Realtime Communication Message" page of the specified controller in the "Measure Monitor" page, and then click the "Download" button to download the messages.
Adding measuring points
  • Measuring Point Name: the name of the measurement point (the name of the measurement point cannot be repeated under the same controller)
  • Read type: only Robot Details are supported
  • Data Type: only STRING type is supported
  • Size: the length of the string for the point
  • Character Encoding Format: consistent with the robot side of the character encoding format, support: ASCII, UTF-8, UTF-16-LITTLE, UTF-16-BIG and GB2312 encoding.
  • Read and write permissions: only Read is supported
  • Mode:
    • Periodic: data is reported regularly according to the reporting cycle of the subgroup to which it belongs.
    • Onchange: data is reported regularly according to a grouped reporting cycle only when there is a change in the value of the measurement point.
    • Never: local use only, no need to upload data from the cloud
  • Unit: measurement point unit
  • Description: Description of the measurement point
  • Group: Group to which the measurement point belongs
  • Store Historical Data: When enabled, a historical data table will be generated with the name of the group to which the measurement point belongs, and the historical data will be stored according to the storage policy set by the group. Stored historical data can be exported as CSV files or obtained by calling the Python API.

*FANUC CNC 0i

FANUC CNC 0i is a type of numerical control system manufactured by FANUC Corporation in Japan. This type of CNC system is mainly used to control metalworking machine tools, such as CNC lathes, CNC milling machines, CNC grinding machines, etc., so that they can automate machining operations.FANUC CNC 0i CNC systems usually have a network communication function, allowing data monitoring and communication through the TCP/IP protocol. The TCP/IP protocol allows the user to establish a network connection with the FANUC CNC 0i system, monitor its status, read data, and send commands.

Adding a controller
  • Name: name of the controller, unique in the list of controllers across the gateway
  • Protocol: Select *FANUC CNC 0i
  • IP address: IP address information of the device
  • Port: port information of the device
  • Polling Interval: the time interval (in seconds) for collecting data, for example, if it is set to 10S, all the measurement points under the controller will be polled every 10S.
  • Enable Multiple Polling Interval: When enabled, you can configure an additional polling cycle and select certain points under the controller to use that polling cycle. This feature can be used to differentiate between measurement points that require high and low frequency acquisition, making efficient use of gateway and PLC performance.
  • Polling Interval 2: i.e. the additional polling cycle (in seconds) that needs to be set when multiple polling cycles are enabled
  • Description: You can add comment information to this controller.

Advanced Settings:

  • Timeout Settings:
    • Timeout: When collecting measurement points, after initiating a read request to the device, the device responds to the timeout time, if the device does not respond to the read request within the set acquisition timeout time, it is still a failure of this acquisition.
    • Connect Timeout: Timeout time for establishing a connection.
  • Communication Message Settings:
    • Store Communication Message: Controllers with this function enabled will store communication messages, and the path and number of stored messages can be set in the "Default Parameters" on the "Parameter Settings" page. If you want to download the stored communication messages, you can go to the "Realtime Communication Message" page of the specified controller in the "Measure Monitor" page, and then click the "Download" button to download the messages.
Adding measuring points
  • Measuring Point Name: the name of the measurement point (the name of the measurement point cannot be repeated under the same controller)
  • Read Type: select from the drop-down box
  • Data Type: different data types are supported according to the selected read type, which cannot be changed
  • Read Bit Data: When the data type selection is not FLOAT,STRING, you can read the value of any bit of data in the integer when it is enabled.
  • Register Bit: The bit offset of the measurement point when reading bit data after turning on value by bit.
  • Negative Value: When Negative Value and data type BIT are turned on, you can choose whether or not to invert the read result.
  • Decimal Places: the length of the data after the decimal point of the measurement point when the data type is FLOAT, maximum 6 digits
  • Read/Write:The read/write privilege is different according to the address type. After selecting the address type, please select the actual supported read/write permissions from the drop-down box.
  • Mode:
    • Periodic: data is reported regularly according to the reporting cycle of the subgroup to which it belongs.
    • Onchange: data is reported regularly according to a grouped reporting cycle only when there is a change in the value of the measurement point.
    • Never: local use only, no need to upload data from the cloud
  • Onchange Deadzone: When the upload mode is Onchange, you can set the value change within a certain range to be considered as no change in the value. If the data has configured data operation, then according to the value after the operation to detect whether the value change exceeds the dead zone.
  • Unit: measurement point unit
  • Description: Description of the measurement point
  • Group: Subgroup to which the measurement point belongs
  • Store Historical Data: When enabled, a historical data table will be generated with the name of the group to which the measurement point belongs, and the historical data will be stored according to the storage policy set by the group. Stored historical data can be exported as CSV files or obtained by calling the Python API.
  • Data Calculation: If the data type of the measurement point is not BIT or STRING and bitwise value is not enabled, simple arithmetic processing is supported through data arithmetic, and the processed data values can be reported to the cloud platform. Values mapped to protocol conversions (Modbus Slave or OPC UA Server, etc.) are by default the raw data values collected rather than the calculated data values.
  • No: no arithmetic is performed, the collected raw data values are used
  • Ratio Conversion: The collected data value is mapped to a data value in the range of the upper and lower limits of the scale in equal proportions according to the range of the upper and lower limits of the data, such as mapping the data collected in the sensor to the actual temperature and humidity. Calculation formula for the calculated data value = (upper limit of the ratio - lower limit of the ratio) / (upper limit of the data - lower limit of the data) * (original data value - lower limit of the data) + lower limit of the ratio
    • Decimal Places: the number of decimal places to be retained after arithmetic operations
    • Data High Limit: the upper data limit for a measurement point
    • Data Lower Limit: lower data limit value for the measurement point
    • High Limit Of Proportion: the upper limit of the data after proportional operation
    • Lower Limit Of Proportion: the lower limit value of the data after proportional operation
  • Offset And Zoom: Calculate the original data value according to the multiplier and offset, the formula is calculated data value = (original data value * Magnification) + Offset
    • Decimal places: the number of decimal places to be retained after arithmetic operations
    • Magnification: the magnification needed to zoom in or out
    • Offset: the data value to be increased or decreased after the multiplier operation
  • Bit Truncation: Intercepts a segment of bit data from the original data as a data value; this operation is not supported for FLOAT-type points.
    • Start Bit: Bit offset to start intercepting the original data
    • End Bit: Bit offset to end the interception of the original data
  • PT/CT: Calculate the raw data value according to the magnification, offset, PT and CT, with the formula [(raw value*magnification)+offset]*PT*CT
    • Decimal Places: the number of decimal places to be retained after arithmetic operations
    • Magnification: the magnification needed to zoom in or out
    • Offset: the data value to be increased or decreased after the multiplier operation
    • PT: Additional PT multiplier
    • CT: additional CT magnification
  • Value Mapping: Configurable conversion of specific values of measurement points to other values.
    • Source Value: The original measured point value collected.
    • Target Value: the value of the measurement point after the conversion is expected.

FATEK

FATEK Programe Port

The Programe Port provides a physical connection, usually a port, through which communication with the FATEK PLC can take place. This programming port is the interface used to connect the PLC to a programming device (e.g. a programmer or PC) for programming, debugging and data transfer.

Adding a controller
  • Name: name of the controller, unique in the list of controllers across the gateway
  • Protocol: Select FATEK Programe Port
  • Slave: unique identification of the slave device
  • Communication Mode: support RS485 and RS232, RS485 is used by default.
  • Polling Interval: the time interval (in seconds) for collecting data, for example, if it is set to 10S, all the measurement points under the controller will be polled every 10S.
  • Enable Multiple Polling Interval: When enabled, you can configure an additional polling cycle and select certain points under the controller to use that polling cycle. This feature can be used to differentiate between test points that require high and low frequency acquisition, making efficient use of gateway and PLC performance.
  • Polling Interval 2: i.e. the additional polling cycle (in seconds) that needs to be set when multiple polling cycles are enabled
  • Description: You can add comment information to this controller.

Advanced Settings:

  • Timeout Settings:
    • Timeout: When collecting measurement points, after initiating a read request to the device, the device responds to the timeout time, if the device does not respond to the read request within the set collection timeout, the collection still fails.
  • Communication time setting:
    • Communication Interval Time: The interval time between message interactions, i.e., after receiving a response from the device, it will wait for a communication interval time before sending the next request message.
  • Communication Message Settings:
    • Store Communication Message: Controllers with this function enabled will store communication messages, and the path and number of stored messages can be set in the "Default Parameters" on the "Parameter Settings" page. If you want to download the stored communication messages, you can go to the "Realtime Communication Message" page of the specified controller in the "Measure Monitor" page, and then click the "Download" button to download the messages.
Adding measuring points
  • Measuring Point Name: the name of the measurement point (the name of the measurement point cannot be repeated under the same controller)
  • Register Type: select from the drop-down box
  • Register Address: Address of the measuring point
  • Data Type: Different Data types are supported depending on the Register type selected. After selecting the Register type, choose the Data type from the drop-down box
  • Read Bit Data: When the data type selection is not FLOAT,STRING, you can read the value of any bit of data in the integer when it is enabled.
  • Register Bit: The bit offset of the measurement point when reading bit data after turning on value by bit.
  • Negative Value: When Negative Value and data type BIT are turned on, you can choose whether or not to invert the read result.
  • Decimal Places: the length of the data after the decimal point of the measurement point when the data type is FLOAT, maximum 6 digits
  • Read/Write:The read/write privilege is different according to the address type. After selecting the address type, please select the actual supported read/write permissions from the drop-down box.
  • Mode:
    • Periodic: data is reported regularly according to the reporting cycle of the subgroup to which it belongs.
    • Onchange: data is reported regularly according to a grouped reporting cycle only when there is a change in the value of the measurement point.
    • Never: local use only, no need to upload data from the cloud
  • Onchange Deadzone: When the upload mode is Onchange, you can set the value change within a certain range to be considered as no change in the value. If the data has configured data operation, then according to the value after the operation to detect whether the value change exceeds the dead zone.
  • Unit: measurement point unit
  • Description: Description of the measurement point
  • Group: Subgroup to which the measurement point belongs
  • Store Historical Data: When enabled, a historical data table will be generated with the name of the group to which the measurement point belongs, and the historical data will be stored according to the storage policy set by the group. Stored historical data can be exported as CSV files or obtained by calling the Python API.
  • Data Calculation: If the data type of the measurement point is not BIT or STRING and bitwise value is not enabled, simple arithmetic processing is supported through data arithmetic, and the processed data values can be reported to the cloud platform. Values mapped to protocol conversions (Modbus Slave or OPC UA Server, etc.) are by default the raw data values collected rather than the calculated data values.
  • No: no arithmetic is performed, the collected raw data values are used
  • Ratio Conversion: The collected data value is mapped to a data value in the range of the upper and lower limits of the scale in equal proportions according to the range of the upper and lower limits of the data, such as mapping the data collected in the sensor to the actual temperature and humidity. Calculation formula for the calculated data value = (upper limit of the ratio - lower limit of the ratio) / (upper limit of the data - lower limit of the data) * (original data value - lower limit of the data) + lower limit of the ratio
    • Decimal Places: the number of decimal places to be retained after arithmetic operations
    • Data High Limit: the upper data limit for a measurement point
    • Data Lower Limit: lower data limit value for the measurement point
    • High Limit Of Proportion: the upper limit of the data after proportional operation
    • Lower Limit Of Proportion: the lower limit value of the data after proportional operation
  • Offset And Zoom: Calculate the original data value according to the multiplier and offset, the formula is calculated data value = (original data value * Magnification) + Offset
    • Decimal places: the number of decimal places to be retained after arithmetic operations
    • Magnification: the magnification needed to zoom in or out
    • Offset: the data value to be increased or decreased after the multiplier operation
  • Bit Truncation: Intercepts a segment of bit data from the original data as a data value; this operation is not supported for FLOAT-type points.
    • Start Bit: Bit offset to start intercepting the original data
    • End Bit: Bit offset to end the interception of the original data
  • PT/CT: Calculate the raw data value according to the magnification, offset, PT and CT, with the formula [(raw value*magnification)+offset]*PT*CT
    • Decimal Places: the number of decimal places to be retained after arithmetic operations
    • Magnification: the magnification needed to zoom in or out
    • Offset: the data value to be increased or decreased after the multiplier operation
    • PT: Additional PT multiplier
    • CT: additional CT magnification
  • Value Mapping: Configurable conversion of specific values of measurement points to other values.
    • Source Value: The original measured point value collected.
    • Target Value: the value of the measurement point after the conversion is expected.

FATEK Programe Port over TCP

FATEK PLC products typically support a variety of communication methods, including programming and data communication over Ethernet (TCP/IP). By mapping the FATEK Programe Port onto a TCP/IP network, users can connect to the PLC over the network and use the appropriate programming software or tools to program, monitor and debug with the PLC.

Adding a controller
  • Name: name of the controller, unique in the list of controllers across the gateway
  • Protocol: Select FATEK Programe Port over TCP
  • IP address: IP address information of the device
  • Port: port information of the device
  • Slave: unique identification of the slave device
  • Polling Interval: the time interval (in seconds) for collecting data, for example, if it is set to 10S, all the measurement points under the controller will be polled every 10S.
  • Enable Multiple Polling Interval: When enabled, you can configure an additional polling cycle and select certain points under the controller to use that polling cycle. This feature can be used to differentiate between test points that require high and low frequency acquisition, making efficient use of gateway and PLC performance.
  • Polling Interval 2: i.e. the additional polling cycle (in seconds) that needs to be set when multiple polling cycles are enabled
  • Description: You can add comment information to this controller.

Advanced Settings:

  • Timeout Settings:
    • Timeout: When collecting measurement points, after initiating a read request to the device, the device responds to the timeout time, if the device does not respond to the read request within the set collection timeout, the collection still fails.
    • Connect Timeout: Timeout time for establishing a connection.
  • Communication Message Settings:
    • Store Communication Message: Controllers with this function enabled will store communication messages, and the path and number of stored messages can be set in the "Default Parameters" on the "Parameter Settings" page. If you want to download the stored communication messages, you can go to the "Realtime Communication Message" page of the specified controller in the "Measure Monitor" page, and then click the "Download" button to download the messages.
Adding measuring points
  • Measuring Point Name: the name of the measurement point (the name of the measurement point cannot be repeated under the same controller)
  • Register Type: select from the drop-down box
  • Register Address: Address of the measuring point
  • Data Type: Different Data types are supported depending on the Register type selected. After selecting the Register type, choose the Data type from the drop-down box
  • Read Bit Data: When the data type selection is not FLOAT,STRING, you can read the value of any bit of data in the integer when it is enabled.
  • Register Bit: The bit offset of the measurement point when reading bit data after turning on value by bit.
  • Negative Value: When Negative Value and data type BIT are turned on, you can choose whether or not to invert the read result.
  • Decimal Places: the length of the data after the decimal point of the measurement point when the data type is FLOAT, maximum 6 digits
  • Read/Write:The read/write privilege is different according to the address type. After selecting the address type, please select the actual supported read/write permissions from the drop-down box.
  • Mode:
    • Periodic: data is reported regularly according to the reporting cycle of the subgroup to which it belongs.
    • Onchange: data is reported regularly according to a grouped reporting cycle only when there is a change in the value of the measurement point.
    • Never: local use only, no need to upload data from the cloud
  • Onchange Deadzone: When the upload mode is Onchange, you can set the value change within a certain range to be considered as no change in the value. If the data has configured data operation, then according to the value after the operation to detect whether the value change exceeds the dead zone.
  • Unit: measurement point unit
  • Description: Description of the measurement point
  • Group: Subgroup to which the measurement point belongs
  • Store Historical Data: When enabled, a historical data table will be generated with the name of the group to which the measurement point belongs, and the historical data will be stored according to the storage policy set by the group. Stored historical data can be exported as CSV files or obtained by calling the Python API.
  • Data Calculation: If the data type of the measurement point is not BIT or STRING and bitwise value is not enabled, simple arithmetic processing is supported through data arithmetic, and the processed data values can be reported to the cloud platform. Values mapped to protocol conversions (Modbus Slave or OPC UA Server, etc.) are by default the raw data values collected rather than the calculated data values.
  • No: no arithmetic is performed, the collected raw data values are used
  • Ratio Conversion: The collected data value is mapped to a data value in the range of the upper and lower limits of the scale in equal proportions according to the range of the upper and lower limits of the data, such as mapping the data collected in the sensor to the actual temperature and humidity. Calculation formula for the calculated data value = (upper limit of the ratio - lower limit of the ratio) / (upper limit of the data - lower limit of the data) * (original data value - lower limit of the data) + lower limit of the ratio
    • Decimal Places: the number of decimal places to be retained after arithmetic operations
    • Data High Limit: the upper data limit for a measurement point
    • Data Lower Limit: lower data limit value for the measurement point
    • High Limit Of Proportion: the upper limit of the data after proportional operation
    • Lower Limit Of Proportion: the lower limit value of the data after proportional operation
  • Offset And Zoom: Calculate the original data value according to the multiplier and offset, the formula is calculated data value = (original data value * Magnification) + Offset
    • Decimal places: the number of decimal places to be retained after arithmetic operations
    • Magnification: the magnification needed to zoom in or out
    • Offset: the data value to be increased or decreased after the multiplier operation
  • Bit Truncation: Intercepts a segment of bit data from the original data as a data value; this operation is not supported for FLOAT-type points.
    • Start Bit: Bit offset to start intercepting the original data
    • End Bit: Bit offset to end the interception of the original data
  • PT/CT: Calculate the raw data value according to the magnification, offset, PT and CT, with the formula [(raw value*magnification)+offset]*PT*CT
    • Decimal Places: the number of decimal places to be retained after arithmetic operations
    • Magnification: the magnification needed to zoom in or out
    • Offset: the data value to be increased or decreased after the multiplier operation
    • PT: Additional PT multiplier
    • CT: additional CT magnification
  • Value Mapping: Configurable conversion of specific values of measurement points to other values.
    • Source Value: The original measured point value collected.
    • Target Value: the value of the measurement point after the conversion is expected.

Fuji

*SPB

The SPB series PLCs are a series of programmable logic controller (PLC) products manufactured by Fuji.The SPB series PLCs usually support a variety of communication protocols and network connections, such as Ethernet, serial communications, etc., to facilitate data exchange and communication with other devices or higher-level systems.

Adding a controller
  • Name: name of the controller, unique in the list of controllers across the gateway
  • Protocol: Select *SPB
  • Station No: the station number of the device
  • Communication Mode: support RS485 and RS232, RS485 is used by default.
  • Polling Interval: the time interval (in seconds) for collecting data, for example, if it is set to 10S, all the measurement points under the controller will be polled every 10S.
  • Enable Multiple Polling Interval: When enabled, you can configure an additional polling cycle and select certain points under the controller to use that polling cycle. This feature can be used to differentiate between test points that require high and low frequency acquisition, making efficient use of gateway and PLC performance.
  • Polling Interval 2: i.e. the additional polling cycle (in seconds) that needs to be set when multiple polling cycles are enabled
  • Description: You can add comment information to this controller.

Advanced Settings:

  • Timeout Settings:
    • Timeout: When collecting measurement points, after initiating a read request to the device, the device responds to the timeout time, if the device does not respond to the read request within the set collection timeout, the collection still fails.
  • Communication time setting:
    • Communication Interval Time: The interval time between message interactions, i.e., after receiving a response from the device, it will wait for a communication interval time before sending the next request message.
  • Communication Message Settings:
    • Store Communication Message: Controllers with this function enabled will store communication messages, and the path and number of stored messages can be set in the "Default Parameters" on the "Parameter Settings" page. If you want to download the stored communication messages, you can go to the "Realtime Communication Message" page of the specified controller in the "Measure Monitor" page, and then click the "Download" button to download the messages.
Adding measuring points
  • Measuring Point Name: the name of the measurement point (the name of the measurement point cannot be repeated under the same controller)
  • Address: Measurement point address
  • Data types: The following data types are supported
    • BIT: 0 or 1
    • BYTE: 8-bit unsigned integer
    • SINT: 8-bit signed integer
    • WORD: 16-bit unsigned integer
    • INT: 16-bit signed integer
    • DWORD: 32-bit unsigned integer
    • DINT: 32-bit signed integer
    • FLOAT: 32-bit floating point number
    • DOUBLE: 64-bit floating point number
    • STRING: 8-bit string
    • BCD16: 16-bit BCD code
  • Decimal Places: The length of the data after the decimal point of the measuring point when the data type is FLOAT or DOUBLE, up to 6 digits.
  • Size: the length of the string when the data type is STRING.
  • Character Encoding Format: ASCII, UTF-8, UTF-16-LITTLE, UTF-16-BIG, GB2312. Only the Data Type selection STRING is valid.
  • Read Bit Data: Enabled to read the value of any bit of data in an integer.
  • Register Bit: The bit offset of the measurement point when reading bit data after turning on Read Bit Data.
  • Negative Value: When turn on Read Bit Data, you can choose whether or not to invert the read result.
  • Numerical mapping: maps 0 and 1 values of BIT-type points to False and True when enabled
  • Read/Write:
    • Read: read only, not write
    • Read/Write: readable and writable
  • Mode:
    • Periodic: data is reported regularly according to the reporting cycle of the subgroup to which it belongs.
    • Onchange: data is reported regularly according to a grouped reporting cycle only when there is a change in the value of the measurement point.
    • Never: local use only, no need to upload data from the cloud
  • Onchange Deadzone: When the upload mode is Onchange, you can set the value change within a certain range to be considered as no change in the value. If the data has configured data operation, then according to the value after the operation to detect whether the value change exceeds the dead zone.
  • Unit: measurement point unit
  • Description: Description of the measurement point
  • Group: Subgroup to which the measurement point belongs
  • Store Historical Data: When enabled, a historical data table will be generated with the name of the group to which the measurement point belongs, and the historical data will be stored according to the storage policy set by the group. The stored historical data can be exported as CSV files or obtained by calling the Python API.
  • Data Calculation: Simple arithmetic processing through data arithmetic is supported when the data type of the measurement point is not BIT or STRING, and the processed data values can be reported to the cloud platform. The values mapped to protocol conversions (Modbus Slave or OPC UA Server, etc.) are by default the raw data values collected rather than the calculated data values.
  • No: no arithmetic is performed, the collected raw data values are used
  • Ratio Conversion: The collected data value is mapped to a data value in the range of the upper and lower limits of the scale in equal proportions according to the range of the upper and lower limits of the data, such as mapping the data collected in the sensor to the actual temperature and humidity. Calculation formula for the calculated data value = (upper limit of the ratio - lower limit of the ratio) / (upper limit of the data - lower limit of the data) * (original data value - lower limit of the data) + lower limit of the ratio
    • Decimal Places: the number of decimal places to be retained after arithmetic operations
    • Data High Limit: the upper data limit for a measurement point
    • Data Lower Limit: lower data limit value for the measurement point
    • High Limit Of Proportion: the upper limit of the data after proportional operation
    • Lower Limit Of Proportion: the lower limit value of the data after proportional operation
  • Offset And Zoom: Calculate the original data value according to the multiplier and offset, the formula is calculated data value = (original data value * Magnification) + Offset
    • Decimal places: the number of decimal places to be retained after arithmetic operations
    • Magnification: the magnification needed to zoom in or out
    • Offset: the data value to be increased or decreased after the multiplier operation
  • Bit Truncation: Intercepts a segment of bit data from the original data as a data value; this operation is not supported for FLOAT-type points.
    • Start Bit: Bit offset to start intercepting the original data
    • End Bit: Bit offset to end the interception of the original data
  • PT/CT: Calculate the raw data value according to the magnification, offset, PT and CT, with the formula [(raw value*magnification)+offset]*PT*CT
    • Decimal Places: the number of decimal places to be retained after arithmetic operations
    • Magnification: the magnification needed to zoom in or out
    • Offset: the data value to be increased or decreased after the multiplier operation
    • PT: Additional PT multiplier
    • CT: additional CT magnification
  • Value Mapping: Configurable conversion of specific values of measurement points to other values.
    • Source Value: The original measured point value collected.
    • Target Value: the value of the measurement point after the conversion is expected

*SPB over TCP

A communication method that encapsulates communication data from Fuji SPB series programmable logic controllers (PLCs) using serial communication protocols (e.g., RS-232, RS-485) and transmits it over a TCP/IP network.

Adding a controller
  • Name: name of the controller, unique in the list of controllers across the gateway
  • Protocol: Select *SPB over TCP
  • Station No: the station number of the device
  • IP address: IP address information of the device
  • Port: port information of the device
  • Polling Interval: the time interval (in seconds) for collecting data, for example, if it is set to 10S, all the measurement points under the controller will be polled every 10S.
  • Enable Multiple Polling Interval: When enabled, you can configure an additional polling cycle and select certain points under the controller to use that polling cycle. This feature can be used to differentiate between test points that require high and low frequency acquisition, making efficient use of gateway and PLC performance.
  • Polling Interval 2: i.e. the additional polling cycle (in seconds) that needs to be set when multiple polling cycles are enabled
  • Description: You can add comment information to this controller.

Advanced Settings:

  • Timeout Settings:
    • Timeout: When collecting measurement points, after initiating a read request to the device, the device responds to the timeout time, if the device does not respond to the read request within the set collection timeout, the collection still fails.
    • Connect Timeout: Timeout time for establishing a connection.
  • Communication Message Settings:
    • Store Communication Message: Controllers with this function enabled will store communication messages, and the path and number of stored messages can be set in the "Default Parameters" on the "Parameter Settings" page. If you want to download the stored communication messages, you can go to the "Realtime Communication Message" page of the specified controller in the "Measure Monitor" page, and then click the "Download" button to download the messages.
Adding measuring points
  • Measuring Point Name: the name of the measurement point (the name of the measurement point cannot be repeated under the same controller)
  • Address: Measurement point address
  • Data types: The following data types are supported
    • BIT: 0 or 1
    • BYTE: 8-bit unsigned integer
    • SINT: 8-bit signed integer
    • WORD: 16-bit unsigned integer
    • INT: 16-bit signed integer
    • DWORD: 32-bit unsigned integer
    • DINT: 32-bit signed integer
    • FLOAT: 32-bit floating point number
    • DOUBLE: 64-bit floating point number
    • STRING: 8-bit string
    • BCD16: 16-bit BCD code
  • Decimal Places: The length of the data after the decimal point of the measuring point when the data type is FLOAT or DOUBLE, up to 6 digits.
  • Size: the length of the string when the data type is STRING.
  • Character Encoding Format: ASCII, UTF-8, UTF-16-LITTLE, UTF-16-BIG, GB2312. Only the Data Type selection STRING is valid.
  • Read Bit Data: Enabled to read the value of any bit of data in an integer.
  • Register Bit: The bit offset of the measurement point when reading bit data after turning on Read Bit Data.
  • Negative Value: When turn on Read Bit Data, you can choose whether or not to invert the read result.
  • Numerical mapping: maps 0 and 1 values of BIT-type points to False and True when enabled
  • Read/Write:
    • Read: read only, not write
    • Read/Write: readable and writable
  • Mode:
    • Periodic: data is reported regularly according to the reporting cycle of the subgroup to which it belongs.
    • Onchange: data is reported regularly according to a grouped reporting cycle only when there is a change in the value of the measurement point.
    • Never: local use only, no need to upload data from the cloud
  • Onchange Deadzone: When the upload mode is Onchange, you can set the value change within a certain range to be considered as no change in the value. If the data has configured data operation, then according to the value after the operation to detect whether the value change exceeds the dead zone.
  • Unit: measurement point unit
  • Description: Description of the measurement point
  • Group: Subgroup to which the measurement point belongs
  • Store Historical Data: When enabled, a historical data table will be generated with the name of the group to which the measurement point belongs, and the historical data will be stored according to the storage policy set by the group. The stored historical data can be exported as CSV files or obtained by calling the Python API.
  • Data Calculation: Simple arithmetic processing through data arithmetic is supported when the data type of the measurement point is not BIT or STRING, and the processed data values can be reported to the cloud platform. The values mapped to protocol conversions (Modbus Slave or OPC UA Server, etc.) are by default the raw data values collected rather than the calculated data values.
  • No: no arithmetic is performed, the collected raw data values are used
  • Ratio Conversion: The collected data value is mapped to a data value in the range of the upper and lower limits of the scale in equal proportions according to the range of the upper and lower limits of the data, such as mapping the data collected in the sensor to the actual temperature and humidity. Calculation formula for the calculated data value = (upper limit of the ratio - lower limit of the ratio) / (upper limit of the data - lower limit of the data) * (original data value - lower limit of the data) + lower limit of the ratio
    • Decimal Places: the number of decimal places to be retained after arithmetic operations
    • Data High Limit: the upper data limit for a measurement point
    • Data Lower Limit: lower data limit value for the measurement point
    • High Limit Of Proportion: the upper limit of the data after proportional operation
    • Lower Limit Of Proportion: the lower limit value of the data after proportional operation
  • Offset And Zoom: Calculate the original data value according to the multiplier and offset, the formula is calculated data value = (original data value * Magnification) + Offset
    • Decimal places: the number of decimal places to be retained after arithmetic operations
    • Magnification: the magnification needed to zoom in or out
    • Offset: the data value to be increased or decreased after the multiplier operation
  • Bit Truncation: Intercepts a segment of bit data from the original data as a data value; this operation is not supported for FLOAT-type points.
    • Start Bit: Bit offset to start intercepting the original data
    • End Bit: Bit offset to end the interception of the original data
  • PT/CT: Calculate the raw data value according to the magnification, offset, PT and CT, with the formula [(raw value*magnification)+offset]*PT*CT
    • Decimal Places: the number of decimal places to be retained after arithmetic operations
    • Magnification: the magnification needed to zoom in or out
    • Offset: the data value to be increased or decreased after the multiplier operation
    • PT: Additional PT multiplier
    • CT: additional CT magnification
  • Value Mapping: Configurable conversion of specific values of measurement points to other values.
    • Source Value: The original measured point value collected.
    • Target Value: the value of the measurement point after the conversion is expected

*SPH Net

Fuji's SPH Net is one of Fuji Electric's (Fuji Electric) product lines, and it is a proprietary communication protocol.SPH Net is typically used to connect PLCs (Programmable Logic Controllers) and other automation equipment for data exchange and control.

Adding a controller
  • Name: name of the controller, unique in the list of controllers across the gateway
  • Protocol: Select *SPH Net
  • Station No: the station number of the device
  • IP address: IP address information of the device
  • Port: port information of the device
  • Polling Interval: the time interval (in seconds) for collecting data, for example, if it is set to 10S, all the measurement points under the controller will be polled every 10S.
  • Enable Multiple Polling Interval: When enabled, you can configure an additional polling cycle and select certain points under the controller to use that polling cycle. This feature can be used to differentiate between test points that require high and low frequency acquisition, making efficient use of gateway and PLC performance.
  • Polling Interval 2: i.e. the additional polling cycle (in seconds) that needs to be set when multiple polling cycles are enabled
  • Description: You can add comment information to this controller.

Advanced Settings:

  • Timeout Settings:
    • Timeout: When collecting measurement points, after initiating a read request to the device, the device responds to the timeout time, if the device does not respond to the read request within the set collection timeout, the collection still fails.
    • Connect Timeout: Timeout time for establishing a connection.
  • Communication Message Settings:
    • Store Communication Message: Controllers with this function enabled will store communication messages, and the path and number of stored messages can be set in the "Default Parameters" on the "Parameter Settings" page. If you want to download the stored communication messages, you can go to the "Realtime Communication Message" page of the specified controller in the "Measure Monitor" page, and then click the "Download" button to download the messages.
Adding measuring points
  • Measuring Point Name: the name of the measurement point (the name of the measurement point cannot be repeated under the same controller)
  • Address: Measurement point address
  • Data types: The following data types are supported
    • BIT: 0 or 1
    • BYTE: 8-bit unsigned integer
    • SINT: 8-bit signed integer
    • WORD: 16-bit unsigned integer
    • INT: 16-bit signed integer
    • DWORD: 32-bit unsigned integer
    • DINT: 32-bit signed integer
    • FLOAT: 32-bit floating point number
    • DOUBLE: 64-bit floating point number
    • STRING: 8-bit string
    • BCD16: 16-bit BCD code
  • Decimal Places: The length of the data after the decimal point of the measuring point when the data type is FLOAT or DOUBLE, up to 6 digits.
  • Size: the length of the string when the data type is STRING.
  • Character Encoding Format: ASCII, UTF-8, UTF-16-LITTLE, UTF-16-BIG, GB2312. Only the Data Type selection STRING is valid.
  • Read Bit Data: Enabled to read the value of any bit of data in an integer.
  • Register Bit: The bit offset of the measurement point when reading bit data after turning on Read Bit Data.
  • Negative Value: When turn on Read Bit Data, you can choose whether or not to invert the read result.
  • Numerical mapping: maps 0 and 1 values of BIT-type points to False and True when enabled
  • Read/Write:
    • Read: read only, not write
    • Read/Write: readable and writable
  • Mode:
    • Periodic: data is reported regularly according to the reporting cycle of the subgroup to which it belongs.
    • Onchange: data is reported regularly according to a grouped reporting cycle only when there is a change in the value of the measurement point.
    • Never: local use only, no need to upload data from the cloud
  • Onchange Deadzone: When the upload mode is Onchange, you can set the value change within a certain range to be considered as no change in the value. If the data has configured data operation, then according to the value after the operation to detect whether the value change exceeds the dead zone.
  • Unit: measurement point unit
  • Description: Description of the measurement point
  • Group: Subgroup to which the measurement point belongs
  • Store Historical Data: When enabled, a historical data table will be generated with the name of the group to which the measurement point belongs, and the historical data will be stored according to the storage policy set by the group. The stored historical data can be exported as CSV files or obtained by calling the Python API.
  • Data Calculation: Simple arithmetic processing through data arithmetic is supported when the data type of the measurement point is not BIT or STRING, and the processed data values can be reported to the cloud platform. The values mapped to protocol conversions (Modbus Slave or OPC UA Server, etc.) are by default the raw data values collected rather than the calculated data values.
  • No: no arithmetic is performed, the collected raw data values are used
  • Ratio Conversion: The collected data value is mapped to a data value in the range of the upper and lower limits of the scale in equal proportions according to the range of the upper and lower limits of the data, such as mapping the data collected in the sensor to the actual temperature and humidity. Calculation formula for the calculated data value = (upper limit of the ratio - lower limit of the ratio) / (upper limit of the data - lower limit of the data) * (original data value - lower limit of the data) + lower limit of the ratio
    • Decimal Places: the number of decimal places to be retained after arithmetic operations
    • Data High Limit: the upper data limit for a measurement point
    • Data Lower Limit: lower data limit value for the measurement point
    • High Limit Of Proportion: the upper limit of the data after proportional operation
    • Lower Limit Of Proportion: the lower limit value of the data after proportional operation
  • Offset And Zoom: Calculate the original data value according to the multiplier and offset, the formula is calculated data value = (original data value * Magnification) + Offset
    • Decimal places: the number of decimal places to be retained after arithmetic operations
    • Magnification: the magnification needed to zoom in or out
    • Offset: the data value to be increased or decreased after the multiplier operation
  • Bit Truncation: Intercepts a segment of bit data from the original data as a data value; this operation is not supported for FLOAT-type points.
    • Start Bit: Bit offset to start intercepting the original data
    • End Bit: Bit offset to end the interception of the original data
  • PT/CT: Calculate the raw data value according to the magnification, offset, PT and CT, with the formula [(raw value*magnification)+offset]*PT*CT
    • Decimal Places: the number of decimal places to be retained after arithmetic operations
    • Magnification: the magnification needed to zoom in or out
    • Offset: the data value to be increased or decreased after the multiplier operation
    • PT: Additional PT multiplier
    • CT: additional CT magnification
  • Value Mapping: Configurable conversion of specific values of measurement points to other values.
    • Source Value: The original measured point value collected.
    • Target Value: the value of the measurement point after the conversion is expected

GE

*SRTP

SRTP is a specific sub-protocol of the SNP protocol, which stands for Real-Time Protocol of SNP (Series Network Protocol).SRTP is usually used for real-time data transmission with high speed and low latency, and is suitable for application scenarios with high real-time requirements, such as control systems and data acquisition, and so on.

Adding a controller
  • Name: name of the controller, unique in the list of controllers across the gateway
  • Protocol: Select *SRTP
  • IP address: IP address information of the device
  • Port: port information of the device
  • Polling Interval: the time interval (in seconds) for collecting data, for example, if it is set to 10S, all the measurement points under the controller will be polled every 10S.
  • Enable Multiple Polling Interval: When enabled, you can configure an additional polling cycle and select certain points under the controller to use that polling cycle. This feature can be used to differentiate between test points that require high and low frequency acquisition, making efficient use of gateway and PLC performance.
  • Polling Interval 2: i.e. the additional polling cycle (in seconds) that needs to be set when multiple polling cycles are enabled
  • Description: You can add comment information to this controller.

Advanced Settings:

  • Timeout Settings:
    • Timeout: When collecting measurement points, after initiating a read request to the device, the device responds to the timeout time, if the device does not respond to the read request within the set collection timeout, the collection still fails.
    • Connect Timeout: Timeout time for establishing a connection.
  • Communication Message Settings:
    • Store Communication Message: Controllers with this function enabled will store communication messages, and the path and number of stored messages can be set in the "Default Parameters" on the "Parameter Settings" page. If you want to download the stored communication messages, you can go to the "Realtime Communication Message" page of the specified controller in the "Measure Monitor" page, and then click the "Download" button to download the messages.
Adding measuring points
  • Measuring Point Name: the name of the measurement point (the name of the measurement point cannot be repeated under the same controller)
  • Address: Measurement point address
  • Data types: The following data types are supported
    • BIT: 0 or 1
    • BYTE: 8-bit unsigned integer
    • SINT: 8-bit signed integer
    • WORD: 16-bit unsigned integer
    • INT: 16-bit signed integer
    • DWORD: 32-bit unsigned integer
    • DINT: 32-bit signed integer
    • FLOAT: 32-bit floating point number
    • DOUBLE: 64-bit floating point number
    • STRING: 8-bit string
    • BCD16: 16-bit BCD code
  • Decimal Places: The length of the data after the decimal point of the measuring point when the data type is FLOAT or DOUBLE, up to 6 digits.
  • Size: the length of the string when the data type is STRING.
  • Character Encoding Format: ASCII, UTF-8, UTF-16-LITTLE, UTF-16-BIG, GB2312. Only the Data Type selection STRING is valid.
  • Read Bit Data: Enabled to read the value of any bit of data in an integer.
  • Register Bit: The bit offset of the measurement point when reading bit data after turning on Read Bit Data.
  • Negative Value: When turn on Read Bit Data, you can choose whether or not to invert the read result.
  • Numerical mapping: maps 0 and 1 values of BIT-type points to False and True when enabled
  • Read/Write:
    • Read: read only, not write
    • Read/Write: readable and writable
  • Mode:
    • Periodic: data is reported regularly according to the reporting cycle of the subgroup to which it belongs.
    • Onchange: data is reported regularly according to a grouped reporting cycle only when there is a change in the value of the measurement point.
    • Never: local use only, no need to upload data from the cloud
  • Onchange Deadzone: When the upload mode is Onchange, you can set the value change within a certain range to be considered as no change in the value. If the data has configured data operation, then according to the value after the operation to detect whether the value change exceeds the dead zone.
  • Unit: measurement point unit
  • Description: Description of the measurement point
  • Group: Subgroup to which the measurement point belongs
  • Store Historical Data: When enabled, a historical data table will be generated with the name of the group to which the measurement point belongs, and the historical data will be stored according to the storage policy set by the group. The stored historical data can be exported as CSV files or obtained by calling the Python API.
  • Data Calculation: Simple arithmetic processing through data arithmetic is supported when the data type of the measurement point is not BIT or STRING, and the processed data values can be reported to the cloud platform. The values mapped to protocol conversions (Modbus Slave or OPC UA Server, etc.) are by default the raw data values collected rather than the calculated data values.
  • No: no arithmetic is performed, the collected raw data values are used
  • Ratio Conversion: The collected data value is mapped to a data value in the range of the upper and lower limits of the scale in equal proportions according to the range of the upper and lower limits of the data, such as mapping the data collected in the sensor to the actual temperature and humidity. Calculation formula for the calculated data value = (upper limit of the ratio - lower limit of the ratio) / (upper limit of the data - lower limit of the data) * (original data value - lower limit of the data) + lower limit of the ratio
    • Decimal Places: the number of decimal places to be retained after arithmetic operations
    • Data High Limit: the upper data limit for a measurement point
    • Data Lower Limit: lower data limit value for the measurement point
    • High Limit Of Proportion: the upper limit of the data after proportional operation
    • Lower Limit Of Proportion: the lower limit value of the data after proportional operation
  • Offset And Zoom: Calculate the original data value according to the multiplier and offset, the formula is calculated data value = (original data value * Magnification) + Offset
    • Decimal places: the number of decimal places to be retained after arithmetic operations
    • Magnification: the magnification needed to zoom in or out
    • Offset: the data value to be increased or decreased after the multiplier operation
  • Bit Truncation: Intercepts a segment of bit data from the original data as a data value; this operation is not supported for FLOAT-type points.
    • Start Bit: Bit offset to start intercepting the original data
    • End Bit: Bit offset to end the interception of the original data
  • PT/CT: Calculate the raw data value according to the magnification, offset, PT and CT, with the formula [(raw value*magnification)+offset]*PT*CT
    • Decimal Places: the number of decimal places to be retained after arithmetic operations
    • Magnification: the magnification needed to zoom in or out
    • Offset: the data value to be increased or decreased after the multiplier operation
    • PT: Additional PT multiplier
    • CT: additional CT magnification
  • Value Mapping: Configurable conversion of specific values of measurement points to other values.
    • Source Value: The original measured point value collected.
    • Target Value: the value of the measurement point after the conversion is expected

HJ212

HJ212-2005-Serial

HJ212-2005 is the earliest version of the HJ212 standard, which was released in 2005. It defines the communication protocol between the monitoring equipment and the data acquisition system, including data frame format, data transmission method, communication parameters, etc.

Adding a controller
  • Name: name of the controller, unique in the list of controllers across the gateway
  • Protocol: select HJ212-2005-Serial
  • Endpoint: support RS232 and RS485, RS485 is used by default.
  • MN: unique identification of the device
  • Password: Access password
  • ST: the system code of the collected points, e.g. the system code for surface water detection is 21.
  • Polling Interval: When enabled, you can configure an additional polling cycle and select certain measurement points under the controller to use that polling cycle. This feature can be used to differentiate between test points that require high and low frequency acquisition, making efficient use of gateway and PLC performance.
  • Description: You can add comment information to this controller.

Advanced Settings:

  • Communication Message Settings:
    • Store Communication Message: Controllers with this function enabled will store communication messages, and the path and number of stored messages can be set in the "Default Parameters" on the "Parameter Settings" page. If you want to download the stored communication messages, you can go to the "Realtime Communication Message" page of the specified controller in the "Measure Monitor" page, and then click the "Download" button to download the messages.
  • Timeout Settings:
    • Timeout: When collecting measurement points, after initiating a read request to the device, the device responds to the timeout time, if the device does not respond to the read request within the set acquisition timeout time, it is still a failure of this acquisition.
Adding measuring points
  • Measuring Point Name: the name of the measurement point (the name of the measurement point cannot be repeated under the same controller)
  • Monitoring Factor Coding:support "-Rtd" and "-Flag" two kinds of numbered factors.
  • Data types: Data type is supported if the monitoring factor coding is "-Rtd":
    • BIT: 0 or 1
    • BYTE: 8-bit unsigned integer
    • SINT: 8-bit signed integer
    • WORD: 16-bit unsigned integer
    • INT: 16-bit signed integer
    • DWORD: 32-bit unsigned integer
    • DINT: 32-bit signed integer
    • FLOAT: 32-bit floating point number
    • DOUBLE: 64-bit floating point number
    • ULONG: 64-bit unsigned integer
    • LONG: 64-bit signed integer
    • If the monitoring factor coding is "-Flag", only the STRING type is supported
    • STRING: 8-bit string
    • BCD16: 16-bit BCD code
  • Decimal Places: The length of the data after the decimal point of the measuring point when the data type is FLOAT or DOUBLE, up to 6 digits.
  • Size: the length of the string when the data type is STRING.
  • Character Encoding Format: ASCII. Only the Data Type selection STRING is valid.
  • Read Bit Data: Enabled to read the value of any bit of data in an integer.
  • Register Bit: The bit offset of the measurement point when reading bit data after turning on Read Bit Data.
  • Negative Value: When turn on Read Bit Data, you can choose whether or not to invert the read result.
  • Numerical mapping: maps 0 and 1 values of BIT-type points to False and True when enabled
  • Read/Write:
    • Read: read only, not write
  • Mode:
    • Periodic: data is reported regularly according to the reporting cycle of the subgroup to which it belongs.
    • Onchange: data is reported regularly according to a grouped reporting cycle only when there is a change in the value of the measurement point.
    • Never: local use only, no need to upload data from the cloud
  • Onchange Deadzone: When the upload mode is Onchange, you can set the value change within a certain range to be considered as no change in the value. If the data has configured data operation, then according to the value after the operation to detect whether the value change exceeds the dead zone.
  • Unit: measurement point unit
  • Description: Description of the measurement point
  • Group: Subgroup to which the measurement point belongs
  • Store Historical Data: When enabled, a historical data table will be generated with the name of the group to which the measurement point belongs, and the historical data will be stored according to the storage policy set by the group. The stored historical data can be exported as CSV files or obtained by calling the Python API.
  • Data Calculation: Simple arithmetic processing through data arithmetic is supported when the data type of the measurement point is not BIT or STRING, and the processed data values can be reported to the cloud platform. The values mapped to protocol conversions (Modbus Slave or OPC UA Server, etc.) are by default the raw data values collected rather than the calculated data values.
  • No: no arithmetic is performed, the collected raw data values are used
  • Ratio Conversion: The collected data value is mapped to a data value in the range of the upper and lower limits of the scale in equal proportions according to the range of the upper and lower limits of the data, such as mapping the data collected in the sensor to the actual temperature and humidity. Calculation formula for the calculated data value = (upper limit of the ratio - lower limit of the ratio) / (upper limit of the data - lower limit of the data) * (original data value - lower limit of the data) + lower limit of the ratio
    • Decimal Places: the number of decimal places to be retained after arithmetic operations
    • Data High Limit: the upper data limit for a measurement point
    • Data Lower Limit: lower data limit value for the measurement point
    • High Limit Of Proportion: the upper limit of the data after proportional operation
    • Lower Limit Of Proportion: the lower limit value of the data after proportional operation
  • Offset And Zoom: Calculate the original data value according to the multiplier and offset, the formula is calculated data value = (original data value * Magnification) + Offset
    • Decimal places: the number of decimal places to be retained after arithmetic operations
    • Magnification: the magnification needed to zoom in or out
    • Offset: the data value to be increased or decreased after the multiplier operation
  • Bit Truncation: Intercepts a segment of bit data from the original data as a data value; this operation is not supported for FLOAT-type points.
    • Start Bit: Bit offset to start intercepting the original data
    • End Bit: Bit offset to end the interception of the original data
  • PT/CT: Calculate the raw data value according to the magnification, offset, PT and CT, with the formula [(raw value*magnification)+offset]*PT*CT
    • Decimal Places: the number of decimal places to be retained after arithmetic operations
    • Magnification: the magnification needed to zoom in or out
    • Offset: the data value to be increased or decreased after the multiplier operation
    • PT: Additional PT multiplier
    • CT: additional CT magnification
  • Value Mapping: Configurable conversion of specific values of measurement points to other values.
    • Source Value: The original measured point value collected.
    • Target Value: the value of the measurement point after the conversion is expected
    • Enable Package Reporting: This field is visible when the controller enables group packet reporting. When the measuring point is enabled, it will report data in accordance with the packet reporting logic set by the controller in addition to the group reporting data

HJ212-2017-Serial

HJ212-2017 is an update and improvement of the original HJ212 standard, released in 2017. It optimises and extends the 2005 protocol, making data transmission more stable, reliable and efficient.

Adding a controller
  • Name: name of the controller, unique in the list of controllers across the gateway
  • Protocol: select HJ212-2017-Serial
  • Endpoint: support RS232 and RS485, RS485 is used by default.
  • MN: unique identification of the device
  • Password: Access password
  • Status expiration time: if no new message is received from the controller or measurement point within the specified time, the status will be automatically updated to offline.
  • Description: You can add comment information to this controller.

Advanced Settings:

  • Communication Message Settings:
    • Store Communication Message: Controllers with this function enabled will store communication messages, and the path and number of stored messages can be set in the "Default Parameters" on the "Parameter Settings" page. If you want to download the stored communication messages, you can go to the "Realtime Communication Message" page of the specified controller in the "Measure Monitor" page, and then click the "Download" button to download the messages.
Adding measuring points
  • Measuring Point Name: the name of the measurement point (the name of the measurement point cannot be repeated under the same controller)
  • Monitoring Factor Coding:support "-Rtd" and "-Flag" two kinds of numbered factors.
  • Data types: Data type is supported if the monitoring factor coding is "-Rtd":
    • BIT: 0 or 1
    • BYTE: 8-bit unsigned integer
    • SINT: 8-bit signed integer
    • WORD: 16-bit unsigned integer
    • INT: 16-bit signed integer
    • DWORD: 32-bit unsigned integer
    • DINT: 32-bit signed integer
    • FLOAT: 32-bit floating point number
    • DOUBLE: 64-bit floating point number
    • ULONG: 64-bit unsigned integer
    • LONG: 64-bit signed integer
    • If the monitoring factor coding is "-Flag", only the STRING type is supported
    • STRING: 8-bit string
    • BCD16: 16-bit BCD code
  • Decimal Places: The length of the data after the decimal point of the measuring point when the data type is FLOAT or DOUBLE, up to 6 digits.
  • Size: the length of the string when the data type is STRING.
  • Character Encoding Format: ASCII. Only the Data Type selection STRING is valid.
  • Read Bit Data: Enabled to read the value of any bit of data in an integer.
  • Register Bit: The bit offset of the measurement point when reading bit data after turning on Read Bit Data.
  • Negative Value: When turn on Read Bit Data, you can choose whether or not to invert the read result.
  • Numerical mapping: maps 0 and 1 values of BIT-type points to False and True when enabled
  • Read/Write:
    • Read: read only, not write
  • Mode:
    • Periodic: data is reported regularly according to the reporting cycle of the subgroup to which it belongs.
    • Onchange: data is reported regularly according to a grouped reporting cycle only when there is a change in the value of the measurement point.
    • Never: local use only, no need to upload data from the cloud
  • Onchange Deadzone: When the upload mode is Onchange, you can set the value change within a certain range to be considered as no change in the value. If the data has configured data operation, then according to the value after the operation to detect whether the value change exceeds the dead zone.
  • Unit: measurement point unit
  • Description: Description of the measurement point
  • Group: Subgroup to which the measurement point belongs
  • Store Historical Data: When enabled, a historical data table will be generated with the name of the group to which the measurement point belongs, and the historical data will be stored according to the storage policy set by the group. The stored historical data can be exported as CSV files or obtained by calling the Python API.
  • Data Calculation: Simple arithmetic processing through data arithmetic is supported when the data type of the measurement point is not BIT or STRING, and the processed data values can be reported to the cloud platform. The values mapped to protocol conversions (Modbus Slave or OPC UA Server, etc.) are by default the raw data values collected rather than the calculated data values.
  • No: no arithmetic is performed, the collected raw data values are used
  • Ratio Conversion: The collected data value is mapped to a data value in the range of the upper and lower limits of the scale in equal proportions according to the range of the upper and lower limits of the data, such as mapping the data collected in the sensor to the actual temperature and humidity. Calculation formula for the calculated data value = (upper limit of the ratio - lower limit of the ratio) / (upper limit of the data - lower limit of the data) * (original data value - lower limit of the data) + lower limit of the ratio
    • Decimal Places: the number of decimal places to be retained after arithmetic operations
    • Data High Limit: the upper data limit for a measurement point
    • Data Lower Limit: lower data limit value for the measurement point
    • High Limit Of Proportion: the upper limit of the data after proportional operation
    • Lower Limit Of Proportion: the lower limit value of the data after proportional operation
  • Offset And Zoom: Calculate the original data value according to the multiplier and offset, the formula is calculated data value = (original data value * Magnification) + Offset
    • Decimal places: the number of decimal places to be retained after arithmetic operations
    • Magnification: the magnification needed to zoom in or out
    • Offset: the data value to be increased or decreased after the multiplier operation
  • Bit Truncation: Intercepts a segment of bit data from the original data as a data value; this operation is not supported for FLOAT-type points.
    • Start Bit: Bit offset to start intercepting the original data
    • End Bit: Bit offset to end the interception of the original data
  • PT/CT: Calculate the raw data value according to the magnification, offset, PT and CT, with the formula [(raw value*magnification)+offset]*PT*CT
    • Decimal Places: the number of decimal places to be retained after arithmetic operations
    • Magnification: the magnification needed to zoom in or out
    • Offset: the data value to be increased or decreased after the multiplier operation
    • PT: Additional PT multiplier
    • CT: additional CT magnification
  • Value Mapping: Configurable conversion of specific values of measurement points to other values.
    • Source Value: The original measured point value collected.
    • Target Value: the value of the measurement point after the conversion is expected
  • Enable Package Reporting: This field is visible when the controller enables group packet reporting. When the measuring point is enabled, it will report data in accordance with the packet reporting logic set by the controller in addition to the group reporting data

IEC 60870

IEC 101

IEC 101 is a standard protocol developed by the International Electrotechnical Commission (IEC) for telecommunication. It is a communication protocol for monitoring and control of power systems, which is mainly used for applications such as remote monitoring, control, data acquisition and protection in power systems.

Adding a controller
  1. Name: The name of the controller, which is unique in the controller list for the entire gateway
  2. Protocol: IEC 101 is selected
  3. Communication Mode: support “Balanced Transmission” and “Unbalanced Transmission”, “Unbalanced Transmission” only supports one side of the communication at the same time to send data, belongs to half duplex, suitable for RS485 scenario, “Balanced Transmission” can support both sides of the communication to send data at the same time, belongs to full duplex, suitable for RS232 scenario
  4. Link Address Size: support 1 and 2. The number of bits or bytes used to represent the address of a device in the link layer
  5. Link Address: A unique identifier used in the link layer to identify a communicating device
  6. ASDU Size: The byte length of the application service data unit, which is the length of the CA public address, the ASDU field is used to distinguish different sub-stations on this link. If more than one substation needs to be collected, more than one controller needs to be configured. 1 and 2 are supported, the default is 2, in bytes
  7. ASDU Address: Application service data unit public address, also known as CA public address. An address or identifier used in a protocol to identify and distinguish between different ASdus
  8. IOA Size: information object address byte length, the length of IOA determines the number and range of monitoring points, the default is 2, unit byte
  9. COT Size: transmission cause byte length, determines the number of transmission causes that can be represented, the default is 2, unit byte
  10. Originator Address: Used to identify the address of the device or system that sends the data packet, identifying the source of the data packet
  11. Endpoint: support RS485 and RS232
  12. General Interrogation Interval: the time interval during which the system regularly sends the total call command
  13. Counter Interrogation Interval: The time interval at which the control system regularly sends the power total call command
  14. Description: Note information can be added to this controller
Advanced Settings:
  1. Timeout: The timeout time of the device response after the reading request is initiated to the device when the measuring point is collected. If the device does not respond to the reading request within the set collection timeout time, it is still the failure of this collection.
  1. Link confirmation timeout: the maximum time for the initiator to wait for a response from the receiver when a packet is interacting
  1. Clock Sysc: When enabled, a clock synchronization command is periodically sent to the slave device to inform the device of the current system time or calibration value
  1. Clock Sync Interval: The frequency at which clock synchronization commands are sent
  1. Operate Mode: supports "Direct Operate" and "Select then Operate ". The "Direct Operate" command is sent directly by the master station to the remote device, and the device performs the corresponding operation immediately after receiving the command, without waiting for additional confirmation or response. In the " Select then Operate" mode, the master station first sends a selection command to the remote device, which indicates that the device is ready to perform a specific action, but does not execute it immediately for the time bei