Instale o AWS IoT Device SDK para Python - AWS IoT Greengrass

AWS IoT Greengrass Version 1 entrou na fase de vida útil prolongada em 30 de junho de 2023. Para obter mais informações, consulte política de manutenção do AWS IoT Greengrass V1. Após essa data, AWS IoT Greengrass V1 não lançaremos atualizações que forneçam recursos, aprimoramentos, correções de erros ou patches de segurança. Os dispositivos que funcionam AWS IoT Greengrass V1 não serão interrompidos e continuarão operando e se conectando à nuvem. É altamente recomendável que você migre para AWS IoT Greengrass Version 2, o que adiciona novos recursos significativos e suporte para plataformas adicionais.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Instale o AWS IoT Device SDK para Python

Os dispositivos cliente podem usar o AWS IoT Device SDK para Python para se comunicar com a AWS IoT e os dispositivos de núcleo AWS IoT Greengrass (usando a linguagem de programação Python). Para obter mais informações, incluindo requisitos, consulte o Readme do AWS IoT Device SDK para Python no GitHub.

Nesta etapa, instale o SDK e obtenha a função de exemplo basicDiscovery.py usada pelos dispositivos cliente simulados em seu computador.

  1. Para instalar o SDK no computador, com todos os componentes necessários, selecione o sistema operacional:

    Windows

    1. Abra um prompt de comando com privilégios elevados e execute o comando a seguir:

      python --version

      Se nenhuma informação sobre versão for retornada ou se o número da versão for menor do que 2.7 para o Python 2 ou menor do que 3.3 para o Python 3, siga as instruções em Fazer download do Python para instalar o Python 2.7 ou superior ou o Python 3.3 ou superior. Para obter mais informações, consulte Como usar o Python no Windows.

    2. Faça download do AWS IoT Device SDK para Python como arquivo zip e extraia-o para um local apropriado em seu computador.

      Anote o caminho do arquivo para a pasta extraída aws-iot-device-sdk-python-master que contém o arquivo setup.py. Na próxima etapa, esse caminho de arquivo será indicado por caminho-para-a-pasta-do-SDK.

    3. No prompt de comandos com privilégios elevados, execute o seguinte:

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

    1. Abra uma janela do terminal e execute o seguinte comando:

      python --version

      Se nenhuma informação sobre versão for retornada ou se o número da versão for menor do que 2.7 para o Python 2 ou menor do que 3.3 para o Python 3, siga as instruções em Fazer download do Python para instalar o Python 2.7 ou superior ou o Python 3.3 ou superior. Para obter mais informações, consulte Como usar o Python em um Macintosh.

    2. Na janela do terminal, execute os seguintes comandos para determinar a versão do OpenSSL:

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

      Anote o valor da versão do OpenSSL.

      nota

      Se você estiver executando o Python 3, use print(ssl.OPENSSL_VERSION).

      Para fechar o shell do Python, execute o seguinte comando:

      >>>exit()

      Se a versão do OpenSSL for 1.0.1 ou posterior, vá para a etapa c. Do contrário, siga estas etapas:

      1. Na janela do terminal, execute o seguinte comando para determinar se o computador está usando o Simple Python Version Management:

        which pyenv

      Se um caminho de arquivo for retornado, selecione a guia Using pyenv (Usando). Se nada for retornado, selecione a guia Not using pyenv (Não está usando).

      Using pyenvNot using pyenv
      Using pyenv

      1. Consulte Python Releases for macOS X (ou semelhante) para determinar a versão estável mais recente do Python. No exemplo a seguir, esse valor é indicado pela versão-mais-recente-do-Python.

      2. Na janela do terminal, execute os seguintes comandos:

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

        Por exemplo, se a versão mais recente do Python 2 for a 2.7.14, esses comandos serão:

        pyenv install 2.7.14
