226
edits
Changes
AWS MQTT cloud connection (view source)
Revision as of 15:02, 11 September 2023
, 15:02, 11 September 2023→Publishing Bluetooth/Wifi scanner/Modbus data
* An AWS account
* An AWS account
* A router from the RUT2xx or RUT9xx or RUTXxx series
* A router from RUTx, TCRx or TRBx series
=Hardware Description=
=Hardware Description=
Hardware descriptions can be found in different Quick Start Guides (QSG). There you will find an overview of the various components on the front and back of a device, hardware installation instructions, first login information, device specifications, and general safety information. Link: [https://wiki.teltonika-networks.com/view/Quick_Start_Guides Quick Start Guides]
Hardware descriptions can be found in different Quick Start Guides (QSG). There you will find an overview of the various components on the front and back of a device, hardware installation instructions, first login information, device specifications, and general safety information. Link: [https://wiki.teltonika-networks.com/view/Quick_Start_Guides Quick Start Guides]
=Set up your Development Environment=
Teltonika Networks devices comes with our created [https://wiki.teltonika-networks.com/view/Firmware_Downloads firmware], therefore no additional development or scripting is required for this unit to support AWS IoT.
=Setting up AWS IoT=
=Setting up AWS IoT=
== Setup your AWS account and Permissions ==
=== Setup your AWS account and Permissions ===
Refer to the online AWS documentation at Set up your AWS Account. Follow the steps outlined in the sections below to create your account and a user and get started:<br>
Refer to the online AWS documentation at [https://docs.aws.amazon.com/iot/latest/developerguide/setting-up.html Set up your AWS Account]. Follow the steps outlined in the sections below to create your account and a user and get started:<br>
* [https://docs.aws.amazon.com/iot/latest/developerguide/setting-up.html#aws-registration Sign up for an AWS account and]
* [https://docs.aws.amazon.com/iot/latest/developerguide/setting-up.html#sign-up-for-aws Sign up for an AWS account]
* [https://docs.aws.amazon.com/iot/latest/developerguide/setting-up.html#create-iam-user Create a user and grant permissions]
* [https://docs.aws.amazon.com/iot/latest/developerguide/setting-up.html#create-an-admin Create a user and grant permissions]
* [https://docs.aws.amazon.com/iot/latest/developerguide/setting-up.html#iot-console-signin Open the AWS IoT console]
* [https://docs.aws.amazon.com/iot/latest/developerguide/setting-up.html#iot-console-signin Open the AWS IoT console]
<br>
<br>
Pay special attention to the Notes.
Pay special attention to the Notes.
<br>
<br>
=== '''Creating a thing''' ===
=== Creating a thing ===
Refer to the online AWS documentation at [[https://docs.aws.amazon.com/iot/latest/developerguide/create-iot-resources.html Create AWS IoT Resources]]. Follow the steps outlined in these sections to provision resources for your device:
Refer to the online AWS documentation at [https://docs.aws.amazon.com/iot/latest/developerguide/create-iot-resources.html Create AWS IoT Resources]. Follow the steps outlined in these sections to provision resources for your device:
* [[https://docs.aws.amazon.com/iot/latest/developerguide/create-iot-resources.html#create-iot-policy Create an AWS IoT Policy]]
* [https://docs.aws.amazon.com/iot/latest/developerguide/create-iot-resources.html#create-iot-policy Create an AWS IoT Policy]
* [[https://docs.aws.amazon.com/iot/latest/developerguide/create-iot-resources.html#create-aws-thing Create a thing object]]
* [https://docs.aws.amazon.com/iot/latest/developerguide/create-iot-resources.html#create-aws-thing Create a thing object]
Pay special attention to the Notes.
Pay special attention to the Notes.
[[File:Networking rutos configuration examples AWS 001.png|border|class=tlt-border]]
[[File:Networking rutos configuration examples AWS 001.png|border|class=tlt-border]]
First off, open the [https://aws.amazon.com/pt/console/ AWS Management Console] and login with your credentials. After that, you will see a screen similar to this:
First off, open the [https://aws.amazon.com/console/ AWS Management Console] and login with your credentials. After that, you will see a screen similar to this:
On the search bar on the top, search for "IoT Core", and click on the first search result. You will see a screen like the one below, open the "Manage" section and click on "Things".
On the search bar on the top, search for "IoT Core", and click on the first search result. You will see a screen like the one below, open the "Manage" section and click on "Things".
With that, your MQTT Broker is all setup, and you can start setting up your RUT router as a Publisher.
With that, your MQTT Broker is all setup, and you can start setting up your RUT router as a Publisher.
=RUT as MQTT Publisher=
=RUT as MQTT Publisher=
If you need any help on setting up each functionality, the Teltonika Wiki has topics for each one of them: [[RUTX11 Bluetooth|Bluetooth]], [[RUTX11 Wireless|WiFi Scanner]], [[RUTX11 Modbus|MODBUS]]
If you need any help on setting up each functionality, the Teltonika Wiki has topics for each one of them: [[RUTX11 Bluetooth|Bluetooth]], [[RUTX11 Wireless|WiFi Scanner]], [[RUTX11 Modbus|MODBUS]]
Then, you will use the "Data to server" functionality, under "Services" menu.
Then, you will use the "[https://wiki.teltonika-networks.com/view/Data_to_Server Data to server]" functionality, under "Services" menu.
[[File:Networking rutos configuration examples AWS 010.png|border|class=tlt-border]]
[[File:Networking rutos configuration examples AWS 010.png|border|class=tlt-border]]
Click on the "Add" button on the right side of the page, you will see the following menu.
Click on the "Add" button on the right side of the page, you will see the following menu.
[[File:Networking rutos configuration examples AWS 011.png|border|class=tlt-border]]
[[File:Networking rutos AWS 3.png|border|class=tlt-border|914x914px]]
[[File:Networking rutos AWS 2.png|border|class=tlt-border|914x914px]]
The main fields you have to fill up are pretty straight forward, just pay more attention for the fields needed for AWS MQTT Broker connection:
The main fields you have to fill up are pretty straight forward, just pay more attention for the fields needed for AWS MQTT Broker connection:
'''"URL / Host / Connection string"''' : There you will paste your AWS Endpoint
'''"Server address"''' : There you will paste your AWS Endpoint
'''"Port"''' : 8883
'''"Port"''' : 8883
'''"Topic"''' : Any name you want, just write it down so you can subscribe this topic later
'''"Topic"''' : Any name you want, just write it down so you can subscribe this topic later
'''"Use TLS"''' : On
'''"Enable Secure Connection"''' : On
'''"TLS type"''' : "Certificate based"
'''"TLS type"''' : "Certificate based"
'''"CA File, Client certificate, Private key"''' : There you will select the files you've downloaded from AWS IoT HuB
'''"CA File, Client certificate, Private key"''' : There you will select the files you've downloaded from AWS IoT HuB
To check if your setup is working, you can use any MQTT client, and subscribe to the topic you've created, you should be able to see the data of the source you've selected. You can use the AWS IoT MQTT test client to subscribe to the topic that the router was publishing.
To check if your setup is working, you can use any MQTT client, and subscribe to the topic you've created, you should be able to see the data of the source you've selected. You can use the AWS IoT MQTT test client to subscribe to the topic that the router was publishing.
[[File:Networking rutos configuration examples AWS 013.png|border|class=tlt-border]]
[[File:Networking rutos configuration examples AWS 013.png|border|class=tlt-border]]
=Example: Publishing RUT MODBUS to AWS IoT using MQTT=
=Example: Publishing RUT MODBUS to AWS IoT using MQTT=
Go to the router configuration page→Services→[https://wiki.teltonika-networks.com/view/Data_to_Server Data to server]. Click on the "Add" button, and the configuration is basically the same as described on the "Publishing Bluetooth/Wifi scanner/Modbus data" section of this article, just change the data source to "MODBUS data" and format the data as you wish. You should have something similar to this.
Go to the router configuration page→Services→[https://wiki.teltonika-networks.com/view/Data_to_Server Data to server]. Click on the "Add" button, and the configuration is basically the same as described on the "Publishing Bluetooth/Wifi scanner/Modbus data" section of this article, just change the data source to "MODBUS data" and format the data as you wish. You should have something similar to this.
[[File:Networking rutos configuration examples AWS 017.png|border|class=tlt-border]]
[[File:Networking rutos AWS 10.png|border|class=tlt-border]]
[[File:Networking rutos AWS 11.png|border|class=tlt-border]]
=== Checking if it works ===
=== Checking if it works ===
[[File:Networking rutos configuration examples AWS 018.png|border|class=tlt-border]]
[[File:Networking rutos configuration examples AWS 018.png|border|class=tlt-border]]
=Debugging=
In the situation when the issue with services [[RUTX11 Bluetooth|Bluetooth]], [[RUTX11 Wireless|WiFi Scanner]], [[RUTX11 Modbus|MODBUS]], [[RUTX11 Data_to_Server|Data to Server]] appears, device internal logs can be taken directly from WebUI [[RUTX11_Administration#Troubleshoot|troubleshoot]] section. Also, there is a lot of useful information in [https://wiki.teltonika-networks.com/view/FAQ frequently asked questions] page.
=Troubleshooting=
The information can be submitted to Teltonika HelpDesk and Teltonika engineers will assist with troubleshooting. For a more detailed information regarding what information should be collected for debugging, please visit the dedicated page on [https://wiki.teltonika-networks.com Teltonika Wiki].
<br>
Alternatively, Teltonika has a [https://community.teltonika-networks.com/ Support Forum] dedicated for troubleshooting, where engineers are actively solving problems.
[[Category:IoT platforms]]
