Usa il tuo PC o Mac Windows o Linux come dispositivo AWS IoT

Per scaricare e installare Git e Python sul tuo computer

1. Verificare che sia installato Git nel computer. Nella riga di comando, immetti questo comando.

   git --version

   Se il comando visualizza la versione Git, Git è installato e puoi continuare con la fase successiva.

   Se il comando visualizza un errore, apri https://git-scm.com/download e installa Git per il tuo computer.

2. Verifica che Python non sia già installato. Inserisci questo comando nella riga di comando.

   python -V

   Nota

   Se questo comando dà un errore: Python was not found, potrebbe essere perché il tuo sistema operativo chiama l'eseguibile Python v3.x come Python3. In tal caso, sostituisci tutte le istanze di python con python3 e continua il resto di questo tutorial.

   Se il comando visualizza la versione Python, Python è già installato. Questo tutorial richiede Python v3.7 o versioni successive.

3. Se Python è installato, puoi ignorare i passaggi rimanenti in questa sezione. Altrimenti, continua.

4. Apri https://www.python.org/downloads/ e scarica il programma di installazione per il tuo computer.

5. Se il download non ha avviato automaticamente l'installazione, esegui il programma scaricato per installare Python.

6. Verificare l'installazione di Python.

   python -V

   Conferma che il comando visualizzi la versione di Python. Se la versione di Python non viene visualizzata, prova a scaricare e installare nuovamente Python.

Per installare AWS IoT Device SDK for Python sul tuo computer

1. Installa la v2 del AWS IoT Device SDK for Python.

   python3 -m pip install awsiotsdk

2. Clona il repository AWS IoT Device SDK for Python nella directory aws-iot-device-sdk -python-v2 della tua home directory. Questa procedura fa riferimento alla directory di base per i file che si sta installando come Pagina principale.

   La posizione effettiva della directory Pagina principale dipende dal sistema operativo.

   Linux/macOS

   In macOS e Linux, la directory Pagina principale è ~.

   cd ~ 
   git clone https://github.com/aws/aws-iot-device-sdk-python-v2.git

   Windows

   In Windows, è possibile trovare la directory Pagina principale eseguendo questo comando nella finestra cmd.

   echo %USERPROFILE%
   cd %USERPROFILE%
   git clone https://github.com/aws/aws-iot-device-sdk-python-v2.git

   Nota

   Se utilizzi Windows anziché 1, usa il PowerShell seguente comando. cmd.exe

   
   echo $home

Per preparare il sistema all'esecuzione dell'applicazione di esempio

• Creazione della directory certs. Nella directory certs, copia i file della chiave privata, del certificato del dispositivo e del certificato CA root salvati quando è stato creato e registrato l'oggetto in Crea AWS IoT risorse. I nomi di file di ogni file nella directory di destinazione devono corrispondere a quelli della tabella.

  I comandi della sezione successiva presuppongono che i file di chiave e certificato siano memorizzati sul dispositivo, come illustrato in questa tabella.

  Linux/macOS

  Esegui questo comando per creare la sottodirectory certs che verrà utilizzata quando si eseguono le applicazioni di esempio.

  mkdir ~/certs

  Nella nuova sottodirectory, copia i file nei percorsi dei file di destinazione indicati nella tabella riportata di seguito.

  Nomi dei file dei certificati
  File	Percorso del file
  Chiave privata	~/certs/private.pem.key
  Certificato del dispositivo	~/certs/device.pem.crt
  Un certificato emesso da una CA root	~/certs/Amazon-root-CA-1.pem

  Esegui questo comando per elencare i file nella directory certs e confrontarli con quelli elencati nella tabella.

  ls -l ~/certs

  Windows

  Esegui questo comando per creare la sottodirectory certs che verrà utilizzata quando si eseguono le applicazioni di esempio.

  mkdir %USERPROFILE%\certs

  Nella nuova sottodirectory, copia i file nei percorsi dei file di destinazione indicati nella tabella riportata di seguito.

  Nomi dei file dei certificati
  File	Percorso del file
  Chiave privata	%USERPROFILE%\certs\private.pem.key
  Certificato del dispositivo	%USERPROFILE%\certs\device.pem.crt
  Un certificato emesso da una CA root	%USERPROFILE%\certs\Amazon-root-CA-1.pem

  Esegui questo comando per elencare i file nella directory certs e confrontarli con quelli elencati nella tabella.

  dir %USERPROFILE%\certs

Per trovare e rivedere il documento della policy per una risorsa oggetto

1. Nella console AWS IoT, nell'elenco Things (Oggetti), trova la risorsa oggetto che rappresenta il tuo dispositivo.

