Skip to main content

Quickstart

Supported Devices​

For a complete list of all supported devices including Fixed Retail Scanners, Handheld Scanners, Mobile Devices and their supported commands, see the Supported Devices page.

Install Aladdin SDS​

warning

Before installing AladdinSDS version 1.1.2 or later, make sure to uninstall any AladdinSDS version lower than 1.1.2 and the Device Integration Gateway (DIG) if present on the machine. Leaving old versions installed may cause conflicts, duplicate device registrations, or unexpected behaviour.

Follow these steps to run the Aladdin SDS as a Windows Service:

  1. Download the .msi installer from Aladdin SDS Installer.

  2. Run the installer and follow the instructions provided.

  3. Check if service is running in the task manager:

    Aladdin SDS Version

  4. Open the config.toml file located at C:\ProgramData\Datalogic\AladdinSDS\config.toml and set the Edge host address:

    [edge]
    host = "<YOUR_EDGE_IP_ADDRESS>"

    Replace <YOUR_EDGE_IP_ADDRESS> with the IP address or hostname of your Edge gateway. For more details on all available configuration options, see the AladdinSDS Configuration page.

  5. Restart the Aladdin SDS service to apply the configuration changes. You can do this from the Windows Services panel (services.msc) by finding AladdinSDS, right-clicking it and selecting Restart.

  6. Connect the Datalogic device to the POS system or the industrial PC.

  7. Read the device serial number using the OpenAPI documentation page.

  8. Click on the GET /devices button, then click on the Try it out button and finally click on the Execute button:

    OpenAPI Documentation

  9. The response will show the device serial number of the devices connected. In the example below, there are two devices connected to the POS system: annotate the id of the devices that you want to add to the platform (in the example below, E22H20130):

    Device Serial Number

Device Smart Enrollment​

  1. Log in to the platform using the credentials provided:

    Login Page

  2. Click on the Device Visibility section:

    Device Visibility

  3. In the Device Visibility page, the POS (host device) and the Datalogic device should be visible with the status To be approved.

    Approve Device Button

  4. Clicking on the Approve button will take you to the Device Approval page where you can add the device to the platform:

    Device Approval

  5. Check the device details and click on the Approve button to add the device to the platform:

    • Device Category: Select the device category from the dropdown (e.g., PowerScan 96x0).
    • Device Location: Select the location from the dropdown list (e.g., Datalogic)
    • Serial Number: Enter the device serial number (e.g., E22H20130).
    • Device Name: Enter a name for the device (e.g., Powerscan_01).

    After clicking the Approve button, the device will be added to the platform and you will be redirected to the Device Visibility page.

  6. The device will now be visible in the platform with the connection offline and status 'Registered':

    Device Added

  7. The device will automatically connect to the platform in a few minutes, changing the connection status to online and the device status to Provisioned and reporting device information and telemetry data in the device details page.