Azure IoT Hub Integration

Overview
Create and configure Azure IoT Hub account
Integration with the Thingsboard
- Thingsboard Uplink Data Converter
- Azure IoT Hub Integration
Validation
- Validate Uplink Messages
Next steps

Overview

Azure IoT Hub Integration allows to stream data from AWS IoT Backend to ThingsBoard and converts device payloads to the ThingsBoard format.

Create and configure Azure IoT Hub account

Integration with the Thingsboard

We have done all necessary steps on the Azure IoT Hub side. Now we can start configuring the Thingsboard.

Thingsboard Uplink Data Converter

First, we need to create Uplink Data converter that will be used for converting messages received from the Azure IoT Hub. The converter should transform incoming payload into the required message format. Message must contains deviceName and deviceType. Those fields are used for submitting data to the correct device. If a device was not found then new device will be created. Here is how demo payload from the Azure IoT Hub will look like:

{
    "devName": "T1",
    "msg": {
        "temp": 42,
        "humidity": 77
    }
}

We will take devName and map it to the deviceName. But you can use another mapping in your specific use cases. Also, we will take the value of the temperature and humidity fields and use it as a device telemetry.

Go to Data Converters and create new uplink Converter with this function:

var data = decodeToJson(payload);
var deviceName = data.devName;
var deviceType = 'thermostat';

var result = {
   deviceName: deviceName,
   deviceType: deviceType,
   telemetry: {
       temperature: data.msg.temp,
       humidity: data.msg.humidity
   }
};

function decodeToString(payload) {
   return String.fromCharCode.apply(String, payload);
}

function decodeToJson(payload) {
   var str = decodeToString(payload);
   var data = JSON.parse(str);
   return data;
}

return result;

Azure IoT Hub Integration

Next we will create Integration with Azure IoT Hub inside the Thingsboard. Open Integrations section and add new Integration with type Azure IoT Hub

Name: IoT Hub
Type: Azure IoT Hub
Uplink data converter: Thermostat Converter
Hostname: AZURE_IOT_HUB_HOSTNAME
Device ID: T1
Credentials: Shared Access Signature
SAS Key: DEVICE_SAS_KEY
Topic filter: devices/T1/messages/devicebound/#

Topic - for more information about IoT Hub topic use link.
Credentials - Azure IoT Hub connection credentials. Can be either Shared Access Signature or PEM.

Different Authentication credentials are supported for Azure IoT Hub:

Shared Access Signature - SAS Key is used for Authentication
PEM - PEM certificates are used for Authentication

If Shared Access Signature credentials type is selected, the following configuration should be provided:

SAS Key - it is key from your device in Azure IoT Hub
CA certificate file, by default used Baltimore certificate. More about certificates here

If PEM credentials type is selected, the following configuration should be provided:

CA certificate file, by default used Baltimore certificate. More about certificates here
Certificate file
Private key file
Private key password

X.509 CA-signed authentication

CACertificates instruction

Validation

Validate Uplink Messages

Lets verify our integration. First, lets put message into uplink stream, so Thingsboard will fetch this message.

Open page with your Device and go to Message to Device.

Send test message to device.

Go to Device Group -> All -> T1 - you can see that

new device was registered in the thingsboard
In the Latest Telemetry section you will see that last submitted temperature = 42 and humidity = 77.

Next steps

入门指南 - 这些指南提供了ThingsBoard主要功能的快速概述。
安装指南 - 了解如何在各种操作系统上安装ThingsBoard。
数据看板 - 这些指南包含有关如何配置复杂的ThingsBoard仪表板的说明。
数据处理 - 了解如何使用ThingsBoard规则引擎。
数据分析 - 了解如何使用规则引擎执行基本的分析任务。
硬件样品 - 了解如何将各种硬件平台连接到ThingsBoard。
高级功能 - 了解高级ThingsBoard功能。
开发指南 - 了解ThingsBoard中的贡献和开发。