Difference between revisions of "Edge Gateway OPC UA Adapter"

From Datonis
Jump to: navigation, search
(Created page with " Edge Gateway Home > '''OPC UA Adapter''' == OpcUA Protocol Connection == {| class="wikitable" | colspan="1" |server_url | colspan="1" |String | cols...")
 
 
(3 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
  [[Datonis Edge Gateway|Edge Gateway Home]] > '''OPC UA Adapter'''
 
  [[Datonis Edge Gateway|Edge Gateway Home]] > '''OPC UA Adapter'''
  
== OpcUA Protocol Connection ==
+
== OPC UA Protocol Connection ==
 
{| class="wikitable"
 
{| class="wikitable"
 
| colspan="1" |server_url
 
| colspan="1" |server_url
 
| colspan="1" |String
 
| colspan="1" |String
| colspan="1" |Address url of the OpcUA server e.g. opc.[null tcp://localhost:12686/example]
+
| colspan="1" |URL address of the OPC UA server e.g. opc.tcp://localhost:12686/example
 
|-
 
|-
 
| colspan="1" |is_secure
 
| colspan="1" |is_secure
 
| colspan="1" |Boolean
 
| colspan="1" |Boolean
| colspan="1" |Signifies whether the connection to OpcUA server is secure or not. If it is true then cert_alias option will be used
+
| colspan="1" |Signifies whether the connection to OPC UA server is secure or not. If it is true then cert_alias option will be used
 
|-
 
|-
 
|cert_alias
 
|cert_alias
 
|String
 
|String
 
|Alias of the client certificate used for secure communication with OpcUA server. The private and public key of the certificate in .pem format has to be
 
|Alias of the client certificate used for secure communication with OpcUA server. The private and public key of the certificate in .pem format has to be
updated via Settings→Device SSL Certificate. The alias mentioned for certificate must match with the one specified in configJson. A default alias
+
updated via Settings→Device SSL Certificate. The alias mentioned for certificate must match with the one specified in config-json. A default alias named opcua is available, its certificate can be found at {install_location}\aliot-4.0\data\keystore\opcua.pem
named opcua is available, its certificate can be found at {install_location}\aliot-4.0\data\keystore\opcua.pem
 
 
|-
 
|-
 
| colspan="1" |discover_endpoints
 
| colspan="1" |discover_endpoints
 
| colspan="1" |Boolean
 
| colspan="1" |Boolean
 
| colspan="1" |true value denotes that the connection endpoints will be discovered from the server_url and endpoint matching with security policy will be used for connection. 
 
| colspan="1" |true value denotes that the connection endpoints will be discovered from the server_url and endpoint matching with security policy will be used for connection. 
false value means the endpoint will be the same as server_url. Default value is false.
+
false value means the endpoint will be the same as server_url. Default value is true.
 
|-
 
|-
 
| colspan="1" |security_policy_uri
 
| colspan="1" |security_policy_uri
 
| colspan="1" |String
 
| colspan="1" |String
 
| colspan="1" |Possible values are http://opcfoundation.org/UA/SecurityPolicy#None, http://opcfoundation.org/UA/SecurityPolicy#Basic128Rsa15, http://opcfoundation.org/UA/SecurityPolicy#Basic256,
 
| colspan="1" |Possible values are http://opcfoundation.org/UA/SecurityPolicy#None, http://opcfoundation.org/UA/SecurityPolicy#Basic128Rsa15, http://opcfoundation.org/UA/SecurityPolicy#Basic256,
http://opcfoundation.org/UA/SecurityPolicy#Basic256Sha256. The uri ending with None means no security policy is applied. Default value is None uri.
+
http://opcfoundation.org/UA/SecurityPolicy#Basic256Sha256. The uri ending with None means no security policy is applied. Default value is Basic128Rsa15 uri.
 
|}
 
|}
  
== OpcUA Protocol Tag ==
+
== OPC UA Read Tag ==
 
{| class="wikitable"
 
{| class="wikitable"
 
| colspan="1" |tag_id
 
| colspan="1" |tag_id
 
| colspan="1" |String
 
| colspan="1" |String
| colspan="1" |Unique tag id defined in the context of the current thing_config. This is used further in metric_mappings or derived_tags or monitor_tag_ids to refer to this tag value.
+
| colspan="1" |Unique tag id defined in the context of the current thing_config. This is used further in metric_mappings or derived_tags or scan_tag_ids or monitor_tag_ids to refer to this tag value.
 
|-
 
|-
 
|node_id
 
|node_id
 
|String
 
|String
|The OpcUA tag definition which is present at OpcUA server e.g. ns=0;i=2259. The format for tag is as follows:
+
|The OPC UA tag definition which is present at OPC UA server e.g. ns=2;s=Channel1.Machine1.Tag1 or ns=0;i=2259. The format for tag is as follows:
 
ns=<namespace id>;s=<string identifier of the tag> OR ns=<namespace id>;i=<integer identifier of the tag>
 
ns=<namespace id>;s=<string identifier of the tag> OR ns=<namespace id>;i=<integer identifier of the tag>
  
Line 42: Line 41:
 
|}
 
|}
  
== Launching OpcUA configuration screen ==
+
== OPC UA Write Tag ==
 +
{| class="wikitable"
 +
| colspan="1" |tag_id
 +
| colspan="1" |String
 +
| colspan="1" |Unique tag id defined in the context of the current thing_config. This is used in Datonis instruction json to address this OPC UA tag.
 +
|-
 +
|node_id
 +
|String
 +
|The OPC UA tag definition which is present at OPC UA server e.g. ns=2;s=Channel1.Machine1.Tag1 or ns=0;i=2259. This tag must be writable i.e. Client Access property must be set to Read/Write. The format for tag is as follows:
 +
ns=<namespace id>;s=<string identifier of the tag> OR ns=<namespace id>;i=<integer identifier of the tag> For example: ns=2;s=Channel1.Machine1.Tag1
 +
|}
 +
 
 +
== Launching OPC UA configuration screen ==
  
 
[[File:ua-1.png|800x800px]]
 
[[File:ua-1.png|800x800px]]
  
== Noting OpcUA url ==
+
== Noting OPC UA url ==
  
[[File:ua-2.png|800x800px]]
+
[[File:Ua-2-new.png|800x800px]]
  
== Adding Gateway certificate to the trusted list ==
+
== Adding Edge certificate to the trusted list ==
On restarting the Datonis IOT Gateway, it will error out with a certificate error: ServiceResultException: Bad_CertificateInvalid (0x80120000) "The certificate provided as a parameter is not valid.
+
On configuring the Datonis Edge Gateway, it will error out with a certificate error: ServiceResultException: Bad_CertificateInvalid (0x80120000) "The certificate provided as a parameter is not valid.
  
In the OPC UA configuration window, select the Trusted Clients tab, you will find a new entry for Datonis Gateway. Right click it and select “Trust”. Disable and enable Gateway again.
+
In the OPC UA configuration window, select the Trusted Clients tab, you will find a new entry for 'OPC UA Adapter'. Right click it and select “Trust”. Disable and enable Gateway again.
  
 
[[File:ua-3.png|800x800px]]
 
[[File:ua-3.png|800x800px]]

Latest revision as of 07:52, 19 July 2018

Edge Gateway Home > OPC UA Adapter

OPC UA Protocol Connection

server_url String URL address of the OPC UA server e.g. opc.tcp://localhost:12686/example
is_secure Boolean Signifies whether the connection to OPC UA server is secure or not. If it is true then cert_alias option will be used
cert_alias String Alias of the client certificate used for secure communication with OpcUA server. The private and public key of the certificate in .pem format has to be

updated via Settings→Device SSL Certificate. The alias mentioned for certificate must match with the one specified in config-json. A default alias named opcua is available, its certificate can be found at {install_location}\aliot-4.0\data\keystore\opcua.pem

discover_endpoints Boolean true value denotes that the connection endpoints will be discovered from the server_url and endpoint matching with security policy will be used for connection. 

false value means the endpoint will be the same as server_url. Default value is true.

security_policy_uri String Possible values are http://opcfoundation.org/UA/SecurityPolicy#Nonehttp://opcfoundation.org/UA/SecurityPolicy#Basic128Rsa15http://opcfoundation.org/UA/SecurityPolicy#Basic256,

http://opcfoundation.org/UA/SecurityPolicy#Basic256Sha256. The uri ending with None means no security policy is applied. Default value is Basic128Rsa15 uri.

OPC UA Read Tag

tag_id String Unique tag id defined in the context of the current thing_config. This is used further in metric_mappings or derived_tags or scan_tag_ids or monitor_tag_ids to refer to this tag value.
node_id String The OPC UA tag definition which is present at OPC UA server e.g. ns=2;s=Channel1.Machine1.Tag1 or ns=0;i=2259. The format for tag is as follows:

ns=<namespace id>;s=<string identifier of the tag> OR ns=<namespace id>;i=<integer identifier of the tag>

For example: ns=2;s=Channel1.Machine1.Tag1

OPC UA Write Tag

tag_id String Unique tag id defined in the context of the current thing_config. This is used in Datonis instruction json to address this OPC UA tag.
node_id String The OPC UA tag definition which is present at OPC UA server e.g. ns=2;s=Channel1.Machine1.Tag1 or ns=0;i=2259. This tag must be writable i.e. Client Access property must be set to Read/Write. The format for tag is as follows:

ns=<namespace id>;s=<string identifier of the tag> OR ns=<namespace id>;i=<integer identifier of the tag> For example: ns=2;s=Channel1.Machine1.Tag1

Launching OPC UA configuration screen

Ua-1.png

Noting OPC UA url

Ua-2-new.png

Adding Edge certificate to the trusted list

On configuring the Datonis Edge Gateway, it will error out with a certificate error: ServiceResultException: Bad_CertificateInvalid (0x80120000) "The certificate provided as a parameter is not valid.

In the OPC UA configuration window, select the Trusted Clients tab, you will find a new entry for 'OPC UA Adapter'. Right click it and select “Trust”. Disable and enable Gateway again.

Ua-3.png