5 Device model ToC Previous Next

5.5 Interfaces ToC Previous Next

5.5.2 VendorNameplate Interface ToC Previous Next index

IVendorNameplateType includes Properties that are commonly used to describe a TopologyElement from a manufacturer point of view. They can be used as part of the identification. The Values of these Properties are typically provided by the component vendor.

The VendorNameplate Interface is illustrated in Figure 8 and formally defined in Table 14.

readme_files/image010.png Figure 8 – VendorNameplate Interface

Table 14 – IVendorNameplateType definition

Attribute Value
BrowseName IVendorNameplateType
IsAbstract True

Subtype of the BaseInterfaceType defined in OPC 10001-7

References NodeClass BrowseName DataType TypeDefinition ModellingRule
           
Product-specific Properties          
HasProperty Variable Manufacturer LocalizedText PropertyType Optional
HasProperty Variable ManufacturerUri String PropertyType Optional
HasProperty Variable Model LocalizedText PropertyType Optional
HasProperty Variable ProductCode String PropertyType Optional
HasProperty Variable HardwareRevision String PropertyType Optional
HasProperty Variable SoftwareRevision String PropertyType Optional
HasProperty Variable DeviceRevision String PropertyType Optional
HasProperty Variable DeviceManual String PropertyType Optional
HasProperty Variable DeviceClass String PropertyType Optional
Product instance-specific Properties          
HasProperty Variable SerialNumber String PropertyType Optional
HasProperty Variable ProductInstanceUri String PropertyType Optional
HasProperty Variable RevisionCounter Int32 PropertyType Optional
           

Product type specific Properties:

Manufacturer provides the name of the company that manufactured the item this Interface is applied to. ManufacturerUri provides a unique identifier for this company. This identifier should be a fully qualified domain name; however, it may be a GUID or similar construct that ensures global uniqueness.

Model provides the name of the product.

ProductCode provides a unique combination of numbers and letters used to identify the product. It may be the order information displayed on type shields or in ERP systems.

HardwareRevision provides the revision level of the hardware.

SoftwareRevision provides the version or revision level of the software component, the software/firmware of a hardware component, or the software/firmware of the Device.

DeviceRevision provides the overall revision level of a hardware component or the Device. As an example, this Property can be used in ERP systems together with the ProductCode Property.

DeviceManual allows specifying an address of the user manual. It may be a pathname in the file system or a URL (Web address).

DeviceClass indicates in which domain or for what purpose a certain item for which the Interface is applied is used. Examples are “ProgrammableController”, “RemoteIO”, and “TemperatureSensor”. This standard does not predefine any DeviceClass names. More specific standards that utilize this Interface will likely introduce such classifications (e.g. IEC 62769, OPC 30000, or OPC 10020).

Product instance specific Properties:

SerialNumber is a unique production number provided by the manufacturer. This is often stamped on the outside of a physical component and may be used for traceability and warranty purposes.

ProductInstanceUri is a globally unique resource identifier provided by the manufacturer. This is often stamped on the outside of a physical component and may be used for traceability and warranty purposes. The maximum length is 255 characters. The recommended syntax of the ProductInstanceUri is: <ManufacturerUri>/<any string> where <any string> is unique among all instances using the same ManufacturerUri.

Examples: “some-company.com/5ff40f78-9210-494f-8206-c2c082f0609c”, “some-company.com/snr-16273849” or “some-company.com/model-xyz/snr-16273849”.

RevisionCounter is an incremental counter indicating the number of times the configuration data has been modified. An example would be a temperature sensor where the change of the unit would increment the RevisionCounter but a change of the measurement value would not affect the RevisionCounter.

Companion specifications may specify additional semantics for the contents of these Properties.

Table 15 specifies the mapping of these Properties to the International Registration Data Identifiers (IRDI) defined in ISO/ICE 11179-6. They should be used if a Server wants to expose a dictionary reference as defined in OPC 10001-5.

Table 15 – VendorNameplate Mapping to IRDIs

Property IRDI
Manufacturer 0112/2///61987#ABA565 - manufacturer
ManufacturerUri -
Model 0112/2///61987#ABA567 - name of product
SerialNumber 0112/2///61987#ABA951 - serial number
HardwareRevision 0112/2///61987#ABA926 - hardware version
SoftwareRevision 0112/2///61987#ABA601 - software version
DeviceRevision -
RevisionCounter -
ProductCode 0112/2///61987#ABA300 – code of product
ProductInstanceUri -
DeviceManual -
DeviceClass 0112/2///61987#ABA566 - type of product

Previous Next