6.3.1.7 Network

This chapter includes all object types needed to represent the physical network topology of a PROFINET network.

Figure 18 shows an example which illustrates the relations between network objects of a single port PROFINET device and a 4 port Ethernet switch.

Figure 18 – Network Topology

The Ethernet interface, ports and cables are represented by objects in the address space. This Ethernet objects relate to each other by CommLinkTo references. This enables the OPC UA Server to represent the physical network topology of the PROFINET network.

6.3.1.7.1 IPnInterfaceType
Table 51 – IPnInterfaceType Definition
Attribute Value
BrowseNameIPnInterfaceType
IsAbstractTrue
References Node Class BrowseName DataType TypeDefinition Modelling Rule
Subtype of BaseInterfaceType defined in [OPC 10000-5].
HasComponentObjectPortsPnPortContainerTypeMandatory
HasPropertyVariableNameOfStationStringPropertyTypeMandatory
HasPropertyVariableDeviceRolePnDeviceRoleOptionSetPropertyTypeMandatory
HasPropertyVariableDeviceVendorStringPropertyTypeOptional
HasPropertyVariableVendorIdUInt16PropertyTypeMandatory
HasPropertyVariableDeviceIdUInt16PropertyTypeMandatory
HasPropertyVariableDeviceInstanceUInt16PropertyTypeOptional
HasPropertyVariableOEMVendorIdUInt16PropertyTypeOptional
HasPropertyVariableOEMDeviceIdUInt16PropertyTypeOptional
CommLinkToObjectEthernetInterfaceEthernetInterfaceTypeOptional
HasComponentObjectStatisticPnPortStatisticTypeOptional
HasComponentMethodSetNameOfStationSetNameOfStationMethodOptional

The BrowseName of an interface object instance shall be the PROFINET interface id with the range 1..16 in decimal number string format.

The NameOfStation variable may be set with the SetNameOfStation method. Nevertheless, the variable itself shall always be read-only.

The CommLinkTo reference points to an EthernetInterfaceType object instance. An object of the IPv4FeatureType must be implemented in this EthernetInterfaceType object instance.

Mapping to PROFINET properties:

BrowseName Method Source
NameOfStation DCPDCP-Identify-ResPDU | NameOfStationValue
DeviceRole DCPDCP-Identify-ResPDU | DeviceRoleDetails
DeviceVendor DCPDCP-Identify-ResPDU | DeviceVendorValue
VendorId DCPDCP-Identify-ResPDU | DeviceIDBlockRes | DeviceIDValue
DeviceId DCPDCP-Identify-ResPDU | DeviceIDBlockRes | DeviceIDValue
DeviceInstance DCPDCP-Identify-ResPDU | DeviceInstanceValue
OEMVendorId DCPDCP-Identify-ResPDU | OEMDeviceIDBlockRes | DeviceIDValue
OEMDeviceId DCPDCP-Identify-ResPDU | OEMDeviceIDBlockRes | DeviceIDValue
6.3.1.7.1.1 SetNameOfStation Method

This optional method writes the NameOfStation remanent to the PROFINET device and sets the NameOfStation variable accordingly.

Signature

	SetNameOfStation (
		[in]	String NameOfStation
		);
	
Argument Description
NameOfStationString containing the new NameOfStation to be written remanent to the device. The maximum length shall be limited to 240 characters (See [PN Protocol] for details).

Method Result Codes

ResultCode Description
Bad_InvalidArgumentThe Server is not able to apply the name. The name may be too long or may contain invalid characters.
Bad_UnexpectedErrorThe Server is not able to apply the name because an unexpected error occurred. The device might be temporarily unavailable or unreachable due to network failure.
6.3.1.7.2 PnInterfaceContainerType
Table 52 – PnInterfaceContainerType Definition
Attribute Value
BrowseNamePnInterfaceContainerType
IsAbstractFalse
References Node Class BrowseName DataType TypeDefinition Modelling Rule
Subtype of BaseObjectType defined in [OPC 10000-5].
HasPnInterfaceObject<Interfaces>BaseObjectType

Optional

Placeholder

The <Interfaces> shall have the references defined in Table 53 and Table 54.

