RetroSearch Browse

Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Showing content from http://docs.aws.amazon.com/iot/latest/developerguide/connecting-to-existing-device.html below:

Connect a Raspberry Pi or other device

In this section, we'll configure a Raspberry Pi for use with AWS IoT. If you have another device that you'd like to connect, the instructions for the Raspberry Pi include references that can help you adapt these instructions to your device.

This normally takes about 20 minutes, but it can take longer if you have many system software upgrades to install.

Set up your device

The goal of this step is to collect what you'll need to configure your device so that it can start the operating system (OS), connect to the internet, and allow you to interact with it at a command line interface.

To complete this tutorial, you need the following:

An AWS account. If you don't have one, complete the steps described in Set up AWS account before you continue.
A Raspberry Pi 3 Model B or more recent model. This might work on earlier versions of the Raspberry Pi, but they have not been tested.
Raspberry Pi OS (32-bit) or later. We recommend using the latest version of the Raspberry Pi OS. Earlier versions of the OS might work, but they have not been tested.

To run this example, you do not need to install the desktop with the graphical user interface (GUI); however, if you're new to the Raspberry Pi and your Raspberry Pi hardware supports it, using the desktop with the GUI might be easier.
An Ethernet or WiFi connection.
Keyboard, mouse, monitor, cables, power supplies, and other hardware required by your device.

Important

Before you continue to the next step, your device must have its operating system installed, configured, and running. The device must be connected to the internet and you will need to be able to access the device by using its command line interface. Command line access can be through a directly-connected keyboard, mouse, and monitor, or by using an SSH terminal remote interface.

If you are running an operating system on your Raspberry Pi that has a graphical user interface (GUI), open a terminal window on the device and perform the following instructions in that window. Otherwise, if you are connecting to your device by using a remote terminal, such as PuTTY, open a remote terminal to your device and use that.

Before you install the AWS IoT Device SDK and sample code, make sure your system is up to date and has the required tools and libraries to install the SDKs.

Update the operating system and install required libraries
Before you install an AWS IoT Device SDK, run these commands in a terminal window on your device to update the operating system and install the required libraries.
```
sudo apt-get update
```
```
sudo apt-get upgrade
```
```
sudo apt-get install cmake
```
```
sudo apt-get install libssl-dev
```
Install Git
If your device's operating system doesn't come with Git installed, you must install it to install the AWS IoT Device SDK for JavaScript.
1. Test to see if Git is already installed by running this command.
```
git --version
```
2. If the previous command returns the Git version, Git is already installed and you can skip to Step 3.
3. If an error is displayed when you run the git command, install Git by running this command.
```
sudo apt-get install git
```
4. Test again to see if Git is installed by running this command.
```
git --version
```
5. If Git is installed, continue to the next section. If not, troubleshoot and correct the error before continuing. You need Git to install the AWS IoT Device SDK for JavaScript.

Install AWS IoT Device SDK

Install the AWS IoT Device SDK.

Python

In this section, you'll install Python, its development tools, and the AWS IoT Device SDK for Python on your device. These instructions are for a Raspberry Pi running the latest Raspberry Pi OS. If you have another device or are using another operating system, you might need to adapt these instructions for your device.

Install Python and its development tools
The AWS IoT Device SDK for Python requires Python v3.5 or later to be installed on your Raspberry Pi.

In a terminal window to your device, run these commands.
1. Run this command to determine the version of Python installed on your device.
```
python3 --version
```
  If Python is installed, it will display its version.
2. If the version displayed is Python 3.5 or greater, you can skip to Step 2.
3. If the version displayed is less than Python 3.5, you can install the correct version by running this command.
```
sudo apt install python3
```
4. Run this command to confirm that the correct version of Python is now installed.
```
python3 --version
```
Test for pip3
In a terminal window to your device, run these commands.
1. Run this command to see if pip3 is installed.
```
pip3 --version
```
2. If the command returns a version number, pip3 is installed and you can skip to Step 3.
3. If the previous command returns an error, run this command to install pip3.
```
sudo apt install python3-pip
```
4. Run this command to see if pip3 is installed.
```
pip3 --version
```
Install the current AWS IoT Device SDK for Python
Install the AWS IoT Device SDK for Python and download the sample apps to your device.

On your device, run these commands.
```
cd ~
python3 -m pip install awsiotsdk
```
```
git clone https://github.com/aws/aws-iot-device-sdk-python-v2.git
```

JavaScript

