Installazione diSDK per dispositivi AWS IoTper Python - AWS IoT Greengrass

AWS IoT Greengrass Version 1 è entrato nella fase di estensione della vita utile il 30 giugno 2023. Per ulteriori informazioni, consulta la politica AWS IoT Greengrass V1 di manutenzione. Dopo questa data, AWS IoT Greengrass V1 non rilascerà aggiornamenti che forniscano funzionalità, miglioramenti, correzioni di bug o patch di sicurezza. I dispositivi che funzionano AWS IoT Greengrass V1 non subiranno interruzioni e continueranno a funzionare e a connettersi al cloud. Ti consigliamo vivamente di eseguire la migrazione a AWS IoT Greengrass Version 2, che aggiunge nuove importanti funzionalità e supporto per piattaforme aggiuntive.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Installazione diSDK per dispositivi AWS IoTper Python

I dispositivi client possono utilizzare ilSDK per dispositivi AWS IoTper comunicare con PythonAWS IoTeAWS IoT GreengrassI dispositivi di base (utilizzando il linguaggio di programmazione Python). Per ulteriori informazioni, inclusi i requisiti, consulta laSDK per dispositivi AWS IoTper PythonReadmesul GitHub.

In questa fase si installa l'SDK e si ottiene labasicDiscovery.pyfunzione di esempio utilizzata dai dispositivi client simulati nel computer.

  1. Per installare l'SDK sul computer con tutti i componenti richiesti, scegliere il sistema operativo:

    Windows

    1. Apri un prompt di comandi elevati ed esegui il seguente comando:

      python --version

      Se non vengono restituite le informazioni relative alla versione o se il numero di versione è inferiore a 2.7 per Python 2 o meno di 3.3 per Python 3, seguire le istruzioni in Download di Python per installare Python 2.7+ o Python 3.3+. Per ulteriori informazioni sulla manutenzione Windows, consulta Utilizzo di Python su Windows.

    2. Download diSDK per dispositivi AWS IoTper Pythoncomeziped estrailo in una posizione appropriata sul computer.

      Prendi nota del percorso file alla cartella aws-iot-device-sdk-python-master estratta che contiene il file setup.py. Nella prossima fase il percorso di questo file è indicato da path-to-SDK-folder.

    3. Dal prompt di comandi elevati, esegui il comando seguente:

      cd path-to-SDK-folder
python setup.py install
    macOS

    1. Apri una finestra del terminale ed esegui il comando seguente:

      python --version

      Se non vengono restituite le informazioni relative alla versione o se il numero di versione è inferiore a 2.7 per Python 2 o meno di 3.3 per Python 3, seguire le istruzioni in Download di Python per installare Python 2.7+ o Python 3.3+. Per ulteriori informazioni sulla manutenzione Windows, consulta Utilizzo di Python su Macintosh.

    2. Nella finestra del terminale, esegui i seguenti comandi per determinare la versione di OpenSSL:

      python
>>>import ssl
>>>print ssl.OPENSSL_VERSION

      Annota il valore della versione di OpenSSL.

      Nota

      Se Python 3 è in esecuzione, utilizza print(ssl.OPENSSL_VERSION).

      Per chiudere lo shell di Python, esegui il seguente comando:

      >>>exit()

      Se la versione di OpenSSL è 1.0.1 o successiva, vai alla fase c. In caso contrario, procedi come descritto:

      1. Nella finestra del terminale, esegui il comando seguente per determinare se il computer sta utilizzando Simple Python Version Management:

        which pyenv

      Se viene restituito un percorso di file, scegli l'Utilizzo dipyenvScheda di connessione. Se non viene restituito nulla, scegli ilNon utilizzarepyenvScheda di connessione.

      Using pyenvNot using pyenv
      Using pyenv

      1. Consulta Versioni di Python per Mac OS X (o simile) per determinare la versione stabile più recente di Python. Nel seguente esempio, questo valore è indicato da latest-Python-version.

      2. Dalla finestra di terminale, esegui i comandi seguenti:

        pyenv install latest-Python-version
pyenv global latest-Python-version

        Ad esempio, se la versione più recente per Python 2 è 2.7.14, i comandi sono:

        pyenv install 2.7.14
pyenv global 2.7.14

      3. Chiudi e riapri la finestra del terminale ed esegui i comandi seguenti:

        python
>>>import ssl
>>>print ssl.OPENSSL_VERSION

        La versione di OpenSSL deve essere almeno 1.0.1. Se la versione è precedente a 1.0.1, l'aggiornamento non è riuscito. Controlla la versione di Python usata nei comandi pyenv install e pyenv global e riprova.

      4. Esegui il comando seguente per uscire dallo shell di Python:

         exit()
      Not using pyenv

      1. Da una finestra del terminale, esegui il comando seguente per determinare se brew è installato:

        which brew

        Se non viene restituito un percorso di file, installa brew come segue:

        /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
        Nota

        Segui le istruzioni di installazione. Il download degli strumenti a riga di comando Xcode può richiedere del tempo.

      2. Esegui i comandi seguenti:

        brew update