Table 53 – PnInterfaceContainerType Additional References
Source Path Reference Type Is Forward Target Path
<Interfaces>0:HasInterfaceTrue
Table 54 – PnInterfaceContainerType Additional Subcomponents
Source Path References NodeClass BrowseName

DataType

TypeDefinition

Others
Applied from IPnInterfaceType
<Interfaces>0:HasComponentObjectPortsPnPortContainerTypeM
<Interfaces>0:HasPropertyVariableNameOfStation

String

PropertyType

M
<Interfaces>0:HasPropertyVariableDeviceRole

PnDeviceRoleOptionSet

PropertyType

M
<Interfaces>0:HasPropertyVariableDeviceVendorString
PropertyType
O
<Interfaces>0:HasPropertyVariableVendorId

UInt16

PropertyType

M
<Interfaces>0:HasPropertyVariableDeviceId

UInt16

PropertyType

M
<Interfaces>0:HasPropertyVariableDeviceInstanceUInt16
PropertyType
O
<Interfaces>0:HasPropertyVariableOEMVendorIdUInt16
PropertyType
O
<Interfaces>0:HasPropertyVariableOEMDeviceIdUInt16
PropertyType
O
<Interfaces>CommLinkToObjectEthernetInterfaceEthernetInterfaceTypeO
<Interfaces>0:HasComponentObjectStatisticPnPortStatisticTypeO
<Interfaces>0:HasComponentMethodSetNameOfStationSetNameOfStationMethodO
6.3.1.7.3 PnPortType

The PnPortType Object Type includes the port specific data of a port submodule.

A PnRealSubmoduleType instance representing a port submodule has an IsPnPort reference to a PnPortType object instance.

Table 55 – PnPortType Definition
Attribute Value
BrowseNamePnPortType
IsAbstractFalse
References Node Class BrowseName DataType TypeDefinition Modelling Rule
Subtype of BaseObjectType defined in [OPC 10000-5].
HasComponentObjectStatisticPnPortStatisticTypeOptional
HasComponentVariableLinkStatePnLinkStateEnumerationBaseDataVariableType Optional
HasComponentVariablePortStatePnPortStateEnumerationBaseDataVariableType Optional
HasComponentVariableMAUTypeUInt16BaseDataVariableType Optional
HasComponentVariableCableDelayUInt32BaseDataVariableType Optional
HasComponentVariablePowerBudgetUInt32BaseDataVariableType Optional
HasComponentVariableIsWirelessBooleanBaseDataVariableType Optional
CommLinkToObjectEthernetPortEthernetPortTypeOptional
GeneratesEventObjectTypePnTopologyChangedEventType

Mapping to PROFINET properties:

BrowseName Method Source
MAUType ReadPDPortDataReal | MAUType
CableDelay ReadPDPortDataReal | LineDelay
PowerBudget ReadPDPortFODataReal | FiberOpticDiagnosisInfo | FiberOpticPowerBudgetReal
IsWireless ReadPDPortDataReal | MediaType
6.3.1.7.4 PnPortContainerType
Table 56 – PnPortContainerType Definition
Attribute Value
BrowseNamePnPortContainerType
IsAbstractFalse
References Node Class BrowseName DataType TypeDefinition Modelling Rule
Subtype of BaseObjectType defined in [OPC 10000-5].
HasPnPortObject<Ports>PnPortType

Optional

Placeholder

6.3.1.7.5 PnPortStatisticType
Table 57 – PnPortStatisticType Definition
Attribute Value
BrowseNamePnPortStatisticType
IsAbstractFalse
References Node Class BrowseName DataType TypeDefinition Modelling Rule
Subtype of BaseObjectType defined in [OPC 10000-5].
HasComponentVariableInOctetsUInt32BaseDataVariableTypeOptional
HasComponentVariableOutOctetsUInt32BaseDataVariableTypeOptional
HasComponentVariableInDiscardsUInt32BaseDataVariableTypeOptional
HasComponentVariableOutDiscardsUInt32BaseDataVariableTypeOptional
HasComponentVariableInErrorsUInt32BaseDataVariableTypeOptional
HasComponentVariableOutErrorsUInt32BaseDataVariableTypeOptional