In this section, you'll install Node.js, the npm package manager, and the AWS IoT Device SDK for JavaScript on your device. These instructions are for a Raspberry Pi running the Raspberry Pi OS. If you have another device or are using another operating system, you might need to adapt these instructions for your device.

Install the latest version of Node.js
The AWS IoT Device SDK for JavaScript requires Node.js and the npm package manager to be installed on your Raspberry Pi.
1. Download the latest version of the Node repository by entering this command.
```
cd ~
curl -sL https://deb.nodesource.com/setup_12.x | sudo -E bash -
```
2. Install Node and npm.
```
sudo apt-get install -y nodejs
```
3. Verify the installation of Node.
```
node -v
```
  Confirm that the command displays the Node version. This tutorial requires Node v10.0 or later. If the Node version isn't displayed, try downloading the Node repository again.
4. Verify the installation of npm.
```
npm -v
```
  Confirm that the command displays the npm version. If the npm version isn't displayed, try installing Node and npm again.
5. Restart the device.
```
sudo shutdown -r 0
```
  Continue after the device restarts.
Install the AWS IoT Device SDK for JavaScript
Install the AWS IoT Device SDK for JavaScript on your Raspberry Pi.
1. Clone the AWS IoT Device SDK for JavaScript repository into the aws-iot-device-sdk-js-v2 directory of your home directory. On the Raspberry Pi, the home directory is ~/, which is used as the home directory in the following commands. If your device uses a different path for the home directory, you must replace ~/ with the correct path for your device in the following commands.
  
  These commands create the ~/aws-iot-device-sdk-js-v2 directory and copy the SDK code into it.
```
cd ~
git clone https://github.com/aws/aws-iot-device-sdk-js-v2.git
```
2. Change to the aws-iot-device-sdk-js-v2 directory that you created in the preceding step and run npm install to install the SDK. The command npm install will invoke the aws-crt library build that can take a few minutes to complete.
```
cd ~/aws-iot-device-sdk-js-v2
npm install
```

Install and run the sample app

In this section, you'll install and run the pubsub sample app found in the AWS IoT Device SDK. This app shows how your device uses the MQTT library to publish and subscribe to MQTT messages. The sample app subscribes to a topic, topic_1, publishes 10 messages to that topic, and displays the messages as they're received from the message broker.

Install the certificate files

The sample app requires the certificate files that authenticate the device to be installed on the device.

To install the device certificate files for the sample app

Create a certs subdirectory in your home directory by running these commands.
```
cd ~
mkdir certs
```
Into the ~/certs directory, copy the private key, device certificate, and root CA certificate that you created earlier in Create AWS IoT resources.

How you copy the certificate files to your device depends on the device and operating system and isn't described here. However, if your device supports a graphical user interface (GUI) and has a web browser, you can perform the procedure described in Create AWS IoT resources from your device's web browser to download the resulting files directly to your device.

The commands in the next section assume that your key and certificate files are stored on the device as shown in this table.
Certificate file names
File

File path

Root CA certificate

~/certs/Amazon-root-CA-1.pem

Device certificate

~/certs/device.pem.crt

Private key

~/certs/private.pem.key

To run the sample app, you need the following information:

Application parameter values

Parameter

Where to find the value

your-iot-endpoint

In the AWS IoT console, choose All devices, and then choose Things.

On the Settings page in the AWS IoT menu. Your endpoint is displayed in the Device data endpoint section.

The your-iot-endpoint value has a format of: endpoint_id-ats.iot.region.amazonaws.com, for example, a3qj468EXAMPLE-ats.iot.us-west-2.amazonaws.com.

Python

To install and run the sample app

Navigate to the sample app directory.

cd ~/aws-iot-device-sdk-python-v2/samples

In the command line window, replace your-iot-endpoint as indicated and run this command.

python3 pubsub.py --topic topic_1 --ca_file ~/certs/Amazon-root-CA-1.pem --cert ~/certs/device.pem.crt --key ~/certs/private.pem.key --endpoint your-iot-endpoint

Observe that the sample app:

Connects to the AWS IoT service for your account.
Subscribes to the message topic, topic_1, and displays the messages it receives on that topic.
Publishes 10 messages to the topic, topic_1.
Displays output similar to the following:

