For Live data, Historical data logging, Datalogging to MQTT broker, and Alarms & Notifications you'll need to set up a data source and add a variable. This article shows you how to do this for the edge gateway's Digital Input. View the installation manual for electrical wiring information.

If you're looking to control the VPN connection with use of the Digital Input, use this article instead: Switch VPN on/off.

For help and solutions with issues, see Digital Input (GPIO) data source issues and solutions.

• Add a data source
• Add variable
• Live data, Historical data logging, Alarms & Notifications

• Remove a data source

Add a data source

The edge gateway's Digital Input will need to be added as a 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 SMTP/GPIO.
4. Enter the requested information (details below) and click on Add.

   Field	Description / instructions
   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	Leave this field empty.
   Error grace period	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.

Add variable

Once you've added a data source, you can add the variable.

5. 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.
6. Click onAdd variable.
7. Enter the requested information (details below) and click on Add.

   Field	Description / instructions
   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 Boolean.
   Protocol	Select GPIO.

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.

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

Live data, Historical data logging, Alarms & Notifications

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

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