The port statistic counters can be read from a PROFINET device with the Read PD Port Statistic PROFINET service.

6.3.1.7.6 NetworkComponentType

The NetworkComponentType is the abstract base ObjectType for different types of network components.

Table 58 – NetworkComponentType Definition
Attribute Value
BrowseNameNetworkComponentType
IsAbstractTrue
References Node Class BrowseName DataType TypeDefinition Modelling Rule
Subtype of BaseObjectType defined in [OPC 10000-5].
HasComponentObject<FeatureName>NetworkComponentFeatureTypeOptionalPlaceholder
HasComponentVariableEnabledBooleanBaseDataVariableTypeOptional
CommLinkToObject<ComponentName>NetworkComponentTypeOptionalPlaceholder

The Enabled variable indicates if the network component is activated (Enabled == True) or deactivated (Enabled == False).

6.3.1.7.7 EthernetInterfaceType

The EthernetInterfaceType is used to represent Ethernet network interfaces.

Table 59 – EthernetInterfaceType Definition
Attribute Value
BrowseNameEthernetInterfaceType
IsAbstractFalse
References Node Class BrowseName DataType TypeDefinition Modelling Rule
Subtype of NetworkComponentType.
HasComponentVariableMacAddressByte [6]BaseDataVariableTypeMandatory
CommLinkToObject<PortName>EthernetPortTypeMandatoryPlaceholder

The MacAddress Variable is read only and represents the unique Layer2 source MAC address of the related interface.

Mapping to PROFINET properties:

BrowseName Method Source
MacAddress DCPDCP-Identify-ResPDU | MACAddressBlockRes | MACAddressValue
6.3.1.7.8 EthernetPortType

The EthernetPortType is used to represent Ethernet ports.

Table 60 – EthernetPortType Definition
Attribute Value
BrowseNameEthernetPortType
IsAbstractFalse
References Node Class BrowseName DataType TypeDefinition Modelling Rule
Subtype of NetworkComponentType.
HasComponentVariablePhysAddressByte [6] BaseDataVariableTypeOptional
CommLinkToObject<EthernetPort>EthernetPortTypeOptional

The PhysAddress Variable is read only and contains a MAC address representing the Port.

6.3.1.7.9 NetworkComponentFeatureType

The NetworkComponentFeatureType is the abstract base ObjectType for different types of network components.

Table 61 – NetworkComponentFeatureType Definition
Attribute Value
BrowseNameNetworkComponentFeatureType
IsAbstractTrue
References Node Class BrowseName DataType TypeDefinition Modelling Rule
Subtype of BaseObjectType defined in [OPC 10000-5].
6.3.1.7.10 IPv4FeatureType

The IPv4FeatureType is used to represent IPv4 settings of a network interface.

Table 62 – IPv4FeatureType Definition
Attribute Value
BrowseNameIPv4FeatureType
IsAbstractFalse
References Node Class BrowseName DataType TypeDefinition Modelling Rule
Subtype of NetworkComponentFeatureType.
HasComponentVariableIpAddressByte[4]BaseDataVariableTypeMandatory
HasComponentVariableSubnetMaskByte[4]BaseDataVariableTypeMandatory
HasComponentVariableDefaultGatewayByte[4]BaseDataVariableTypeMandatory
HasComponentVariableDhcpEnabledBooleanBaseDataVariableTypeMandatory

Mapping to PROFINET properties:

BrowseName Method Source
IpAddress DCPDCP-Identify-ResPDU | IPParameterBlockRes | IPParameterValue | IPAddress
SubnetMask DCPDCP-Identify-ResPDU | IPParameterBlockRes | IPParameterValue | Subnetmask
DefaultGateway DCPDCP-Identify-ResPDU | IPParameterBlockRes | IPParameterValue | StandardGateway
DhcpEnabled DCPDCP-Identify-ResPDU | DHCPParameterBlockRes | DHCPParameter | DHCPParameterLength

The IpAddress Variable describes the IPv4 address on the interface.

The SubnetMask Variable describes the IPv4 Subnet mask on the interface.

The DefaultGateway Variable describes the IPv4 address of the default gateway.

The DhcpEnabled Variable specifies whether the DHCPv4 Client functionality for this interface is enabled.