For the complete documentation index, see llms.txt. This page is also available as Markdown.

MQTT connection configuration with Azure IoT Hub

Aranet PRO base station also allows all sensor data publishing directly to Azure IoT Hub, but here the base should also have the firmware version at least 2.5.17. So before proceeding further, please first check the firmware version of the Aranet PRO base station in the graphical user interface section System → FIRMWARE and if it is older than 2.5.17, then update to the latest version available from https://aranet.com/downloads/ section of our webpage:

1

Prepare Azure IoT Hub and device

  1. Check and save the Serial number of the Aranet PRO base station (label on the device or System ⇒ STATUS in GUI).

  1. Log in to your Azure account and create a new IoT Hub resource.

  1. Click on New

  1. Create new resource group if needed, enter the necessary Name and press OK.

  1. Enter IoT hub name and press Review + create, then Create.

  1. When deployment is done press Go to resource.

2

Add a device in IoT Hub

  1. Select the IoT devices section and press New.

  1. Enter the serial number of the Aranet PRO base station in the Device ID field without additional symbols and press Save.

  1. Go to Shared access policies, click on iothubowner and copy the Connection string—primary key.

3

Use Azure IoT Explorer to generate SAS token for device

  1. Download and install Azure IoT Explorer from https://github.com/Azure/azure-iot-explorer/releases.

  1. Launch Azure IoT Explorer and press Add connection.

  1. Paste the iothubowner Connection string (from previous step) and press Save

  1. Click on the Aranet PRO device object in Azure IoT Explorer.

  1. Click on Connection string with the SAS token subsection, select Primary key as Symmetric key, enter Expiration (minutes) time (example: 9999999999), press Generate and copy the generated SAS token connection string.

  1. Paste the copied string into a text editor for further use.

Configure Aranet PRO to connect to Azure IoT Hub

Open Aranet PRO base station GUI, section MQTT and:

  1. Enable the MQTT connection;

  2. Paste the HostName value (from the SAS token connection string) into the Host address field (example: aranetpro.azure-devices.net);

  3. Port: 8883;

  4. Protocol version: MQTT v3.1.1;

  5. Enable Authentication;

  6. Username: HostName/SerialNumber (example: aranetpro.azure-devices.net/349681000816);

  7. Password: paste the text string that comes after SharedAccessSignature in the SAS token;

  8. QoS level: 0 or 1 (2 is not supported by Azure);

  9. Root topic: any value you want;

  10. Sensor measurement format: Azure (sensor measurements will not be accepted by the Azure platform if format is raw or JSON);

  11. Encryption: TLSv1.2;

  1. Press Save. If the connection is successful, a success message will be shown on top of the MQTT page in Aranet PRO GUI.

  2. Check published data in Azure IoT Explorer by clicking Telemetry and pressing Start.

Last updated