Skip to main content
Skip table of contents

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

  1. Configure both the asset class and workflow class according to the required steps for your integration as described below.
  2. 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.
  3. Create an asset in the account you created your work schedule in using the above asset class to connect to Machine Connect.
  4. 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.
  5. 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

  1. Download Machine Connect here.
  2. Extract the zip file and copy all extracted files to a disk location you will run the application from (such as c:\MachineConnect).
  3. Open Windows Task Scheduler;
  4. Select the Task Scheduler Library, right-click, then select Create Task. 
  5. In each tab, set the below configurations:
    1. 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.
    2. In the Triggers tab, select New and set Begin the Task to At Startup, Repeat task every to 1 minute, and duration to Indefinitely, then select OK.
    3. In the Actions tab, select New. Then, ensure Action is set to Start a program and enter the location of the Machine Connect application under Program/script, then select OK.
    4. In the Conditions tab, ensure all options are cleared, then select OK.
    5. In the Settings tab, select Allow task to be run on command, Run task as soon as possible after a scheduled start is missed, and If running the task does not end when requested, force it to stop, then select OK
  6. Once all settings are configured in each tab, select OK to save your new task.
  7. Restart your PC. Within a minute of logging in, Machine Connect will launch
  8. Enter your Username, Password, and the Asset ID (asset key in Utility Cloud itself) of the asset Machine Connect will perform work against. 
  9. Select start. Machine connect will begin communicating with Utility Cloud and retrieve the asset attributes from your asset and instructions for collecting data from the Work Schedule.
    MC Running

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:

  1. 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..
  2. 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.
  3. 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.
  4. 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
TEXTYesAB Legacy|{IP ADDRESS:PORT}|{FAMILY}|{MEMORY-ADDRESS}Friendly name for the tagFriendly 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
TEXTYesAB Control Logix|{IP ADDRESS}|{PORT}|{PLCTAGNAME}Friendly name for the tagFriendly 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:

  1. Create a new point type asset class to represent the “System”, ensuring that it is associated with a business line.
  2. In your new asset class, add the required asset class fields described below.
  3. 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.
  4. 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.
  5. 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
TEXTYesMC_INTTYPEInterface TypeDefines the interface type.RSVIEW32
TEXTYesMC_APPApplicationDefines the DDE Application Name

{application name}

TEXTYesMC_TOPICTopicDefines the DDE Topic{topic}

Workflow Class Fields

Field Type
Required
Key
Name
Description
Default Value
TEXTYes{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:

  1. Create a new point type asset class to represent the “System”, ensuring that it is associated with a business line.

  2. In your new asset class, add the required asset class fields described below.

  3. 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.

  4. 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.

  5. 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
TEXTYesMC_INTTYPEInterface TypeDefines the interface type.GE PROFICY HISTORIAN
TEXTYesMC_OLEDBOLE DB Connection StringDefines the connection string.
Provider=iHOLEDB.iHistorian.1
  • 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
TEXTYes{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:

  1. Create a new point type asset class to represent the “System”, ensuring that it is associated with a business line.

  2. In your new asset class, add the required asset class fields described below.

  3. 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.

  4. 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.

  5. 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
TEXTYesMC_INTTYPEInterface TypeDefines the interface type.GE PROFICY IFIX

Workflow Class Fields

Field Type
Required
Key
Name
Description
Default Value
TEXTYes{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:

  1. Create a new point type asset class to represent the “System”, ensuring that it is associated with a business line.
  2. In your new asset class, add the required asset class fields described below.
  3. 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.
  4. 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.
  5. 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
TEXTYesMC_INTTYPEInterface TypeDefines the interface type.WONDERWARE

Workflow Class Fields

Field Type
Required
Key
Name
Description
Default Value
TEXTYes{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:

  1. Create a new point type asset class to represent the “System”, ensuring that it is associated with a business line.
  2. In your new asset class, add the required asset class fields described below.
  3. 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.
  4. 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.
  5. 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 TypeRequired

Title

Key

Type

Details

TEXTYes

MC_INTTYPE

MC_INTTYPE

Text


TEXTYes

OPC_SERVER_URL

OPC_SERVER_URL

Text


TEXTYes

OPC_USERNAME

OPC_USERNAME

Text


TEXTYes

OPC_PASSWORD

OPC_PASSWORD

Text


TEXTYes

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.tcp://opc.server.com:4840

OPC_USERNAME

Username

OPC_PASSWORD

Password

OPC_LAMBDA

ENABLED


Workflow Class Fields

Field Type
Required
Title
Key
Description
Default Value
TEXTYes{Identifier}{NodeId}Friendly name for the tag

NodeId will come from the OPC UA Desktop Client such as UAExpert.


JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.