# 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}