An Opc Library and a command line to perform OPC operations with ease and transparency among different protocols. Currently supports synchronous operation over UA and DA protocols.
A nuget package is available for the library. To install Hylasoft.Opc
, run the following command in the Package Manager Console:
PM> Install-Package Hylasoft.Opc
To install the command line interface, head to the release section
.
to use the UA Client simply...
using (var client = new UaClient(new Uri("opc.tcp://host-url")))
{
// Use `client` here
}
and to use the DA Client instead:
using (var client = new DaClient(new Uri("opcda://host-url")))
{
// Use `client` here
}
You can get a reference to a node with...
var node = client.FindNode("path.to.my.node");
This will get you a reference to the node node
in the folder path.to.my
.
You can use the node reference to explore the hieriarchy of nodes with the properties Parent
and SubNodes
. For example...
Node parentNode = node.Parent;
IEnumerable<Node> children = client.ExploreFolder(node.Tag);
IENumerable<Node> grandChildren = children.SelectMany(m => client.ExploreFolder(m.Tag));
Reading a variable? As simple as...
var myString = client.Read<string>("path.to.string");
var myInt = client.Read<int>("path.to.num");
The example above will read a string from the tags string
and num
in the folder path.to
To write a value just...
client.Write("path.to.string", "My new value");
client.Write("path.to.num", 42);
Dead-simple monitoring:
client.Monitor<string>("path.to.string", (newValue, unsubscribe) =>
{
DoSomethingWithYourValue(newValue);
if(ThatsEnough == true)
unsubscribe();
});
The second parameter is an Action<T, Action>
that has two parameter:
newValue
is the new value of the tagunsubscribe
is a function that unsubscribes the current monitored item. It's very handy when you want to terminate your callback
it's important that you either enclose the client into a using
statement or call Dispose()
when you are finished, to unsubscribe all the monitored items and terminate the connection!
Each method as an asynchornous counterpart that can be used with the async/await syntax. The asynchronous syntax is recommended over the synchronous one (maybe the synchronous one will be deprecated one day).
You can also use the command line interface project to quickly test your an OPC. Build the h-opc-cli
project or download it from the release
page of this repository, then run:
h-opc-cli.exe [OpcType] [server-url]
Where OpcType
is the type of opc to use (e.g: "UA", "DA"). Once the project is running, you can use the internal command to manipulate the variable. To have more information aboute the internal commands, type help
or ?
The repository uses cs-boilerplate. Read the readme of the cs-boilerplate repository to understand how to build, run tasks and commit your work to master
.
The following binaries belong to the OPC Foundation. You must become a registered user in order to use them:
OPC.Ua.Client.dll
OPC.Ua.Core.dll
OPC.Ua.Configuration.dll
OpcComRcw.dll
OpcNetApi.Com.dll
OpcNetApi.dll
You must agree to the terms and condition exposed on the OPC Foundation website. Hyla Soft is not responsible of their usage and cannot be held responsible.
- Add promise-based asynchronous calls