Point Builder Utility is a tool designed for creating PI Points for the Citect interface. It reads information from Citect variable and/or trend tables and creates files with PI Points in CSV or PIConfig format.
Point Builder Utility creates the following PI Attributes:
-
PI Attribute
|
Citect Field
|
Default Value
|
Commentary
|
Tag
|
NAME
|
NAME
|
Prefix and suffix added to NAME field if they are specified by the user
|
PointSource
|
n/a
|
none
|
Specified by the user
|
PointType
|
TYPE
|
none
|
|
DigitalSet
|
n/a
|
DefaultSet
|
Calculated according set of rules specified by the user
|
Location1
|
n/a
|
1
|
Interface ID
|
Location2
|
n/a
|
0
|
Input(0) or Output(1) tag
|
Location3
|
n/a
|
0
|
|
Location4
|
n/a
|
1
|
Scan class specified by the user
|
InstrumentTag
|
NAME
|
NAME
|
|
Descriptor
|
COMMENT, UNIT or ADDR
|
COMMENT
|
User can choose which Citect field is used for this attribute.
|
EngUnits
|
ENG_UNITS
|
|
|
Zero
|
ENG_ZERO or RAW_ZERO
|
ENG_ZERO
|
|
Span
|
ENG_FULL – ENG_ZERO or RAW_FULL – RAW_ZERO
|
ENG_FULL – ENG_ZERO
|
|
Shutdown
|
n/a
|
0
|
Always 0 for all tags
|
Point type attribute will be assigned to PI tag according the following table:
-
Citect Point Type
|
PI Point Type
|
BCD
|
Int32
|
BYTE
|
Int16
|
DIGITAL
|
Digital
|
INT
|
Int32
|
LONG
|
Int32
|
LONGBCD
|
Int32
|
REAL
|
Float32
|
STRING
|
String
|
UINT
|
Int32
|
Configuration Tab
When Point Builder Utility run for the first time no configuration exists and “Create Points File” and “Display Points” buttons are disabled. The text boxes with missing or wrong settings are highlighted in yellow color indicating the bad values.
PI Point Attributes section
-
Tag Prefix – if not empty the text will be added in front of Citect point name. For example, if Citect “NAME” field is “SomeTag” and Tag Prefix is “Unit1:” PI tag name will be “Unit1:SomeTag”.
-
Tag Suffix – if not empty the text will be added after Citect point name.
-
PointSource – PointsSource PI attribute for all tags.
-
Location1 – Location1 PI attribute for all tags.
-
Location2 – Location2 PI attribute. If Citect PI Interface option is selected the user can specify desired Location2 and this value will be used for all PI Tags. If OPC interface option is selected the Location2 text box is disabled. The Location2 attribute value depends on Citect Point Type and will be assigned to tags according the following table:
-
Citect Point Type
|
Location2 for OPC interface
|
String
|
1
|
Digital
|
2
|
All other types
|
0
|
-
Location3 – Location3 PI attribute for all tags. If Citect PI Interface option is selected the Location3 text box is disabled and default value 0 will be assigned to all tags. If OPC interface option is selected the user can specify desired Location3 value and this value will be assigned to all PI Tags. The valid Location3 values for OPC Interface option are 0, 1, or 2.
-
Location4 – Location4 PI attribute for all tags.
-
Zero – Citect field to be used for Zero PI attribute. The possible values are “ENG_ZERO” or “RAW_ZERO”.
-
Span – Citect fields calculation to be used for Span PI attribute. The possible values are “ENG_FULL - ENG_ZERO” or “RAW_FULL - RAW_ZERO”. Note that the matching values should be used for Zero and Span. If “ENG…” is selected for Zero attribute the “ENG…” will automatically selected for Span attribute as well and vice versa.
-
Descriptor – Citect field to be used for Descriptor PI attribute. The possible values are “COMMENT” , “UNIT” or “ADDR”.
-
Use Trend Table for additional info – This option is enabled only if “COMMENT” field is used for Descriptor PI Attribute. If this option is selected the Point Builder utility will additionally look for not empty COMMENT field in Trend table in case if COMMENT field in Variable table is empty for given Citect point. If not empty COMMENT found for this point it will be used for Descriptor attribute. If this option is not selected (default setting) and COMMENT field in Variable table is empty no further search will be done and empty Descriptor will be assigned to this PI Point.
Variable file
The variable.dbf file represents variable table used for Citect point attributes. If selected file has wrong format (not a dbf file) or doesn’t have all required fields the error message will be displayed when user attempts to select such file.
There are some differences in PI Tag attributes (Location2 and Location3) depending on where the tags are sourced. The two options are available – Citect Interface or OPC interface.
PI Points file section
Two formats for generated PI Point file are available: CSV format and PI Config format. The CSV file can be used directly in PI Tag Configurator – PISMT Excel addin. The PI Config file can be used as input file for PIConfig. See PI System User manual for more details.
-
Symbol to replace comma in fields. If there is comma symbol in Citect fields it will be replaced by another character specified by the user. The available options are: semicolon, space and underscore.
-
PI Points file name – File name and path for output file.
When all settings are correct the buttons “Create Points File” and “Display Points” are enabled.
Digital Sets Tab
Here user can specify default set name for Digital tags and create list of rules.
If no rules are specified the default set will be used for all digital tags. If Default Set Name text box is empty it will have yellow backcolor specifying the wrong setting. The “Create Points File” and “Display Points” buttons will be disabled.
Digital Set naming frame is used to create the rules for Digital set naming.
Each rule has Condition and Set Name fields. If condition is true the Set Name will be used for DigitalSet PI Attribute for given Citect Digital point.
For example, the first rule is if Citect COMMENT filed equal *DUMMY* then digital set name for tags with this comment will be “DummySet”.
Note the wildcard characters in *DUMMY*. It means that all comment fields containing DUMMY pattern will match this condition.
The ? wildcard is also supported. It means one any character.
More complex conditions are available. Condition can be created using “Build” button.
In that case the NAME field should match *ABC?Tag pattern and COMMENT field shouldn’t contain DUMMY pattern. Her 2 Citect fields are used to create rule.
The order of rules in the list is important. The first condition is checked first; if it doesn’t match, the second condition checked and so on. If no conditions are true for COMMENT and/or NAME Citect fields then the Default Set name is used.
Point Builder Tab
The settings can be tested with “Display Points” button. The output PI Points file will not be created, but all points and attributes will be displayed in the grid. For creating Points file the “Create Points File” button should be used.
Save Settings button is used to save current setting in PointBuilder.ini file. This file located in the same directory where the Point Builder utility is.
When Point Builder utility run for the first time the settings file doesn’t exist. When settings are saved the file will be created and used by Point Builder Utility in feature.
Share with your friends: |