Supported hardware and firmware
Cloud Logging via OPC-UA is supported on the CloudVPN router in firmware 3.7 and up. Please upgrade your firmware if you are running an older version.Activate Cloud Logging
Please first activate Cloud Logging (or start the 30 day free trial) if you haven't already.The Second step in Cloud Logging is setting up a data source. This is done by selecting a communication protocol and defining the variables. This article shows you how to do this for communication via OPC-UA.
PLC setting
The CloudVPN router supports the following methods of authentication with the OPC-UA server on your PLC. Make sure your OPC-UA server is configured to support at least one of these.
Authentication method | Security policy | Message security mode |
---|---|---|
Anonymous |
None Basic128Rsa15 Basic256 Basic256Sha256 |
None |
A bit later in this article, when you add the data source, you have the option to select which authentication method you want to use. Regardless of your choice, communication between the CloudVPN router and the CloudVPN Portal is always secure (more info).
Select a communication protocol
You first have to select a communication protocol. This is the protocol that the CloudVPN router will use to communicate with the PLC.
- Go to the CloudVPN Portal Fleet Manager app, which is accessible from the Apps menu in the top right corner if you are currently in a different CloudVPN Portal app.
- Open the Main menu , go to Devices , and select the concerning device.
- Click on the Add a serviceicon in the left menu, select [Data source], and then select [OPC Unified Architecture].
- Enter the requested information (details below) and click on [Add].
Field | Description |
---|---|
Name | Enter a name for the data source. |
Identifier | The identifier is a computer-friendly rewrite of the "Name" and ensures that every data source remains unique, even if they share the same name. |
IP address |
Enter the IP address of your PLC. Leave empty if you're using an CloudVPN Agent. |
Port | The port number will be entered automatically (Port 4840 for OPC-UA). |
Authentication |
Select the OPC-UA server's authentication type and enter your credentials if required. Supported authentication methods:
|
Polling sleep time |
To log data as accurately as possible, the CloudVPN router continuously asks the variables' values from the PLC (this does not count towards your license's dps/hr). While the CloudVPN router does wait for the PLC to reply before asking again, in very rare cases this may noticeably impact the PLC's performance. In such a rare situation you may want to change this setting to 100ms or higher. In general "None" is recommended for Cloud Logging to be as accurately as possible. |
Add variables
Once you've added a data source and selected a communication protocol, you can start adding variables. You can do this by following the steps below:
- Expand the Data source service and go to [Variables].
You'll need to know your variable's data type and address. Below you'll find a table containing all available data types and their equivalents in the CloudVPN Portal.
Offline (PLC) | Online (CloudVPN Portal) |
Boolean | Boolean |
SByte | Int8 |
Int16 | Int16 |
Int32 | Int32 |
Int64 | Int64 |
Byte | UInt8 |
UInt16 | UInt16 |
UInt32 | UInt32 |
UInt64 | UInt64 |
Float | Float32 |
Double | Float64 |
String | String |
The variable's address consists of a namespace index and identifier. In the example below we'll be using UaExpert to find these attributes.
- Open UaExpert, press [Server] and then [Add].
- Select [Advanced], enter the IP address and port number (default 4840), separated by a colon, and press [OK].
- If you're not already automatically connected, you can manually connect to the added server by going to [Server] > [Connect].
- Once you're connected, find and select your variable in the "address space"-window in the bottom left.
- You should see the variable's NamespaceIndex and Identifier in the "attribute"-window in the top right.
For iX Devices
Once you have added the data source the next step would be adding the variables in.
- "Name" here is independent, you may give a name that you which to identify this variable later.
- "Type" here must match the IX Project tag Data Type
- "Namespace" here for IX devices are always 2
- Identifier type here is related to how we are calling on our tags, as we are using tag names it will be string
- "Value" is the tag name that we have exposed on the IX devices
For Nexto Devices
- Ensure "Support OPC UA features is checked on BCS tools
- "Name" here is independent, you may give a name that you which to identify this variable later.
- "Type" here must match the in Nexto Xpress tag Data Type
- "Namespace" here for Nexto Xpress devices are always 4
- Identifier type here is related to how we are calling on our tags, as we are using tag names it will be string
- "Value" is the tag name that we have exposed on the IX devices
- Value should include the |var|
Example: |var|XP325.Application.Machines.Machine1.Temperature
Now you have all the necessary information to add the variable to your data source and can now choose to:
Tip!
It is advisable to add variables in small batches and test them to verify their configuration.Manually add new variables
- Go back to where you were in the CloudVPN Portal.
- Click on [Add variable] in the bottom right corner.
- Enter the requested information (details below) and click on [Add].
Field | Description |
---|---|
Name | Enter a name for the variable. |
Identifier |
This identifier is a computer-friendly rewrite of the "Name" and ensures that every variable remains unique, even if they share the same name. This identifier is not the same as your OPC-UA variable's "Identifier" (value "20001" in the top-right corner of the example image shown above). That, instead, needs to be entered in the field "Value". |
Type | Select the variable's data type (bool, int, float, etc). |
Length | (for String data types only) The String length. |
Namespace | Enter the namespace index. |
Identifier type | Select the identifier type. |
Value | Enter the identifier value. |
Factor | Multiplies the value (leave empty if the data type is boolean). |
Unit | Displayed text behind the value. |
Temporary disconnect
After this next step, the config push, the device may temporarily disconnect and LAN communication may be temporarily interrupted while it's applying the new settings. This may take a minute.You have now made the changes in the CloudVPN Portal, but these are not yet active in your device. You will need to push your changes to your device for them to take effect.
- Click [Push config to device] in the top right corner.
Next step
Import variables from a file (or device)
You can easily and effortlessly copy variables from one device to another by exporting the concerning variables (view the "Manage variables" part of this article) and then importing them in your new device. Alternatively, you can manually prepare your variables in the required CSV format to load them all at once into your configurator. The CSV file structure is explained in our Import variables article.
- Go back to where you were in the CloudVPN Portal.
- Click on [Import from CSV-file] in the top right corner of the screen.
- Select a CSV file to import and click on [Open].
Temporary disconnect
After this next step, the config push, the device may temporarily disconnect and LAN communication may be temporarily interrupted while it's applying the new settings. This may take a minute.You have now made the changes in the CloudVPN Portal, but these are not yet active in your device. You will need to push your changes to your device for them to take effect.
- Click [Push config to device] in the top right corner.
Next step
Test variables
The test utility is used to check if all the added variables are set correctly. It shows the communication status with the PLC and displays each variable's current value if everything is configured correctly. If not, the values will stay empty. The test utility will attempt to update values every 0.5 seconds, regardless of how often it's actually being logged (this does not count towards your license's dps/hr). Please follow the steps below to test your variables.
- Expand the Data source service, go to [Variables], and click on [Run test] at the top.
A connection will now be set up to stream the data directly to your computer, using:
Port | Transport protocol | Application protocol |
---|---|---|
443 | TCP | WebSocket |
You will see live values of all variables, if the configuration is set up correctly.
Unexpected result?
If the test utility shows unexpected values, please check if the addresses and data types of all variables are entered correctly.
If you get no data at all, please also check that the above listed port and protocols are not being blocked by your computer's or company's firewall.Next step
Now that you've tested the variables, you can view our "Configure data tags" guide to start logging.Manage variables
You can view all defined variables on the variables page:
- Expand the Data source service and go to [Variables].
You can [Edit] individual variables, [Remove] individual or a selection of variables, and export all or a selection of variables.
Variables can be selected by clicking the checkbox on the left, or you can select them all by clicking the checkbox at the top.
Comments
0 comments
Article is closed for comments.