Connecting to a3qEXAMPLEffp-ats.iot.us-west-2.amazonaws.com with client ID 'test-0c8ae2ff-cc87-49d2-a82a-ae7ba1d0ca5a'...
Connected!
Subscribing to topic 'topic_1'...
Subscribed with QoS.AT_LEAST_ONCE
Sending 10 message(s)
Publishing message to topic 'topic_1': Hello World! [1]
Received message from topic 'topic_1': b'Hello World! [1]'
Publishing message to topic 'topic_1': Hello World! [2]
Received message from topic 'topic_1': b'Hello World! [2]'
Publishing message to topic 'topic_1': Hello World! [3]
Received message from topic 'topic_1': b'Hello World! [3]'
Publishing message to topic 'topic_1': Hello World! [4]
Received message from topic 'topic_1': b'Hello World! [4]'
Publishing message to topic 'topic_1': Hello World! [5]
Received message from topic 'topic_1': b'Hello World! [5]'
Publishing message to topic 'topic_1': Hello World! [6]
Received message from topic 'topic_1': b'Hello World! [6]'
Publishing message to topic 'topic_1': Hello World! [7]
Received message from topic 'topic_1': b'Hello World! [7]'
Publishing message to topic 'topic_1': Hello World! [8]
Received message from topic 'topic_1': b'Hello World! [8]'
Publishing message to topic 'topic_1': Hello World! [9]
Received message from topic 'topic_1': b'Hello World! [9]'
Publishing message to topic 'topic_1': Hello World! [10]
Received message from topic 'topic_1': b'Hello World! [10]'
10 message(s) received.
Disconnecting...
Disconnected!

If you're having trouble running the sample app, review Troubleshoot problems with the sample application.

You can also add the --verbosity Debug parameter to the command line so the sample app displays detailed messages about what itâs doing. That information might provide you the help you need to correct the problem.

JavaScript

To install and run the sample app

In your command line window, navigate to the ~/aws-iot-device-sdk-js-v2/samples/node/pub_sub directory that the SDK created and install the sample app by using these commands. The command npm install will invoke the aws-crt library build that can take a few minutes to complete.
```
cd ~/aws-iot-device-sdk-js-v2/samples/node/pub_sub
npm install
```

In the command line window, replace your-iot-endpoint as indicated and run this command.

node dist/index.js --topic topic_1 --ca_file ~/certs/Amazon-root-CA-1.pem --cert ~/certs/device.pem.crt --key ~/certs/private.pem.key --endpoint your-iot-endpoint

Observe that the sample app:

Connects to the AWS IoT service for your account.
Subscribes to the message topic, topic_1, and displays the messages it receives on that topic.
Publishes 10 messages to the topic, topic_1.
Displays output similar to the following:

Publish received on topic topic_1
{"message":"Hello world!","sequence":1}
Publish received on topic topic_1
{"message":"Hello world!","sequence":2}
Publish received on topic topic_1
{"message":"Hello world!","sequence":3}
Publish received on topic topic_1
{"message":"Hello world!","sequence":4}
Publish received on topic topic_1
{"message":"Hello world!","sequence":5}
Publish received on topic topic_1
{"message":"Hello world!","sequence":6}
Publish received on topic topic_1
{"message":"Hello world!","sequence":7}
Publish received on topic topic_1
{"message":"Hello world!","sequence":8}
Publish received on topic topic_1
{"message":"Hello world!","sequence":9}
Publish received on topic topic_1
{"message":"Hello world!","sequence":10}

If you're having trouble running the sample app, review Troubleshoot problems with the sample application.

View messages from the sample app in the AWS IoT console

You can see the sample app's messages as they pass through the message broker by using the MQTT test client in the AWS IoT console.

To view the MQTT messages published by the sample app

Review View MQTT messages with the AWS IoT MQTT client. This helps you learn how to use the MQTT test client in the AWS IoT console to view MQTT messages as they pass through the message broker.
Open the MQTT test client in the AWS IoT console.
Subscribe to the topic, topic_1.

In your command line window, run the sample app again and watch the messages in the MQTT client in the AWS IoT console.

Python

cd ~/aws-iot-device-sdk-python-v2/samples
python3 pubsub.py --topic topic_1 --ca_file ~/certs/Amazon-root-CA-1.pem --cert ~/certs/device.pem.crt --key ~/certs/private.pem.key --endpoint your-iot-endpoint

JavaScript

cd ~/aws-iot-device-sdk-js-v2/samples/node/pub_sub
node dist/index.js --topic topic_1 --ca_file ~/certs/Amazon-root-CA-1.pem --cert ~/certs/device.pem.crt --key ~/certs/private.pem.key --endpoint your-iot-endpoint

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4