OPC Unified Architecture – Part 22: Base Network Model
5.3.1 Enumeration DataTypes
5.3.1.1 Duplex Enumeration
The Duplex is an enumeration representing the configured, negotiated, or actual duplex mode of an Ethernet interface (aDuplexStatus is defined in IEEE 802.3-2022, 30.3.1.1.32, aDuplexStatus). The values of the DuplexEnumeration are defined in Table 18.
Table 18 – Duplex Values
Name
Value
Description
Full
0
Full duplex.
Half
1
Half duplex.
Unknown
2
Link is currently disconnected or initializing.
Its representation in the AddressSpace is defined in Table 19.
Table 19 – Duplex Definition
Attribute
Value
BrowseName
Duplex
IsAbstract
False
References
NodeClass
BrowseName
DataType
TypeDefinition
Other
Subtype of the Enumeration type defined in OPC 10000-5
HasProperty
Variable
EnumValues
EnumValueType[]
PropertyType
Conformance Units
BNM Ethernet Base Info
5.3.1.2 InterfaceAdminStatus Enumeration
The InterfaceAdminStatus is an enumeration for the possible desired states of the network interface (ifAdminStatus is defined in IETF RFC 2863: The Interfaces Group MIB - ifAdminStatus). The values of the InterfaceAdminStatusEnumeration are defined in Table 20.
Table 20 – InterfaceAdminStatus Values
Name
Value
Description
Up
0
Ready to pass packets.
Down
1
Not ready to pass packets and not in some test mode.
Testing
2
In some test mode.
Its representation in the AddressSpace is defined in Table 21.
Table 21 – InterfaceAdminStatus Definition
Attribute
Value
BrowseName
InterfaceAdminStatus
IsAbstract
False
References
NodeClass
BrowseName
DataType
TypeDefinition
Other
Subtype of the Enumeration type defined in OPC 10000-5
HasProperty
Variable
EnumValues
EnumValueType[]
PropertyType
Conformance Units
BNM Ethernet Base Info
5.3.1.3 InterfaceOperStatus Enumeration
The InterfaceOperStatus is an enumeration for the possible operational states of the network interface (ifOperStatus is defined in IETF RFC 2863: The Interfaces Group MIB - ifOperStatus). The values of the InterfaceOperStatusEnumeration are defined in Table 22.
Table 22 – InterfaceOperStatus Values
Name
Value
Description
Up
0
Ready to pass packets.
Down
1
The interface does not pass any packets.
Testing
2
In some test mode. No operational packets can be passed.
Unknown
3
Status cannot be determined for some reason.
Dormant
4
Waiting for some external event.
NotPresent
5
Some component (typically hardware) is missing.
LowerLayerDown
6
Down due to state of lower-layer interface(s).
Its representation in the AddressSpace is defined in Table 23.
Table 23 – InterfaceOperStatus Definition
Attribute
Value
BrowseName
InterfaceOperStatus
IsAbstract
False
References
NodeClass
BrowseName
DataType
TypeDefinition
Other
Subtype of the Enumeration type defined in OPC 10000-5
HasProperty
Variable
EnumValues
EnumValueType[]
PropertyType
Conformance Units
BNM Ethernet Base Info
5.3.1.4 NegotiationStatus Enumeration
The NegotiationStatus is an enumeration representing the status of the auto-negotiation protocol (aAutoNegAutoConfig is defined in IEEE 802.3-2022, clause 30.6.1.1.4, aAutoNegAutoConfig). The values of the NegotiationStatus Enumeration are defined in Table 24.
Table 24 – NegotiationStatus Values
Name
Value
Description
InProgress
0
The auto-negotiation protocol is running and negotiation is currently in-progress.
Complete
1
The auto-negotiation protocol has completed successfully.
Failed
2
The auto-negotiation protocol has failed.
Unknown
3
The auto-negotiation status is not currently known, this could be because it is still negotiating or the protocol cannot run (e.g., if no medium is present).
NoNegotiation
4
No auto-negotiation is executed. The auto-negotiation function is either not supported on this interface or has not been enabled.
Its representation in the AddressSpace is defined in Table 25.
Table 25 – NegotiationStatus Definition
Attribute
Value
BrowseName
NegotiationStatus
IsAbstract
False
References
NodeClass
BrowseName
DataType
TypeDefinition
Other
Subtype of the Enumeration type defined in OPC 10000-5
HasProperty
Variable
EnumValues
EnumValueType[]
PropertyType
Conformance Units
BNM AutoNeg
5.3.1.5 TsnFailureCode Enumeration
The TsnFailureCode is an Enumeration to provide detailed error information for failures occurring during TSN stream establishment (TSN Failure Codes are defined in IEEE 802.1Qcc-2018, Table 46-15, TSN Failure Codes). The TsnFailureCode Enumeration is defined in Table 26.
Table 26 – TsnFailureCode values
Name
Value
Description
NoFailure
0
No failure
InsufficientBandwidth
1
Insufficient bandwidth
InsufficientResources
2
Insufficient bridge resources
InsufficientTrafficClassBandwidth
3
Insufficient bandwidth for Traffic Class
StreamIdInUse
4
StreamID in use by another Talker
StreamDestinationAddressInUse
5
Stream destination address already in use
StreamPreemptedByHigherRank
6
Stream pre-empted by higher rank
LatencyHasChanged
7
Reported latency has changed
EgressPortNotAvbCapable
8
Egress port is not AVBCapable
UseDifferentDestinationAddress
9
Use a different destination address
OutOfMsrpResources
10
Out of MSRP resources
OutOfMmrpResources
11
Out of MMRP resources
CannotStoreDestinationAddress
12
Cannot store destination address
PriorityIsNotAnSrcClass
13
Requested priority is not an SR Class priority
MaxFrameSizeTooLarge
14
MaxFrameSize is too large for media
MaxFanInPortsLimitReached
15
MaxFanInPorts limit has been reached
FirstValueChangedForStreamId
16
Changes in FirstValue for a registered StreamID
VlanBlockedOnEgress
17
VLAN is blocked on this egress port (Registration Forbidden)
VlanTaggingDisabledOnEgress
18
VLAN tagging is disabled on this egress port (untagged set)
SrClassPriorityMismatch
19
SR class priority mismatch
FeatureNotPropagated
20
Enhanced feature cannot be propagated to original Port
MaxLatencyExceeded
21
MaxLatency exceeded
BridgeDoesNotProvideNetworkId
22
Nearest Bridge cannot provide network identification for stream transformation
StreamTransformNotSupported
23
Stream transformation not supported
StreamIdTypeNotSupported
24
Stream identification type not supported for stream transformation
FeatureNotSupported
25
Enhanced feature cannot be supported without a CNC
Its representation in the AddressSpace is defined in Table 27.
Table 27 – TsnFailureCode Definition
Attribute
Value
BrowseName
TsnFailureCode
IsAbstract
False
References
NodeClass
BrowseName
DataType
TypeDefinition
Other
Subtype of the Enumeration type defined in OPC 10000-5
HasProperty
Variable
EnumValues
EnumValueType[]
PropertyType
Conformance Units
BNM TSN Base Info
5.3.1.6 TsnStreamState Enumeration
The TsnStreamState is an enumeration representing the state of the configuration process of a TSN Talker or Listener.
The default value is Disabled. The TsnStreamStateEnumeration is defined in Table 28.
Table 28 – TsnStreamState Values
Name
Value
Description
Disabled
0
The related TSN Streamis currently disabled.
Configuring
1
The related TSN Streamis in the process of receiving configuration parameters from the TSN Control Layer.
Ready
2
The related TSN Streamhas successfully received and applied the configuration from the TSN Control Layer. The related TSN Streamis not fully operational as long as local preconditions (e.g. synchronization state) are not valid.
Operational
3
The related TSN Streamobject is configured and all other required preconditions (e.g. synchronization state) for sending / receiving data are valid.
Error
4
The related TSN Streamobject is in an error state.
Its representation in the AddressSpace is defined in Table 29.
Table 29 – TsnStreamState Definition
Attribute
Value
BrowseName
TsnStreamState
IsAbstract
False
References
NodeClass
BrowseName
DataType
TypeDefinition
Other
Subtype of the Enumeration type defined in OPC 10000-5
HasProperty
Variable
EnumValues
EnumValueType[]
PropertyType
Conformance Units
BNM TSN Base Info
5.3.1.7 TsnTalkerStatus Enumeration
The TsnTalkerStatus is an enumeration representing the state of the TSN Talker configuration.
The default value is None. The TsnTalkerStatusEnumeration is defined in Table 30Table 30.
Table 30 – TsnTalkerStatus Values
Name
Value
Description
None
0
No Talker detected.
Ready
1
Talker ready (configured).
Failed
2
Talker failed.
Its representation in the AddressSpace is defined in Table 31Table 31.
Table 31 – TsnTalkerStatus Definition
Attribute
Value
BrowseName
TsnTalkerStatus
IsAbstract
False
References
NodeClass
BrowseName
DataType
TypeDefinition
Other
Subtype of the Enumeration type defined in OPC 10000-5
HasProperty
Variable
EnumValues
EnumValueType[]
PropertyType
Conformance Units
BNM TSN Base Info
5.3.1.8 TsnListenerStatus Enumeration
The TsnListenerStatus is an enumeration representing the state of the TSN Listener configuration.
The default value is None. The TsnListenerStatusEnumeration is defined in Table 32Table 32.
Table 32 – TsnListenerStatus Values
Name
Value
Description
None
0
No Listener detected.
Ready
1
Listener ready (configured).
PartialFailed
2
One or more Listeners ready, and one or more Listeners failed.
Failed
3
Listener failed.
Its representation in the AddressSpace is defined in Table 33Table 33.
Table 33 – TsnListenerStatus Definition
Attribute
Value
BrowseName
TsnListenerStatus
IsAbstract
False
References
NodeClass
BrowseName
DataType
TypeDefinition
Other
Subtype of the Enumeration type defined in OPC 10000-5
HasProperty
Variable
EnumValues
EnumValueType[]
PropertyType
Conformance Units
BNM TSN Base Info
5.3.1.9 ChassisIdSubtype Enumeration
The ChassisIdSubtype is an enumeration representing different types of chassis identifier as defined in IEEE 802.1AB-2016, Table 8-2, chassis ID subtype.
The ChassisIdSubtypeEnumeration is defined in Table 34.
Table 34 – ChassisIdSubtype Values
Name
Value
Description
ChassisComponent
1
Represents a chassis identifier based on the value of entPhysicalAlias object (defined in IETF RFC 2737) for a chassis component (i.e., an entPhysicalClass value of chassis(3))
InterfaceAlias
2
Represents a chassis identifier based on the value of ifAlias object (defined in IETF RFC 2863) for an interface on the containing chassis.
PortComponent
3
Represents a chassis identifier based on the value of entPhysicalAlias object (defined in IETF RFC 2737) for a port or backplane component (i.e., entPhysicalClass has a value of port(10), or backplane(4)), within the containing chassis.
MacAddress
4
Represents a chassis identifier based on the value of a unicast source address (encoded in network byte order and IEEE 802.3 canonical bit order) of a port on the containing chassis as defined in IEEE Std 802-2014.
NetworkAddress
5
Represents a chassis identifier based on a network address associated with a particular chassis. The encoded address is actually composed of two fields. The first field is a single octet, representing the IANA AddressFamilyNumbers value for the specific address type, and the second field is the network address value.
InterfaceName
6
Represents a chassis identifier based on the value of ifName object (defined in IETF RFC 2863) for an interface on the containing chassis.
Local
7
Represents a chassis identifier based on a locally defined value.
Its representation in the AddressSpace is defined in Table 35.
Table 35 – ChassisIdSubtype Definition
Attribute
Value
BrowseName
ChassisIdSubtype
IsAbstract
False
References
NodeClass
BrowseName
DataType
TypeDefinition
Other
Subtype of the Enumeration type defined in OPC 10000-5
HasProperty
Variable
EnumValues
EnumValueType[]
PropertyType
Conformance Units
BNM IEEE LLDP Info
5.3.1.10 PortIdSubtype Enumeration
The PortIdSubtype is an enumeration representing different types of port identifier as defined in IEEE 802.1AB-2016, Table 8-3, port ID subtype.
The PortIdSubtypeEnumeration is defined in Table 36.
Table 36 – PortIdSubtype Values
Name
Value
Description
InterfaceAlias
1
Represents a port identifier based on the ifAlias MIB object defined in IETF RFC 2863.
PortComponent
2
Represents a port identifier based on the value of entPhysicalAlias (defined in IETF RFC 2737) for a port component (i.e., entPhysicalClass value of port(10) or backplane(4)), within the containing chassis.
MacAddress
3
Represents a port identifier based on a unicast source address (encoded in network byte order and IEEE 802.3 canonical bit order) which has been detected by the agent and associated with a particular port (IEEE Std 802-2014).
NetworkAddress
4
Represents a port identifier based on a network address, detected by the agent and associated with a particular port.
InterfaceName
5
Represents a port identifier based on the ifName MIB object, defined in IETF RFC 2863.
AgentCircuitId
6
Represents a port identifier based on the agent-local identifier of the circuit (defined in IETF RFC 3046), detected by the agent and associated with a particular port.
Local
7
Represents a port identifier based on a value locally assigned.
Its representation in the AddressSpace is defined in Table 37.
Table 37 – PortIdSubtype Definition
Attribute
Value
BrowseName
PortIdSubtype
IsAbstract
False
References
NodeClass
BrowseName
DataType
TypeDefinition
Other
Subtype of the Enumeration type defined in OPC 10000-5
HasProperty
Variable
EnumValues
EnumValueType[]
PropertyType
Conformance Units
BNM IEEE LLDP Info
5.3.1.11 ManAddrIfSubtype Enumeration
The ManAddrIfSubtype is an enumeration representing different types of management address interface as defined in IEEE 802.1AB-2016, Section 8.5.9.5, interface numbering subtype.
The ManAddrIfSubtypeEnumeration is defined in Table 38.
Table 38 – ManAddrIfSubtype Values
Name
Value
Description
None
0
Optional variable is not set.
Unknown
1
Interface is not known.
PortRef
2
Interface based on the port-ref MIB object.
SystemPortNumber
3
Interface based on the system port number.
Its representation in the AddressSpace is defined in Table 39.
Table 39 – ManAddrIfSubtype Definition
Attribute
Value
BrowseName
ManAddrIfSubtype
IsAbstract
False
References
NodeClass
BrowseName
DataType
TypeDefinition
Other
Subtype of the Enumeration type defined in OPC 10000-5