|
| 1 | +# umati showcase information model for Textile Testing Devices |
| 2 | + |
| 3 | +In the following the umati showcase describes the additional information on top |
| 4 | +of the OPC 40444 UA for Textile Testing Devices companion specification. |
| 5 | + |
| 6 | +Please refer to the provided XML-NodeSets, UaModeler-project or the [TTD |
| 7 | +repos](https://github.com/umati/TTD) for exemplary implementation. |
| 8 | + |
| 9 | +## NodeSets |
| 10 | + |
| 11 | +[NodeSet](https://github.com/OPCFoundation/UA-Nodeset/tree/latest/TTD) |
| 12 | + |
| 13 | +## General information valid for the umati showcase demonstration |
| 14 | + |
| 15 | +| **DISCLAIMER** | For all applications the OPC UA server is to be configured |
| 16 | +without predefined NodeIds for the instances. Clients need to utilize the |
| 17 | +Services [Browse](https://reference.opcfoundation.org/Core/docs/Part4/5.8.2/) |
| 18 | +and |
| 19 | +[TranslateBrowsePathsToNodeIds](https://reference.opcfoundation.org/Core/docs/Part4/5.8.4/) |
| 20 | +to access nodes of interest. | |
| 21 | + |
| 22 | +### Identification data |
| 23 | + |
| 24 | +The identification for textile testing devices is inherited from the Machinery |
| 25 | +companion specification. To fill the demo dashboard machine page with the most |
| 26 | +content the variables marked with a **strong mandatory** should be provided if |
| 27 | +you like to look the machine identification nicely. |
| 28 | + |
| 29 | +#### [**MachineIdentificationType Definition**](https://reference.opcfoundation.org/Machinery/docs/8.6/) |
| 30 | + |
| 31 | +| **Attribute** | **Value** | | | | | |
| 32 | +| --------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ | --------------------------- | --------------- | ------------------ | --------- | |
| 33 | +| BrowseName | MachineIdentificationType | | | | | |
| 34 | +| IsAbstract | False | | | | | |
| 35 | +| Description | Contains information about the identification and nameplate of a machine | | | | | |
| 36 | +| | | | | | | |
| 37 | +| **References** | **NodeClass** | **BrowseName** | **DataType** | **TypeDefinition** | **Other** | |
| 38 | +| Subtype of the 2:FunctionalGroupType defined in OPC 10000-100, i.e. inheriting the InstanceDeclarations of that Node. | | | | | | |
| 39 | +| 0:HasProperty | Variable | 0:DefaultInstanceBrowseName | 0:QualifiedName | 0:PropertyType | | |
| 40 | +| 0:HasInterface | ObjectType | IMachineVendorNameplateType | | | | |
| 41 | +| 0:HasInterface | ObjectType | IMachineTagNameplateType | | | | |
| 42 | +| Applied from IMachineVendorNameplateType | | | | | | |
| 43 | +| 0:HasProperty | Variable | 2:ProductInstanceUri | 0:String | 0:PropertyType | M, RO | |
| 44 | +| 0:HasProperty | Variable | 2:Manufacturer | 0:LocalizedText | 0:PropertyType | M, RO | |
| 45 | +| 0:HasProperty | Variable | 2:ManufacturerUri | 0:String | 0:PropertyType | O, RO | |
| 46 | +| 0:HasProperty | Variable | **2:Model** | 0:LocalizedText | 0:PropertyType | **M**, RO | |
| 47 | +| 0:HasProperty | Variable | **2:ProductCode** | 0:String | 0:PropertyType | **M**, RO | |
| 48 | +| 0:HasProperty | Variable | 2:HardwareRevision | 0:String | 0:PropertyType | O, RO | |
| 49 | +| 0:HasProperty | Variable | **2:SoftwareRevision** | 0:String | 0:PropertyType | **M**, RO | |
| 50 | +| 0:HasProperty | Variable | 2:DeviceClass | 0:String | 0:PropertyType | O, RO | |
| 51 | +| 0:HasProperty | Variable | 2:SerialNumber | 0:String | 0:PropertyType | M, RO | |
| 52 | +| 0:HasProperty | Variable | **YearOfConstruction** | UInt16 | 0:PropertyType | **M**, RO | |
| 53 | +| 0:HasProperty | Variable | MonthOfConstruction | Byte | 0:PropertyType | O, RO | |
| 54 | +| 0:HasProperty | Variable | InitialOperationDate | DateTime | 0:PropertyType | O, RO | |
| 55 | +| Applied from IMachineTagNameplateType | | | | | | |
| 56 | +| 0:HasProperty | Variable | 2:AssetId | 0:String | 0:PropertyType | O, RW | |
| 57 | +| 0:HasProperty | Variable | 2:ComponentName | 0:LocalizedText | 0:PropertyType | O, RW | |
| 58 | +| 0:HasProperty | Variable | **Location** | 0:String | 0:PropertyType | **M**, RW | |
| 59 | + |
| 60 | +#### Special requirements for correct location of the machine icon on the dashboard |
| 61 | + |
| 62 | +The instance _Location_ property is evaluated according to the special |
| 63 | +requirements detailed [Dashboard |
| 64 | +feature](../Dashboard.md#location-of-fair-machine-and-software-icons-on-the-dashboard) |
| 65 | +to place a map icon for the machine. |
| 66 | + |
| 67 | +### Adaption of the provided information models for your purpose |
| 68 | + |
| 69 | +- The provided NodeSet contains the address space with the ObjectTypes, |
| 70 | + VariableTypes and DataTypes of the MachineTools companion specification and |
| 71 | + **must not** be changed. |
| 72 | +- Change the URI of the instance namespace (optional, but recommended) |
| 73 | + |
| 74 | + `http://www.<MANUFACTURERDOMAIN>/example` |
| 75 | + |
| 76 | +- The rules for creating a URI can be found online. Please follow [this |
| 77 | + link](https://en.wikipedia.org/wiki/Uniform_Resource_Identifier). In the case |
| 78 | + of a URL as a URI, it is not necessary that the site actually exists, |
| 79 | + it only identifies the machine uniquely. In order to simplify debugging it is |
| 80 | + recommended to choose a URI which allows an identification of the machine also |
| 81 | + for third persons, e.g., by including the company name. |
| 82 | + |
| 83 | +## Value mapping between OPC UA companion specification and umati.app MachineTool page |
| 84 | + |
| 85 | +### TTD- Overview |
| 86 | + |
| 87 | + |
| 88 | + |
| 89 | +Hint: TTD has not stacklight so it is not shown |
| 90 | + |
| 91 | +### TTD - Identification |
| 92 | + |
| 93 | + |
| 94 | + |
| 95 | +### TTD - Active Program |
| 96 | + |
| 97 | + |
| 98 | + |
| 99 | +### TTD - Results |
| 100 | + |
| 101 | + |
0 commit comments