DOC

OPC UA Part 6: Mappings Specification

By Carol Bailey,2014-12-01 13:29
12 views 0
OPC UA Part 6: Mappings Specification

     ?

    F O U N D A T I O N

    OPC Unified Architecture

    Release Candidate Specification

    Part 6: Mappings

    Version 0.93

    June 1, 2006

    Send comments to:

    UAcomments@opcfoundation.org

OPC Unified Architecture, Part 6 i Release Candidate 0.93

Specification Industry Standard Comments:

    Type Specification

Title: OPC Unified Date: June 1, 2006

    Architecture

    Part 6

    Mappings

Version: Release Candidate 0.93 Software MS-Word

     Source: OPC UA Part 6 - Mappings RC0.93

    Specification.doc

    Author: OPC Foundation Status: Release Candidate

    OPC Unified Architecture, Part 6 ii Release Candidate 0.93

    CONTENTS

    Page

    1 Scope .............................................................................................................................. 1

    2 Reference Documents ....................................................................................................... 1

    3 Terms, definitions, and conventions .................................................................................... 2 3.1 OPC UA Part 1 terms................................................................................................ 2 3.2 OPC UA Part 2 terms................................................................................................ 3 3.3 OPC UA Mappings terms .......................................................................................... 3

    3.3.1 Communication Stack .................................................................................... 3

    3.3.2 Mapping ....................................................................................................... 3

    3.3.3 Encoding ...................................................................................................... 3

    3.3.4 Transport Protocol ......................................................................................... 4

    3.3.5 Programmers' Interface .................................................................................. 4

    3.3.6 Certificate Store ............................................................................................ 4

    3.3.7 Certificate Trust List ...................................................................................... 4

    3.3.8 Certificate Revocation List.............................................................................. 4

    3.3.9 Certification Authority .................................................................................... 4 3.4 Abbreviations and symbols ........................................................................................ 4

    4 Overview ......................................................................................................................... 4 4.1 The Mapping Process ............................................................................................... 4 4.2 Communication Stacks ............................................................................................. 5 4.3 Message Encoding ................................................................................................... 5 4.4 Formal Interface Definition ........................................................................................ 5 4.5 Certificate Management ............................................................................................ 6 4.6 Server Discovery ...................................................................................................... 6

    5 Mappings ......................................................................................................................... 6 5.1 General ................................................................................................................... 6 5.2 UA Native Mapping ................................................................................................... 6

    5.2.1 General ........................................................................................................ 6

    5.2.2 Serialization Layer ......................................................................................... 8

    5.2.3 Secure Channel Layer ................................................................................... 9

    5.2.4 Transport Layer........................................................................................... 14 5.3 XML Web Services Mapping .................................................................................... 19

    5.3.1 General ...................................................................................................... 19

    5.3.2 SOAP ......................................................................................................... 20

    5.3.3 HTTP ......................................................................................................... 21

    5.3.4 WS Addressing ........................................................................................... 21

    5.3.5 WS Security ................................................................................................ 22

    5.3.6 WS Trust .................................................................................................... 23

    5.3.7 WS Secure Conversation ............................................................................. 23

    6 Message Encoding.......................................................................................................... 25

    6.1.1 Built-in Types .............................................................................................. 25 6.2 UA Binary .............................................................................................................. 26

    6.2.1 General ...................................................................................................... 26

    6.2.2 Built-in Types .............................................................................................. 26

    6.2.3 Enumerations.............................................................................................. 34

    6.2.4 Arrays ........................................................................................................ 34

    6.2.5 Simple Types .............................................................................................. 34

    6.2.6 Structures ................................................................................................... 34

OPC Unified Architecture, Part 6 iii Release Candidate 0.93

    6.2.7 Messages ................................................................................................... 35

    6.3 XML ...................................................................................................................... 35

    6.3.1 Built-in Types .............................................................................................. 35

    6.3.2 Enumerations.............................................................................................. 41

    6.3.3 Arrays ........................................................................................................ 41

    6.3.4 Structures ................................................................................................... 41

    6.3.5 Messages ................................................................................................... 42 7 Formal Interface Definition ............................................................................................... 42

    7.1 General ................................................................................................................. 42

    7.2 Mapping File .......................................................................................................... 42

    7.3 UA Native Mapping ................................................................................................. 42

    7.4 XML Web Service Mapping ..................................................................................... 42 8 Managing Certificates ..................................................................................................... 42

    8.1 Certificate Stores ................................................................................................... 42

    8.2 Application Instance Certificates .............................................................................. 43

    8.2.1 Installation .................................................................................................. 43

    8.2.2 Certificate Trust Lists ................................................................................... 43

    8.2.3 Certificate Revocation Lists .......................................................................... 43

    8.2.4 Proof of Possession ..................................................................................... 43

    8.3 Software Certificates .............................................................................................. 44

    8.3.1 General ...................................................................................................... 44

    8.3.2 Verification ................................................................................................. 44 9 Server Discovery ............................................................................................................ 44

    9.1 Overview ............................................................................................................... 44

    9.2 WS-Inspection ....................................................................................................... 44

    9.3 WS-Discovery ........................................................................................................ 45

    9.4 UDDI..................................................................................................................... 45 Annex A Constants ................................................................................................... 46 A.1 Service Type Ids ............................................................................................................. 46 Annex B Type Declarations for the UA Native Mapping................................................. 47 Annex C WSDL for the UA XML Mapping .................................................................... 48 Annex D Mapping File Syntax .................................................................................... 49 D.1 General ......................................................................................................................... 49 D.2 Dictionary ...................................................................................................................... 49 D.3 Abstract Type ................................................................................................................. 50 D.4 Simple Type ................................................................................................................... 50 D.5 Complex Type ................................................................................................................ 51 D.6 Enumerated Type ........................................................................................................... 52 D.7 Service Type .................................................................................................................. 53