pyenv global 2.7.14

      3. Feche e então reabra a janela de terminal e execute os seguintes comandos:

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

        A versão do OpenSSL deve ser no mínimo 1.0.1. Se a versão for inferior a 1.0.1, então a atualização falhou. Verifique o valor da versão do Python usada nos comandos pyenv install e pyenv global e tente novamente.

      4. Execute o seguinte comando para sair do shell do Python:

         exit()
      Not using pyenv

      1. Em uma janela do terminal, execute o seguinte comando para determinar se o brew está instalado:

        which brew

        Se o caminho de um arquivo não for retornado, instale o brew da seguinte forma:

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

        Siga as instruções de instalação. O download para as ferramentas de linha de comando do Xcode podem demorar algum tempo.

      2. Execute os seguintes comandos:

        brew update
brew install openssl
brew install python@2

        O AWS IoT Device SDK para Python requer o OpenSSL 1.0.1 (ou posterior) compilado com o executável do Python. O comando brew install python instala um executável do python2 que atende a esse requisito. O executável python2 é instalado no diretório /usr/local/bin, que deve fazer parte da variável de ambiente PATH. Para confirmar, execute o seguinte comando:

        python2 --version

        Se as informações de versão do python2 forem fornecidas, vá para a próxima etapa. Caso contrário, adicione permanentemente o caminho /usr/local/bin à sua variável de ambiente PATH anexando a seguinte linha em seu perfil de shell:

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

        Por exemplo, se estiver usando .bash_profile ou ainda não tiver um perfil de shell, execute o seguinte comando em uma janela do terminal:

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

        Em seguida, execute source em seu perfil e confirme se o python2 --version fornece informações sobre versão. Por exemplo, se estiver usando .bash_profile, execute os seguintes comandos:

        source ~/.bash_profile
python2 --version

        As informações da versão do python2 devem ser retornadas.

      3. Acrescente a seguinte linha a seu perfil de shell:

        alias python="python2"

        Por exemplo, se estiver usando .bash_profile ou ainda não tiver um perfil de shell, execute o seguinte comando:

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

      4. Em seguida, execute source em seu perfil de shell. Por exemplo, se estiver usando .bash_profile, execute o seguinte comando:

        source ~/.bash_profile

        A invocação do comando python executa o executável do Python que contém a versão do OpenSSL (python2).

      5. Execute os seguintes comandos:

        python
 import ssl
 print ssl.OPENSSL_VERSION

        A versão do OpenSSL deve ser a 1.0.1 ou posterior.

      6. Para sair do shell do Python, execute o seguinte comando:

         exit()

    3. Execute os seguintes comandos para instalar o AWS IoT Device SDK para 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. Na janela de terminal do , execute o seguinte comando:

      python --version

      Se nenhuma informação sobre versão for retornada ou se o número da versão for menor do que 2.7 para o Python 2 ou menor do que 3.3 para o Python 3, siga as instruções em Fazer download do Python para instalar o Python 2.7 ou superior ou o Python 3.3 ou superior. Para obter mais informações, consulte Como usar o Python em plataformas Unix.

    2. No terminal, execute os seguintes comandos para determinar a versão do OpenSSL:

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

      Anote o valor da versão do OpenSSL.

      nota

      Se você estiver executando o Python 3, use print(ssl.OPENSSL_VERSION).

      Para fechar o shell do Python, execute o seguinte comando:

       exit()

      Se a versão do OpenSSL for 1.0.1 ou posterior, vá para a próxima etapa. Caso contrário, execute o(s) comando(s) para atualizar o OpenSSL para sua distribuição (por exemplo, sudo yum update openssl, sudo apt-get update e assim por diante).

      Confirme se a versão do OpenSSL é a 1.0.1 ou posterior executando os seguintes comandos:

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

    3. Execute os seguintes comandos para instalar o AWS IoT Device SDK para 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. Depois de instalar o AWS IoT Device SDK para Python, navegue até a pasta samples e abra a pasta greengrass.

    Para este tutorial, você copiará a função de exemplo basicDiscovery.py, que usa os certificados e as chaves baixadas em Criar dispositivos cliente em um grupo do AWS IoT Greengrass.

  3. Copie basicDiscovery.py na pasta que contém os certificados e as chaves de dispositivo HelloWorld_Publisher e HelloWorld_Subscriber.