Machine Connect
What is Machine Connect?
The Machine Connect application is middleware used to collect data from local enterprise systems (sensors, SCADA, DCS, and other hardware/software) and reliably transport that data to the cloud for use within Utility Cloud. Machine Connect Online is similar to Machine Connect except hosted in the cloud instead of locally and currently hosts the OPC interface. Machine Connect's main use case is interfacing with internet-based SCADA (for example integration with Mission SCADA), sensors, and IoT devices.
Who should be using it?
Machine Connect is used to send data to Utility Cloud from a local system automatically on a regular basis when the local system is not able or configured to push data directly to the Utility Cloud API.
If your system is able to POST to a RESTful API, you can learn more about our API here.
Available Interfaces
- Allen-Bradley PLCs
- Allen-Bradley (RSVIEW32)
- GE Proficy Historian (GE PROFICY HISTORIAN)
- GE Proficy iFIX (GE PROFICY IFIX)
- OPC (MISSION SCADA)
- Wonderware (WONDERWARE)
Machine Connect Setup
- Configure both the asset class and workflow class according to the required steps for your integration as described below.
- Create a work schedule from the Work Scheduler page for the using the above asset class and workflow along with the frequency Machine Connect should submit data from the defined tags on.
- Create an asset in the account you created your work schedule in using the above asset class to connect to Machine Connect.
- Create a new user specifically for use in connecting Machine Connect to Utility Cloud. This user should not be used as a traditional user who logs into Utility Cloud.
- Install and configure Machine Connect.
The frequency in your work schedule should be set to be no more than every 15 minutes.
Installing Machine Connect
- Download Machine Connect here.
- Extract the zip file and copy all extracted files to a disk location you will run the application from (such as c:\MachineConnect).
- Open Windows Task Scheduler;
- Select the Task Scheduler Library, right-click, then select Create Task.
- In each tab, set the below configurations:
- In the General tab, add a Name for your task and select Run whether user is logged in or not. This option assumes that on startup your PC will automatically login with your current user and is the common configuration for SCADA or machines with HMI or other software designed to start on boot.
- In the General tab, add a Name for your task and select Run whether user is logged in or not. This option assumes that on startup your PC will automatically login with your current user and is the common configuration for SCADA or machines with HMI or other software designed to start on boot.
If Machine Connect is successful in retrieving data, you will see the audits and reports folders created in the same location you saved Machine Connect with the workflows.json file reflecting the scheduled workflow for the asset you chose.
Allen-Bradley PLC Network Interface
If you would like to configure Machine Connect to send data from your Allen-Bradley PLC Network:
- Create a new point type asset class to represent the “System”, ensuring that it is associated with a business line. No attributes are required for this asset class..
- Create a new asset using the above asset class. Note the "asset key" shown in the attributes section of the asset details page. This will be used later when you install Machine Connect.
- Create a new workflow to collect data using Machine Connect. You'll need to create one workflow for each collection of data points collected at a given frequency (for example "Hourly SCADA data" or "15 Minute Data"). When creating, ensure the Machine Connected setting is enabled and that the workflow is associated with the business line and asset class above.
- In your new workflow, create one workflow field for each tag you'd like Machine Connect to query using the below formats.
Workflow Class Fields
SLC/PLC5/Micrologix:
Field Type | Required | Key | Title | Description |
---|---|---|---|---|
TEXT | Yes | AB Legacy|{IP ADDRESS:PORT}|{FAMILY}|{MEMORY-ADDRESS} | Friendly name for the tag | Friendly description for the tag |
{FAMILY} options: (0 = PLC5; 1 = SLC500; 2 = MicroLogix). Any key not found in this format will be ignored and not be included in the final report.
Key Examples:
- AB Legacy|192.168.125.15|1|F211:202
- AB Legacy|192.168.125.15|1|F211:236
AB Legacy|192.168.125.17:999|2|F21:237
ControlLogix:
Field Type | Required | Key | Title | Description |
---|---|---|---|---|
TEXT | Yes | AB Control Logix|{IP ADDRESS}|{PORT}|{PLCTAGNAME} | Friendly name for the tag | Friendly name for the tag |
Key Examples:
- AB Control Logix|192.168.125.10|44818|AIR\HDR\AI\DEWPOINT\PV
- AB Control Logix|192.168.125.10|44818|Program:DIST.Deliv.AI.Chlor.EU
- AB Control Logix|192.168.125.10|44818|Program:DIST.Deliv.AI.Flow.EU
- AB Control Logix|192.168.125.10|44818|Program:DIST.Deliv.AI.Press.EU
- AB Control Logix|192.168.125.10|44818|Program:DIST.Deliv.AI.pH.EU
- AB Control Logix|192.168.125.10|44818|RACK.RACK[3].AI.CIP_Return_Temp.EU
Allen-Bradley RSVIEW32 Interface
If you would like to configure Machine Connect to send data from your Allen-Bradley RSVIEW32:
- Create a new point type asset class to represent the “System”, ensuring that it is associated with a business line.
- In your new asset class, add the required asset class fields described below.
- Create a new asset using the above asset class. Note the "asset key" shown in the attributes section of the asset details page. This will be used later when you install Machine Connect.
- Create a new workflow to collect data using Machine Connect. You'll need to create one workflow for each collection of data points collected at a given frequency (for example "Hourly SCADA data" or "15 Minute Data"). When creating, ensure the Machine Connected setting is enabled and that the workflow is associated with the business line and asset class above.
- In your new workflow, create one workflow field for each tag you'd like Machine Connect to query using the below formats.
Asset Class Attributes
Field Type | Required | Key | Name | Description | Default Value |
---|---|---|---|---|---|
TEXT | Yes | MC_INTTYPE | Interface Type | Defines the interface type. | RSVIEW32 |
TEXT | Yes | MC_APP | Application | Defines the DDE Application Name | {application name} |
TEXT | Yes | MC_TOPIC | Topic | Defines the DDE Topic | {topic} |
Workflow Class Fields
Field Type | Required | Key | Name | Description | Default Value |
---|---|---|---|---|---|
TEXT | Yes | {tagName} | {tag_name} | Friendly name for the tag |
RSVIEW32 is expecting the key value to represent the data point item.
GE Proficy Historian Interface
If you would like to configure Machine Connect to send data from your GE Proficy Historian:
Create a new point type asset class to represent the “System”, ensuring that it is associated with a business line.
In your new asset class, add the required asset class fields described below.
Create a new asset using the above asset class. Note the "asset key" shown in the attributes section of the asset details page. This will be used later when you install Machine Connect.
Create a new workflow to collect data using Machine Connect. You'll need to create one workflow for each collection of data points collected at a given frequency (for example "Hourly SCADA data" or "15 Minute Data"). When creating, ensure the Machine Connected setting is enabled and that the workflow is associated with the business line and asset class above.
In your new workflow, create one workflow field for each tag you'd like Machine Connect to query using the below formats.
Asset Class Attributes
Field Type | Required | Key | Name | Description | Default Value |
---|---|---|---|---|---|
TEXT | Yes | MC_INTTYPE | Interface Type | Defines the interface type. | GE PROFICY HISTORIAN |
TEXT | Yes | MC_OLEDB | OLE DB Connection String | Defines the connection string. |
|
- To connect an OLE DB client to a Historian server on a local connection (both software packages are on the same PC), use the below connection string:
Provider=iHOLEDB.iHistorian.1
- To connect an OLE DB client to a Historian Server on a remote PC, use the below connection string:
Provider=iHOLEDB.iHistorian.1;PersistSecurity Info=False;USER ID=[Username];Password=[Password];Data Source=[Target]
Workflow Class Fields
Field Type | Required | Key | Name | Description | Default Value |
---|---|---|---|---|---|
TEXT | Yes | {tag_name} | {tag_name} | Friendly name for the tag |
GE Proficy Historian is expecting the key value to represent the full tag name as queried from the IHRAWDATA table;
GE Proficy iFIX Interface
If you would like to configure Machine Connect to send data from your GE Proficy iFix:
Create a new point type asset class to represent the “System”, ensuring that it is associated with a business line.
In your new asset class, add the required asset class fields described below.
Create a new asset using the above asset class. Note the "asset key" shown in the attributes section of the asset details page. This will be used later when you install Machine Connect.
Create a new workflow to collect data using Machine Connect. You'll need to create one workflow for each collection of data points collected at a given frequency (for example "Hourly SCADA data" or "15 Minute Data"). When creating, ensure the Machine Connected setting is enabled and that the workflow is associated with the business line and asset class above.
In your new workflow, create one workflow field for each tag you'd like Machine Connect to query using the below formats.
Asset Class Attributes
Field Type | Required | Key | Name | Description | Default Value |
---|---|---|---|---|---|
TEXT | Yes | MC_INTTYPE | Interface Type | Defines the interface type. | GE PROFICY IFIX |
Workflow Class Fields
Field Type | Required | Key | Name | Description | Default Value |
---|---|---|---|---|---|
TEXT | Yes | {node}.{tagName}.{field} | {tag_name} | Friendly name for the tag |
GE Proficy iFix is expecting the key value to be in the format {node}.{tagName}.{field}.
Wonderware Interface
If you would like to configure Machine Connect to send data from Wonderware:
- Create a new point type asset class to represent the “System”, ensuring that it is associated with a business line.
- In your new asset class, add the required asset class fields described below.
- Create a new asset using the above asset class. Note the "asset key" shown in the attributes section of the asset details page. This will be used later when you install Machine Connect.
- Create a new workflow to collect data using Machine Connect. You'll need to create one workflow for each collection of data points collected at a given frequency (for example "Hourly SCADA data" or "15 Minute Data"). When creating, ensure the Machine Connected setting is enabled and that the workflow is associated with the business line and asset class above.
- In your new workflow, create one workflow field for each tag you'd like Machine Connect to query using the below formats.
Asset Class Attributes
Field Type | Required | Key | Name | Description | Default Value |
---|---|---|---|---|---|
TEXT | Yes | MC_INTTYPE | Interface Type | Defines the interface type. | WONDERWARE |
Workflow Class Fields
Field Type | Required | Key | Name | Description | Default Value |
---|---|---|---|---|---|
TEXT | Yes | {tagname}|{datatype} | {tag_name} | Friendly name for the tag |
Wonderware is expecting the key value to be in the format {tagname}|{datatype} with {datatype} being one of the following data types: “INT”, “DISC”, “FLT”, “DIFF”, “STR”. If your datatype is "STR" you can specify a length by using an additional underscore after the "STR" (i.e. "MTP_%R2221|STR_5" where 5 defines the length.)
OPC-UA Interface
If you would like to configure Machine Connect or Machine Connect Online to send data from OPC:
- Create a new point type asset class to represent the “System”, ensuring that it is associated with a business line.
- In your new asset class, add the required asset class fields described below.
- Create a new asset using the above asset class with the values for each asset class attribute described below. Note the "asset key" shown in the attributes section of the asset details page. This will be used later when you install and configure Machine Connect.
- Create a new workflow to collect data using Machine Connect. You'll need to create one workflow for each collection of data points collected at a given frequency (for example "Hourly SCADA data" or "15 Minute Data"). When creating, ensure the Machine Connected setting is enabled and that the workflow is associated with the business line and asset class above.
- In your new workflow, create one workflow field for each tag you'd like Machine Connect to query using the below formats.
If you use local Machine Connect, you can select Force Workflow Capture to make sure that a workflow report is created with data from the OPC UA server. If you use cloud-based Machine Connect Online you will need to wait for the next workflow capture.
Asset Class Fields
Field Type | Required | Title | Key | Type | Details |
---|---|---|---|---|---|
TEXT | Yes | MC_INTTYPE | MC_INTTYPE | Text | |
TEXT | Yes | OPC_SERVER_URL | OPC_SERVER_URL | Text | |
TEXT | Yes | OPC_USERNAME | OPC_USERNAME | Text | |
TEXT | Yes | OPC_PASSWORD | OPC_PASSWORD | Text | |
TEXT | Yes | OPC_LAMBDA | OPC_LAMBDA | Text | Add this field if you are using Machine Connect Online |
Asset Field Values
Field name | Field value |
---|---|
MC_INTTYPE | OPC |
OPC_SERVER_URL | |
OPC_USERNAME | Username |
OPC_PASSWORD | Password |
OPC_LAMBDA | ENABLED |
Workflow Class Fields
Field Type | Required | Title | Key | Description | Default Value |
---|---|---|---|---|---|
TEXT | Yes | {Identifier} | {NodeId} | Friendly name for the tag |
NodeId will come from the OPC UA Desktop Client such as UAExpert.