104
edits
Changes
no edit summary
=== '''Creating a thing''' ===
=== '''Creating a thing''' ===
[[File:Networking rutos configuration examples AWS 001.png]]
[[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/pt/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".
[[File:Networking rutos configuration examples AWS 002.png]]
[[File:Networking rutos configuration examples AWS 002.png|border|class=tlt-border]]
Then, do the following procedure to create a Thing: click on the "Create Things" button '''→''' "Create single thing" '''→''' Give it any name '''→''' "No shadow" '''→'''"Auto-generate a new certificate (recommended)" '''→''' "Create thing".
Then, do the following procedure to create a Thing: click on the "Create Things" button '''→''' "Create single thing" '''→''' Give it any name '''→''' "No shadow" '''→'''"Auto-generate a new certificate (recommended)" '''→''' "Create thing".
Certificates are used by Publishers and Subscribers to connect to your AWS MQTT Broker.
Certificates are used by Publishers and Subscribers to connect to your AWS MQTT Broker.
You will be prompted to download the certificates, download the "Device certificate", "Private key file, "Public key file" and "Amazon Root CA 1".[[File:Networking rutos configuration examples AWS 003.png]]
You will be prompted to download the certificates, download the "Device certificate", "Private key file, "Public key file" and "Amazon Root CA 1".[[File:Networking rutos configuration examples AWS 003.png|border|class=tlt-border]]
Move all the 4 files to a folder on the C:\ drive, so it's easy to locate them. Then, rename them as following: Keep the "AmazonRootCA1.pem" as it is, the file xxxxx.'''pem.crt''' as device_certificate.pem.crt, the file xxxxx-'''private.pem.key''' as private_key.pem.key and the file xxxxx-'''public.pem.key''' as public_key.pem.key. After that, you will have the following:
Move all the 4 files to a folder on the C:\ drive, so it's easy to locate them. Then, rename them as following: Keep the "AmazonRootCA1.pem" as it is, the file xxxxx.'''pem.crt''' as device_certificate.pem.crt, the file xxxxx-'''private.pem.key''' as private_key.pem.key and the file xxxxx-'''public.pem.key''' as public_key.pem.key. After that, you will have the following:
[[File:Networking rutos configuration examples AWS 004.png]]
[[File:Networking rutos configuration examples AWS 004.png|border|class=tlt-border]]
===Setting up policies===
===Setting up policies===
Go back to the AWS IoT HuB, open the "Secure" tab and click on "Policies".
Go back to the AWS IoT HuB, open the "Secure" tab and click on "Policies".
[[File:Networking rutos configuration examples AWS 005.png]]
[[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]]
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]]
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".
[[File:Networking rutos configuration examples AWS 007.png]]
[[File:Networking rutos configuration examples AWS 007.png|border|class=tlt-border]]
Then select the policy you've created previously, and click on "Attach policies"
Then select the policy you've created previously, and click on "Attach policies"
[[File:Networking rutos configuration examples AWS 008.png]]
[[File:Networking rutos configuration examples AWS 008.png|border|class=tlt-border]]
===Getting your endpoint===
===Getting your endpoint===
You can find it into the "Settings" tab, copy and save it.
You can find it into the "Settings" tab, copy and save it.
[[File:Networking rutos configuration examples AWS 009.png]]
[[File:Networking rutos configuration examples AWS 009.png|border|class=tlt-border]]
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.
Then, you will use the "Data to server" functionality, under "Services" menu.
Then, you will use the "Data to server" functionality, under "Services" menu.
[[File:Networking rutos configuration examples AWS 010.png]]
[[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:Img4587.png|border|class=tlt-border|782x782px]]
[[File:Networking rutos configuration examples AWS 011.png|border|class=tlt-border]]
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:
After setting up all, you should have something similar to the screen below. Click on save and apply.
After setting up all, you should have something similar to the screen below. Click on save and apply.
[[File:Config421.png|border|class=tlt-border|749x749px]]
[[File:Networking rutos configuration examples AWS 012.png|border|class=tlt-border]]
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:Image4752.png|border|class=tlt-border|961x961px]]
[[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=
=== Enabling MODBUS TCP Slave ===
=== Enabling MODBUS TCP Slave ===
Enabling the MODBUS Slave option on the router allows it to answer any requests coming from a MODBUS Master. To do that, go to the router configuration page->Services->MODBUS-> MODBUS TCP Slave. Then clock the "Enable" slider and save.
Enabling the MODBUS Slave option on the router allows it to answer any requests coming from a MODBUS Master. To do that, go to the router configuration page→Services→MODBUS→MODBUS TCP Slave. Then clock the "Enable" slider and save.
[[File:Imagehowknows.png|border|class=tlt-border]]
[[File:Networking rutos configuration examples AWS 014.png|border|class=tlt-border]]
=== Enabling MODBUS TCP Master ===
=== Enabling MODBUS TCP Master ===
Enabling the MODBUS Master option on the router allows it to make specific requests to any slave in the MODBUS network. To do that, go to the router configuration page->Services->MODBUS-> MODBUS TCP Master. Click on the "Add" button, and do the following configuration on the page:
Enabling the MODBUS Master option on the router allows it to make specific requests to any slave in the MODBUS network. To do that, go to the router configuration page→Services→MODBUS→MODBUS TCP Master. Click on the "Add" button, and do the following configuration on the page:
[[File:Imagedsadadssa.png|border|class=tlt-border]]
[[File:Networking rutos configuration examples AWS 015.png|border|class=tlt-border]]
'''"Name"''' : Any name
'''"Name"''' : Any name
Then scroll down the page a bit, on the "Add new request" section, give any name to your request and click on the "Add" button. Then do the following configuration
Then scroll down the page a bit, on the "Add new request" section, give any name to your request and click on the "Add" button. Then do the following configuration
[[File:Imagegpdddd.png|border|class=tlt-border|1012x1012px]]
[[File:Networking rutos configuration examples AWS 016.png|border|class=tlt-border]]
'''"Data type"''' : Data type of the data you are going to receive, in this case, the router reports its device name using ASCII
'''"Data type"''' : Data type of the data you are going to receive, in this case, the router reports its device name using ASCII
=== Configuring Data to Server ===
=== Configuring Data to Server ===
Go to the router configuration page->Services->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→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:Imagesdasdsada.png|border|class=tlt-border]]
[[File:Networking rutos configuration examples AWS 017.png|border|class=tlt-border]]
=== Checking if it works ===
=== Checking if it works ===
Then, you can use the AWS MQTT test client to check if your setup works, if everything was setup correctly, you should see something like this.
Then, you can use the AWS MQTT test client to check if your setup works, if everything was setup correctly, you should see something like this.
[[File:Imagefdsfdsfsd.png|border|class=tlt-border|721x721px]]
[[File:Networking rutos configuration examples AWS 018.png|border|class=tlt-border]]
