OPC-UA - Knowledge Base

Overview of OPC-UA (Open Platform Communications Unified Architecture) for building automation — nodes, security, gateway limitations, and common integration pitfalls.

Categories:

What OPC-UA Is

OPC-UA (Open Platform Communications Unified Architecture) is a platform-independent industrial interoperability standard that replaces legacy OPC-DA. It provides secure, structured data exchange between automation systems, SCADA platforms, historians, and cloud services. In building automation, OPC-UA sources are typically converted to BACnet or Modbus via a protocol gateway.

Core Concepts

ConceptDescription
NodeThe fundamental OPC-UA element — variables, objects, methods, and views are all nodes
NamespaceHierarchical organization of nodes within a server’s address space
NodeIDUnique identifier for each node (numeric, string, GUID, or opaque format)
Security ModeCertificate-based authentication and encryption built into the protocol
SubscriptionEvent-driven data delivery via monitored items (gateway may use polling instead)
Product KeyPer-unit firmware activation key required for OPC-UA driver on QuickServer

Gateway Capabilities

CapabilityQuickServer Support
OPC-UA Client (read)✅ Supported
OPC-UA Client (write)❌ Not supported — requires custom development (~3 days)
OPC-UA Server❌ Not supported
Polling modeSequential polling (not subscription-based)

[!CAUTION] QuickServer’s OPC-UA client is read-only. If the integration requires writing setpoints or commands to the OPC-UA server, confirm this at pre-sales. Write capability requires custom firmware development.

Integration Prerequisites

  1. OPC-UA server IP address — must be a routable IP (not localhost or 127.0.0.1).
  2. NodeID / namespace export — list of nodes to read.
  3. Read vs. write requirements — clarify before quoting.
  4. Security certificates — if the server requires certificate-based authentication.
  5. OPC-UA product key — required per QuickServer unit for firmware activation.

Common Problems

  • Read-only assumption — customers expect bidirectional control; discovering the write limitation mid-project causes escalation.
  • Recovery mode “FORBIDDEN” error — a malformed configuration can remove the OPC-UA firmware. Recovery requires reloading firmware via the QuickServer recovery procedure.
  • Localhost IP constraint127.0.0.1 is not routable from the gateway. The server must be on an accessible network IP.
  • Certificate misconfiguration — authentication or encryption failures when certificates are missing, expired, or in the wrong format.
  • Missing product key — OPC-UA firmware requires a per-unit product key for activation.

Tools & Diagnostics

ToolTypeDescription
UaExpertClientFree OPC-UA client — node browsing, data access, certificate management. Most popular free OPC-UA client in the industry.
Prosys OPC UA BrowserClientFree OPC-UA client for node browsing and value reading. Lightweight alternative to UaExpert.
Prosys OPC UA Simulation ServerSimulatorFree OPC-UA server simulator with configurable nodes for development and testing.

Need more help?

If this page does not resolve the issue, contact Chipkin support with the product model, protocol details, and any diagnostics you have already captured.

Open Chipkin Support