To retrieve wiring information, Smart Instrumentation uses macros that are identified by their macro name, together with appropriate parameters needed to retrieve specific tag data.
When you create a tag number and a matching device panel, the software creates a group that includes all the wires associated with that specific tag. Each wire can belong to one group only. After you connect a cable with the device panel, the software sorts the wires into different group levels. Every connection of a wire to a terminal is assigned a group sequence that maps and numbers the connections starting with the value '1' that is usually on the device panel side.
The following diagram is an example that explains the meaning of wire groups.
Before you can start to build typical wiring drawing blocks, you need to know:
-
How to identify typical wiring routing.
-
The number of routing levels, usually determined by the number of wires connected to the device-panel, but this may be different if, for example, a power supply is involved.
-
The group sequence that each wire and terminal connection has in the current typical routing.
Syntax
The syntax used for wiring macros is as follows:
[Macro_name.x.y]
where the letter 'x' designates the group level and the letter 'y' designates the group sequence.
Examples
The following examples show how the wiring macro syntax is used to retrieve specific data for a terminal and for a wire:
-
To retrieve the number of the terminal at Group Level 1 and Group Sequence 3, the required macro is TERM_NUM.1.3.
-
To retrieve the color of the wire at Group Level 2 and Group Sequence 2, the required macro is W_CLR.2.2.
-
When retrieving data for a wire, you may use the group sequence corresponding to either of the wire ends, so for example, to extract the wire name for the wire at Group Level 2 whose ends have sequence numbers 3 and 4, you may use either macro W_TAG.2.3 or W_TAG.2.4.
-
Control system macros do not require the 'y' (group sequence) parameter.
-
If you generate a loop drawing with tag numbers that have incomplete wiring, the macros will not be able to retrieve all the needed wiring information since propagation is bi-directional: from the field device and from the Control System.
-
The software does not order wire sequence numbers sequentially until the propagation process finds signal continuity between the field device and the Control System.
-
Special macros exist to extract data related to an overall shield. The macro for a wire that is used as an overall shield has the format [NOSHW_TAG.x.y.] and the macro for a terminal to which an overall shield is connected has the format [NOSHT_NUM.x.y.]. For these macros to function properly, the following conditions must be met:
-
The polarity of the wire must be designated as Shield.
-
The level and sequence of at least one of the wires in the cable must be defined.
-
-
For CAD drawings only, if required, you can associate each macro with a macro function, which determines how the software performs string manipulation on the target data. For example, a macro function can retrieve the entire target data string or just part of the data string and display it on the generated drawing. Associating a macro function with a macro is optional.
-
The general format of a wiring macro that includes a user-defined macro function is [Macro_name.F1.x.y].
Your user defined macro names must be unique, do not copy or use existing macro names
as this results in the macros failing to display correctly.