For Live data, Historical data logging, Datalogging to MQTT broker, and Alarms & Notifications you'll need to set up a data source and add variables. This article shows you how to do this for communication via EtherNet/IP.

Manufacturers that support EtherNet/IP: Rockwell Automation (Allen-Bradley), Omron.

For help and solutions with issues, see EtherNet/IP data source issues and solutions.

• Prepare the machine
• Add a data source
• Find the address of your EtherNet/IP variables
• Add variables
• Live data, Historical data logging, Alarms & Notifications

• Remove a data source

Prepare the machine

Some machines need to be prepared to enable communication.

Add a data source

The machine will need to be added as a EtherNet/IP data source.

1. Go to Fleet Manager > Devices and click on your device name.
2. In the left menu, go to Data sources.
   • Tip: You can switch between the Card view , with useful data source information at a glance, and the List view . For more information, see Data sources overview FAQ.
3. Click onAdd data source and select EtherNet/IP.
4. Enter the requested information (details below) and click on Add.

   Field	Description
   Name	Enter a name for the data source.
   Identifier	The identifier is entered automatically and ensures that every data source remains unique, even if they share the same name.
   IP address	Enter the IP address of your machine. Leave empty for localhost, if you're using an IXagent, or if you're adding this data source for a Docker container on a SecureEdge Pro.
   Port	The port number will be entered automatically (port 44818 for EtherNet/IP).
   CPU	Select your machine type. Are you using an Allen-Bradley SLC PLC? Try selecting AB Micrologix as CPU. The following information only applies to the IXrouter3: Option AB Micro800 and option Omron NX / NJ / NY / NA requires IXrouter firmware 3.25 or higher. These options include performance improvements and bug fixes and are recommended over the legacy combined option AB Micro800, Omron NX / NJ / NY / NA. When changing from this legacy option to one of the new options, it is necessary to reboot your IXrouter after pushing the configuration to the IXrouter. The combined option AB Micro800, Omron NX / NJ / NY / NA works with both old and new firmware, but is deprecated and will no longer receive improvements and bug fixes.
   Rack and Slot	Rack and slot number of your machine. The default rack number is 1, the default slot number is 0.
   Polling sleep time	The edge gateway will continuously request data from the machine. This then enables you to log aggregated values, like the average value or the maximum value that occurred, and to trigger alarms when certain conditions are met. The polling sleep time is the time that the edge gateway waits before asking data again, after it just received data from the machine. A polling sleep time of 100ms is recommended to minimize CPU load on the edge gateway and machine. In the rare case that you are experiencing a high CPU load on the machine, you can increase this setting to reduce the load further. Make sure it's shorter than your shortest logging interval to prevent missing data.
   Error grace period	Supported hardware SecureEdge and SecureEdge Pro, firmware 5.0 and up (upgrade) IXrouter3, firmware 3.25 and up (upgrade) IXrouter2 (unsupported) In rare situations, mainly during the startup period of a PLC, the PLC might already accept communication attempts from the edge gateway, but it may not be fully ready yet. It might then return errors or 0-values instead of the actual values. This may result in no data (missing data) or incorrect data being read. The error grace period can be configured to bridge this moment and only start polling variables after the configured time, granting the PLC sufficient time to fully start up and maintaining the reliability of the machine data. An error grace period of 0 seconds (Off) is recommended. In the rare case that you are experiencing no data (missing data) or incorrect data during startup you can increase this setting to bridge that period.
   Use custom broker	Leave this unchecked unless you are following instructions for Datalogging to MQTT broker.

Find the address of your EtherNet/IP variables

The address of an EtherNet/IP variable depends on the machine type.

Add variables

Once you've added a data source and have your EtherNet/IP addresses, you can start adding variables.

5. Go back to the IXON Cloud.
6. The Variables tab of your data source should have automatically opened.
   • If it didn't: Go to Fleet Manager > Devices, click on your device name, go to Data sources, click on your data source, and go to the Variables tab.
7. Click onAdd variable.
8. Enter the requested information (details below) and click on Add.

   Field	Description
   Name	Enter a name for the variable.
   Identifier	The identifier is entered automatically and ensures that every variable remains unique, even if they share the same name.
   Type	Select the variable's data type (bool, int, float, etc) using the translation tables shown earlier. Find the address of your EtherNet/IP variables.
   Length	(for String data types only) The String length.
   Address	Enter the variable's address using the CPU-specific notation explained earlier. Find the address of your EtherNet/IP variables.
   Factor	Multiplies the value. Leave empty if the data type is boolean. For information on where this factor is and isn't used, see How to use factors in Live Data and Historical data.
   Unit	Displayed behind the value (e.g. kg).

9. Repeat the previous steps for every variable you want to add or click Import from CSV-file near the top right corner to add variables in bulk instead.
   • The structure of the CSV file is explained here: Import variables: CSV file structure.
   • Using Export to CSV-file and Import from CSV-file enables you to easily copy variables from one device to another device. Alternatively, you can also use device templates.

You have now made the changes in the IXON Cloud, but these are not yet active in your device. You will need to push your changes to your device for them to take effect.

10. Click on Push device config in the top right corner.

Live data, Historical data logging, Alarms & Notifications

Now that the data source and variables have been set up, you can continue below.

11. Click below to continue in the feature specific articles.
    • Live data
    • Historical data logging
    • Datalogging to MQTT broker
    • Alarms & Notifications

Remove a data source

Deleting a data source is permanent and cannot be undone. All logged data that is linked to this data source or its variables will also be permanently removed.

1. Go to Fleet Manager > Devices and click on your device name.
2. In the left menu, go to Data sources.
3. Click on the data source you wish to remove.
4. In the top right, open More optionsand select Remove data source.