Clone a Device Connection
Overview
Emerson ROC Device Connections can be cloned using the Emerson ROC APIs with scripts that can be executed in the Ignition Designer Script Console.
⚠️ This action requires EFM Emerson ROC Driver v4.0.19 or newer.
Once you have configured and tested the base device connection to be cloned, use the scripts below to clone device connections either on the same Edge device or on a clean Edge device.
Five scripts are available to help manage Emerson ROC device connection replication. Clicking a script file name opens the script in a new browser tab.
Download Scripts
| File Name 📥 | Description |
|---|---|
| EmersonROCCloneDevice.py | Clones a device connection to multiple new device connections. You will set the unique configuration parameters for each new device in this script. |
| EmersonROCSaveBaseDeviceToFile.py | Saves a device connection configuration to a file, including its TLP Templates and Poll Groups. |
| EmersonROCCreateDeviceFromFile.py | Creates and configures a device connection from file configurations. You will set the file paths to each required configuration file in this script. |
| EmersonROCRemoveDevice.py | Removes device connections. |
| EmersonROCDisableEnableDevice.py | Enables or disables device connections. |
The Cirrus Link Utilities file is not required, but may be downloaded to assist with managing Emerson ROC device connections in Ignition Designer.
| File Name 📥 | Description |
|---|---|
| EmersonROCUtils.zip | A collection of utility functions for managing Emerson ROC device connections in Ignition Designer. |
Run Scripts
- In Ignition Designer, navigate to File > Import and select the EmersonROCUtils.zip file.
- You will see the script under Scripting > Project Library > CirrusLink.
- Open the Tools > Script Console and copy the script from each file as needed. Set the configuration parameters required within each script.
- Select Execute.
This example shows the EmersonROCSaveBaseDeviceToFile script.
✅ After the script finishes, verify that the cloned device connections are configured correctly and can connect successfully.