brew install openssl
brew install python@2

        LaSDK per dispositivi AWS IoTper Python richiede OpenSSL versione 1.0.1 (o successive) compilate con l'eseguibile Python. Il comando brew install python installa un eseguibile python2 che soddisfa questa esigenza. L'eseguibile python2 è installato nella directory /usr/local/bin, che dovrebbe essere parte della variabile di ambiente PATH. Per averne la conferma, esegui il comando seguente:

        python2 --version

        Se le informazioni di versione di python2 vengono fornite, vai alla fase successiva. In caso contrario, aggiungi definitivamente il percorso /usr/local/bin alla variabile di ambiente PATH aggiungendo la seguente riga al profilo shell:

        export PATH="/usr/local/bin:$PATH"

        Ad esempio, se stai utilizzando .bash_profile o non disponi di un profilo shell, esegui il seguente comando da una finestra del terminale:

        echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.bash_profile

        Quindi, rintraccia l'origine del profilo shell e conferma che python2 --version fornisca le informazioni sulla versione. Ad esempio, se utilizzi .bash_profile, esegui i comandi seguenti:

        source ~/.bash_profile
python2 --version

        Le informazioni sulla versione di python2 dovrebbero essere restituite.

      3. Aggiungi la riga seguente al profilo shell:

        alias python="python2"

        Ad esempio, se stai utilizzando .bash_profile o non disponi di un profilo shell, esegui il seguente comando:

        echo 'alias python="python2"' >> ~/.bash_profile

      4. Quindi, rintraccia l'origine del profilo shell. Ad esempio, se utilizzi .bash_profile, esegui il comando seguente:

        source ~/.bash_profile

        Richiamando il comando python verrà avviato l'eseguibile Python che contiene la versione di OpenSSL richiesta (python2).

      5. Esegui i comandi seguenti:

        python
 import ssl
 print ssl.OPENSSL_VERSION

        La versione di OpenSSL deve essere almeno 1.0.1. o successiva.

      6. Per uscire dallo shell di Python, esegui il comando seguente:

         exit()

    3. Esegui i comandi seguenti per installare l'SDK per dispositivi AWS IoTper Python:

      cd ~
git clone https://github.com/aws/aws-iot-device-sdk-python.git
cd aws-iot-device-sdk-python
sudo python setup.py install
    UNIX-like system

    1. Dalla finestra di un terminale, eseguire il comando riportato qui sotto:

      python --version

      Se non vengono restituite le informazioni relative alla versione o se il numero di versione è inferiore a 2.7 per Python 2 o meno di 3.3 per Python 3, seguire le istruzioni in Download di Python per installare Python 2.7+ o Python 3.3+. Per ulteriori informazioni, consulta Utilizzo di Python su piattaforme Unix.

    2. Nel terminale, esegui i seguenti comandi per determinare la versione di OpenSSL:

      python
>>>import ssl
>>>print ssl.OPENSSL_VERSION

      Annota il valore della versione di OpenSSL.

      Nota

      Se Python 3 è in esecuzione, utilizza print(ssl.OPENSSL_VERSION).

      Per chiudere lo shell di Python, esegui il seguente comando:

       exit()

      Se la versione di OpenSSL è 1.0.1 o successiva, vai alla fase successiva. In caso contrario, esegui il comando/i per aggiornare OpenSSL per la distribuzione (ad esempio, sudo yum update openssl, sudo apt-get update e così via).

      Verifica che la versione di OpenSSL sia 1.0.1 o successiva eseguendo i comandi seguenti:

      python
>>>import ssl
>>>print ssl.OPENSSL_VERSION
>>>exit()

    3. Esegui i comandi seguenti per installare l'SDK per dispositivi AWS IoTper Python:

      cd ~
git clone https://github.com/aws/aws-iot-device-sdk-python.git
cd aws-iot-device-sdk-python
sudo python setup.py install

  2. Dopo laSDK per dispositivi AWS IoTper Python è installato, passa allasamplescartella e apri ilgreengrassfolder.

    Per questo tutorial si copia la funzione di esempio basicDiscovery.py, che utilizza i certificati e le chiavi che sono stati scaricati in Creare dispositivi client in unAWS IoT Greengrassgruppo.

  3. Copy (Copia)basicDiscovery.pynella cartella che contiene l' HelloWorld_Publisher e HelloWorld_Certificati e chiavi del dispositivo abbonato.