1 Scope
This document provides a comprehensive overview of the information model structure of loading equipment defined in the OPC UA Companion Specification Mining. As mentioned in OPC 40560, this machine and system category-level document contains parent types and common features of machines, equipment, systems and services that are classified as loading equipment or systems.
2 Normative references
The following documents are referred to in the text in such a way that some or all of their content constitutes requirements of this document. For dated references, only the edition cited applies. For undated references, the latest edition of the referenced document (including any amendments and errata) applies
OPC 10000-1, OPC Unified Architecture - Part 1: Overview and Concepts
OPC 10000-1
OPC 10000-2, OPC Unified Architecture - Part 2: Security Model
OPC 10000-2
OPC 10000-3, OPC Unified Architecture - Part 3: Address Space Model
OPC 10000-3
OPC 10000-4, OPC Unified Architecture - Part 4: Services
OPC 10000-4
OPC 10000-5, OPC Unified Architecture - Part 5: Information Model
OPC 10000-5
OPC 10000-6, OPC Unified Architecture - Part 6: Mappings
OPC 10000-6
OPC 10000-7, OPC Unified Architecture - Part 7: Profiles
OPC 10000-7
OPC 10000-100, OPC Unified Architecture - Part 100: Devices
OPC 10000-100
OPC 40001-1, OPC UA for Machinery - Part 1: Basic Building Blocks
http://www.opcfoundation.org/UA/Machinery/
OPC 40560, OPC Unified Architecture for Mining – General
http://opcfoundation.org/UA/Mining/General/
3 Terms, definitions and conventions
3.1 Overview
It is assumed that basic concepts of OPC UA information modelling OPC 10000-1, OPC 10000-100 and OPC 40001‑1 are understood in this document. This document will use these concepts to describe the OPC 40562-1 Information Model. For the purposes of this document, the terms and definitions given in the documents referenced in the OPC Core documents, OPC 10000-1, OPC 10000-100, OPC 40001-1 and OPC 40560 apply.
Note that OPC UA terms and terms defined in this specification are italicized in the specification.
3.2 Conventions used in this document
The conventions and definitions described in the OPC Core documents, OPC 10000-1, OPC 10000-100, OPC 40001-1 and OPC 40560 apply
4 General information to 40562-1: Loading General
4.1 Introduction to the OPC UA Companion Specification Mining
For general information on the OPC UA Companion Specification Mining and OPC UA in general, please refer to OPC 40560.
As explained in OPC 40560, the machine and system category-level documents serve as an abstraction layer for the types of machinery with similar functionalities.
4.2 Introduction to the Loading Equipment General
4.2.1 Untitled
The Loading Equipment General document, OPC 40562-1, serves as an abstraction layer to all machines and systems that are classified as loading equipment or systems. Therefore, it contains parent types and common features that are shared by two or more extraction equipment or systems. Documents detailing the extraction equipment or systems, that are part of the OPC 40562 multi-part documents, are given in Table 1.
| Document Name | Number | Description |
| General (This document) | OPC 40562-1 | General Information about Loading Equipment |
| Hydraulic Excavator | OPC 40562-2 | Machine specific information about the Hydraulic Excavator machine |
4.2.2 Untitled
This document contains common OPC UA type definitions to all loading equipment and systems.
5 OPC UA ObjectTypes
5.1 LoadingMachineType ObjectType definition
5.1.1 Overview
The LoadingMachineType provides a representation of loading machines within the MiningEquipmentType as shown in Figure 1. Importantly, it is composed of a ParameterSet Object instance declaration to cover all relevant parameters of the equipment. Intended to be used as an AddIn, as defined in OPC 10001-7, this ObjectType can serve as a type definition of an Object instance declaration called LoadingMachine by definition.