OPC Unified Architecture, Part 6 iv Release Candidate 0.93

    FIGURES

    Figure 1 The UA Native Mapping Stack Overview .................................................................... 7 Figure 2 UA Native Mapping Message Processing ................................................................... 8 Figure 3 Establishing a Secure Channel ............................................................................... 11 Figure 4 Renewing Security Tokens ..................................................................................... 12 Figure 5 UA TCP Normal Message Sequences ..................................................................... 15 Figure 6 UA TCP Error Recovery Sequences ........................................................................ 17 Figure 7 The XML Web Services Stack ................................................................................ 19 Figure 8 Encoding Integers in a Binary Stream...................................................................... 27 Figure 9 Encoding Floating Points in a Binary Stream ............................................................ 27 Figure 10 Encoding Strings in a Binary Stream ..................................................................... 28

    OPC Unified Architecture, Part 6 v Release Candidate 0.93

    TABLES

    Table 1 UA Native Mapping Message Header ......................................................................... 8 Table 2 UA Native Mapping Message Footer .......................................................................... 9 Table 3 Security Header Components .................................................................................... 9 Table 4 Security Footer Components ................................................................................... 10 Table 5 Security Algorithms ................................................................................................ 10 Table 6 UA TCP Message Types ......................................................................................... 14 Table 7 UA TCP Hello Message .......................................................................................... 16 Table 8 UA TCP Acknowledge Message ............................................................................... 16 Table 9 UA TCP Disconnect Message .................................................................................. 17 Table 10 UA TCP Data Message ......................................................................................... 18 Table 11 UA Abort Message................................................................................................ 18 Table 12 UA Error Message ................................................................................................ 18 Table 13 WS-Addressing Headers ....................................................................................... 21 Table 14 WS-Trust User Token Policy .................................................................................. 23 Table 15 WS-* Namespace Prefixes .................................................................................... 23 Table 16 ChannelSecurityToken to SCT Mapping .................................................................. 24 Table 17 RequestSecurityToken Message Components ......................................................... 24 Table 18 Security Algorithm Mappings ................................................................................. 25 Table 19 RequestSecurityTokenResponse Message Components ........................................... 25 Table 20 Built-in Data Types ............................................................................................... 26 Table 21 Supported Floating Point Types ............................................................................. 27 Table 22 NodeId Components ............................................................................................. 29 Table 23 NodeId Encoding Values ....................................................................................... 29 Table 24 Two Byte NodeId Binary Encoding ......................................................................... 29 Table 25 Four Byte NodeId Binary Encoding ......................................................................... 29 Table 26 Uri NodeId Binary Encoding ................................................................................... 30 Table 27 Guid NodeId Binary Encoding ................................................................................ 30 Table 28 Standard NodeId Binary Encoding .......................................................................... 30 Table 29 DiagnosticInfo Binary Encoding ............................................................................. 31 Table 30 Extension Object Binary Encoding .......................................................................... 32 Table 31 Variant Binary Encoding ........................................................................................ 32 Table 32 Variant Encoding Masks ........................................................................................ 33 Table 33 Data Value Binary Encoding .................................................................................. 33 Table 34 Simple Type Mapping ........................................................................................... 34 Table 35 Sample UA Binary Encoded Structure ..................................................................... 35 Table 36 XML Datatype Mappings for Integers ...................................................................... 36 Table 37 XML Datatype Mappings for Floating Points ............................................................ 36 Table 38 String Format for Guid Components ....................................................................... 37 Table 39 Components of NodeId URI ................................................................................... 38 Table 40 Components of Enumeration.................................................................................. 41 Table 41 Certificate Store Locations .................................................................................... 43 Table 42 Dictionary Element Components ............................................................................ 50

    OPC Unified Architecture, Part 6 vi Release Candidate 0.93 Table 43 Abstract Type Element Components ....................................................................... 50 Table 44 Simple Type Components...................................................................................... 51 Table 45 Complex Type Components ................................................................................... 52 Table 46 Field Type Components ........................................................................................ 52 Table 47 Enumerated Type Components .............................................................................. 53 Table 48 Service Type Components ..................................................................................... 54

    OPC Unified Architecture, Part 6 vii Release Candidate 0.93

    OPC FOUNDATION

    ____________

    UNIFIED ARCHITECTURE

    FOREWORD

    This specification is the specification for developers of OPC UA clients and servers. The specification is a result of an analysis and design process to develop a standard interface to facilitate the development of servers and clients by multiple vendors that shall inter-operate seamlessly together.

    Trademarks

    Most computer and software brand names have trademarks or registered trademarks. The individual trademarks have not been listed here.

    NON-EXCLUSIVE LICENSE AGREEMENT

    The OPC Foundation, a non-profit corporation (the “OPC Foundation”), has defined a set of standard objects, interfaces and behaviours associated with the objects intended to promote interoperability between automation/control applications, field systems/devices, and business/office applications in the process control industry. The OPC specifications, sample software that demonstrates the implementation of the specifications, standard interface components deliverables and related documentation (collectively, the “OPC Materials”), form a set of standard objects, interfaces and behaviour that are based on the technology being used in the automation marketplace, and includes the use of Microsoft Technology as well providing interoperability to non Microsoft platforms. The technology defines standard objects, methods, and properties for servers of real-time information like distributed process systems, programmable logic controllers, smart field devices and analyzers in order to communicate the information that such servers contain to standard compliant technologies enabled devices (e.g., servers, applications, etc.). The OPC Foundation will grant to you (the “User”), whether an individual or legal entity, a license to use, and provide User with a copy of, the current version of the OPC Materials so long as User abides by the terms contained in this Non-Exclusive License Agreement (“Agreement”). If User does not agree to the terms and conditions contained in this Agreement, the OPC Materials may not be used, and all copies (in all formats) of such materials in User‟s possession must either be destroyed or returned to the OPC Foundation. By using the OPC Materials, User (including any employees and agents of User) agrees to be bound by the terms of this Agreement. LICENSE GRANT:

    Subject to the terms and conditions of this Agreement, the OPC Foundation hereby grants to User a non-exclusive, royalty-free, limited license to use, copy, display and distribute the OPC Materials in order to make, use, sell or otherwise distribute any products and/or product literature that are compliant with the standards included in the OPC Materials.

    All copies of the OPC Materials made and/or distributed by User must include all copyright and other proprietary rights notices include on or in the copy of such materials provided to User by the OPC Foundation. The OPC Foundation shall retain all right, title and interest (including, without limitation, the copyrights) in the OPC Materials, subject to the limited license granted to User under this Agreement. WARRANTY AND LIABILITY DISCLAIMERS:

    User acknowledges that the OPC Foundation has provided the OPC Materials for informational purposes only in order to help User understand Microsoft‟s OLE/COM technology. THE OPC MATERIALS ARE PROVIDED “AS IS” WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, WARRANTIES OF PERFORMANCE, MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT. USER BEARS ALL RISK RELATING TO QUALITY, DESIGN, USE AND PERFORMANCE OF THE OPC MATERIALS. The OPC Foundation and its members do not warrant that the OPC Materials, their design or their use will meet User‟s requirements, operate without interruption or be error free.

    IN NO EVENT SHALL THE OPC FOUNDATION, ITS MEMBERS, OR ANY THIRD PARTY BE LIABLE FOR ANY COSTS, EXPENSES, LOSSES, DAMAGES (INCLUDING, BUT NOT LIMITED TO, DIRECT, INDIRECT, CONSEQUENTIAL, INCIDENTAL, SPECIAL OR PUNITIVE DAMAGES) OR INJURIES INCURRED BY USER OR ANY THIRD PARTY AS A RESULT OF THIS AGREEMENT OR ANY USE OF THE OPC MATERIALS.

OPC Unified Architecture, Part 6 viii Release Candidate 0.93

    GENERAL PROVISIONS:

    This Agreement and User‟s license to the OPC Materials shall be terminated (a) by User ceasing all use of the OPC Materials, (b) by User obtaining a superseding version of the OPC Materials, or (c) by the OPC Foundation, at its option, if User commits a material breach hereof. Upon any termination of this Agreement, User shall immediately cease all use of the OPC Materials, destroy all copies thereof then in its possession and take such other actions as the OPC Foundation may reasonably request to ensure that no copies of the OPC Materials licensed under this Agreement remain in its possession.

    User shall not export or re-export the OPC Materials or any product produced directly by the use thereof to any person or destination that is not authorized to receive them under the export control laws and regulations of the United States. The Software and Documentation are 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 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 the State of Minnesota, excluding its choice or law rules.

    This Agreement embodies the entire understanding between the parties with respect to, and supersedes any prior understanding or agreement (oral or written) relating to, the OPC Materials.

Report this document

For any questions or suggestions please email
cust-service@docsford.com