Add an IoT Edge Device on Windows with Multipass

Prerequisites

Before you begin, you need:

1. Create an IoT Edge device in the Device Visibility section.

2. Go to the Device Overview page. Here, you can find the Serial Number and the other required parameters clicking on the Get Credentials button.

Network Requirements

To ensure proper communication between your IoT Edge device and Datalogic Connect services, make sure the following network endpoints are accessible:

Endpoint	Port	Protocol	Notes
*.azure-devices.net	8883, 443	MQTT TLS, HTTPS	Send diagnostic data, receive cloud commands (edgeHub upstream)
global.azure-devices-provisioning.net	443	HTTPS	Device provisioning
*.blob.core.windows.net	443	HTTPS	File upload, Docker image pull
crsolinfraprodeuw.azurecr.io	443	HTTPS	Container registry
crsolinfraprodeuw.westeurope.data.azurecr.io	443	HTTPS	Container registry (data endpoint)
*.azureiotcentral.com	443	HTTPS	Device Smart Enrollment

Firewall Configuration

If your device is behind a corporate firewall, ensure all outbound endpoints above are whitelisted. The IoT Edge runtime will automatically select the best available upstream protocol (MQTT TLS on 8883, or HTTPS on 443).

Local Inbound Ports (Field Devices → Edge Device)

The following ports must be reachable from Datalogic field devices or AladdinSDS on the local network:

Port	Protocol	Service	Used by
1883	MQTT (plain TCP)	Mosquitto	PCs, POS systems, HOST-type devices
9883	MQTT over TLS (mTLS)	Mosquitto	Datalogic scanner devices with client certificates
8090	HTTP	StorageModule	Field devices downloading firmware/config or uploading logs
8098	HTTP	ProvisioningModule	Field devices requesting X.509 certificates

Windows requirements

• A Windows 10 or Windows 11 machine with Hyper-V enabled. You can enable Hyper-V by following the instructions on the Microsoft Hyper-V installation guide.

Add an IoT Edge Device on Windows with Multipass

1. Install Multipass:

   • Download and install Multipass from the official website.
   • Follow the installation instructions for Windows.

2. Create a Bridged Network:

   • Open PowerShell or Command Prompt and run the following command to create a bridged network:

     multipass networks
     multipass set local.bridged-network="Default Switch"

3. Update the Cloud-Init File with Edge Device Parameters:

   • Download the cloud-init-edge.yaml script for configuring the Edge device.
   • Open the file in a text editor and replace the placeholder values with the actual values you noted earlier:
     • REPLACE_WITH_YOUR_SCOPE_ID with your Scope ID
     • REPLACE_WITH_YOUR_EDGE_DEVICE_SERIAL_NUMBER with your Serial Number
     • REPLACE_WITH_YOUR_EDGE_DEVICE_PRIMARY_KEY with your Device Primary Key
     • REPLACE_WITH_YOUR_ORGANIZATION_ID with your Organization ID
     • REPLACE_WITH_YOUR_SAS_DEVICES_KEY with your SAS Devices Key
     • REPLACE_WITH_YOUR_SAS_SMART_ENROLLMENT_KEY with your SAS Smart Enrollment Key
     • REPLACE_WITH_YOUR_SAS_EDGE_STORAGE_KEY with your Sas Edge Storage Key
   • Save the changes to the file.

4. Create an Ubuntu VM:

   • Open PowerShell or Command Prompt and run the following command to create a new Ubuntu 22.04 VM:

      multipass launch 22.04 --name edge-vm --cpus 1 --disk 5G --memory 2G --cloud-init cloud-init-edge.yaml --bridged

   • This command creates a VM named edge-vm with 1 CPU, 5GB disk space, and 2GB memory, using the specified cloud-init file and bridged network. After running the command, wait a few minutes for the VM to be fully set up.
   • You can check the status of the VM with:

   multipass list

   or you can run Multipass app to see the status.

5. Check the Edge Device Status:

   • After the VM is created, you can check the status of your IoT Edge device in the Datalogic Connect portal under the Devices section. It may take a few minutes for the device to appear as "Connected".

Troubleshooting

1. Multipass Waiting for Daemon:
   • If you encounter an error stating "Waiting for daemon...", ensure that the Multipass service is running. Additionally, you can open a power shell as administrator and run (the Y is for Yes and if you have a different language on your Windows you might need to change it accordingly):

     takeown /a /r /d Y /f "C:\ProgramData\Multipass"

     You can find more information on the issue page