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:
| Platform | Reference |
|---|---|
| Windows | Windows |
| Linux | Linux |
Format Notes
The configuration uses TOML (Tom's Obvious, Minimal Language) format:
- Strings must be in quotes:
"value" - Numbers have no quotes:
1234 - Booleans:
trueorfalse(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 minutes3600000= 1 hour (default)7200000= 2 hours
[aladdinSDS]
sendTelemetryMs = 3600000
sendConnectionMin
- Type: Integer (minutes)
- Default:
5 - Valid Range: 1 to 1440 (24 hours), or
0to 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 snapshot1= every minute (debugging and smoke tests)5= every 5 minutes (default)60= every hour
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, ignoringscheduleUpdateTime"DEFER"= Updates are deferred until the current time falls withinscheduleUpdateTime(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
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. Whenfalse, 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.nameresource 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.
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.
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.
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. Whenfalse, 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. Whenfalse, 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). Whenfalse, 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. Whenfalse, 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. Whenfalse, 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 received0= No retries, give up after the first timeout1or 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
- Backup: Always back up the original
config.tomlbefore making changes - Restart Service: Restart the AladdinSDS service for changes to take effect, see Windows or Linux
- 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
# ============================================================================
Related Documentation
- Installation Guide: See Windows Installation or Linux Installation for setup instructions
- Supported Devices: See Supported Devices for the scanners AladdinSDS manages and the features available on each interface