2. Scegli il link di Name (Nome) della risorsa oggetto che rappresenta il tuo dispositivo per aprire la pagina Thing details (Dettagli dell'oggetto).

3. Nella pagina Thing details (Dettagli dell'oggetto), nella scheda Certificates (Certificati), scegli il certificato allegato alla risorsa oggetto. Dovrebbe esserci un solo certificato nell'elenco. Se ci sono più certificati, scegli il certificato i cui sono installati i file sul tuo dispositivo e che verrà utilizzato per connetterti ad AWS IoT Core.

   Nella pagina dei dettagli del Certificate (Certificato), nella scheda Policies (Policy), scegli la policy allegata al certificato. Dovrebbe essercene solo uno. Se ce n'è più di uno, ripeti il passaggio successivo per assicurarti che almeno una policy conceda l'accesso richiesto.

4. Nella pagina di panoramica Policy, trova l'editor JSON e scegli Edit policy document (Modifica documento della policy) per rivedere e modificare il documento della policy secondo necessità.

5. Nell'esempio seguente viene visualizzata la policy JSON. Nell'"Resource"elemento, sostituisci region:account con il tuo Regione AWS e Account AWS in ciascuno dei Resource valori.

   {
       "Version": "2012-10-17",
       "Statement": [
           {
               "Effect": "Allow",
               "Action": [
                   "iot:Publish",
                   "iot:Receive"
               ],
               "Resource": [
                   "arn:aws:iot:region:account:topic/test/topic"
               ]
           },
           {
               "Effect": "Allow",
               "Action": [
                   "iot:Subscribe"
               ],
               "Resource": [
                   "arn:aws:iot:region:account:topicfilter/test/topic"
               ]
           },
           {
               "Effect": "Allow",
               "Action": [
                   "iot:Connect"
               ],
               "Resource": [
                   "arn:aws:iot:region:account:client/test-*"
               ]
           }
       ]
   }

Per visualizzare i messaggi MQTT pubblicati dall'app di esempio

1. Verificare Visualizza i messaggi MQTT con il AWS IoT client MQTT. In questo modo si impara come utilizzare il client di test MQTT nella console AWS IoT per visualizzare i messaggi MQTT durante il passaggio attraverso il broker di messaggi.

2. Apri il client di test MQTT nella console AWS IoT .

3. In Subscribe to a topic (Sottoscrizione a un argomento), effettua la sottoscrizione all'argomento, test/topic.

4. Nella finestra a riga di comando, esegui di nuovo l'app di esempio e guarda i messaggi nel Client MQTT nella console AWS IoT .

   Linux/macOS

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

   Windows

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

Per configurare la policy ed eseguire l'esempio Sottoscrizione condivisa

1. Per eseguire l'esempio Sottoscrizione condivisa, è necessario impostare la policy dell'oggetto come documentato in MQTT 5 Shared Subscription.

2. Per eseguire l'esempio Sottoscrizione condivisa, esegui i comandi seguenti.

   Linux/macOS

   Per eseguire lo script di esempio su Linux/macOS

   1. Nella finestra a riga di comando passa alla directory ~/aws-iot-device-sdk-python-v2/samples che l'SDK ha creato utilizzando questi comandi.

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

   2. Nella finestra della riga di comando, sostituisci your-iot-endpointcome indicato ed esegui questo comando.

      python3 mqtt5_shared_subscription.py --endpoint your-iot-endpoint --ca_file ~/certs/Amazon-root-CA-1.pem --cert ~/certs/device.pem.crt --key ~/certs/private.pem.key --group_identifier consumer

   Windows

   Per eseguire l'applicazione di esempio su un PC Windows

   1. Nella finestra a riga di comando passa alla directory %USERPROFILE%\aws-iot-device-sdk-python-v2\samples che l'SDK ha creato e installa l'app di esempio utilizzando questi comandi.

      cd %USERPROFILE%\aws-iot-device-sdk-python-v2\samples

   2. Nella finestra della riga di comando, sostituisci your-iot-endpointcome indicato ed esegui questo comando.

      python3 mqtt5_shared_subscription.py --endpoint your-iot-endpoint --ca_file %USERPROFILE%\certs\Amazon-root-CA-1.pem --cert %USERPROFILE%\certs\device.pem.crt --key %USERPROFILE%\certs\private.pem.key --group_identifier consumer

   Nota

   Facoltativamente, puoi specificare un identificatore gruppo in base alle tue esigenze quando esegui l'esempio (ad esempio, --group_identifier consumer). Se non viene specificato, python-sample è l'identificatore gruppo predefinito.

3. L'aspetto dell'output nella riga di comando può essere simile al seguente:

   Publisher]: Lifecycle Connection Success
   [Publisher]: Connected
   Subscriber One]: Lifecycle Connection Success
   [Subscriber One]: Connected
   Subscriber Two]: Lifecycle Connection Success
   [Subscriber Two]: Connected
   [Subscriber One]: Subscribed to topic 'test/topic' in shared subscription group 'consumer'.
   [Subscriber One]: Full subscribed topic is: '$share/consumer/test/topic' with SubAck code: [<SubackReasonCode.GRANTED_QOS_1: 1>]
   [Subscriber Two]: Subscribed to topic 'test/topic' in shared subscription group 'consumer'.
   [Subscriber Two]: Full subscribed topic is: '$share/consumer/test/topic' with SubAck code: [<SubackReasonCode.GRANTED_QOS_1: 1>]
   [Publisher]: Sent publish and got PubAck code: <PubackReasonCode.SUCCESS: 0>
   [Subscriber Two] Received a publish
           Publish received message on topic: test/topic
           Message: b'"Hello World!  [1]"'
   [Publisher]: Sent publish and got PubAck code: <PubackReasonCode.SUCCESS: 0>
   [Subscriber One] Received a publish
           Publish received message on topic: test/topic
           Message: b'"Hello World!  [2]"'
   [Publisher]: Sent publish and got PubAck code: <PubackReasonCode.SUCCESS: 0>
   [Subscriber Two] Received a publish
           Publish received message on topic: test/topic
           Message: b'"Hello World!  [3]"'
   [Publisher]: Sent publish and got PubAck code: <PubackReasonCode.SUCCESS: 0>
   [Subscriber One] Received a publish
           Publish received message on topic: test/topic
           Message: b'"Hello World!  [4]"'
   [Publisher]: Sent publish and got PubAck code: <PubackReasonCode.SUCCESS: 0>
   [Subscriber Two] Received a publish
           Publish received message on topic: test/topic
           Message: b'"Hello World!  [5]"'
   [Publisher]: Sent publish and got PubAck code: <PubackReasonCode.SUCCESS: 0>
   [Subscriber One] Received a publish
           Publish received message on topic: test/topic
           Message: b'"Hello World!  [6]"'
   [Publisher]: Sent publish and got PubAck code: <PubackReasonCode.SUCCESS: 0>
   [Subscriber Two] Received a publish
           Publish received message on topic: test/topic
           Message: b'"Hello World!  [7]"'
   [Publisher]: Sent publish and got PubAck code: <PubackReasonCode.SUCCESS: 0>
   [Subscriber One] Received a publish
           Publish received message on topic: test/topic
           Message: b'"Hello World!  [8]"'
   [Publisher]: Sent publish and got PubAck code: <PubackReasonCode.SUCCESS: 0>
   [Subscriber Two] Received a publish
           Publish received message on topic: test/topic
           Message: b'"Hello World!  [9]"'
   [Publisher]: Sent publish and got PubAck code: <PubackReasonCode.SUCCESS: 0>
   [Subscriber One] Received a publish
           Publish received message on topic: test/topic
           Message: b'"Hello World!  [10]"'
   [Subscriber One]: Unsubscribed to topic 'test/topic' in shared subscription group 'consumer'.
   [Subscriber One]: Full unsubscribed topic is: '$share/consumer/test/topic' with UnsubAck code: [<UnsubackReasonCode.SUCCESS: 0>]
   [Subscriber Two]: Unsubscribed to topic 'test/topic' in shared subscription group 'consumer'.
   [Subscriber Two]: Full unsubscribed topic is: '$share/consumer/test/topic' with UnsubAck code [<UnsubackReasonCode.SUCCESS: 0>]
   Publisher]: Lifecycle Disconnected
   [Publisher]: Lifecycle Stopped
   [Publisher]: Fully stopped
   Subscriber One]: Lifecycle Disconnected
   [Subscriber One]: Lifecycle Stopped
   [Subscriber One]: Fully stopped
   Subscriber Two]: Lifecycle Disconnected
   [Subscriber Two]: Lifecycle Stopped
   [Subscriber Two]: Fully stopped
   Complete!

4. Apri Client di test MQTT nella console AWS IoT . In Sottoscrizione a un argomento, effettua la sottoscrizione all'argomento della Sottoscrizione condivisa, ad esempio: $share/consumer/test/topic. Puoi specificare un identificatore gruppo in base alle tue esigenze quando esegui l'esempio (ad esempio, --group_identifier consumer). Se non specifichi un identificatore gruppo, il valore predefinito è python-sample. Per ulteriori informazioni, consultare esempio Python MQTT 5 Shared Subscription e Sottoscrizioni condivise nella Guida per gli sviluppatori di AWS IoT Core .

   Nella finestra a riga di comando, esegui nuovamente l'app di esempio e guarda la distribuzione dei messaggi nel Client di test MQTT della Console AWS IoT e la riga di comando.