barnacles-opcua

barnacles-opcua is an OPC UA server of IoT data from ambient wireless sensors. reelyActive is an OPC UA logo member.

barnacles-opcua ingests a real-time stream of dynamb objects from barnacles, converting their properties into standard OPC UA format. It couples seamlessly with reelyActive's Pareto Anywhere open source IoT middleware.

barnacles-opcua is a lightweight Node.js package that can run on resource-constrained edge devices as well as on powerful cloud servers and anything in between.

Pareto Anywhere integration

A common application of barnacles-opcua is to publish IoT data from pareto-anywhere via an OPC UA server. Simply follow our Create a Pareto Anywhere startup script tutorial using the script below:

#!/usr/bin/env node

const ParetoAnywhere = require('../lib/paretoanywhere.js');

// Edit the options to customise the server
const BARNACLES_OPCUA_OPTIONS = {};

// ----- Exit gracefully if the optional dependency is not found -----
let BarnaclesOPCUA;
try {
  BarnaclesOPCUA = require('barnacles-opcua');
}
catch(err) {
  console.log('This script requires barnacles-opcua.  Install with:');
  console.log('\r\n    "npm install barnacles-opcua"\r\n');
  return console.log('and then run this script again.');
}
// -------------------------------------------------------------------

let pa = new ParetoAnywhere();
pa.barnacles.addInterface(BarnaclesOPCUA, BARNACLES_OPCUA_OPTIONS);

Supported Properties

barnacles-opcua currently supports the following properties:

| OPC UA browseName | OPC UA dataType | dynamb property | |:------------------------|:----------------|:-----------------------| | Temperature | AnalogDataItem | temperature | | AccelerationTimeSeriesX | YArrayItem | accelerationTimeSeries | | AccelerationTimeSeriesY | YArrayItem | accelerationTimeSeries | | AccelerationTimeSeriesZ | YArrayItem | accelerationTimeSeries |

Additional dynamb properties will be added in future.

Quick Start

Clone this repository, then from its root folder, install dependencies with npm install. Start the OPC-UA server with the following command:

npm start

and connect an OPC-UA client (see examples below) on port 4840 and resource path /UA/ParetoAnywhere. Note that no device data will be available without a source of dynamb data, for example from Pareto Anywhere open source IoT middleware.

Simulated Data

The following simulated devices/sensors are supported for interface testing.

Sensor-Works BluVib

To simulate a Sensor-Works BluVib industrial vibration sensor, start barnacles-opcua with the following command:

npm run sensorworks-bluvib

Simulated sensor browseName = "5e4504b1071b/3" will expose the following variables:

| OPC UA browseName | OPC UA dataType | |:------------------------|:----------------| | Temperature | AnalogDataItem | | AccelerationTimeSeriesX | YArrayItem | | AccelerationTimeSeriesY | YArrayItem | | AccelerationTimeSeriesZ | YArrayItem |

Observing Data with opcua-commander

The opcua-commander CLI, based on the same node-opcua open source package used by barnacles-opcua, provides a simple means of browsing and monitoring the OPC-UA data.

After installing opcua-commander, open a terminal and browse to the barnacles-opcua server with the following command:

opcua-commander -e opc.tcp://localhost:4840

Use the arrow keys and the t / l / i / c / u / s / a keys to navigate through the CLI interface, and use the x key to close.

Observing Data with UaExpert

Unified Automation offers UaExpert, a full-featured Windows/Linux OPC UA client, for free download, with registration.

Options

barnacles-opcua supports the following options:

| Property | Default | Description | |:------------|:---------------------------|:---------------------------------| | port | 4840 | OPC UA Server port |

Acknowledgements

barnacles-opcua is based on the Node-OPCUA open source project, maintained by Sterfive, which we invite you to consider sponsoring at opencollective.com/node-opcua.

Contributing

Discover how to contribute to this open source project which upholds a standard code of conduct.

Security

Consult our security policy for best practices using this open source software and to report vulnerabilities.

License

MIT License

Copyright (c) 2024 reelyActive

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.