User Tools

Site Tools


Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
registers [2018/11/23 21:59]
akuzmuk [Creating a register, basic settings]
registers [2020/07/31 14:21] (current)
atolstov [Dictionary]
Line 1: Line 1:
 ====== Working with registers ====== ====== Working with registers ======
 ===== General information ===== ===== General information =====
- 
- 
 In the world of industrial automation, //​Registers//​ are understood as units of data that are attributes of automation equipment. They can describe some external parameters of technological processes (the value of temperature,​ pressure, flow, state of actuators, etc.) or internal states of the devices themselves (parameters of regulators, filters, alarms etc.). In the world of industrial automation, //​Registers//​ are understood as units of data that are attributes of automation equipment. They can describe some external parameters of technological processes (the value of temperature,​ pressure, flow, state of actuators, etc.) or internal states of the devices themselves (parameters of regulators, filters, alarms etc.).
  
Line 31: Line 29:
   ***Connection** the registers belongs to    ***Connection** the registers belongs to 
   ***Title** register'​s name   ***Title** register'​s name
-  ***Address** The address in the address space of this connection. While entering value, the address validation is being made. Address assignment ​formats are described ​[here].+  ***Address** The address in the address space of this connection. While entering value, the address validation is being made. Address assignment ​format depends upon protocol type and usually comprised of a '​letter + digit' sequence. The letter indicates memory address space and the digit is an offset in this memory. See [[supported_protocols]].
   ***Description** - description field for the register   ***Description** - description field for the register
   ***Category** - the name of the group to which the register will be included.   ***Category** - the name of the group to which the register will be included.
Line 59: Line 57:
   *String - the system will treat data in the register as string data. Intended mainly to use with internal Sxx registers.  ​   *String - the system will treat data in the register as string data. Intended mainly to use with internal Sxx registers.  ​
  
-=== Value format ===+==== Value format ​====
 Specifies the format of the read data. Possible options are: Specifies the format of the read data. Possible options are:
   *Unsigned integer ​   *Unsigned integer ​
Line 70: Line 68:
   *Singned Floating Point 24 bit(such format is used in OWEN devices e.g.)    *Singned Floating Point 24 bit(such format is used in OWEN devices e.g.) 
  
-=== Bit mask ===+==== Bit mask ====
 Bit mask allows to conviniently check the state of individual bits in a source register. ​ Bit mask allows to conviniently check the state of individual bits in a source register. ​
 When setting the bitmask to the register, the value from the register will be compared with the sum of corresponding weights 2^p (p - bit position, starting from 0) of the selected bits.  When setting the bitmask to the register, the value from the register will be compared with the sum of corresponding weights 2^p (p - bit position, starting from 0) of the selected bits. 
Line 80: Line 78:
 But sometimes it is neccessary to write a defined mask (group of bits) to the end device. In this case remember how the number in WebHMI register is obtain. E.g. to set 7th and 6th bit (started from 0) in the source register, 3 value has to be written in WebHMI register. Or if 7th and zero bits were checked in the mask, 129 would have to be written to set these bits. But sometimes it is neccessary to write a defined mask (group of bits) to the end device. In this case remember how the number in WebHMI register is obtain. E.g. to set 7th and 6th bit (started from 0) in the source register, 3 value has to be written in WebHMI register. Or if 7th and zero bits were checked in the mask, 129 would have to be written to set these bits.
  
-=== Delta format ===+==== Delta format ​====
 Allows you to convert register data into increment or derivative. ​ Allows you to convert register data into increment or derivative. ​
 {{::​delta_format.png?​direct&​600|}} {{::​delta_format.png?​direct&​600|}}
Line 86: Line 84:
 In the first case (delta value), the register will be equal to the difference of the current subtracted value and the previous one. In the second (Delta value / Delta time) - delta value, divided by the time between polls, i.e. Derivative with respect to time. In the first case (delta value), the register will be equal to the difference of the current subtracted value and the previous one. In the second (Delta value / Delta time) - delta value, divided by the time between polls, i.e. Derivative with respect to time.
  
-=== Display as time duration ===+==== Display as time duration ​====
 Show the number in seconds in the format of the length of the time interval (hours, days, etc.). The format is useful, for example, when displaying the duration of events. Show the number in seconds in the format of the length of the time interval (hours, days, etc.). The format is useful, for example, when displaying the duration of events.
  
