12.2.1 Device Type

12.2.1.1 General

OPC UA for Devices and FDT use different approaches in regard to representation of device type specific data. Some of the data defined in OPC UA for representation of the device type is available only in instance-specific data of the DTMs (see Figure 12).

The data from FDT may be mapped either to Attributes (table header “Attribute”) or to properties and other child Nodes (table header “BrowseName”) of the corresponding OPC UA Node.

Figure 12 – Example for sources of DeviceType information

For this reason the device type specific data of OPC is mapped to data on several interfaces of the DTM (see Table 58).

12.2.1.2 Mapping for DeviceType (“Types” standard Object)

All device types provided by DTMs in IDtmInformation shall be represented as subtypes of FdtDeviceType in the “Types” standard Object (see Table 58).

Table 58 – DeviceType mapping
OPCFDT
AttributeInterfaceMethodData memberDescription
BrowseName IDtmInformation<>GetSupported­TypesDeviceTypeInfo.Name
DisplayNameIDtmInformation<>GetSupported­TypesDeviceTypeInfo.Name
BrowseNameInterfaceMethodData memberDescription
2:SerialNumberMapping for online device only, see Table 61
2:RevisionCounterNot supported. Value is always set to -1
2:ManufacturerIDtmInformation<>GetSupported­TypesDeviceTypeInfo.ProductManufacturerName
ManufacturerIdIDtmInformationGetDeviceIdentInfoDeviceIdentInfo.ManufacturerId
2:ModelIDtmInformation<>GetSupported­TypesDeviceTypeInfo.ProductName
2:DeviceManualAll documents will be provided in folder Documentation
2:DeviceRevisionIDtmInformation<>GetSupported­TypesDeviceTypeInfo.ProductRevision
2:SoftwareRevisionIDtmInformationGetDeviceIdentInfoDeviceIdentInfo.SoftwareRevision
2:HardwareRevisionIDtmInformationGetDeviceIdentInfoDeviceIdentInfo.HardwareRevision
2:DeviceClass(O)IDtmInformation<>GetSupported­TypesDeviceTypeInfo.DeviceClassifications[0].DomainId + “:” + DeviceTypeInfo.DeviceClassifications[0].IdThe value is a concatenation of the enumeration member names for DomainId and Id.
DeviceTypeIdIDtmInformation<>GetSupported­TypesDeviceTypeInfo.Id
2:ManufacturerUri(O)Not supported.
2:ProductCode(O)Not supported.
2:ProductInstanceUri(O)Not supported.
<CP_Identifier>(O)IDtmInformation<>GetSupported­Types

TypeInfo.BusCategories[].Category¬Type == required

<Identifier> = TypeInfo.BusCategories[].Protocol¬Name

HasComponent-reference of type RequiredProtocol.

IDtmInformation

IChannels

<>GetSupported­Types

IChannels.CommunicationChannels

TypeInfo.BusCategories[].Category¬Type == supported

<Identifier> = CommunicationChannelItem.Id

HasComponent-reference of type SupportedProtocol.

If one Channel requires multiple protocols, multiple connection points are provided, an additional number is concatenated to the channel id.

0:IconIDtmInformationGetFdtIcon()Iconsee explanation below the table
Applied from IFdtDeviceHealthType
2:DeviceHealthMapping for online device only, see Table 61
2:DeviceHealthAlarms(O)---No mapping defined.
OPCFDT
BrowseNameInterfaceMethodData memberDescription
Applied from IFdtSupportInfoType
2:DeviceTypeImage(O)This folder will contain items as defined in 12.2.8.1.
2:Documentation
(O)		IDtmInformation<>GetSupported­TypesDeviceTypeInfo.DocumentsThis folder will contain items that represent the shown FDT data member as defined in 7.3
2:ProtocolSupport (O)INetworkDataGetNetworkDataInfoNetworkData.
DeviceInformationDocuments		This folder will be provided as defined in 12.2.8.2.
2:ImageSet(O)Not supported.

