1,108
edits
Changes
Azure IoT Hub cloud connection RUTOS (view source)
Revision as of 13:02, 29 March 2023
, 13:02, 29 March 2023no edit summary
This article contains instructions on how to configure a RUT router in order to connect to the Azure IoT Hub.<br>
This article contains instructions on how to configure a RUT router in order to connect to the Azure IoT Hub.<br>
==Prerequisites==
==Prerequisites==
==Azure account creation==
==Azure account creation==
Visit https://azure.microsoft.com/en-us/ and create an account that will suit your needs, for testing purposes we will be using free Azure account.
Visit https://azure.microsoft.com/en-us/ and create an account that will suit your needs, for testing purposes we will be using free Azure account.
==Managing Azure services==
==Managing Azure services==
<ul>
<ul>
<li>First you will want to create a Resource group for easier management of resources that you will add later. In Microsoft Azure home page.</li>
<li>First you will want to create a Resource group for easier management of resources that you will add later. In Microsoft Azure home page.</li>
<ul>Select '''Resource groups''' <br>If it is not in very first page, click '''More services''' and locate it there. </ul>
<ul>Select '''Resource groups''' <br>If it is not in very first page, click '''More services''' and locate it there. </ul>
<div>[[File:Azure01.png|border|class=tlt-border|800px]]</div>
<div>[[File:Azure new.png|border|class=tlt-border|1068x134px]]
</div>
<li>In new window, select '''Add'''</li>
<li>In new window, select '''Add'''</li>
[[File:Azure02.png|border|class=tlt-border]]
[[File:Azure02.png|border|class=tlt-border]]
[[File:Networking_rutx_configuration_examples_package_manager_v1.png|border|class=tlt-border]]
[[File:Networking_rutx_configuration_examples_package_manager_v1.png|border|class=tlt-border]]
<li>Now navigate to ''' Services > Cloud solutions > Azure IoT Hub''' </li>
<li>Now navigate to ''' Services → Cloud solutions → Azure IoT Hub''' </li>
<div>1. Select Enable '''Azure IoT Hub monitoring'''</div>
<div>1. Select Enable '''Azure IoT Hub monitoring'''</div>
<div>2. Paste previously copied Connection String (For this test we leave other values as default)</div>
<div>2. Paste previously copied Connection String (For this test we leave other values as default)</div>
[[File:Azure26-1_RUTX.png]]
[[File:Azure26-1_RUTX.png]]
<li>Go to '''Services > Cloud solutions > Azure IoT Hub'''</li>
<li>Go to '''Services → Cloud solutions → Azure IoT Hub'''</li>
<div>1. Enable monitoring </div>
<div>1. Enable monitoring </div>
<div>2. Use same Connection string as before (GSM values configuration) </div>
<div>2. Use same Connection string as before (GSM values configuration) </div>
</ul>
</ul>
==Checking if MQTT messages are being forwarded to Azure IoT Hub==
===Testing the configuration===
----
===Linux===
====Linux====
----
<ul>
<ul>
<div>Connect to router with SSH, in logread you should see Router establishing connection to Azure IoT Hub: </div>
<div>Connect to router with SSH, in logread you should see Router establishing connection to Azure IoT Hub: </div>
</ul>
</ul>
===Windows===
====Windows====
----
<ul>
<ul>
<li>Install a MQTT client software to do the test, for this example we used MQTT.fx</li>
<li>Install a MQTT client software to do the test, for this example we used MQTT.fx</li>
<li>If you did everything right this message will be shown in the device explorer</li>
<li>If you did everything right this message will be shown in the device explorer</li>
</ul>
</ul>
==Setting router to Forward Modbus data to Azure IoT Hub==
To send Modbus data to Azure IoT Hub, configure the device with your desired Modbus configuration, then go to '''Services → Data to server''' and configure as follows:
# Enable the instance
# Name - enter '''desired name'''
# Data source - '''Modbus data'''
# Protocol - '''Azure MQTT'''
# JSON format - '''data''' you would like '''to receive'''
# URL/Host/Connection string - '''Azure connection string'''
[[File:Data to server.png|border|class=tlt-border|793x628px]]<br>
'''Note''': Azure IoT Hub configuration on the device can be left as previous.
===Testing the configuration===
----
If everything was configured correctly in Device Explorer, Data tab you should receive message:
[[File:Explorer message.png|border|class=tlt-border|653x592px]]