-=== Dictionary ===+==== Dictionary ​====
 Contains the enumeration of pairs '​value,​ text word(s)',​ when you select a dictionary for the register, the values ​​read from the device are compared with the data of the dictionary and, if the word matches, the word corresponding to the value will be found. If there is a mismatch, the register will contain the value itself. The dictionaries are created and edited in the menu Setup -> Dictionary. Contains the enumeration of pairs '​value,​ text word(s)',​ when you select a dictionary for the register, the values ​​read from the device are compared with the data of the dictionary and, if the word matches, the word corresponding to the value will be found. If there is a mismatch, the register will contain the value itself. The dictionaries are created and edited in the menu Setup -> Dictionary.
 {{::​dictionary.png?​direct&​800|}} {{::​dictionary.png?​direct&​800|}}
  
-If third element in a row is set (e.g. "1, ON, client:​dashboards.divider.on"), Level2 cloud system can interpret it like a tag and use its own dictionary with multilanguage support. ​+If third element in a row is set (e.g. ''​1, ON, client:​dashboards.divider.on''​), Level2 cloud system can interpret it like a tag and use its own dictionary with multilanguage support. ​
  
-=== Units of measurement ===+==== Units of measurement ​====
 Indication of engineering units for the register data. The string specified in the field will be displayed after the text string with the register value on dashboards. ​ Indication of engineering units for the register data. The string specified in the field will be displayed after the text string with the register value on dashboards. ​
  
-=== Value Calculations ===+==== Value Calculations ​====
 Show the result of the formula: Show the result of the formula:
 result = value_read х **multiplier** + **shift value** result = value_read х **multiplier** + **shift value**
 Scaling value with offset in the register to convert raw value from ADC to engineering units. The result is shown with the set **precision**. Scaling value with offset in the register to convert raw value from ADC to engineering units. The result is shown with the set **precision**.
-=== Min/Max Allowed Value For Operator === +==== Min/Max Allowed Value For Operator ​==== 
 These fields allow you to limit the min. and max. possible value for the register, which can be changed by the user from the dashboard. These fields allow you to limit the min. and max. possible value for the register, which can be changed by the user from the dashboard.
-=== Min/Max Reasonable Value ===+==== Min/Max Reasonable Value ====
 These fields allow to designate a zone of unreliable values ​​of the register, thus it is possible to judge the sensor failure. When reading the value outside the zone, a nil will be written to the register, which in turn can be defined as a '​failed state'​. ​ These fields allow to designate a zone of unreliable values ​​of the register, thus it is possible to judge the sensor failure. When reading the value outside the zone, a nil will be written to the register, which in turn can be defined as a '​failed state'​. ​
  
Line 119: Line 117:
 But sometimes there is a need to track values more precisely, e.g. to view signal transitions,​ rising or falling edges of the discrete signals etc. Then there is an option to use log data.  But sometimes there is a need to track values more precisely, e.g. to view signal transitions,​ rising or falling edges of the discrete signals etc. Then there is an option to use log data. 
  
-=== Writing registers to the log === +==== Writing registers to the log ==== 
 In this section '​Log'​ means a separate part of a database which saves register values and: In this section '​Log'​ means a separate part of a database which saves register values and:
   *it can be a source of data for graphs   *it can be a source of data for graphs
Line 213: Line 211:
   ***Edit, Delete, Clone** buttons - corresponds to editing, deleting or cloning register(connection).   ***Edit, Delete, Clone** buttons - corresponds to editing, deleting or cloning register(connection).
  
-=== Group operations ===  +==== Bulk operations ​==== 
-== Working with selections == +It is also known as Group operations 
 +=== Working with selections ​=== 
 When the cursor hovers over the connection, a checkbox appears to the right of it for selecting or deselecting all registers in the connection. ​ When the cursor hovers over the connection, a checkbox appears to the right of it for selecting or deselecting all registers in the connection. ​
  
Line 221: Line 220:
 There are some group operations inside **Tools** sub-menu for selected register - see below. ​ There are some group operations inside **Tools** sub-menu for selected register - see below. ​
  
-{{::reg_group_ops.png?​direct&​800|}}+{{ ::tools_menu_new.png?​direct&​400 |}} 
  
   ***Export registers** - export selected register in a *.csv file to have a template or make some bulk modification using convenient spreadsheet editor   ***Export registers** - export selected register in a *.csv file to have a template or make some bulk modification using convenient spreadsheet editor
 +  ***Export register values** - export the current values of the selected registers to a csv-file
   ***Disable** - disable polling of the selected register   ***Disable** - disable polling of the selected register
   ***Enable** - enable polling of the selected register   ***Enable** - enable polling of the selected register
Line 249: Line 250:
  
 Another possible use for map is to quickly find some internal register in a list, using browser hotkey F3 or Crtl-F. And quickly follow the link to view register'​s settings. Another possible use for map is to quickly find some internal register in a list, using browser hotkey F3 or Crtl-F. And quickly follow the link to view register'​s settings.
- 
- 
- 

Page Tools