2
Concepts
, functions and gateway design
UGW X-series
Concepts, functions and gateway design
10 of 66
2.5
Configuration and project planning
2.5.1
Control via text files
The gateway is configured using text files. For each driver, there is a file (*.cfg) with communication
parameters (e.g. baud rate) and a file (*.txt) in which the driver-specific data points are defined. The
file named
dispatch.txt
contains the mappings of the data points of the various protocols.
All text
files can be edited or created and imported in advance in the web client of the UGW.
Example: Downloaded text and configuration files:
All the text files have the same basic layout:
There are so-called
sections
which begin with a line with the data point definition in square
brackets. The lines following belong to such a section up to the next section or to the end of the file.
The lines following the section name have the structure
keyword = value
.
The files can also include blank and comment lines at any point (introduced by the # character).
Capitalisation is taken into account.
Example 1 of file format
# Comment first line of file
comment line
# First data point comment line
[address1]
Start of section with address
address1
name = first example data point
key name with value of first example data point
further_properties = 7
Key of further properties with value 7
[address2]
Start of section with address
address2
# Another comment
comment line
name = second example data point
key name
# Comment last line
comment line
Example 2 of file format
# Data point list
comment line
[S local.BI 1]
Start of section 1
name = Failure Slave 1
key name
bac_description = Failure Slave 1
query = pe
writecache = yes
bac_polarity = 0
bac_time_delay = 0
bac_alarm_value = 1
bac_notify_type = event
bac_event_enable = (1,1,1)
bac_inactive_text = available
bac_active_text = error [Y local.AI 1001]
Start of section 2
name = Slave 1 Value 1
Key name with value of second example data point
query = pe
writecache = yes
bac_units = 95
bac_cov_increment = 0
bac_resolution = 0.1
