The NodeOPCUA API The NodeOPCUA API

  • API Docs for Version: 0.5.4

    • APIs

    Show:

    UAOffNormalAlarm Class

    Extends UADiscreteAlarm
    Defined in: packages\node-opcua-address-space\src\alarms_and_conditions\off_normal_alarm.js:21
    Module: opcua.address_space.AlarmsAndConditions

    The OffNormalAlarmType is a specialization of the DiscreteAlarmType intended to represent a discrete Condition that is considered to be not normal. This sub type is usually used to indicate that a discrete value is in an Alarm state, it is active as long as a non-normal value is present.

    Constructor

    Methods

    (static)UAAcknowledgeableConditionBase.instantiate

    (
    • addressSpace
    • conditionTypeId
    • options
    • data
    )
    UAAcknowledgeableConditionBase

    Inherited from UAAcknowledgeableConditionBase: packages\node-opcua-address-space\src\alarms_and_conditions\acknowledgeable_condition.js:318

    Parameters:

    Returns:

    UAAcknowledgeableConditionBase:

    (static)UAAlarmConditionBase.instantiate

    (
    • namespace
    • alarmConditionTypeId
    • options
    • data
    )

    Inherited from UAAlarmConditionBase: packages\node-opcua-address-space\src\alarms_and_conditions\alarm_condition.js:700

    Parameters:

    • namespace Namespace
    • alarmConditionTypeId Object
    • options Object
      • inputNode
      • optionals

        could be "SuppressedState" , "ShelvingState"

      • [maxTimeShelved] Number | Null optional

        max TimeShelved duration (in ms)

    • data Object

    (static)UAOffNormalAlarm.instantiate

    (
    • namespace
    • limitAlarmTypeId
    • options
    • data When
    )

    Defined in packages\node-opcua-address-space\src\alarms_and_conditions\off_normal_alarm.js:134

    Parameters:

    • namespace Namespace
    • limitAlarmTypeId Object
    • options Object
    • data When Object

      the value of inputNode doesn't match the normalState node value, then the alarm is raised.

    _calculateConditionInfo

    (
    • stateData
    • isActive
    • value
    • oldCondition
    )
    ConditionInfo

    Inherited from UAAlarmConditionBase: packages\node-opcua-address-space\src\alarms_and_conditions\alarm_condition.js:594

    Parameters:

    • stateData Object

      the new calculated state of the alarm

    • isActive Boolean
    • value Number

      the new value of the limit alarm

    • oldCondition ConditionInfo

      given for information purpose

      • severity
      • quality
      • message
      • retain

    Returns:

    ConditionInfo:

    the new condition info

    this method need to be overridden by the instantiate to allow custom message and severity to be set based on specific context of the alarm.

    Example:

    var myAlarm = addressSpace.instantiateExclusiveLimitAlarm({...}); myAlarm._calculateConditionInfo = function(stateName,value,oldCondition) { var percent = Math.ceil(value * 100); return new ConditionInfo({ message: "Tank is almost " + percent + "% full", severity: 100, quality: StatusCodes.Good }); };

    _confirm_branch

    (
    • eventId
    • comment
    • branch
    • message
    )
    private

    Inherited from UAAcknowledgeableConditionBase: packages\node-opcua-address-space\src\alarms_and_conditions\acknowledgeable_condition.js:223

    Parameters:

    • eventId Object
    • comment Object
    • branch Object
    • message Object

    _installInputNodeMonitoring install mechanism that listen to input node datavalue changes so that alarm status can be automatically updated appropriatly.

    (
    • inputNode
    )
    Void protected

    Inherited from UAAlarmConditionBase: packages\node-opcua-address-space\src\alarms_and_conditions\alarm_condition.js:512

    Parameters:

    Returns:

    Void:

    _setEnabledState

    (
    • requestedEnabledState
    )
    StatusCode private

    Inherited from UAConditionBase: packages\node-opcua-address-space\src\alarms_and_conditions\condition.js:923

    Parameters:

    • requestedEnabledState Boolean

    Returns:

    StatusCode:

    StatusCodes.Good if successful or BadConditionAlreadyEnabled/BadConditionAlreadyDisabled

    acknowledgeAndAutoConfirmBranch

    (
    • branch
    • comment
    )

    Inherited from UAAcknowledgeableConditionBase: packages\node-opcua-address-space\src\alarms_and_conditions\acknowledgeable_condition.js:278

    Parameters:

    autoConfirmBranch

    (
    • branch
    • comment
    )

    Inherited from UAAcknowledgeableConditionBase: packages\node-opcua-address-space\src\alarms_and_conditions\acknowledgeable_condition.js:260

    Parameters:

    • branch Object
    • comment Object

    getBranchCount

    () Number

    Inherited from UAConditionBase: packages\node-opcua-address-space\src\alarms_and_conditions\condition.js:806

    Returns:

    Number:

    getEnabledState

    () Boolean

    Inherited from UAConditionBase: packages\node-opcua-address-space\src\alarms_and_conditions\condition.js:901

    Returns:

    Boolean:

    getEnabledStateAsString

    () String

    Inherited from UAConditionBase: packages\node-opcua-address-space\src\alarms_and_conditions\condition.js:909

    Returns:

    String:

    getInputNodeNode

    () BaseNode

    Inherited from UAAlarmConditionBase: packages\node-opcua-address-space\src\alarms_and_conditions\alarm_condition.js:473

    Returns:

    BaseNode:

    return the node in the address space pointed by the inputNode value

    Note: please note the difference between alarm.inputNode

    • alarm.inputNode is a UAVariable property of the alarm object holding the nodeid of the input node in its value.
    • getInputNodeNode() is the UAVariable that contains the value that affects the state of the alarm and whose node id is stored in alarm.inputNode

    getMaxTimeShelved

    () Duration

    Inherited from UAAlarmConditionBase: packages\node-opcua-address-space\src\alarms_and_conditions\alarm_condition.js:214

    Returns:

    Duration:

    getSuppressedOrShelved

    () Boolean

    Inherited from UAAlarmConditionBase: packages\node-opcua-address-space\src\alarms_and_conditions\alarm_condition.js:179

    Returns:

    Boolean:

    isSuppressedOrShelved

    () Boolean

    Inherited from UAAlarmConditionBase: packages\node-opcua-address-space\src\alarms_and_conditions\alarm_condition.js:156

    Returns:

    Boolean:

    post_initialize

    () private

    Inherited from UAConditionBase: packages\node-opcua-address-space\src\alarms_and_conditions\condition.js:784

    raiseConditionEvent Raise a Instance Event (see also UAObject#raiseEvent to raise a transient event)

    (
    • branch
    )

    Inherited from UAConditionBase: packages\node-opcua-address-space\src\alarms_and_conditions\condition.js:1070

    Parameters:

    setEnabledState

    (
    • requestedEnabledState
    )
    private

    Inherited from UAConditionBase: packages\node-opcua-address-space\src\alarms_and_conditions\condition.js:994

    Parameters:

    • requestedEnabledState Boolean

    setLocalTime

    (
    • time
    )

    Inherited from UAConditionBase: packages\node-opcua-address-space\src\alarms_and_conditions\condition.js:1013

    Parameters:

    • time Date

    setMaxTimeShelved

    (
    • duration
    )

    Inherited from UAAlarmConditionBase: packages\node-opcua-address-space\src\alarms_and_conditions\alarm_condition.js:196

    Parameters:

    • duration Object

      ( Duration in Milliseconds)

      note: duration must be greater than 10ms and lesser than 2**31 ms

    setNormalStateValue

    (
    • value
    )

    Defined in packages\node-opcua-address-space\src\alarms_and_conditions\off_normal_alarm.js:67

    Parameters:

    • value Object

    setReceiveTime

    (
    • time
    )

    Inherited from UAConditionBase: packages\node-opcua-address-space\src\alarms_and_conditions\condition.js:1004

    Parameters:

    • time Date

    Properties

    inputNode

    UAVariable

    Inherited from UAAlarmConditionBase: packages\node-opcua-address-space\src\alarms_and_conditions\alarm_condition.js:522

    The InputNode Property provides the NodeId of the Variable the Value of which is used as primary input in the calculation of the Alarm state. If this Variable is not in the AddressSpace, a Null NodeId shall be provided. In some systems, an Alarm may be calculated based on multiple Variables Values; it is up to the system to determine which Variable’s NodeId is used. dataType is DataType.NodeId

    maxTimeShelved

    UAVariable

    Inherited from UAAlarmConditionBase: packages\node-opcua-address-space\src\alarms_and_conditions\alarm_condition.js:821

    The optional Property MaxTimeShelved is used to set the maximum time that an Alarm Condition may be shelved. The value is expressed as duration. Systems can use this Property to prevent permanent Shelving of an Alarm. If this Property is present it will be an upper limit on the duration passed into a TimedShelve Method call. If a value that exceeds the value of this property is passed to the TimedShelve Method, than a Bad_ShelvingTimeOutOfRange error code is returned on the call. If this Property is present it will also be enforced for the OneShotShelved state, in that an Alarm Condition will transition to the Unshelved state from the OneShotShelved state if the duration specified in this Property expires following a OneShotShelve operation without a change of any of the other items associated with the Condition.

    shelvingState

    UAShelvingStateMachine

    Inherited from UAAlarmConditionBase: packages\node-opcua-address-space\src\alarms_and_conditions\alarm_condition.js:784

    ShelvingState suggests whether an Alarm shall (temporarily) be prevented from being displayed to the user. It is quite often used to block nuisance Alarms.

    suppressedState

    UATwoStateVariable

    Inherited from UAAlarmConditionBase but overwritten in packages\node-opcua-address-space\src\alarms_and_conditions\alarm_condition.js:765

    SuppressState is used internally by a Server to automatically suppress Alarms due to system specific reasons. For example a system may be configured to suppress Alarms that are associated with machinery that is shutdown, such as a low level Alarm for a tank that is currently not in use.

    Events

    acknowledged

    Inherited from UAAcknowledgeableConditionBase: packages\node-opcua-address-space\src\alarms_and_conditions\acknowledgeable_condition.js:197

    Event Payload:

    confirmed

    Inherited from UAAcknowledgeableConditionBase: packages\node-opcua-address-space\src\alarms_and_conditions\acknowledgeable_condition.js:249

    Event Payload:

    • eventId Object
    • comment Object
    • eventId raised Object

      when the alarm branch has been confirmed