Overcurrent Automation Interface Manual
Overcurrent Automation Interface Manual
Automation Interface
OMICRON Test Universe
2
OMICRON Test Universe Overcurrent Automation Interface
1 Contents
1 Contents .............................................................................................................................................................3
2 Introduction........................................................................................................................................................8
3 Object Hierarchy .................................................................................................................................................9
4 Reference..........................................................................................................................................................10
4.1 Application Object......................................................................................................................................10
4.1.1 Properties ............................................................................................................................................10
[Link] Application (read only)..................................................................................................................10
[Link] Constants (read only) ....................................................................................................................10
[Link] Document (read only) ...................................................................................................................11
[Link] Name (read only) ..........................................................................................................................11
[Link] Parent (read only)..........................................................................................................................11
[Link] Visible ...........................................................................................................................................12
4.1.2 Methods..............................................................................................................................................12
[Link] Quit ..............................................................................................................................................12
4.2 Document Object .......................................................................................................................................13
4.2.1 Properties ............................................................................................................................................13
[Link] Application (read only)..................................................................................................................13
[Link] ChangeAllowed (read only) ...........................................................................................................13
[Link] Comment......................................................................................................................................13
[Link] HwInfo (read only) ........................................................................................................................14
[Link] Parent(read only)...........................................................................................................................14
[Link] PuDoTest (read only) .....................................................................................................................14
[Link] Shots (read only) ...........................................................................................................................14
[Link] TestObject (read only) ...................................................................................................................15
[Link] TestSettings (read only) .................................................................................................................15
[Link] Version (read only) ......................................................................................................................15
4.2.2 Methods..............................................................................................................................................16
[Link] UpdateAllViews(hint) ....................................................................................................................16
4.3 TestSettings Object.....................................................................................................................................17
4.3.1 Properties ............................................................................................................................................17
[Link] AbsMaxTime .................................................................................................................................17
[Link] Application (read only)..................................................................................................................17
[Link] BinaryOutputs (read only) .............................................................................................................17
[Link] DelayTime .....................................................................................................................................17
[Link] FaultType ......................................................................................................................................18
[Link] FaultVAngle ..................................................................................................................................18
[Link] LoadIsRel ......................................................................................................................................19
[Link] LoadCurrent..................................................................................................................................19
[Link] LoadCurrentRel .............................................................................................................................19
[Link] PreFaultTime ...............................................................................................................................20
[Link] FaultVoltageLN ...........................................................................................................................20
[Link] FaultVoltageLL ............................................................................................................................20
[Link] GroupOfFault (read only) ............................................................................................................21
[Link] Parent (read only)........................................................................................................................21
3
OMICRON Test Universe Overcurrent Automation Interface
4
OMICRON Test Universe Overcurrent Automation Interface
5
OMICRON Test Universe Overcurrent Automation Interface
6
OMICRON Test Universe Overcurrent Automation Interface
7
OMICRON Test Universe Overcurrent Automation Interface
2 Introduction
The OMICRON OMOvcBND test module provides the capabilities to test overcurrent protective relays. It can be
used stand-alone or embedded in the OMICRON Control Center. In this case, it is possible to use the module as an
Automation Server from any automation client, especially form the Control Center Script Language.
To use the module efficiently, it is very convenient to be well acquainted with its capabilities and testing concept.
Please refer to the OMICRON Overcurrent documentation and on-line help for a detailed description of the
module.
8
OMICRON Test Universe Overcurrent Automation Interface
3 Object Hierarchy
Application
Constants
Document
Test Settings
Binary Outputs
Binary Inputs
Hardware Info
Test Object
Fault Group
Trip Characteristic
User Point
Shots Collection
Shot
Pu/Do Test
9
OMICRON Test Universe Overcurrent Automation Interface
4 Reference
The following section contains the enumeration of all the properties and methods that will be available via
automation in the OMOvcBND module.
4.1.1 Properties
10
OMICRON Test Universe Overcurrent Automation Interface
11
OMICRON Test Universe Overcurrent Automation Interface
[Link] Visible
Syntax: [Link]
Type: Boolean
Description: Shows/hides the main application window.
Example: Dim otm As Object
Dim Ovc As Object
Set otm = [Link](“[Link]”)
Set Ovc = [Link]
'Is the application visible?
If [Link] then
MsgBox "Application is already visible"
Else 'Make the application visible
[Link] = True
End If
Note: If you use an external OLE Automation controller (e.g. OMICRON Control Center) and you create the
Application Object (Application) therefore starting the OMICRON Overcurrent program, you have to set the visible
property to TRUE before you see the main window of the application.
4.1.2 Methods
[Link] Quit
Syntax: [Link]()
Return Type: none
Description: Terminates execution of the application.
Example: Dim otm As Object
Dim Ovc As Object
Set otm = [Link](1)
Set Ovc = [Link]
[Link]
[Link]
12
OMICRON Test Universe Overcurrent Automation Interface
4.2.1 Properties
[Link] Comment
Syntax: [Link]
Type: String
Description: This property allows access to the comment string that can be shown in the report.
Example: Dim otm As Object
Dim Ovc As Object
Set otm = [Link](“[Link]”)
Set Ovc = [Link]
‘Set comment in the report
[Link] = “This test is simulated”
13
OMICRON Test Universe Overcurrent Automation Interface
14
OMICRON Test Universe Overcurrent Automation Interface
15
OMICRON Test Universe Overcurrent Automation Interface
4.2.2 Methods
[Link] UpdateAllViews(hint)
Syntax: [Link](hint)
Long hint
Return Type: none
Description: This method updates the UI and the report. The optional Hint parameter is used to
add information that the views can interpret. By calling this method without
parameters, all the UI is fully updated.
Example: Dim otm As Object
Dim Ovc As Object
Set otm = [Link](“[Link]”)
Set Ovc = [Link]
[Link] = “This is an Automation test”
[Link]
16
OMICRON Test Universe Overcurrent Automation Interface
4.3.1 Properties
[Link] AbsMaxTime
Syntax: [Link]
Type: Double
Description: Get / Set the maximum fault time – absolute, in seconds.
Example: Dim otm As Object
Dim Ovc As Object
Set otm = [Link](“[Link]”)
Set Ovc = [Link]
Dim settings As Object
Set settings = [Link]
[Link] = 240.0
[Link] DelayTime
Syntax: [Link]
Type: Double
Description: Get / Set the delay time in seconds. This is the time between shots where all the
output magnitudes will be 0.
Example: Dim otm As Object
Dim Ovc As Object
Set otm = [Link](“[Link]”)
Set Ovc = [Link]
Dim settings As Object
Set settings = [Link]
[Link] = 0.1
17
OMICRON Test Universe Overcurrent Automation Interface
[Link] FaultType
Syntax: [Link]
Type: Long
Description: Get / Set the type of fault for which the test will be performed. The Overcurrent
module can only test in one fault loop, this property selects which one is tested.
The possible values for this property are:
FAULT_L1E
FAULT_L2E
FAULT_L3E
FAULT_L1L2
FAULT_L3L1
FAULT_L2L3
FAULT_L1L2L3
FAULT_I0 (Zero-sequence fault)
FAULT_I2 (Negative sequence fault)
Example: Dim otm As Object
Dim Ovc As Object
Dim Con As object
Dim settings As Object
Set otm = [Link](“[Link]”)
Set Ovc = [Link]
Set Con = [Link]
Set settings = [Link]
[Link] = Con.FAULT_L1L2L3 ‘Three-phase fault
[Link] FaultVAngle
Syntax: [Link]
Type: Double
Description: Get / Set the Fault angle for the voltages in degrees. If the [Link]
property is True, this property controls the angle between voltages and current
according to the particular fault model for each fault.
Example: Dim otm As Object
Dim Ovc As Object
Set otm = [Link](“[Link]”)
Set Ovc = [Link]
Dim settings As Object
Set settings = [Link]
[Link] = 45.0
18
OMICRON Test Universe Overcurrent Automation Interface
[Link] LoadIsRel
Syntax: [Link]
Type: Boolean
Description: Get / Set whether the load current is fixed for all shots (False) or different for each
fault and equal to a fraction of the fault current for each point (True).
Example: Dim otm As Object
Dim Ovc As Object
Set otm = [Link](“[Link]”)
Set Ovc = [Link]
Dim settings As Object
Set settings = [Link]
[Link] = True
[Link] LoadCurrent
Syntax: [Link]
Type: Double
Description: Get / Set the Load Current in times In. This setting will be used by the module when
LoadIsRel is False.
Example: Dim otm As Object
Dim Ovc As Object
Set otm = [Link](“[Link]”)
Set Ovc = [Link]
Dim settings As Object
Set settings = [Link]
[Link] = 0.85
[Link] LoadCurrentRel
Syntax: [Link]
Type: Double
Description: Get / Set the Load Current in times Ifault. This setting will be used by the module
when LoadIsRel is True.
Example: Dim otm As Object
Dim Ovc As Object
Set otm = [Link](“[Link]”)
Set Ovc = [Link]
Dim settings As Object
Set settings = [Link]
[Link] = 0.90
19
OMICRON Test Universe Overcurrent Automation Interface
[Link] PreFaultTime
Syntax: [Link]
Type: Double
Description: Get / Set the pre-fault time in seconds
Example: Dim otm As Object
Dim Ovc As Object
Set otm = [Link](“[Link]”)
Set Ovc = [Link]
Dim settings As Object
Set settings = [Link]
[Link] = 0 'Proceed directly to the fault
[Link] FaultVoltageLN
Syntax: [Link]
Type: Double
Description: Get / Set the line to neutral fault voltage, in Volts. This value is linked to
FaultVoltageLL, so changes in one of them are reflected on the other.
Example: Dim otm As Object
Dim Ovc As Object
Set otm = [Link](“[Link]”)
Set Ovc = [Link]
Dim settings As Object
Set settings = [Link]
[Link] = 63.51
[Link] FaultVoltageLL
Syntax: [Link]
Type: Double
Description: Get / Set the line to line fault voltage, in Volts. This value is linked to
FaultVoltageLN, so changes in one of them are reflected on the other.
Example: Dim otm As Object
Dim Ovc As Object
Set otm = [Link](“[Link]”)
Set Ovc = [Link]
Dim settings As Object
Set settings = [Link]
[Link] =110.0
20
OMICRON Test Universe Overcurrent Automation Interface
[Link] RelMaxTime
Syntax: [Link]
Type: Double
Description: Get / Set the maximum fault time – relative, in %.
Example: Dim otm As Object
Dim Ovc As Object
Set otm = [Link](“[Link]”)
Set Ovc = [Link]
Dim settings As Object
Set settings = [Link]
[Link] = 100.0
21
OMICRON Test Universe Overcurrent Automation Interface
[Link] TriggerLogic
Syntax: [Link]
Type: long
Description: Get / Set the logic for the binary trigger. The possible values are:
LOGIC_AND
LOGIC_OR
Example: Dim otm As Object
Dim Ovc As Object
Set otm = [Link](“[Link]”)
Set Ovc = [Link]
Dim settings As Object
Set settings = [Link]
[Link] = [Link].LOGIC_AND
22
OMICRON Test Universe Overcurrent Automation Interface
The OMOvcBND module controls expanded I/O devices, and outputs both in the CMC itself and in the expansion
device(s) can be controlled from this class.
4.4.1 Properties
23
OMICRON Test Universe Overcurrent Automation Interface
24
OMICRON Test Universe Overcurrent Automation Interface
4.5.1 Properties
25
OMICRON Test Universe Overcurrent Automation Interface
The OMOvcBND module controls expanded I/O devices, and inputs both in the CMC itself and in the expansion
device(s) can be controlled from this class.
4.6.1 Properties
26
OMICRON Test Universe Overcurrent Automation Interface
sigidTRIP
sigidSTART
sigidUSER_INPBIN_DEF1
sigidUSER_INPBIN_DEF2
sigidUSER_INPBIN_DEF3
sigidUSER_INPBIN_DEF4
sigidUSER_INPBIN_DEF5
sigidUSER_INPBIN_DEF6
sigidUSER_INPBIN_DEF7
sigidUSER_INPBIN_DEF8
Example: Dim otm As Object
Dim Ovc As Object
Set otm = [Link](“[Link]”)
Set Ovc = [Link]
'Set binary input for TRIP signal
Dim st As Object
Set st = [Link]
Dim trip As Object
Set trip = [Link]([Link])
[Link] = [Link].TRIG_POS
Dim start As Object
Set start = [Link]([Link])
[Link] = [Link].TRIG_DONTCARE
27
OMICRON Test Universe Overcurrent Automation Interface
28
OMICRON Test Universe Overcurrent Automation Interface
4.7.1 Properties
29
OMICRON Test Universe Overcurrent Automation Interface
4.8.1 Properties
30
OMICRON Test Universe Overcurrent Automation Interface
PostProcessTOChanges is called automatically when the TestObject object is destroyed, if any changes had
been made and not processed.
[Link] AddInfo1
Syntax: object.AddInfo1
Type: String
Description: Get / Set the device's additional info / 1.
[Link] AddInfo2
Syntax: object.AddInfo2
Type: String
Description: Get / Set the device's additional info / 2.
[Link] Address
Syntax: [Link]
Type: String
Description: Get / Set the device's address.
[Link] BayAddr
Syntax: [Link]
Type: String
Description: Get / Set the Address of the Bay.
[Link] BayName
Syntax: [Link]
Type: String
Description: Get / Set the Name of the Bay.
31
OMICRON Test Universe Overcurrent Automation Interface
[Link] DebounceTime
Syntax: [Link]
Type: Double
Description: Get / Set the binary inputs debounce time in s.
[Link] DeglitchTime
Syntax: [Link]
Type: Double
Description: Get / Set the binary inputs deglitch time in s.
[Link] DevType
Syntax: [Link]
Type: String
Description: Get / Set the device's type.
[Link] Fnom
Syntax: [Link]
Type: Double
Description: Get / Set the nominal frequency in Hz.
[Link] IMax
Syntax: [Link]
Type: Double
Description: Get / Set the device’s maximum current in A.
This is the highest current that can be applied to the device by the
OMICRON equipment without risk of damage.
[Link] INom
Syntax: [Link]
Type: Double
Description: Get / Set the nominal current in A.
[Link] Iprim
Syntax: [Link]
Type: Double
Description: Get / Set the primary current in A.
[Link] Manufacturer
Syntax: [Link]
Type: String
Description: Get / Set the device manufacturer's description.
32
OMICRON Test Universe Overcurrent Automation Interface
[Link] Name
Syntax: [Link]
Type: String
Description: Get / Set the device name.
[Link] Phases
Syntax: [Link]
Type: Long
Description: Get / Set the device's number of phases.
[Link] ResidualI
Syntax: [Link]
Type: Double
Description: Get / Set the device’s residual I ratio (IN / Inom).
[Link] ResidualV
Syntax: [Link]
Type: Double
Description: Get / Set the device’s residual V ratio (IN / Inom).
[Link] Serial
Syntax: [Link]
Type: String
Description: Get / Set the device’s serial number as string.
[Link] SubsAddr
Syntax: [Link]
Type: String
Description: Get / Set the address of the substation.
[Link] SubsName
Syntax: [Link]
Type: String
Description: Get / Set the device’s serial number as string.
33
OMICRON Test Universe Overcurrent Automation Interface
[Link] VMax
Syntax: [Link]
Type: Double
Description: Get / Set the device’s maximum voltage in V.
This is the highest voltage that can be applied to the device by the
OMICRON equipment without risk of damage.
[Link] VNom
Syntax: [Link]
Type: Double
Description: Get / Set the nominal voltage in V.
[Link] Vprim
Syntax: [Link]
Type: Double
Description: Get / Set the primary voltage in V.
[Link] AutoReset
Syntax: [Link]
Type: Boolean
Description: True if the formula for the automatic calculation of the Reset Time (delay time) is to
be used, False otherwise. Please note that not all characteristics may use the
automatic calculation of the reset time. The parameter is meaningless unless
[Link] is true, although it will be set none the less.
[Link] CurrTolAbs
Syntax: [Link]
Type: Double
Description: Get / Set the Absolute Current Tolerance in times In.
[Link] CurrTolRel
Syntax: [Link]
Type: Double
Description: Get / Set the Relative Current Tolerance in %.
[Link] CurrTToBus
Syntax: [Link]
Type: Boolean
Description: True is the Current transformer is grounded towards the busbar, False if it is
grounded towards the line.
34
OMICRON Test Universe Overcurrent Automation Interface
[Link] Directional
Syntax: [Link]
Type: Boolean
Description: Get / Set whether the module will use Voltages.
[Link] PwrTOnBus
Syntax: [Link]
Type: Boolean
Description: True is the power transformer is grounded on the busbar, False if it is grounded on
the line.
[Link] TimeTolAbs
Syntax: [Link]
Type: Double
Description: Get / Set the Absolute Time Tolerance in seconds.
[Link] TimeTolRel
Syntax: [Link]
Type: Double
Description: Get / Set the Relative Time Tolerance in %.
35
OMICRON Test Universe Overcurrent Automation Interface
[Link] AutoUpdate
Syntax: [Link]
Type: Boolean
Description: Get / Set whether the module will be updated automatically after changes to the
TestObject parameters. If this property is set to False, it is the responsibility of the
programmer to update the module after all the changes are done, by calling the
UpdateAfterChanges method.
This is not a property of the Overcurrent Test Object, but of the TestObject
automation object. Therefore, the variable is destroyed when the TestObject is
destroyed, and is reset to its default value of True every time a new TestObject is
created.
4.9.4 Methods
[Link] UpdateAfterChanges()
Syntax: [Link]()
Return Type: none
Description: Updates the module after changes to the Test Object. If AutoUpdate is True, the
module will be automatically updated after each change to the Test Object. To gain
efficiency, the programmer can set AutoUpdate to False and call this method
expressly after all changes are done. Please note that in that case, the module will be
in an unpredictable state after any changes to the Test Object are made, and until
this method is called.
36
OMICRON Test Universe Overcurrent Automation Interface
4.10.1 Properties
[Link] IGrActive
Syntax: [Link]
Type: Boolean
Description: Get / Set whether the I> protective unit is active. The unit can be configured
regardless of the value of this parameter.
[Link] IGrIpickup
Syntax: [Link]
Type: Double
Description: Get / Set the pickup value for the I> protective unit in times In.
[Link] IGrTimeIndex
Syntax: [Link]
Type: Double
Description: Get / Set the Time index for the tripping characteristic of the I> protective unit. If the
unit is set to Definite Time, this parameter is considered as the operating time, in
seconds. If the unit is set to a curve, this parameter is considered as the time index
for the curve, and has no dimension.
[Link] IGr2Active
Syntax: object.IGr2Active
Type: Boolean
Description: Get / Set whether the I>> protective unit is active. The unit can be configured
regardless of the value of this parameter.
[Link] IGr2Ipickup
Syntax: object.IGr2Ipickup
Type: Double
Description: Get / Set the pickup value for the I>> protective unit in times In.
[Link] IGr2OperTime
Syntax: object.IGr2OperTime
Type: Double
Description: Get / Set the operating time for the I>> protective unit, in seconds.
37
OMICRON Test Universe Overcurrent Automation Interface
[Link] IGr3Active
Syntax: object.IGr3Active
Type: Boolean
Description: Get / Set whether the I>>> protective unit is active. The unit can be configured
regardless of the value of this parameter.
[Link] IGr3Ipickup
Syntax: object.IGr3Ipickup
Type: Double
Description: Get / Set the pickup value for the I>>> protective unit in times In.
[Link] IGr3OperTime
Syntax: object.IGr3OperTime
Type: Double
Description: Get / Set the operating time for the I>>> protective unit, in seconds.
[Link] ResetRatio
Syntax: [Link]
Type: Double
Description: Get / Set the nominal Reset Ratio (Ipickup / Idropoff) for the group. If
[Link] is True, this will be the nominal value against
which the measured ratio is evaluated. The value of this property goes from 1 to 5, in
steps of 0.01
38
OMICRON Test Universe Overcurrent Automation Interface
4.11.1 Properties
[Link] AutoresetR
Syntax: [Link]
Type: Double
Description: Get/Set the R factor from the Auto Reset formula. This property is meaningless unless
IsAutoreset is True.
[Link] AutoresetT
Syntax: [Link]
Type: Double
Description: Get/Set the T exponent from the Auto Reset formula. This property is meaningless
unless IsAutoreset is True.
39
OMICRON Test Universe Overcurrent Automation Interface
40
OMICRON Test Universe Overcurrent Automation Interface
41
OMICRON Test Universe Overcurrent Automation Interface
4.11.2 Methods
[Link] SetPredefChar(type)
Syntax: SetPredefChar(type)
Long type
Return Type: Boolean
Description: Set the characteristic to one of the predefined types; the possible types are the
following:
PREDEF_DEFINITE Definite time
PREDEF_NORMAL_INVERSE Inverse
PREDEF_VERY_INVERSE Very Inverse
PREDEF_EXTR_INVERSE Extremely Inverse
This method returns True if the operation was successful, False otherwise.
[Link] SetI2tChar(Name, A, P, Q)
Syntax: SetI2tChar(Name, A, P, Q)
String Name
Double A
Double P
Double Q
Return Type: Boolean
Description: Set the characteristic to I2t, with the provided parameters. Returns True if the
operation was successful, False otherwise.
[Link] SetIACChar(Name, A, B, C, D, E)
Syntax: SetIACChar(Name, A, B, C, D, E)
String Name
Double A
Double B
Double C
Double D
Double E
Return Type: Boolean
Description: Set the characteristic to IAC, with the provided parameters. Returns True if the
operation was successful, False otherwise.
42
OMICRON Test Universe Overcurrent Automation Interface
[Link] SetUserChar(Name)
Syntax: SetUserChar(Name)
String Name
Return Type: Boolean
Description: Set the characteristic to User Char, with the provided name. Returns True if the
operation was successful, False otherwise.
Note: We use this method to give a name to the User Characteristic and activate it. Please note that this method
will clear the User Point array (UserPoints object). After using this method, the points must be added to
UserPoints. It is important to know that the points in UserPoints will be deleted if SetInverseChar,
SetPredefinedChar or SetI2tChar are called; also, that UserPoints will be read-only until the characteristic has
been set to User Char with this method.
43
OMICRON Test Universe Overcurrent Automation Interface
4.12.1 Properties
4.12.2 Methods
The user must provide the current in times the pickup current, and the corresponding
time. It is not possible to add points having the same current value as one point
already in the table. The user characteristic must follow a down-and-right direction,
points that would create an upward or leftward direction of the characteristic are not
allowed.
[Link] Remove(index)
Syntax: Remove(Index)
Long Index
Return Type: Boolean
Description: Removes a point from the list. Index must be between 1 and [Link].
Returns True if the point was removed, False otherwise. Please note that it is
permitted to remove all points of a characteristic.
44
OMICRON Test Universe Overcurrent Automation Interface
[Link] RemoveAll()
Syntax: RemoveAll()
Return Type: Boolean
Description: Removes all points from the characteristic. The resulting characteristic is valid, if quite
useless.
45
OMICRON Test Universe Overcurrent Automation Interface
4.13.1 Properties
46
OMICRON Test Universe Overcurrent Automation Interface
Option Explicit
Dim oc As Object
Dim ocApp As Object
Dim ocConst As Object
Dim ocTO As Object
[Link] = False
[Link] = True
[Link] = False
[Link] = False
[Link] = 10
[Link] = 0.1
[Link] = 3
[Link] = 0.1
'After the general settings, let's set the groups one by one
47
OMICRON Test Universe Overcurrent Automation Interface
[Link] = True
[Link] = 5
[Link] = 1
[Link]("GE DFP100 VI", 3.922, 0.0982, 2, 1, 0, 0)
group.IGr2Active = True
group.IGr2Ipickup = 100
group.IGr2OperTime = 0.1
group.IGr3Active = False
group.IGr3Ipickup = 100
group.IGr3OperTime = 1
[Link] = True
[Link] = 5
[Link] = 1
[Link]("UserChar")
'The points can be entered in any order, we do not have to enter them sorted
[Link](1.05, 100.0)
[Link](1.20, 40.0)
[Link](1.50, 28.0)
[Link](2.00, 23.0)
group.IGr2Active = True
group.IGr2Ipickup = 100
group.IGr2OperTime = 0.1
group.IGr3Active = False
group.IGr3Ipickup = 100
group.IGr3OperTime = 1
[Link] = True
[Link] = 1
[Link] = 1
[Link](ocConst.PREDEF_NORMAL_INVERSE)
group.IGr2Active = True
group.IGr2Ipickup = 4
group.IGr2OperTime = 0.1
group.IGr3Active = False
group.IGr3Ipickup = 10
group.IGr3OperTime = 0.05
48
OMICRON Test Universe Overcurrent Automation Interface
[Link] = True
[Link] = 1
[Link] = 1
[Link](ocConst.PREDEF_NORMAL_INVERSE)
group.IGr2Active = True
group.IGr2Ipickup = 4
group.IGr2OperTime = 0.1
group.IGr3Active = False
group.IGr3Ipickup = 10
group.IGr3OperTime = 0.05
[Link]
49
OMICRON Test Universe Overcurrent Automation Interface
4.15.1 Properties
4.15.2 Methods
50
OMICRON Test Universe Overcurrent Automation Interface
Description: Creates a new test point and adds it to the collection. Returns the Shot object if the
point was successfully created and added, Nothing if the method could not add the
point. New points are added at the end of the test point list. If the points in the list
had been sorted, the addition of a new point may require that the list be re-sorted by
invoking the Sort method. This would break the link between the point in the table
and the object returned by the method, and must therefore not be done until the
object has been released.
The user must provide the current in times the pickup current of a given protective
unit, and the unit relative to which the point is defined. If no unit is provided, the
point will be added relative to I>. It is not possible to add points having the same
relative value respect to the same unit as one point already in the table. However, it is
possible to add points that resolve to the same location in the I/t diagram as long as
they are defined relative to different units.
It is also possible to define the point as Backward. If the parameter is not provided,
the point will be entered as Forward. It is only possible to add Backward points
when the [Link] setting is True. Otherwise, the point will not be
added and the method will return Nothing. Two points can have the same Itest and
be relative to the same unit if one is Forward and the other is Backward.
Possible values for the relTo parameter are: UNIT_IGR (I>), UNIT_IGR2 (I>>)and
UNIT_IGR3(I>>>).
[Link] Remove(Index)
Syntax: Remove(Index)
Long Index
Return Type: Boolean
Description: Removes a point from the list. Index must be between 1 and [Link]. Returns
True if the point was removed, False otherwise.
[Link] RemoveAll()
Syntax: RemoveAll()
Return Type: Boolean
Description: Removes all test points from the list.
[Link] Sort(order)
Syntax: Sort(order)
optional Long order
Return Type: none
Description: Sorts the points in the characteristic by current values. The parameters can be:
SORT_ASCENDING The points are sorted with the lower currents first
SORT_DESCENDING The points are sorted with the higher currents first
If the order parameter is missing, SORT_ASCENDING will be assumed.
Note: Please note that the points cannot be returned to their original order once sorted. Also, the sorting only
applies to the points already in the table, new points are added unsorted at the end of the table.
51
OMICRON Test Universe Overcurrent Automation Interface
4.16.1 Properties
52
OMICRON Test Universe Overcurrent Automation Interface
53
OMICRON Test Universe Overcurrent Automation Interface
Out or range happens when the currents and/or voltages necessary to test the point
according to the user's specifications exceed the hardware's limits or any of the
maximums set in the Test Object for the relay's protection ([Link] and
[Link]).
Out of time range happens when the maximum test time exceeds the limits of the
module. Please note that this does not include "No tripping", which resolves to the
maximum fault time (absolute or relative, as appropriate.)
If the point tripped during pre-fault, the results will be meaningless, since the fault
values where not even applied – no times will be measured in this case.
54
OMICRON Test Universe Overcurrent Automation Interface
4.17.1 Properties
[Link] Evaluate
Syntax: [Link]
Type: Boolean
Description: Get / Set whether the test will be evaluated. If the test is not evaluated, its result will
not be used for the module's evaluation.
[Link] Resolution
Syntax: [Link]
Type: Double
Description: Get / Set the resolution of the test, in cycles. This value affects the timing of the
Pu/Do test steps.
55
OMICRON Test Universe Overcurrent Automation Interface
[Link] TripValue
Syntax: [Link]
Type: Double
Description: Get / Set the value of the initial trip for the EM test, in times the pickup current.
[Link] Type
Syntax: [Link]
Type: Long
Description: Get / Set the type of Pickup/Dropout test to be performed. The values can be
PUDO_TEST_NONE No test will be performed
PUDO_TEST_START Test for relays with Start contact
PUDO_TEST_EM Test for EM relays without start contact (or full simulation)
Note: The following section describes the scope and meaning of the values for TestStatus.
PU_TESTED applies to both types of tests. It means that the test was fully completed and both the Pickup and the
Dropout values were found. All results are valid.
PU_NO_START applies only to the Start test. It means that the Start contact never was active. Often this is a signal
of wrong wiring or incorrect configuration of the Trigger (FixedTrigger object.) No results are valid
56
OMICRON Test Universe Overcurrent Automation Interface
PU_NO_DROPOUT applies only to the Start test. It means that no Dropout value was detected (the Start contact
remained active even when the down sweep reached its lower limit.) No results are valid.
PU_NO_PICKUP applies only to the Start test. It means that no pickup value was detected (the Start contact
remained inactive even when the up sweep reached its upper limit.) The dropout value ([Link]) is
valid.
PU_OUT_OF_RANGE applies to both tests. Some point of the test sequence exceeds the hardware's limits or any of
the maximums set in the Test Object for the relay's protection ([Link] and [Link]). No
results are valid.
PU_NOT_TESTED applies to both tests. The test was not performed, and therefor no results are valid.
PU_OUT_OF_TIME_RANGE and PU_EM_TIME_TOO_HIGH apply only to the EM test. The trip time of the point
selected for the initial trip of the test (obtained automatically from the operating characteristic) exceeds the
module's (PU_OUT_OF_TIME_RANGE) or the CMC's (PU_EM_TIME_TOO_HIGH) limits. No results are valid.
PU_NOT_TRIPPED applies only to the EM test. It means that the initial trip was not detected. No results are valid.
PU_EM_NO_PICKUP applies only to the EM test. It means that the pickup value could not be determined. No
results are valid.
PU_EM_NO_DROPOUT applies only to the EM test. It means that the dropout value could not be determined. The
pickup value ([Link]) is valid.
57
OMICRON Test Universe Overcurrent Automation Interface
Option Explicit
Dim oc As Object
Dim ocApp As Object
Dim ocConst As Object
Dim ocShots As Object
Dim ocPuDo As Object
[Link](0.95, ocConst.UNIT_IGR2)
[Link](1.05, ocConst.UNIT_IGR2)
[Link](1.50, ocConst.UNIT_IGR2)
[Link](2.00, ocConst.UNIT_IGR2)
[Link](5.00, ocConst.UNIT_IGR2)
[Link](0.95, ocConst.UNIT_IGR3)
[Link](1.05, ocConst.UNIT_IGR3)
[Link](1.50, ocConst.UNIT_IGR3)
[Link](2.00, ocConst.UNIT_IGR3)
[Link](5.00, ocConst.UNIT_IGR3)
'Now check that all points are passed, and the overload status
58
OMICRON Test Universe Overcurrent Automation Interface
MsgBox msg
LeaveApp:
[Link]
59
OMICRON Test Universe Overcurrent Automation Interface
End Sub
60