A DTM can provide several icons (list of icons). The rule for selection of the icon and extraction of an image (a specific resolution) from the icon is frame application specific. The selection of the image format in general is implementation specific, all types are allowed that are defined in OPC UA 10000-3.

12.2.1.3 Mapping for Offline Device (“Objects” standard Object)

The information for a device (instance) is based on the information provided by a DTM (instance). The mapping for the device node is defined in Table 59.

Table 59 – Device information mapping
OPCFDT
AttributeInterfaceMethodData memberDescription
TypeReference---NodeId of the DeviceType
BrowseName IDtmDtmSystemGuiLabel
DisplayNameIDtmDtmSystemGuiLabel

The device parameters provide offline identification information based on DTM type information intended for identification. This data may provide values or regular expressions to define ranges of supported values.

In the call to IDtmInformation.GetDeviceIdentInfo() a protocol must be specified. The first entry from the list of INetworkData.ActiveProtocols shall be used.

GetDeviceIdentInfo() may return a list of DeviceIdentInfo where the first entry is used for the parameters as defined below. Exposing the remaining list entries is implementation specific.

Table 60 – Offline device parameter mapping
OPCFDT
BrowseNameInterfaceMethodData memberDescription
ManufacturerIdIDtmInformationGetDeviceIdentInfo()DeviceIdentInfo[0].GetManufacturerId()
DeviceTypeIdIDtmInformationGetDeviceIdentInfo()DeviceIdentInfo[0].
GetDeviceTypeId()
2:NetworkAddress INetworkDataGetAddressInfo()AddressInfo.DeviceAddresses[].Addressstring array containing all addresses provided
DeviceTag-/--/-(default value)
2:Serial Number-/--/-(default value)
2:SoftwareRevisionIDtmInformationGetDeviceIdentInfo()DeviceIdentInfo[0].GetSoftwareRevision()
2:HardwareRevisionIDtmInformationGetDeviceIdentInfo()DeviceIdentInfo[0].GetHardwareRevision()
Contents of FunctionalGroup “Identification” (see 12.2.5.)
ProtocolIdIDtmInformationGetDeviceIdentInfo()DeviceIdentInfo[0].GetProtocolId()
ProtocolSpecific­IdentificationIDtmInformationGetDeviceIdentInfo()DeviceIdentInfo[0].
GetProtocolSpecificProperties()
DeviceSpecific-IdentificationIDtmInformationGetDeviceIdentInfo()DeviceIdentInfo[0].DeviceSpecificProperties
12.2.1.4 Mapping for Online Device (“Objects” standard Object online reference)

Device parameters provide identification information based on data read online from the device. This data may be different from the data provided in the DeviceType.

Table 61 – Online device parameter mapping
OPCFDT
BrowseNameInterfaceMethodData memberDescription
ManufacturerIdIHardwareInformation<>HardwareScan()DeviceScanInfo.GetManufacturerId()
DeviceTypeIdIHardwareInformation<>HardwareScan()DeviceScanInfo.GetDeviceTypeId()
2:NetworkAddress IHardwareInformation<>HardwareScan()DeviceScanInfo.GetAddress()
DeviceTagIHardwareInformation<>HardwareScan()DeviceScanInfo.GetTag()
2:DeviceHealthIOnlineOperation<>ReadDevice-Status()DeviceStatus.StatusFlagFor mapping of the enumeration values see 12.1.1.
2:Serial NumberIHardwareInformation<>HardwareScan()DeviceScanInfo.SerialNumber()
2:SoftwareRevisionIHardwareInformation<>HardwareScan()DeviceScanInfo.GetSoftwareRevision()
2:HardwareRevisionIHardwareInformation<>HardwareScan()DeviceScanInfo.GetHardwareRevision()
Contents of FunctionalGroup “Identification” (see 12.2.5.)
ProtocolIdIHardwareInformation<>HardwareScan()DeviceScanInfo.GetProtocolId()
ProtocolSpecific­IdentificationIHardwareInformation<>HardwareScan()DeviceScanInfo.GetProtocolSpecific­Properties()
DeviceSpecific-IdentificationIHardwareInformation<>HardwareScan()DeviceScanInfo.DeviceSpecificProperties