The ConditionType defines all general characteristics of a Condition. All other ConditionTypes derive from it. It is formally defined in Table 10 and Table 11. The False state of the EnabledState shall not be extended with a sub state machine.
Table 10 – ConditionType definition
|
Attribute |
Value |
||||
|
BrowseName |
ConditionType |
||||
|
IsAbstract |
True |
||||
|
References |
NodeClass |
BrowseName |
DataType |
TypeDefinition |
ModellingRule |
|
Subtype of the BaseEventType defined in 10000-5 |
|||||
|
HasSubtype |
ObjectType |
DialogConditionType |
Defined in Clause 5.6.2 |
||
|
HasSubtype |
ObjectType |
AcknowledgeableConditionType |
Defined in Clause 5.7.2 |
||
|
|
|
|
|
|
|
|
HasProperty |
Variable |
ConditionClassId |
NodeId |
PropertyType |
Mandatory |
|
HasProperty |
Variable |
ConditionClassName |
LocalizedText |
PropertyType |
Mandatory |
|
HasProperty |
Variable |
ConditionName |
String |
PropertyType |
Mandatory |
|
HasProperty |
Variable |
BranchId |
NodeId |
PropertyType |
Mandatory |
|
HasProperty |
Variable |
Retain |
Boolean |
PropertyType |
Mandatory |
|
HasProperty |
Variable |
SupportsFilteredRetain |
Boolean |
PropertyType |
|
|
HasComponent |
Variable |
EnabledState |
LocalizedText |
TwoStateVariableType |
Mandatory |
|
HasComponent |
Variable |
Quality |
StatusCode |
ConditionVariableType |
Mandatory |
|
HasComponent |
Variable |
LastSeverity |
UInt16 |
ConditionVariableType |
Mandatory |
|
HasComponent |
Variable |
Comment |
LocalizedText |
ConditionVariableType |
Mandatory |
|
HasProperty |
Variable |
ClientUserId |
String |
PropertyType |
Mandatory |
|
|
|
|
|
|
|
|
HasComponent |
Method |
Disable |
Defined in Clause 5.5.4 |
Mandatory |
|
|
HasComponent |
Method |
Enable |
Defined in Clause 5.5.5 |
Mandatory |
|
|
HasComponent |
Method |
AddComment |
Defined in Clause 5.5.6 |
Mandatory |
|
|
HasComponent |
Method |
ConditionRefresh |
Defined in Clause 5.5.7 |
|
|
|
HasComponent |
Method |
ConditionRefresh2 |
Defined in Clause 5.5.8 |
|
|
|
ConformanceUnits |
|||||
|
A & C Basic |
|||||
Table 11 – ConditionType Additional Subcomponents
|
BrowsePath |
References |
NodeClass |
BrowseName |
DataType |
TypeDefinition |
Others |
|
EnabledState |
HasProperty |
Variable |
TrueState |
LocalizedText |
PropertyType |
|
|
EnabledState |
HasProperty |
Variable |
FalseState |
LocalizedText |
PropertyType |
|
The empty “Others” column indicates that no ModellingRule applies.
The ConditionType inherits all Properties of the BaseEventType. Their semantic is defined in 10000-5. SourceNode Property identifies the ConditionSource. See 5.12 for more details. If the ConditionSource is not a Node in the AddressSpace, the NodeId is set to NULL. The SourceNode Property is the Node, which the Condition is associated with, it may be the same as the InputNode for an Alarm, but it may be a separate node. For example, a motor, which is a Variable with a Value that is an RPM, may be the ConditionSource for Conditions that are related to the motor as well as a temperature sensor associated with the motor. In the former the InputNode for the High RPM Alarm is the value of the Motor RPM, while in the later the InputNode of the High Alarm would be the value of the temperature sensor that is associated with the motor.
ConditionClassId, ConditionClassName, ConditionSubClassId and ConditionSubClassName originally defined in ConditionType are now defined in the BaseEventType (from which this type is derived). They are optional in the BaseEventType, but ConditionClassId, and ConditionClassName are Mandatory in ConditionType and thus listed(to update the modelling rule).
ConditionName identifies the Condition instance that the Event originated from. It can be used together with the SourceName in a user display to distinguish between different Condition instances. If a ConditionSource has only one instance of a ConditionType, and the Server has no instance name, the Server shall supply the name element of the BrowseName of the ConditionType.
BranchId is NULL for all Event Notifications that relate to the current state of the Condition instance. If BranchId is not NULL, it identifies a previous state of this Condition instance that still needs attention by an Operator. If the current ConditionBranch is transformed into a previous ConditionBranch then the Server needs to assign a non-NULL BranchId. An initial Event for the branch will generated with the values of the ConditionBranch and the new BranchId. The ConditionBranch can be updated many times before it is no longer needed. When the ConditionBranch no longer requires Operator input the final Event will have Retain set to False. The retain bit on the current Event is True, as long as any ConditionBranches require Operator input. See 4.2 for more information about the need for creating and maintaining previous ConditionBranches and Clause B.1 for an example using branches. The BranchId DataType is NodeId although the Server is not required to have ConditionBranches in the AddressSpace. The use of a NodeId allows the Server to use simple numeric identifiers, strings or arrays of bytes.
Retain when True describes a Condition (or ConditionBranch) as being in a state that is interesting for a Client wishing to synchronize its state with the Server’s state. The logic to determine how this flag is set is Server specific. Typically, all Active Alarms would have the Retain flag set; however, it is also possible for inactive Alarms to have their Retain flag set to True.
In normal processing when a Client receives an Event with the Retain flag set to False, the Client should consider this as a ConditionBranch that is no longer of interest, in the case of a “current Alarm display” the ConditionBranch would be removed from the display.
SupportsFilteredRetain Property is only provided on the ConditionType. When this Property is set to True on the Type, then the Server provides a Client specific Retain flag value taking into account any Client provided filter. When the property is False on the ConditionType then the Server does not provide a Client specific the value of the Retain flag. For example, if a Client applies a filter to exclude Alarms that are shelved, and the SupportsFilteredRetain is set to True, the Client receives an Alarm (it is not shelved, Retain is true). The Client (or another Client) shelves the Alarm. At this point the Alarm no longer passes the filter, but since the previous event was sent, this event is transmitted with Retain = False. For an example see B.1.4
Figure 11 - SupportsFilteredRetain process
Figure 11 provides an illustration of the processing a Server shall follow for processing Retain flag when SupportsFilteredRetain flag is set to True.
EnabledState indicates whether the Condition is enabled. EnabledState/Id is True if enabled, False otherwise. EnabledState/TransitionTime defines when the EnabledState last changed. Recommended state names are described in A.1.
A Condition’s EnabledState effects the generation of Event Notifications and as such results in the following specific behaviour:
- When the Condition instance enters the Disabled state, the Retain Property of this Condition shall be set to False by the Server to indicate to the Client that the Condition instance is currently not of interest to Clients. This includes all ConditionBranches if any branches exist.
- When the Condition instance enters the enabled state, the Condition shall be evaluated and all of its Properties updated to reflect the current values. If this evaluation causes the Retain Property to transition to True for any ConditionBranch, then an Event Notification shall be generated for that ConditionBranch.
- The Server may choose to continue to test for a Condition instance while it is Disable d. However, no Event Notifications will be generated while the Condition instance is disabled.
- For any Condition that exists in the AddressSpace the Attributes and the following Variables will continue to have valid values even in the Disable d state; EventId, Event Type, Source Node, Source Name, Time, and EnabledState. Other Properties may no longer provide current valid values. All Variables that are no longer provided shall return a status of Bad_ConditionDisabled. The Event that reports the Disabled state should report the Properties as NULL or with a status of Bad_ConditionDisabled.
When enabled, changes to the following Variables shall cause a ConditionType Event Notification:
- Quality
- Severity (inherited from BaseEventType)
- Comment
This may not be the complete list. Subtypes of ConditionType may define additional Variables that trigger Event Notifications. In general, changes to Variables of the types TwoStateVariableType, ConditionVariableType, StateMachineType or any of their subtypes trigger Event Notifications and are not explicitly described in subtypes.
In the event of a restart of an AlarmManager, the AlarmManager shall recover the Enabled/Disabled states of all current conditions. If the system can not determine if the Condition is Enabled or Disabled, it shall be Enabled.
Quality reveals the status of process values or other resources that this Condition instance is based upon. If, for example, a process value is “Uncertain”, the associated “LevelAlarm” Condition is also questionable. Values for the Quality can be any of the OPC StatusCodes defined in 10000-8 as well as Good, Uncertain and Bad as defined in 10000-4. These StatusCodes are similar to but slightly more generic than the description of data quality in the various field bus specifications. It is the responsibility of the Server to map internal status information to these codes. A Server that supports no quality information shall return Good. This quality can also reflect the communication status associated with the system that this value or resource is based on and from which this Alarm was received. For communication errors to the underlying system, especially those that result in some unavailable Event fields, the quality shall be Bad_NoCommunication error.
Events are only generated for Conditions that have their Retain field set to True and for the initial transition of the Retain field from True to False.
LastSeverity provides the previous severity of the ConditionBranch. Initially this Variable contains a zero value; it will return a value only after a severity change. The new severity is supplied via the Severity Property, which is inherited from the BaseEventType.
Comment contains the last comment provided for a certain state (ConditionBranch) of a Condition. It may have been provided by an AddComment Method, some other Method or in some other manner. Any change in this field, shall trigger a new event to be generated. The initial value of this Variable is NULL, unless it is provided in some other manner.
ClientUserId is related to the Comment field and contains the identity of the user who inserted the most recent Comment. The logic to obtain the ClientUserId is defined in 10000-5.
The NodeId of the Condition instance is used as ConditionId. It is not explicitly modelled as a component of the ConditionType. However, it can be requested with the following SimpleAttributeOperand (see Table 12) in the SelectClause of the EventFilter: See 10000-4 for a detailed definition of the SelectClause in an Event Subscription.
Table 12 – ConditionId SimpleAttributeOperand Illustration
|
Name |
Type |
Description |
|
SimpleAttributeOperand |
|
|
|
typeId |
NodeId |
NodeId of the ConditionType Node |
|
browsePath[] |
QualifiedName |
empty |
|
attributeId |
IntegerId |
Id of the NodeId Attribute |