OPC UA Client and Server

The OPC UA stack is implemented in Lua and provides a LUA API for application code. Interfacing to C code and hardware is typically performed via a so called Lua binding. Lua bindings can be hand coded or created automatically by using interface compilers. See the section Lua Server Pages and C/C++ for an introduction to Lua bindings and the section Advanced Lua Bindings for a more detailed introduction. We provide an online web interface wrapper for the SWIG interface compiler, which can be used initially if you plan on auto creating the Lua bindings.

We provide ready to run OPC-UA examples on GitHub. The combined OPC-UA client and server stack is integrated in the pre-compiled Mako Server, which you may download and use for running the OPC-UA examples.

Note: this is a draft document for Real Time Logic’s new OPC-UA stack.

Features

transport protocols:

• uatcp-uasc-uabinary - OPC UA Secure Conversation UA Binary over TCP/IP

• https-uabinary - OPC UA Secure Conversation UA Binary over HTTPS

• https-uajson - OPC UA Secure Conversation UA JSON over HTTPS

HTTPS transport protocols support only secure policy None.

Secure polices

• None - No security, no encryption

• Basic128Rsa15 - RSA with SHA-1 and 128 bit encryption

• Aes128Sha256RsaOaep - AES with SHA-256 and 128 bit encryption

• Basic256Sha256 - RSA with SHA-256 and 256 bit encryption

User authentication

• Anonymous - No user authentication

• Username - Username and password authentication

• Certificate - Certificate authentication

• IssuedToken - Token authentication: JWT, Azure, Oauth2, OPC-UA

Services

• OpenSecureChannel

• CloseSecureChannel

• CreateSession

• ActivateSession

• FindServers

• GetEndpoints

• CloseSession

• Read

• Write

• AddNodes

• Browse

• TranslateBrowsePathsToNodeIds

Index

• Server - Getting Started
  • Creating a Server
  • Adding Nodes on server
  • Starting the Server
  • Stopping the Server
• Client - Getting Started
  • Connecting to Server
  • Browsing Address Space
  • Reading Node Attributes
  • Closing Server Connection
  • Asynchronous Cosocket Mode
• Configuration table
• Logging subsystem
• Address Space Browsing
  • Browsing by String NodeID
  • Detailed Parameters
• Adding Nodes
  • Adding Folder Node
  • Adding Variables
  • Variable Node Attributes
  • Object node attributes
  • Results
• Reading and Writing Data
  • Reading Attributes
    • Read parameters
    • Read Example
  • Writing Attributes
    • Write Parameters
    • Write example
  • Node Attribute
    • Base node attribute numbers
    • Object node attribute numbers
    • Object Type node attribute numbers
    • Variable node attribute numbers
    • Variable Type node attribute numbers
    • Reference Type node attribute numbers
    • Data Type node attribute numbers
    • Method node attribute numbers
    • View node attribute numbers
    • List of all attribute numbers
• Exporting Device Data
  • Value Callback
  • Write Callback Parameters
  • Read Callback Parameters
  • Error reporting
  • Custom data source example
• Third Party Clients
  • UAExpert
  • ProSys OPCUA
  • dataFEED OPCUA
• Secure Policy
  • None
  • Basic128Rsa15
  • Aes128_Sha256_RsaOaep
  • Basic256Sha256
  • Establishing secure connection
• HTTP Transport
  • HTTP Client
    • Examples
      • Binary Encoding
      • JSON Encoding
  • HTTP Server
    • Example
• Application certificate
  • Creating certificate with xlua
  • Creating OpenSSL certificate
• Authentication
  • Client Authentication
    • Working with client sessions
    • Anonymous
    • User Name
    • x509 certificate
    • JWT, OAuth2, Azure
  • Server side authentication
    • Identity token policies
    • Authentication callback
    • Anonymous token
    • User Name and password
    • X509 user certificate
    • Issued tokens
• Client API reference
  • Constructor
    • Client configuration table
  • Methods
    • connect
    • openSecureChannel
    • findServers
    • getEndpoints
    • createSession
    • activateSession
    • browse
    • read
    • write
    • addNodes
    • translateBrowsePaths
    • closeSecureChannel
    • disconnect
    • Message callback
• Initialize OPCUA project
  • Initializing a server
  • Initializing a client
• Data Types
  • Node Identifiers (NodeID)
    • Encoding and decoding NodeID string notation
  • Variant
    • Variant example
    • The fields you may set in a Variant table
  • OPC-UA Types
  • activateSessionResponse
  • addNodesResponse
  • browseParameters
  • browseResult
  • closeSecureChannelResponse
  • closeSessionResponse
  • createSessionResponse
  • findServersResponse
  • getEndpointsResponse
  • openSecureChannelResponse
  • readResponse
  • writeResponse