# Device settings

Some technology-specific fields are essential for the agent when setting up an ELCO EdgeBox device (a.k.a., thing) in the IoTHub.

# Thing

A thing is a digital representation of a physical device (commonly termed "digital-twin").

# Configuration

The configuration defines connection-related settings for communicating with the device. Here, essential technology-specific fields to set are:

  • endpoint: The endpoint defines the devices address and listening port number. This information is used by the agent for establishing a connection with the device.
  • sdkVersion: Optionally, you can define the SDK version of your device. This version will determine the payload version used for communicating the agent and the device.

# Properties

Properties represent all items that the agent should monitor; this means reading or writing data from or into them, respectively.

# Predefined

For ELCO EdgeBox devices, there are some predefined technology-specific properties:

  • data: This property contains the latest active push of real-time data.
  • alarm: This property informs about the latest pushed alarms.
  • plcStatus: This property informs about the connection status of the PLC qeuipment monitored by the device.
  • configUpdate: This property informs about the latest updates on the device's configuration.

# Actions

Actions are interaction affordances that allow to invoke specific functions on the device or retrieve information from it. Here, essential technology-specific actions are:

  • connect: Use this action for connecting and subscribing to the ELCO EdgeBox device.
  • disconnect: Use this action for disconnecting and unsubscribing from the ELCO EdgeBox device.
  • allData: Use this action to trigger an acquisition of all real-time data.
  • plcStatus: Use this action to trigger a PLC status request.
  • control: Use this action to trigger a variable control request. For instance, if the device is monitoring two PLCs with identifiers "0" and "1", respectively. Then, the control request for settings new values is as follows:
{"0": 12.3, "1": 0}
Last Updated: 1/14/2022, 2:07:20 PM