Skip to main content

Configuration

This page lists the configuration sections and options of the AladdinSDS service, as they appear in its config.toml file. The sections in square brackets are the same on every platform. For what the service does with them, see the Overview; for setup, see Windows Installation or Linux Installation. The complete default file is at the end of the page, under Default Configuration File.

Configuration Files​

The location of config.toml, the recommended download folder, the path of the Updater binary and the way to restart the service depend on the platform:

PlatformReference
WindowsWindows
LinuxLinux

Format Notes​

The configuration uses TOML (Tom's Obvious, Minimal Language) format:

  • Strings must be in quotes: "value"
  • Numbers have no quotes: 1234
  • Booleans: true or false (no quotes)
  • Windows paths: Use double backslashes "C:\\Path\\To\\File"

Options marked Restart required take effect only after the service is restarted, see After Making Changes.

Configuration Sections​

[edge] - Edge Gateway Connection​

Settings for communicating with the IoT Edge Gateway for cloud connectivity.

host​

  • Type: String (hostname or IP address)
  • Default: "localhost"
  • Description: Network address of the IoT Edge Gateway.
  • Values:
    • "localhost" = Edge running on same machine (development/testing)
    • IP address = Remote Edge (e.g., "192.168.1.100")
    • Hostname = DNS-resolvable name (e.g., "edge-gateway.local")
[edge]
host = "localhost"

[aladdinSDS] - Service Behavior​

Controls how the service behaves, including telemetry, connection reports and logging.

sendTelemetryMs​

  • Type: Integer (milliseconds)
  • Default: 3600000
  • Valid Range: 60000 (1 min) to 86400000 (24 hours)
  • Description: How often the service sends device telemetry data to the IoT Edge Gateway.
  • Examples:
    • 300000 = 5 minutes
    • 3600000 = 1 hour (default)
    • 7200000 = 2 hours
[aladdinSDS]
sendTelemetryMs = 3600000

sendConnectionMin​

  • Type: Integer (minutes)
  • Default: 5
  • Valid Range: 1 to 1440 (24 hours), or 0 to disable
  • Description: How often the service re-publishes a full connection snapshot to the IoT Edge Gateway. The snapshot covers the connection status of the POS and every scanner currently connected, including docked children. It keeps the view of online hosts and devices in Datalogic Connect up to date even if a previous status report was missed, for example during a short broker disconnection. The snapshot is sent only while the MQTT connection is up; cycles in which the broker is unreachable are skipped, not retried.
  • Examples:
    • 0 = disabled, no periodic snapshot
    • 1 = every minute (debugging and smoke tests)
    • 5 = every 5 minutes (default)
    • 60 = every hour
note

This interval is independent of the snapshot that the service always sends once on every (re)connection and when the gateway address changes.

sendConnectionMin = 5

logLevel​

  • Type: String (enum)
  • Default: "INFO"
  • Valid Values: "TRACE", "DEBUG", "INFO", "WARN", "ERROR", "FATAL", "OFF"
  • Restart required: Yes
  • Description: Controls how much detail is written to the log files. Higher detail levels (TRACE, DEBUG) consume more disk space and CPU.
  • Recommended: "INFO" for production, "DEBUG" for troubleshooting
logLevel = "INFO"

locationId​

  • Type: String (UUID)
  • Default: "" (empty, not set)
  • Format: e.g., "00000000-0000-0000-0000-000000000000"
  • Description: Optional identifier of the physical or logical location of this service. When set, it is included in the connection and diagnostic MQTT payloads.
locationId = ""

[autoConfiguration] - Auto-Configuration (Standalone Mode)​

Settings for the auto-configuration feature in standalone mode, which applies firmware updates and configuration packages to the attached scanners automatically.

scheduleUpdateTime​

  • Type: String (time window)
  • Default: "00:00 - 01:00"
  • Format: "HH:MM - HH:MM"
  • Description: Time window during which scheduled auto-configuration (firmware updates or configuration deployment) is allowed to run.
[autoConfiguration]
scheduleUpdateTime = "00:00 - 01:00"

eventDrivenUpdateMode​

  • Type: String (enum)
  • Default: "DEFER"
  • Valid Values:
    • "IMMEDIATE" = Updates are applied as soon as they are detected, ignoring scheduleUpdateTime
    • "DEFER" = Updates are deferred until the current time falls within scheduleUpdateTime (default)
    • "DISABLED" = The auto-configuration feature is disabled
  • Description: Controls the behavior when an event-driven update is detected.
eventDrivenUpdateMode = "DEFER"

retryTimes​

  • Type: Integer
  • Default: 3
  • Description: Maximum number of retry attempts for an SDS package. A package that still fails after the last retry is blocked.
retryTimes = 3

retryDelay​

  • Type: Integer (seconds)
  • Default: 30
  • Description: Delay between retry attempts.
retryDelay = 30

removePackageAfterExecute​

  • Type: String (enum)
  • Default: "DEPEND_ON_PACKAGE"
  • Valid Values:
    • "REMOVE" = Remove the package after all valid devices have been configured
    • "NOT_REMOVE" = Keep the package after execution
    • "DEPEND_ON_PACKAGE" = Follow the setting in the package itself (default)
  • Description: Determines whether the package is removed once all valid devices have been processed successfully.
removePackageAfterExecute = "DEPEND_ON_PACKAGE"

[files] - File Transfer Service​

Settings for the transfer of firmware packages and file uploads.

protocol​

  • Type: String (enum)
  • Default: "http"
  • Valid Values: "http", "https"
  • Restart required: Yes
  • Description: Protocol used for file uploads from devices or external systems.
[files]
protocol = "http"

port​

  • Type: Integer (TCP port)
  • Default: 8090
  • Valid Range: 1024-65535 (avoid privileged ports below 1024)
  • Restart required: Yes
  • Description: TCP port of the file transfer service. Used for firmware packages and device configurations.
port = 8090

downloadTimeoutMs​

  • Type: Integer (milliseconds)
  • Default: 3600000
  • Valid Range: 60000 (1 min) to unlimited
  • Restart required: Yes
  • Description: Maximum time allowed to download a firmware package before timing out.
downloadTimeoutMs = 3600000

downloadPath​

  • Type: String (file path)
  • Default: "download/"
  • Restart required: Yes
  • Description: Directory where SDS packages are downloaded. Supports relative or absolute paths.
  • Recommended values: see Windows and Linux
warning

Ensure this directory has write permissions and sufficient disk space for package downloads.

downloadPath = "download/"

removeDownloadedPackage​

  • Type: Boolean
  • Default: false
  • Description: When true, the ZIP package downloaded from Datalogic Connect (for example by Change configuration) is deleted from the download folder after the command completes. When false, the package is kept.
removeDownloadedPackage = false

[mqtt] - MQTT Broker Connection​

Settings for the MQTT message broker used to communicate with the IoT Edge Gateway and cloud services.

port​

  • Type: Integer (TCP port)
  • Default: 1883
  • Restart required: Yes
  • Description: TCP port of the MQTT broker.
[mqtt]
port = 1883

[http] - HTTP API Server​

REST API server for device management, configuration, and monitoring.

port​

  • Type: Integer (TCP port)
  • Default: 9000
  • Valid Range: 1024-65535
  • Restart required: Yes
  • Description: TCP port of the REST API server. Used to access the AladdinSDS API and its interactive documentation.
[http]
port = 9000

[otel] - OpenTelemetry Export​

Settings of the internal OpenTelemetry (OTEL) span and log exporter.

endpoint​

  • Type: String (URL)
  • Default: "http://localhost:4317"
  • Restart required: Yes
  • Description: URL of the OTLP gRPC collector endpoint.
[otel]
endpoint = "http://localhost:4317"

serviceName​

  • Type: String
  • Default: "SDS"
  • Restart required: Yes
  • Description: Logical service name, exported as the service.name resource attribute.
serviceName = "SDS"

[connectivity] - Device Connectivity Policy​

Controls which communication channels AladdinSDS uses for each device family. A scanner can be reached through its host interface (USB-COM or USB-OEM) and through its service port, see Scanner Discovery.

FRSConnectivity​

  • Type: String (enum)
  • Default: "BOTH"
  • Valid Values:
    • "NO" = Disable all communication with fixed retail scanners
    • "HOST" = Use only the host interface (USB-COM/USB-OEM)
    • "SERVICES" = Use only the service port
    • "BOTH" = Prefer the service port, fall back to the host interface (default)
  • Restart required: Yes
  • Description: Connectivity policy for fixed retail scanners (FRS).
[connectivity]
FRSConnectivity = "BOTH"

HHSConnectivity​

  • Type: String (enum)
  • Default: "BOTH"
  • Valid Values: same as FRSConnectivity
  • Restart required: Yes
  • Description: Connectivity policy for handheld scanners (HHS).
HHSConnectivity = "BOTH"

releaseHostFRS​

  • Type: Boolean
  • Default: false
  • Description: When true, AladdinSDS releases both the host port and the service port of a fixed retail scanner after a compliance check or firmware update.
warning

Releasing the ports disconnects them, so the fixed retail scanner stops delivering barcodes to the POS.

releaseHostFRS = false

releaseHostHHS​

  • Type: Boolean
  • Default: false
  • Description: When true, AladdinSDS releases both the host port and the service port of a handheld scanner after a compliance check or firmware update.
warning

Releasing the ports disconnects them, so the handheld scanner stops delivering barcodes to the POS.

releaseHostHHS = false

[updater] - Auto-Update Settings​

Configuration for the automatic service updater component.

note

This section applies only where the SDS Updater component is installed. The Windows installation guide asks to deselect it during setup.

path (Optional)​

  • Type: String (file path)
  • Default: Not set; the default path of the detected operating system is used
  • Description: Path of the Updater executable. Set it only to override the default path. See Windows and Linux for the defaults.
[updater]
# path = ""

scheduleEnabled​

  • Type: Boolean
  • Default: false
  • Restart required: Yes
  • Description: When true, the updater checks for and installs updates on schedule. When false, updates must be triggered manually via API.
scheduleEnabled = false

scheduleHour​

  • Type: Integer (24-hour format)
  • Default: 6
  • Valid Range: 0-23 (0 = midnight, 12 = noon, 23 = 11 PM)
  • Restart required: Yes
  • Description: Hour of the day (local time) when scheduled update checks run.
scheduleHour = 6

triggerOnStart​

  • Type: Boolean
  • Default: false
  • Restart required: Yes
  • Description: When true, the updater checks for updates immediately when the service starts. When false, only scheduled or manual updates occur.
triggerOnStart = false

allowDowngrade​

  • Type: Boolean
  • Default: false
  • Restart required: No, applied immediately
  • Description: When true, the updater may install a version older than the current one (rollback). When false, it refuses to.
allowDowngrade = false

manifestUrl​

  • Type: String (URL)
  • Default: "https://aladdin.datalogic.com/sds/aladdin-sds-manifest.json"
  • Restart required: Yes
  • Description: URL of the JSON manifest file listing available service updates. The updater fetches this file to determine if new versions are available.
manifestUrl = "https://aladdin.datalogic.com/sds/aladdin-sds-manifest.json"

[notification] - Notifications​

Settings of the notification service.

enableNotify​

  • Type: Boolean
  • Default: false
  • Description: When true, the service shows notification messages. When false, notifications are disabled.
[notification]
enableNotify = false

[frsRecollector] - FRS Children Recollector​

Controls how AladdinSDS polls again the child devices attached to a fixed retail scanner, such as a docked handheld scanner.

retryNumber​

  • Type: Integer
  • Default: 1
  • Valid Range: 1 or more
  • Description: How many times the child device list is fetched again before a recollect cycle gives up.
[frsRecollector]
retryNumber = 1

periodMs​

  • Type: Integer (milliseconds)
  • Default: 30000 (30 seconds)
  • Valid Range: greater than 0
  • Description: Delay between consecutive poll attempts.
periodMs = 30000

[diagnostic] - Diagnostic Acknowledgement​

Settings for diagnostic message handling and acknowledgements (ACK) from the IoT Edge Gateway.

enableDiagnosticACK​

  • Type: Boolean
  • Default: false
  • Description: When true, diagnostic messages are tracked and sent again if no ACK is received. When false, diagnostic messages are published without tracking or retries.
[diagnostic]
enableDiagnosticACK = false

diagnosticACKTimeout​

  • Type: Integer (seconds)
  • Default: 60
  • Valid Range: 1 or more
  • Description: How long AladdinSDS waits for an ACK from the IoT Edge Gateway before retrying the message.
diagnosticACKTimeout = 60

diagnosticACKMaxRetries​

  • Type: Integer
  • Default: 3
  • Valid Values:
    • -1 = Unlimited retries, until an ACK is received
    • 0 = No retries, give up after the first timeout
    • 1 or more = Limited number of retries
  • Description: Maximum number of retries for a diagnostic message that is not acknowledged within diagnosticACKTimeout. Each retry publishes the message again with a new message ID.
diagnosticACKMaxRetries = 3

[detection] - Device Detection​

Controls the retry behavior of device detection and connection checks.

detectionRetryTimesShort​

  • Type: Integer
  • Default: 3
  • Valid Range: 1 or more
  • Description: How many times a short detection cycle is retried before giving up.
[detection]
detectionRetryTimesShort = 3

detectionRetryTimesLong​

  • Type: Integer
  • Default: 3
  • Valid Range: 1 or more
  • Description: How many times a long detection cycle is retried before giving up.
detectionRetryTimesLong = 3

connectionCheckIntervalShort​

  • Type: Integer (milliseconds)
  • Default: 1000 (1 second)
  • Valid Range: greater than 0
  • Description: Wait time between consecutive short detection attempts.
connectionCheckIntervalShort = 1000

connectionCheckIntervalLong​

  • Type: Integer (milliseconds)
  • Default: 60000 (60 seconds)
  • Valid Range: greater than 0
  • Description: Wait time between consecutive long detection attempts.
connectionCheckIntervalLong = 60000

Common Configuration Scenarios​

Enable Scheduled Updates​

To let the updater check for and install updates every day at 3 AM and at every service start:

[updater]
scheduleEnabled = true
scheduleHour = 3
triggerOnStart = true

Configure Frequent Telemetry​

To send device telemetry more frequently:

[aladdinSDS]
sendTelemetryMs = 300000 # 5 minutes instead of 1 hour

Apply Auto-Configuration Immediately​

To apply firmware and configuration packages as soon as they are detected, without waiting for the schedule window:

[autoConfiguration]
eventDrivenUpdateMode = "IMMEDIATE"

Use Only the Host Interface for Handheld Scanners​

To keep AladdinSDS off the service port of handheld scanners:

[connectivity]
HHSConnectivity = "HOST"

After Making Changes​

  1. Backup: Always back up the original config.toml before making changes
  2. Restart Service: Restart the AladdinSDS service for changes to take effect, see Windows or Linux
  3. Verify: Check the service logs to ensure the service started correctly, see Windows or Linux

Default Configuration File​

The complete config.toml with its default values and inline comments:

config.toml
# ============================================================================
# Datalogic Aladdin SDS Configuration File
# ============================================================================
# File Location:
# Windows: C:\ProgramData\Datalogic\AladdinSDS\config.toml
# Linux: /opt/AladdinSDS/config.toml
#
# Format: TOML (Tom's Obvious, Minimal Language)
# - Strings must be in quotes: "value"
# - Numbers have no quotes: 1234
# - Booleans: true or false (no quotes)
# - Paths on Windows: Use double backslashes "C:\\Path\\To\\File"

# ----------------------------------------------------------------------------
# [edge] - Edge Gateway Configuration
# ----------------------------------------------------------------------------
# Settings for communicating with the Datalogic edge gateway.
[edge]

# host - Edge gateway hostname or IP address
# Network address of the edge gateway for cloud connectivity.
# Values:
# - "localhost": Gateway running on same machine (development/testing)
# - IP address: Remote gateway (e.g., "192.168.1.100")
# - Hostname: DNS-resolvable name (e.g., "edge-gateway.local")
host = "localhost"

# ----------------------------------------------------------------------------
# [aladdinSDS] - AladdinSDS Agent Behavior Configuration
# ----------------------------------------------------------------------------
# Controls how the SDS agent behaves, including telemetry and logging.
[aladdinSDS]

# sendTelemetryMs - Telemetry reporting interval (milliseconds)
# How often the agent sends device telemetry data to the edge gateway.
# Default: 3600000 (1 hour)
# Range: 60000 (1 min) to 86400000 (24 hours)
# Examples:
# - 300000 = 5 minutes
# - 3600000 = 1 hour (default)
# - 7200000 = 2 hours
sendTelemetryMs = 3600000

# sendConnectionMin - Host/device connection re-publish interval (minutes)
# How often the agent re-publishes a full connection snapshot to the edge
# gateway. The snapshot covers:
# - the host connection status for this machine
# - every currently connected device (recursively, including children)
# Useful to keep DL Connect's view of ONLINE hosts/devices fresh even if a
# previous status publish was missed (e.g. transient broker disconnect).
# The snapshot is only sent when the MQTT client is connected; cycles
# where the broker is unreachable are skipped (no retry storm).
# Default: 5 (every 5 minutes)
# Range: 1 to 1440 (24 hours)
# Set to 0 to DISABLE the periodic snapshot (no scheduler started).
# Note: this is independent of the one-shot snapshot already sent on
# (re)connect and on edge-host change.
# Examples:
# - 0 = disabled
# - 1 = every minute (debug / smoke tests)
# - 5 = every 5 minutes (default)
# - 60 = every hour
sendConnectionMin = 5

# logLevel - Application logging verbosity
# Controls how much detail is written to log files (restart required).
# Valid values: "TRACE", "DEBUG", "INFO", "WARN", "ERROR", "FATAL", "OFF"
# Default: "INFO"
logLevel = "INFO"

# locationId - Optional identifier for the physical or logical location of this service.
# Included in connection and diagnostic MQTT payloads when configured.
# Format: String / UUID (e.g. "00000000-0000-0000-0000-000000000000")
locationId = ""

# ----------------------------------------------------------------------------
# [autoConfiguration] - Auto-Configuration Feature - Standalone Mode
# ----------------------------------------------------------------------------
# Settings for the auto-configuration feature - Standalone Mode.
[autoConfiguration]

# scheduleUpdateTime - Time window during which scheduled Auto-Configuration are allowed to run (firmware updates or configuration deployment).
# Range: "HH:MM - HH:MM"
# Default: "00:00 - 01:00"
scheduleUpdateTime = "00:00 - 01:00"

# eventDrivenUpdateMode - Controls behavior when an event-driven update is detected.
# Valid values:
# - "IMMEDIATE": Updates are applied instantly upon detection (ignore scheduleUpdateTime).
# - "DEFER": Automatically updates are deferred until the current time falls within the scheduleUpdateTime window.
# - "DISABLED": disables Auto-Configuration feature.
# Default: "DEFER"
eventDrivenUpdateMode = "DEFER"

# retryTimes - Maximum number of retry attempts for the SDS package.
# If the package still fails after reaching the maximum retry count, it will be blocked.
# Default: 3
retryTimes = 3

# retryDelay - Delay between retry attempts in seconds.
# Default: 30
retryDelay = 30

# removePackageAfterExecute - Determines whether the package is removed
# This setting takes effect after all valid devices have been successfully processed.
# The actual behavior depends on the selected value, which controls whether the package is removed, retained, or governed by its own configuration.
# Valid values:
# - "REMOVE": Remove the package after all valid devices have been configured.
# - "NOT_REMOVE": Keep the package after execution.
# - "DEPEND_ON_PACKAGE": Follow the package configuration.
# Default: DEPEND_ON_PACKAGE
removePackageAfterExecute = "DEPEND_ON_PACKAGE"

# ----------------------------------------------------------------------------
# [files] - File Transfer Service Configuration
# ----------------------------------------------------------------------------
# HTTP server for receiving firmware packages and file uploads.
[files]

# protocol - File transfer protocol
# Protocol used for file uploads from devices or external systems (restart required).
# Valid values: "http", "https"
# Default: "http"
protocol = "http"

# port - File service listening port
# TCP port for the file transfer HTTP server (restart required).
# Default: 8090
# Range: 1024-65535 (avoid privileged ports below 1024)
port = 8090

# downloadTimeoutMs - File download timeout (milliseconds)
# Maximum time allowed to download a firmware package (restart required).
# Default: 3600000 (1 hour)
# Range: 60000 (1 min) to unlimited
downloadTimeoutMs = 3600000

# downloadPath - Package download directory
# Where SDS packages are downloaded (restart required).
# Default: "download/"
# Important: Ensure this directory has write permissions
# Windows recommended: "C:\\Program Files\\Datalogic\\AladdinSDS\\download"
# Linux recommended: "/opt/AladdinSDS/download"
downloadPath = "download/"

# removeDownloadedPackage - Delete the downloaded package after execution
# When true, the zip package downloaded from DL Connect (e.g. via Change Configuration)
# is automatically deleted from the download folder after the command completes.
# When false, the downloaded package is kept in the download folder.
# Default: false
removeDownloadedPackage = false

# ----------------------------------------------------------------------------
# [mqtt] - MQTT Broker Connection Configuration
# ----------------------------------------------------------------------------
# Connection settings for the MQTT message broker used to communicate
# with the edge gateway and cloud services.
[mqtt]

# port - MQTT broker port
# TCP port of the MQTT broker (restart required).
# Default: 1883
port = 1883

# ----------------------------------------------------------------------------
# [http] - HTTP API Server Configuration
# ----------------------------------------------------------------------------
# REST API server for device management, configuration, and monitoring.
[http]

# port - API server listening port (restart required).
# Default: 9000
# Range: 1024-65535
port = 9000

# ----------------------------------------------------------------------------
# [otel] - OpenTelemetry Export Configuration
# ----------------------------------------------------------------------------
# Settings used by the internal OTEL span/log exporter.
[otel]

# endpoint - OTLP collector endpoint
# URL of the OTLP gRPC collector endpoint (restart required).
# Default: "http://localhost:4317"
endpoint = "http://localhost:4317"

# serviceName - OpenTelemetry service name
# Logical service name exported as resource attribute service.name (restart required).
# Default: "SDS"
serviceName = "SDS"

# ----------------------------------------------------------------------------
# [connectivity] - Device Connectivity Policy
# ----------------------------------------------------------------------------
# Controls which communication channels Aladdin SDS uses for each device family.
[connectivity]

# FRSConnectivity - Connectivity policy for Fixed Retail Scanners (FRS)
# Determines which communication channels are used for FRS devices (restart required).
# Valid values:
# - "NO": Disable all communication with FRS devices
# - "HOST": Use only the primary host interface (USB-COM/USB-OEM)
# - "SERVICES": Use only the Service Port communication channel
# - "BOTH": Prioritize Service Port, fallback to host port (default)
# Default: "BOTH"
FRSConnectivity = "BOTH"

# HHSConnectivity - Connectivity policy for Handheld Scanners (HHS)
# Determines which communication channels are used for HHS devices (restart required).
# Valid values:
# - "NO": Disable all communication with HHS devices
# - "HOST": Use only the primary host interface (USB-COM/USB-OEM)
# - "SERVICES": Use only the Service Port communication channel
# - "BOTH": Prioritize Service Port, fallback to host port (default)
# Default: "BOTH"
HHSConnectivity = "BOTH"

# releaseHostFRS - Release host and service ports for FRS after operations complete
# When true, Aladdin SDS releases both the host port and the service port of the device after compliance check/firmware update.
# Stopping barcode reception on FRS device due to port disconnection.
# Default: false
releaseHostFRS = false

# releaseHostHHS - Release host and service ports for HHS after operations complete
# When true, Aladdin SDS releases both the host port and the service port of the device after compliance check/firmware update.
# Stopping barcode reception on HHS device due to port disconnection.
# Default: false
releaseHostHHS = false

# ----------------------------------------------------------------------------
# [updater] - Auto-Update Configuration
# ----------------------------------------------------------------------------
# Settings for the automatic service updater component.
[updater]

# path - Updater executable path (optional, overrides default OS path)
# Leave commented to use the default path for the detected OS.
# Windows default: C:\Program Files\Datalogic\SDSUpdater\DatalogicSDSUpdater.exe
# Linux default: /usr/bin/datalogic-sds-updater
# path = ""

# scheduleEnabled - Enable scheduled automatic updates
# When true, the updater checks for and installs updates on schedule (restart required).
# When false, updates must be triggered manually via API.
# Default: false
scheduleEnabled = false

# scheduleHour - Daily update check time (24-hour format)
# Hour of the day (local time) when scheduled updates run (restart required).
# Range: 0-23 (0 = midnight, 12 = noon, 23 = 11 PM)
# Default: 6 (6:00 AM)
scheduleHour = 6

# triggerOnStart - Check for updates on service startup
# When true, the updater checks for updates immediately when service starts (restart required).
# When false, only scheduled or manual updates occur.
# Default: false
triggerOnStart = false

# allowDowngrade - Allow the updater to install an older version when requested
# When true, rollback/downgrade installs are permitted by the update service.
# When false, the updater refuses to install a version older than the current one.
# This setting is applied immediately without a service restart.
# Default: false
allowDowngrade = false

# manifestUrl - Update manifest URL
# URL of the JSON manifest file listing available service updates (restart required).
# The updater fetches this file to determine if new versions are available.
# Default: "https://aladdin.datalogic.com/sds/aladdin-sds-manifest.json"
manifestUrl = "https://aladdin.datalogic.com/sds/aladdin-sds-manifest.json"

# ----------------------------------------------------------------------------
# [notification] - Notification Configuration
# ----------------------------------------------------------------------------
# Settings for the notification service.
[notification]

# enableNotify - Enable notification service
# When true, the service shows notifications message.
# When false, notifications are disabled.
# Default: false
enableNotify = false

# ----------------------------------------------------------------------------
# [frsRecollector] - FRS Children Recollector Configuration
# ----------------------------------------------------------------------------
# Controls how the AladdinLib re-polls child devices that are attached to an
# FRS (Fixed Retail Scanner) host device.
[frsRecollector]

# retryNumber - Number of poll attempts for the FRS children recollector
# How many times the lib will retry fetching the child device list before
# giving up on a particular recollect cycle.
# Default: 1
# Range: >= 1
retryNumber = 1

# periodMs - Delay between FRS recollector polls (milliseconds)
# How long the lib waits between consecutive poll attempts.
# Default: 30000 (30 seconds)
# Range: > 0
periodMs = 30000

# ----------------------------------------------------------------------------
# [diagnostic] - Diagnostic Message Configuration
# ----------------------------------------------------------------------------
# Settings for diagnostic message handling and acknowledgements.
[diagnostic]

# enableDiagnosticACK - Enable diagnostic message acknowledgement tracking
# When true, diagnostic messages are tracked and retried if ACK is not received.
# When false, diagnostic messages are published without tracking or retries.
# Default: false
enableDiagnosticACK = false

# diagnosticACKTimeout - Timeout duration in seconds to wait for diagnostic ACK response
# How long SDS waits for an ACK from IoT Edge before retrying the message.
# Default: 60
# Range: >= 1
diagnosticACKTimeout = 60

# diagnosticACKMaxRetries - Maximum number of retry attempts for an unacknowledged diagnostic message
# When a diagnostic message does not receive an ACK within diagnosticACKTimeout, SDS retries
# by republishing with a new message ID. This setting limits how many times that retry occurs.
# Set to -1 for unlimited retries (retries until ACK is received).
# Set to 0 to disable retries (give up after first timeout, no retry).
# Default: 3
# Range: -1 = unlimited, 0 = no retries, >= 1 = limited retries
diagnosticACKMaxRetries = 3

# ----------------------------------------------------------------------------
# [detection] - Device Detection Configuration
# ----------------------------------------------------------------------------
# Controls device detection and connection check retry behavior.
[detection]

# detectionRetryTimesShort - Number of retry attempts for short detection cycles
# How many times the detection logic retries a short detection cycle before giving up.
# Default: 3
# Range: >= 1
detectionRetryTimesShort = 3

# detectionRetryTimesLong - Number of retry attempts for long detection cycles
# How many times the detection logic retries a long detection cycle before giving up.
# Default: 3
# Range: >= 1
detectionRetryTimesLong = 3

# connectionCheckIntervalShort - Interval between short detection check attempts (milliseconds)
# How long the detection logic waits between consecutive short detection attempts.
# Default: 1000 (1 second)
# Range: > 0
connectionCheckIntervalShort = 1000

# connectionCheckIntervalLong - Interval between long detection check attempts (milliseconds)
# How long the detection logic waits between consecutive long detection attempts.
# Default: 60000 (60 seconds)
# Range: > 0
connectionCheckIntervalLong = 60000

# ============================================================================
# End of Configuration
# ============================================================================