node-red-contrib-winccoa

Node-RED nodes for exchanging data with a _SIMATIC WinCC Open Architecture_
system.

Primary Input Nodes

- __dpConnect:__ Connect to datapoints on the WinCC OA server and get notified when their values change.
- __dpGet:__ Get current or archived datapoint values on request (also includes _dpGetAsynch()_ functionality).
- __dpGetPeriod:__ Get archived datapoint values for a given time range.
- __dpQuery:__ Submit an SQL-like query to a WinCC OA server.

Output Node

- __dpSet:__ Set datapoint values.

Additional Nodes

- __alertGetPeriod:__ Get alerts for a given time range.
- __dpNames:__ Get names of datapoints matching a search pattern.
- __dpGetAlias:__ Get datapoint aliases.
- __dpGetDescription:__ Get datapoint descriptions.
- __dpGetFormat:__ Get datapoint value formats.
- __dpGetUnit:__ Get datapoint value units.
- __default server:__ Define the WinCC OA server to be used by other nodes.

Configuration Node

- __WinCC OA Server:__ Configuration node for defining a connection to a WinCC OA WSS server.

Installation

npm install -g node-red-contrib-winccoa

or install __node-red-contrib-winccoa__ from the Node-RED palette or install Node-RED from WinCC OA GEDI.

Then configure a WinCC OA Secure WebSocket (WSS) server (see description of nodes _WinCC OA Server_ and
_default server_) when adding the first node. You need an installation of WinCC OA Version 3.17 or higher
running a WSS server to which these nodes can connect.

See also the _WinCC OA Online Documentation_.

Examples

This package contains several example flows that demonstrate how to use these nodes. The connection
information for the WinCC OA WSS server needs to be defined in the example flows, preferably by adding a
_default server_ node.

Releases

- V1.x: Initial test implementation
- V2.0: Major rework, now using oaJsApi for communication with server
- __NB: not compatible with V1__
- __NB: needs WinCC OA Version 3.17__ (or higher)
- V2.1: Support for Node-RED V1.0
- V3.0: __incompatible changes, needs WinCC OA Version 3.17 P003__ (or higher)
- Optional input port for _dpConnect_ (shown when no datapoint is specified)
- _select locale_ node removed (locale now defined in server configuration)
- Time values are now returned as milliseconds, not strings
- V3.1: first version to also work with __WinCC OA Version 3.18__ servers

Contributors

- Jürgen Steiner - ETM
- Martin Kumhera - ETM