Skip to main content

Configuration

This section describes the configuration settings for the Device Integration Agent. The configuration file is located at config.toml in the root directory of the Device Integration Agent. If the Device Integration Agent is running as a Windows service, the configuration file is located in the installation directory located at C:\Program Files\Datalogic device integration gateway\config.toml.

The default config.toml is as follows:

agent = {sendTelemetryMs=3600000, logLevel="INFO"}
firmware = {protocol = "http", host = "<EDGE_DEVICE_IP>", port="8090"}
mqtt ={ clientId="${random.uuid}", host="tcp://<EDGE_DEVICE_IP>:1883" }
service={tlsEnabled = false, host = "localhost", port="9000"}

The config.toml file contains configuration settings for: service, agent, firmware and mqtt.

service ={ tlsEnabled = true, host = "localhost", port="9000"}

The service section contains configuration for the Aladdin SDS.

  • tlsEnabled: Whether TLS is enabled.
  • host: The hostname or IP address of the Aladdin SDS.
  • port: The port number on which the Aladdin SDS is running.
agent = {sendTelemetryScheduleMs=3600000, downloadPath="download/", logLevel="INFO"}

The agent section contains configuration for the Device Integration Agent.

  • sendTelemetryScheduleMs: The frequency at which telemetry data is sent to the cloud, in milliseconds. The default is 1 hour.
  • downloadPath: The path to the directory where firmware is downloaded. The default is "download/".
  • logLevel: controls the verbosity of logging output. It is a string value that can be set to one of the following levels:TRACE, DEBUG, INFO, WARN, ERROR
firmware = { protocol = "http", host = "<EDGE_DEVICE_IP>", port = "8090", downloadTimeoutMs=360000 }

The firmware section contains configuration for the Edge Device Storage Module.

  • protocol: The communication protocol used by the Edge Device Storage Module.
  • host: The hostname or IP address of the Edge Device Storage Module.
  • port: The port number on which the Edge Device Storage Module is running.
  • downloadTimeoutMs: The timeout for downloading firmware, in milliseconds. The default is 1 hour. For big firmware files, this value should be increased.
mqtt ={ clientId="${random.uuid}", host="tcp://20.73.75.238:1883", username="optional", password="optional", caFilePath="optional", crtFilePath="optional", keyFilePath="optional"}

The mqtt section contains configuration for the EDGE MQTT broker.

  • clientId: The client ID used to connect to the MQTT broker.
  • host: The hostname or IP address and port of the MQTT broker.
  • username: The username used to connect to the MQTT broker.
  • password: The password used to connect to the MQTT broker.
  • caFilePath: The path to the CA certificate file used to connect to the MQTT broker.
  • crtFilePath: The path to the certificate file used to connect to the MQTT broker.
  • keyFilePath: The path to the key file used to connect to the MQTT broker.

Please note that these values are specific to a particular environment and would need to be changed to match your specific setup.

OpenTelemetry configuration​

This section describes how to configure the Device Integration Gateway. The configuration file is located at otel.properties in the root directory of the Device Integration Gateway. If the Device Integration Gateway is running as a Windows service, the configuration file is located in the installation directory located at C:\Program Files\Datalogic device integration gateway\otel.properties.

The default otel.properties is as follows:

otel.resource.attributes=service.name=DIG
otel.exporter.otlp.protocol=grpc
otel.exporter.otlp.endpoint=http://0.0.0.0:4317
otel.metric.export.interval=600000

The otel.properties file contains configuration settings for the Aladdin SDS.

  • otel.resource.attributes=service.name: Name of the service

  • otel.exporter.otlp.protocol: Protocol used to send data to open telemetry collector. Needs to be set accordingly to the otel collector

  • otel.exporter.otlp.endpoint: Otel collector endpoint

  • otel.metric.export.interval: Defines the interval at which metrics are sent to the OpenTelemetry collector.