AWS MQTT cloud connection: Difference between revisions
no edit summary
No edit summary |
PauliusRug (talk | contribs) No edit summary |
||
| (23 intermediate revisions by 4 users not shown) | |||
| Line 8: | Line 8: | ||
* An AWS account | * An AWS account | ||
* A router from the | * A router from RUTx, TCRx or TRBx series | ||
=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] | |||
=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 === | ||
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#sign-up-for-aws Sign up for an AWS account] | |||
* [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] | |||
<br> | |||
Pay special attention to the Notes. | |||
<br> | |||
=== 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: | |||
* [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] | |||
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 | 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". | ||
| Line 39: | Line 63: | ||
[[File:Networking rutos configuration examples AWS 005.png|border|class=tlt-border]] | [[File:Networking rutos configuration examples AWS 005.png|border|class=tlt-border]] | ||
Do the following procedure: Click on "Create policy" '''→''' Give it a name '''→''' Policy effect: allow '''→''' Policy action: * '''→''' Policy resource: *'''→''' Create.[[File:Networking rutos configuration examples AWS 006.png|border|class=tlt-border]] | Do the following procedure: Click on "Create policy" '''→''' Give it a name '''→''' Policy effect: allow '''→''' Policy action: * '''→''' Policy resource: *'''→''' Create. | ||
<b>NOTE</b>: The examples in this document are intended only for dev environments. All devices in your production fleet must have credentials with privileges that authorize only intended actions on specific resources. The specific permission policies can vary for your use case. Identify the permission policies that best meet your business and security requirements. For more information, refer to [https://docs.aws.amazon.com/iot/latest/developerguide/example-iot-policies.html Example policies] and [https://docs.aws.amazon.com/iot/latest/developerguide/security-best-practices.html Security Best practices]. | |||
[[File:Networking rutos configuration examples AWS 006.png|border|class=tlt-border]] | |||
Then, on the same "Secure" tab, click on certificates. There you will see one certificate, the one you've created, select it by checking the checkbox, then go to "Actions", and click on "Attach policy". | Then, on the same "Secure" tab, click on certificates. There you will see one certificate, the one you've created, select it by checking the checkbox, then go to "Actions", and click on "Attach policy". | ||
| Line 57: | Line 85: | ||
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= | ||
| Line 75: | Line 104: | ||
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]] | ||
| Line 145: | Line 174: | ||
=== Configuring Data to Server === | === Configuring Data to Server === | ||
Go to the router configuration | 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 configuration examples AWS 017.png|border|class=tlt-border]] | ||
| Line 153: | Line 182: | ||
[[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]] | |||