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 5 and formally defined in Table 17.
Figure 5 – VendorNameplate Interface
Table 17 – IVendorNameplateType definition
Attribute |
Value |
||||
BrowseName |
IVendorNameplateType |
||||
IsAbstract |
True |
||||
References |
NodeClass |
BrowseName |
DataType |
TypeDefinition |
ModellingRule |
Subtype of the BaseInterfaceType defined in OPC 10001-7 |
|||||
|
|
|
|
|
|
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 |
HasProperty |
Variable |
SoftwareReleaseDate |
DateTime |
PropertyType |
Optional |
HasProperty |
Variable |
PatchIdentifiers |
String[] |
PropertyType |
Optional |
Conformance Units |
|||||
DI Nameplate |
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. SemanticVersionString (a sub-type of String defined in OPC 10000-5) may be used when using the Semantic Versioning format.
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. SemanticVersionString (a sub-type of String defined in OPC 10000-5) may be used when using the Semantic Versioning format.
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. SemanticVersionString (a sub-type of String defined in OPC 10000-5) may be used when using the Semantic Versioning format.
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.
SoftwareReleaseDate defines the date when the software is released. If the version information is about patches, this should be the date of the latest patch. It is additional information for the user.
PatchIdentifiers identify the list of patches that are applied to a software version. The format and semantics of the strings are vendor-specific. The order of the strings shall not be relevant.
Companion specifications may specify additional semantics for the contents of these Properties.
Table 18 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 18 – VendorNameplate Mapping to IRDIs
Property |
IRDI |
Manufacturer |
|
ManufacturerUri |
|
Model |
|
SerialNumber |
|
HardwareRevision |
|
SoftwareRevision |
|
DeviceRevision |
- |
RevisionCounter |
|
ProductCode |
|
ProductInstanceUri |
|
DeviceManual |
- |
DeviceClass |