Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/node-opcua/node-opcua
Unlocking the Full Potential of OPC UA with Typescript and NodeJS - http://node-opcua.github.io/
https://github.com/node-opcua/node-opcua
cryptography cybersecurity energy iec-62541 iiot industrial-automation industry-4 instrumentation iot-platform javascript m2m manufacturing node-opcua nodejs opc-ua opcua transport typescript
Last synced: about 2 months ago
JSON representation
Unlocking the Full Potential of OPC UA with Typescript and NodeJS - http://node-opcua.github.io/
- Host: GitHub
- URL: https://github.com/node-opcua/node-opcua
- Owner: node-opcua
- License: mit
- Created: 2014-01-22T21:48:45.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2024-04-08T15:53:15.000Z (5 months ago)
- Last Synced: 2024-04-23T10:27:18.589Z (5 months ago)
- Topics: cryptography, cybersecurity, energy, iec-62541, iiot, industrial-automation, industry-4, instrumentation, iot-platform, javascript, m2m, manufacturing, node-opcua, nodejs, opc-ua, opcua, transport, typescript
- Language: TypeScript
- Homepage:
- Size: 40.8 MB
- Stars: 1,424
- Watchers: 84
- Forks: 477
- Open Issues: 31
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
node-opcua
==========
node-opcua is a full OPC UA stack for NodeJS and the Browser written in Typescript.
[](https://img.shields.io/npm/v/node-opcua)
[](https://github.com/node-opcua/node-opcua/actions/workflows/workflow.yml)
[](https://lernajs.io/)
[](https://coveralls.io/r/node-opcua/node-opcua)
[](https://gitter.im/node-opcua/node-opcua)
[](https://leanpub.com/node-opcuabyexample-edition2024)
[](https://www.npmtrends.com/node-opcua-server)
[](https://www.npmtrends.com/node-opcua-server)
[](https://www.npmtrends.com/node-opcua-client)
[](https://www.npmtrends.com/node-opcua-client)
[](https://opencollective.com/node-opcua#support)
[![Become a sponsor](https://opencollective.com/node-opcua/tiers/sponsor.svg?avatarHeight=36&width=600")](https://opencollective.com/node-opcua/contribute/sponsor-23291/checkout?interval=month&amount=500&contributeAs=me)
[Node-opcua](https://node-opcua.github.io/) is the OPC-UA stack running on NodeJS.
Why NodeJS ?
Because NodeJs is a great framework for designing high-performing asynchronous applications.
## Getting started
### installing node-opcua as a node package
$ mkdir mytest
$ cd mytest
$ npm init
$ npm install node-opcua --unsafe-perms
$ # Create your first app.js file!
### installing node-opcua samples as a node package
```shell
$ mkdir myserver
$ cd myserver
$ npm init
$ npm install node-opcua-samples --unsafe-perms
$ ./node_modules/.bin/simple_server
```
or
```shell
$ ./node_modules/.bin/simple_client -e "opc.tcp://opcserver.mAutomation.net:4841" -n="ns=1;s=EVR2.system.RTC_SEC"
```
or
```shell
$ ./node_modules/.bin/simple_client -e "opc.tcp://opcuademo.sterfive.com:26543"
```
## Minimum Nodejs requirement
* Nodejs version 18 or above
## tutorials and guided examples
[](https://leanpub.com/node-opcuabyexample-edition2024). This book provides a large number of practical and ready-to-use and fully documented examples. It's the best starting point to learn about node-opcua.
## Sponsors & Backers
The funding of node-opcua entirely relies on its users.
We appreciate that, once you have evaluated the software and you have decided to use it in one of your applications, you consider supporting our effort by either financially contributing to one of our sponsor programs:
- https://github.com/sponsors/node-opcua
- https://opencollective.com/node-opcua
Grants ensure the following:
- 🔨 Long-term maintenance of the project
- ⚙️ maintain the website and continuous integration platform
- 🛣 Progress on the road map
- 🐛 Quick responses to bug reports
- 🚀 New features & enhancements
- ⚖️ representing the node-opcua user community at the OPC Foundation
## Sponsors
## Backers
Thank you to all our backers! [Become a backer](https://opencollective.com/node-opcua#backer)
## Contributors
This project exists thanks to all the people who contribute.
## Getting professional support
To get professional support, consider subscribing to the node-opcua membership community:
[](https://support.sterfive.com)
Registered members have access to an extended set of online documentation.
Registered members can post and query Sterfive for any question related to NodeOPCUA in a private chat room.
or contact [sterfive](https://www.sterfive.com) for dedicated consulting and more advanced support or for a certified version of node-opcua. ([email protected]).
## Road-map
If your company would like to participate and influence the development of future versions of node-opcua please contact [sterfive](mailto:[email protected]).
Those are the items we would like to achieve in the next version of the API.
* improved documentation
* Compliance testing and certification (CTT)
* Pub-sub support
* support for redundancy
* session-less transactions
* WebSocket transport
* JTokens and OAuth
* reversed connection
* more tutorials
## Advanced topics
### installing node-opcua from source
#### running the demo server from source
$ git clone https://github.com/node-opcua/node-opcua.git
$ cd node-opcua
$ npm install -g pnpm
$ pnpm recursive install
$ pnpm build
$ node packages/node-opcua-samples/bin/simple_server
#### running the demo client from source
$ git clone https://github.com/node-opcua/node-opcua.git
$ cd node-opcua
$ npm install -g pnpm
$ pnpm recursive install
$ pnpm build
$ node packages/node-opcua-samples/bin/simple_client.js -e "opc.tcp://opcserver.mAutomation.net:4841" -n="ns=1;s=EVR2.system.RTC_SEC"
### Tutorials
* [create a server](https://github.com/node-opcua/node-opcua/blob/master/documentation/creating_a_server.md)
* [create a client in typescript](https://github.com/node-opcua/node-opcua/blob/master/documentation/creating_a_client_typescript.md)
* more tutorials are available in the book (https://leanpub.com/node-opcuabyexample-edition2024)
* more advanced examples and training material are available for the NodeOPCUA Subscription members at (https://support.sterfive.com)
### API reference
* check out the [API documentation](https://node-opcua.github.io/api_doc/index.html)
## Contributing
$ git clone git://github.com/node-opcua/node-opcua.git
$ cd node-opcua
$ npm install -g pnpm
$ pnpm install
$ pnpm recursive install
$ pnpm build
[](https://nodei.co/npm/node-opcua/)
[](https://www.openhub.net/p/node-opcua)
## Supported Features
| __**Service**__ | | |
|-----------------------------|-----------------------|---------------------------|
| Discovery Service Set | | |
| |FindServers() | :white_check_mark: |
| |GetEndpoints() | :white_check_mark: |
| |RegisterServer() | :white_check_mark: |
| |RegisterServer2() | :white_check_mark: |
| |FindServersOnNetwork() | :white_check_mark: |
| Secure Channel Service Set | | |
| |OpenSecureChannel() | :white_check_mark: |
| |CloseSecureChannel() | :white_check_mark: |
| Session Service Set | | |
| |CreateSession() | :white_check_mark: |
| |CloseSession() | :white_check_mark: |
| |ActivateSession() | :white_check_mark: |
| |Cancel() | |
| View Service Set | | |
| |Browse() | :white_check_mark: |
| |BrowseNext() | :white_check_mark: |
| |TranslateBrowsePathsToNodeIds() | :white_check_mark:|
| |RegisterNodes() | :white_check_mark:|
| |UnregisterNodes() |:white_check_mark:|
| Attribute Service Set | ||
| |Read() |:white_check_mark:|
| |Write() |:white_check_mark:|
| |HistoryRead() |:waxing_crescent_moon:|
| |HistoryUpdate() |:waxing_crescent_moon:|
|MonitoredItems Service Set | ||
| |CreateMonitoredItems() |:white_check_mark:|
| |ModifyMonitoredItems() |:white_check_mark:|
| |SetMonitoringMode() |:white_check_mark:|
| |SetTriggering() |:new_moon:|
| |DeleteMonitoredItems() |:white_check_mark:|
|Subscription Service Set | ||
| |CreateSubscription() |:white_check_mark:|
| |ModifySubscription() |:white_check_mark:|
| |DeleteSubscriptions() |:white_check_mark:|
| |Publish() |:white_check_mark:|
| |Republish() |:white_check_mark:|
| |TransferSubscriptions()|:white_check_mark:|
|Node Management Service Set | ||
| |AddNodes() |:new_moon:|
| |AddReferences() |:new_moon:|
| |DeleteNodes() |:new_moon:|
| |DeleteReferences() |:new_moon:|
|Query Service Set | ||
| |QueryFirst() |:new_moon:|
| |QueryNext() |:new_moon:|
| PubSUB | as a commercial module |:white_check_mark:|
| GDS | as a commercial module |:white_check_mark:|
| | | |
|----------------------------------------|:------------------------:|--------------------|
| __**Transport Protocol**__ | | |
| **Transport** | **Status** | **Comment** |
| UA-TCP UA-SC UA Binary | :white_check_mark: | OPC.TCP - Binary |
| SOAP-HTTP WS-SC UA Binary | :new_moon: | HTTP/HTTPS - Binary|
| SOAP-HTTP WS-SC UA XML | :new_moon: | |
| SOAP-HTTP WS-SC UA XML-UA Binary | :new_moon: | |
| __**Security Policies**__ | | |
| **Policy** | **Status** | **Comment** |
| None | :white_check_mark: | |
| Basic128Rsa15 | :white_check_mark: | deprecated in 1.04 |
| Basic256 | :white_check_mark: | deprecated in 1.04 |
| Basic256Sha256 | :white_check_mark: | |
| **Authentication** | **Status** | **Comment** |
| Anonymous |:white_check_mark: | |
| User Name Password |:white_check_mark: | |
| X509 Certificate |:white_check_mark: | |
| __**client facets**__ | | |
| Base Client Behaviour |:white_check_mark: | |
| AddressSpace Lookup |:white_check_mark: | |
| Attribute Read |:white_check_mark: | |
| DataChange Subscription |:white_check_mark: | |
| DataAccess |:white_check_mark: | |
| Discovery |:white_check_mark: | |
| Event Subscription |:white_check_mark: | |
| Method call |:white_check_mark: | |
| Historical Access |:first_quarter_moon: | |
| Advanced Type |:white_check_mark: | |
| Programming |:new_moon: | |
| Auditing |:first_quarter_moon: | |
| Redundancy |:new_moon: |Sponsors wanted |
| __**server profiles**__ | | |
| Core Server | :white_check_mark: | |
| Data Access Server | :white_check_mark: | |
| Embedded Server | :white_check_mark: | |
| Nano Embedded Device Server | :white_check_mark: | |
| Micro Embedded Device Server | :white_check_mark: | |
| Standard DataChange Subscription Server| :white_check_mark: | |
| Standard Event Subscription Server | :white_check_mark: | |
| Standard UA Server | :white_check_mark: | |
| Redundancy Transparent Server | :new_moon: |Sponsors wanted |
| Redundancy Visible Server | :new_moon: |Sponsors wanted |
| Node Management Server | :new_moon: |Sponsors wanted |
| Auditing Server | :first_quarter_moon: | |
| Complex Type Server | :white_check_mark: |(sponsored) |
| Session Diagnostics | :white_check_mark: | (sponsored)|
| Subscription Diagnostics | :white_check_mark: | (sponsored)|
| Alarms & Conditions | :white_check_mark: | (sponsored)|
| Pub & Sub | :new_moon: |Sponsors wanted |
## Feedback
* if you're using node-opcua in one of your project, please feel free to leave a comment and a quick description in the [wiki](https://github.com/node-opcua/node-opcua/wiki)
* if you have a particular wish or found a issue, let us known and [create an issue](https://github.com/node-opcua/node-opcua/issues?state=open)
## About licensing
The node-opcua core module is [copyrighted and licencsd under the term of the "The MIT License"](./LICENSE).
This means that :
- node-opcua comes without any warranty of any kind.
- you can freely re-use in an open-source application or a commercial application
- you have to include the software copyright notice in all copies or substantial portions of the software.
You are strongly encouraged to apply to our [NodeOPCUA Membership](https://support.sterfive.com) to get additional benefits and support.
## Copyright
Copyright (c) 2022-2024 Sterfive SAS - 833264583 RCS ORLEANS - France (https://www.sterfive.com)
Copyright (c) 2014-2022 Etienne Rossignon