5.1.2 ObjectType Definition
The LoadingMachineType is formally defined in Table 2.
| Attribute | Value | ||||
| BrowseName | LoadingMachineType | ||||
| IsAbstract | False | ||||
| References | Node Class | BrowseName | DataType | TypeDefinition | Other |
| Subtype of the MiningEquipmentType defined in OPC 40560, i.e. inheriting the InstanceDeclarations of that Node. | |||||
| 0:HasProperty | Variable | DefaultInstanceBrowseName | 0:QualifiedName | 0:PropertyType | |
| 0:HasComponent | Object | 2:MethodSet | 0:BaseObjectType | O | |
| 0:HasComponent | Object | 2:ParameterSet | 0:BaseObjectType | O | |
| Conformance Units | |||||
|---|---|---|---|---|---|
| Loading General Functional Variables | |||||
| Loading General Methods |
The components of the LoadingMachineType have additional References which are defined in Table 3.
| BrowsePath | References | NodeClass | BrowseName | DataType | TypeDefinition | Others |
| 2:MethodSet | 0:HasComponent | Method | PositioningComplete | O | ||
| 2:MethodSet | 0:HasComponent | Method | RequestForLoading | O | ||
| 2:MethodSet | 0:HasComponent | Method | StopLoading | O | ||
| 2:ParameterSet | 0:HasComponent | Variable | ExclusionZone | 0:3DFrame[] | 0:3DFrameType | O, RO |
| 2:ParameterSet | 0:HasComponent | Variable | MachinePose | 0:3DFrame | 0:3DFrameType | O, RO |
The components of the LoadingMachineType have additional references which are defined in Table 4.
| BrowsePath | Value Attribute | Description Attribute |
| DefaultInstanceBrowseName | LoadingMachine | The default BrowseName for instances of the type |
5.1.3 RequestForLoading Method
The signature of this Method is specified below. Table 5 specifies the Arguments and AddressSpace representation, respectively.
Signature
RequestForLoading(
[out] 0:Boolean LoadingStartAcknowledged );| Argument | Description |
| LoadingStartAcknowledged | The LoadingStartAcknowledged variable indicates whether the loading request was successful or not True – Okay False – Loading Request not successful |
| Attribute | Value | ||||
| BrowseName | RequestForLoading | ||||
| References | NodeClass | BrowseName | DataType | TypeDefinition | ModellingRule |
|---|---|---|---|---|---|
| 0:HasProperty | Variable | 0:OutputArguments | 0:Argument[] | 0:PropertyType | 0:Mandatory |
5.1.4 StopLoading Method
The signature of this Method is specified below. Table 7 specifies the Arguments and AddressSpace representation, respectively.
Signature
StopLoading(
[out] 0:Boolean LoadingStopAcknowledged );| Argument | Description |
| LoadingStopAcknowledged | The LoadingStopAcknowledged variable indicates whether the stop loading request was successful or not True – Okay False – Stop Loading Request not successful |
| Attribute | Value | ||||
| BrowseName | StopLoading | ||||
| References | NodeClass | BrowseName | DataType | TypeDefinition | ModellingRule |
|---|---|---|---|---|---|
| 0:HasProperty | Variable | 0:OutputArguments | 0:Argument[] | 0:PropertyType | 0:Mandatory |
5.1.5 PositioningComplete Method
The signature of this Method is specified below. Table 9 specifies the Arguments and AddressSpace representation, respectively.
Signature
PositioningComplete(
[out] 0:Boolean PositioningCompleteResult );| Argument | Description |
| PositioningCompleteResult | The PositioningComplete method is called by a partnering machine when they have completed the positioning procedure. True – Okay False – Positioning Complete Call not reciprocated |
| Attribute | Value | ||||
| BrowseName | PositioningComplete | ||||
| References | NodeClass | BrowseName | DataType | TypeDefinition | ModellingRule |
|---|---|---|---|---|---|
| 0:HasProperty | Variable | 0:OutputArguments | 0:Argument[] | 0:PropertyType | 0:Mandatory |
6 Profiles and Conformance Units
This chapter defines the corresponding profiles and conformance units for the OPC UA Information Model for OPC 40562-1. Profiles are named groupings of conformance units. Facets are profiles that will be combined with other Profiles to define the complete functionality of an OPC UA Server or Client. The following tables specify the facets available for Servers that implement the OPC 40562-1 Information Model companion specification.
NOTE: The names of the supported profiles are available in the Server Object under ServerCapabilities.ServerProfileArray
6.1 Conformance Units
Table 11 defines the corresponding Conformance Units for the OPC UA Information Model for OPC 40562-1: OPC UA for Mining - Loading - General.
| Category | Title | Description |
| Server | Loading General Functional Variables | Supports all mandatory variables part of the LoadingMachineType type definition. |
| Server | Loading General Methods | Supports all mandatory methods part of the LoadingMachineType type definition. |
| Client | Loading General Client Functional Variables | Supports querying all mandatory variables part of the LoadingMachineType type definition. |
| Client | Loading General Client Methods | Supports calling all mandatory methods part of the LoadingMachineType type definition. |
6.2 Profiles
6.2.1 Profile list
Table 12 lists all Profiles defined in this document and defines their URIs.
| Profile | URI |
| Loading General Core Server Facet | http://opcfoundation.org/UA-Profile/Mining/Loading/General/Server/Core |
| Loading General Core Client Facet | http://opcfoundation.org/UA-Profile/Mining/Loading/General/Client/Core |
6.2.2 Untitled
6.2.3 Server Facets
6.2.3.1 Overview
The following sections specify the Facets available for Servers that implement the OPC 40562-1: OPC UA for Mining - Loading - General companion specification.
6.2.3.2 Loading General Core Server Facet
Table 13 defines a Profile that describes the base characteristics for an OPC UA Server that has implemented the OPC 40562-1 Information Model.
| Group | Conformance Unit / Profile Title | Mandatory / Optional |
| Loading General | Loading General Functional Variables | M |
| Loading General | Loading General Methods | M |
6.2.4 Client Facets
6.2.4.1 Overview
The following tables specify the Facets available for Clients that implement the OPC 40562-1: OPC UA for Mining - Loading - General companion specification.
6.2.4.2 Loading General Core Client Facet
Table 14 defines a Facet that describes the base characteristics for an OPC UA Client querying an OPC UA Server that has implemented the OPC 40562-1 Information Model.
| Group | Conformance Unit / Profile Title | Mandatory / Optional |
| Loading General | Loading General Client Functional Variables | M |
| Loading General | Loading General Client Methods | M |
7 Namespaces
7.1 Namespace Metadata
Table 15 defines the namespace metadata for this document. The Object is used to provide version information for the namespace and an indication about static Nodes. Static Nodes are identical for all Attributes in all Servers, including the Value Attribute. See OPC 10000-5 for more details.
The information is provided as Object of type NamespaceMetadataType. This Object is a component of the Namespaces Object that is part of the Server Object. The NamespaceMetadataType ObjectType and its Properties are defined in OPC 10000-5.
The version information is also provided as part of the ModelTableEntry in the UANodeSet XML file. The UANodeSet XML schema is defined in OPC 10000-6.
| Attribute | Value | ||
| BrowseName | http://opcfoundation.org/UA/Mining/Loading/General/ | ||
| Property | DataType | Value | |
|---|---|---|---|
| NamespaceUri | String | http://opcfoundation.org/UA/Mining/Loading/General/ | |
| NamespaceVersion | String | 1.0.0 | |
| NamespacePublicationDate | DateTime | 2022-09-01 | |
| IsNamespaceSubset | Boolean | False | |
| StaticNodeIdTypes | IdType [] | System.Int32[] | |
| StaticNumericNodeIdRange | NumericRange [] | ||
| StaticStringNodeIdPattern | String | ||
Note: The IsNamespaceSubset Property is set to False as the UaNodeSet XML file contains the complete Namespace. Servers only exposing a subset of the Namespace need to change the value to True.
7.2 Handling of OPC UA Namespaces
Namespaces are used by OPC UA to create unique identifiers across different naming authorities. The Attributes NodeId and BrowseName are identifiers. A Node in the UA AddressSpace is unambiguously identified using a NodeId. Unlike NodeIds, the BrowseName cannot be used to unambiguously identify a Node. Different Nodes may have the same BrowseName. They are used to build a browse path between two Nodes or to define a standard Property.
Servers may often choose to use the same namespace for the NodeId and the BrowseName. However, if they want to provide a standard Property, its BrowseName shall have the namespace of the standards body although the namespace of the NodeId reflects something else, for example the EngineeringUnits Property. All NodeIds of Nodes not defined in this document shall not use the standard namespaces.
Table 16 provides a list of mandatory and optional namespaces used in an OPC 40562-1 OPC UA Server.
| NamespaceURI | Description | Use |
| http://opcfoundation.org/UA/ | Namespace for NodeIds and BrowseNames defined in the OPC UA specification. This namespace shall have namespace index 0. | Mandatory |
| Local Server URI | Namespace for nodes defined in the local server. This namespace shall have namespace index 1. | Mandatory |
| http://opcfoundation.org/UA/DI/ | Namespace for NodeIds and BrowseNames defined in OPC 10000-100. The namespace index is Server specific. | Mandatory |
| http://opcfoundation.org/UAMachinery/ | Namespace for NodeIds and BrowseNames defined in OPC 40001-1. The namespace index is Server specific. | Mandatory |
| http://opcfoundation.org/UA/Mining/General/ | Namespace for NodeIds and BrowseNames defined in OPC 40560. The namespace index is Server specific. | Mandatory |
| http://opcfoundation.org/UA/Mining/Loading/General/ | Namespace for NodeIds and BrowseNames defined in this document. The namespace index is Server specific. | Mandatory |
| Vendor specific types | A Server may provide vendor-specific types like types derived from ObjectTypes defined in this document in a vendor-specific namespace. | Optional |
| Vendor specific instances | A Server provides vendor-specific instances of the standard types or vendor-specific instances of vendor-specific types in a vendor-specific namespace. It is recommended to separate vendor specific types and vendor specific instances into two or more namespaces. | Mandatory |
Table 17 provides a list of namespaces and their indices used for BrowseNames in this document. The default namespace of this document is not listed since all BrowseNames without prefix use this default namespace.
| NamespaceURI | Namespace Index | Example |
| http://opcfoundation.org/UA/ | 0 | 0:EngineeringUnits |
| http://opcfoundation.org/UA/DI/ | 2 | 2:DeviceRevision |
| http://opcfoundation.org/UA/Machinery/ | 3 | 3:MachineComponentsType |
| http://opcfoundation.org/UA/Mining/General/ | 4 | 4:MiningEquipmentType |
8 (normative)OPC 40562-1 Namespace and mappings
Namespace and identifiers for OPC 40562-1 Information Model
This appendix defines the numeric identifiers for all of the numeric NodeIds defined in this document. The identifiers are specified in a CSV file with the following syntax:
<SymbolName>, <Identifier>, <NodeClass>Where the SymbolName is either the BrowseName of a Type Node or the BrowsePath for an Instance Node that appears in the specification and the Identifier is the numeric value for the NodeId.
The BrowsePath for an Instance Node is constructed by appending the BrowseName of the instance Node to the BrowseName for the containing instance or type. An underscore character is used to separate each BrowseName in the path. Let’s take for example, the MiningEquipmentType ObjectType Node which has the add-in Identification object. The Name for the Identification InstanceDeclaration within the MiningEquipmentType declaration is: MiningEquipmentType_Identification.
The NamespaceUri for all NodeIds defined here is:
http://opcfoundation.org/UA/Mining/Loading/General/
The CSV released with this version of the specification can be found here:
http://opcfoundation.org/UA/schemas/Mining/Loading/General/1.0.0/NodeIds.csv
NOTE The latest CSV that is compatible with this version of the specification can be found here:
http://opcfoundation.org/UA/schemas/Mining/Loading/General/NodeIds.csv
A computer processible version of the complete Information Model defined in this document is also provided. It follows the XML Information Model schema syntax defined in OPC 10000-6.
The Information Model Schema for this version of the specification (including any revisions, amendments or errata) can be found here:
NOTE The latest Information Model schema that is compatible with this version of the document can be found here:
http://opcfoundation.org/UA/schemas/Mining/Loading/General/opc.ua.mining.loading.general.nodeset2.xml
___________
Agreement of Use
COPYRIGHT RESTRICTIONS
This document is provided "as is" by the OPC Foundation and VDMA.
Right of use for this specification is restricted to this specification and does not grant rights of use for referred documents.
Right of use for this specification will be granted without cost.
This document may be distributed through computer systems, printed or copied as long as the content remains unchanged and the document is not modified.
OPC Foundation and VDMA do not guarantee usability for any purpose and shall not be made liable for any case using the content of this document.
The user of the document agrees to indemnify OPC Foundation and VDMA and their officers, directors and agents harmless from all demands, claims, actions, losses, damages (including damages from personal injuries), costs and expenses (including attorneys' fees) which are in any way related to activities associated with its use of content from this specification.
The document shall not be used in conjunction with company advertising, shall not be sold or licensed to any party.
The intellectual property and copyright is solely owned by the OPC Foundation and VDMA.
PATENTS
The attention of adopters is directed to the possibility that compliance with or adoption of OPC or VDMA specifications may require use of an invention covered by patent rights. OPC Foundation or VDMA shall not be responsible for identifying patents for which a license may be required by any OPC or VDMA specification, or for conducting legal inquiries into the legal validity or scope of those patents that are brought to its attention. OPC or VDMA specifications are prospective and advisory only. Prospective users are responsible for protecting themselves against liability for infringement of patents.
WARRANTY AND LIABILITY DISCLAIMERS
WHILE THIS PUBLICATION IS BELIEVED TO BE ACCURATE, IT IS PROVIDED "AS IS" AND MAY CONTAIN ERRORS OR MISPRINTS. THE OPC FOUDATION NOR VDMA MAKES NO WARRANTY OF ANY KIND, EXPRESSED OR IMPLIED, WITH REGARD TO THIS PUBLICATION, INCLUDING BUT NOT LIMITED TO ANY WARRANTY OF TITLE OR OWNERSHIP, IMPLIED WARRANTY OF MERCHANTABILITY OR WARRANTY OF FITNESS FOR A PARTICULAR PURPOSE OR USE. IN NO EVENT SHALL THE OPC FOUNDATION NOR VDMA BE LIABLE FOR ERRORS CONTAINED HEREIN OR FOR DIRECT, INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL, RELIANCE OR COVER DAMAGES, INCLUDING LOSS OF PROFITS, REVENUE, DATA OR USE, INCURRED BY ANY USER OR ANY THIRD PARTY IN CONNECTION WITH THE FURNISHING, PERFORMANCE, OR USE OF THIS MATERIAL, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
The entire risk as to the quality and performance of software developed using this specification is borne by you.
RESTRICTED RIGHTS LEGEND
This Specification is provided with Restricted Rights. Use, duplication or disclosure by the U.S. government is subject to restrictions as set forth in (a) this Agreement pursuant to DFARs 227.7202-3(a); (b) subparagraph (c)(1)(i) of the Rights in Technical Data and Computer Software clause at DFARs 252.227-7013; or (c) the Commercial Computer Software Restricted Rights clause at FAR 52.227-19 subdivision (c)(1) and (2), as applicable. Contractor / manufacturer are the OPC Foundation, 16101 N. 82nd Street, Suite 3B, Scottsdale, AZ, 85260-1830
COMPLIANCE
The combination of VDMA and OPC Foundation shall at all times be the sole entities that may authorize developers, suppliers and sellers of hardware and software to use certification marks, trademarks or other special designations to indicate compliance with these materials as specified within this document. Products developed using this specification may claim compliance or conformance with this specification if and only if the software satisfactorily meets the certification requirements set by VDMA or the OPC Foundation. Products that do not meet these requirements may claim only that the product was based on this specification and must not claim compliance or conformance with this specification.
TRADEMARKS
Most computer and software brand names have trademarks or registered trademarks. The individual trademarks have not been listed here.
GENERAL PROVISIONS
Should any provision of this Agreement be held to be void, invalid, unenforceable or illegal by a court, the validity and enforceability of the other provisions shall not be affected thereby.
This Agreement shall be governed by and construed under the laws of Germany.
This Agreement embodies the entire understanding between the parties with respect to, and supersedes any prior understanding or agreement (oral or written) relating to, this specification.