Aviso de fim do suporte: em 7 de outubro de 2026, AWS o suporte para o. AWS IoT Greengrass Version 1 Depois de 7 de outubro de 2026, você não poderá mais acessar os AWS IoT Greengrass V1 recursos. Para obter mais informações, visite [Migrar de AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html).
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 for Python para se comunicar com AWS IoT dispositivos AWS IoT Greengrass principais (usando a linguagem de programação Python). Para obter mais informações, incluindo requisitos, consulte o AWS IoT Device SDK [Readme](https://github.com/aws/aws-iot-device-sdk-python) para Python em. 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](https://technet.microsoft.com/en-us/library/cc947813(v=ws.10).aspx) 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](https://wiki.python.org/moin/BeginnersGuide/Download) 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](https://docs.python.org/3.6/using/windows.html).
1. Faça download do [AWS IoT Device SDK para Python](https://github.com/aws/aws-iot-device-sdk-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 é indicado por*path-to-SDK-folder*.
1. 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](https://wiki.python.org/moin/BeginnersGuide/Download) 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](https://docs.python.org/3/using/mac.html).
1. 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\$1VERSION)**.
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](#step-c-install-python-sdk). 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 pyenv ]
1. Consulte [Python Releases for macOS X](https://www.python.org/downloads/mac-osx/) (ou semelhante) para determinar a versão estável mais recente do Python. No exemplo a seguir, esse valor é indicado por*latest-Python-version*.
1. 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
```
1. 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.
1. 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](https://brew.sh/) 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.
1. Execute os seguintes comandos :
```
brew update
brew install openssl
brew install python@2
```
O AWS IoT Device SDK for Python requer a versão 1.0.1 (ou posterior) do OpenSSL compilada com o executável 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](https://en.wikipedia.org/wiki/Source_(command)) 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.
1. 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
```
1. Em seguida, execute [source](https://en.wikipedia.org/wiki/Source_(command)) 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`).
1. Execute os seguintes comandos :
```
python
import ssl
print ssl.OPENSSL_VERSION
```
A versão do OpenSSL deve ser a 1.0.1 ou posterior.
1. Para sair do shell do Python, execute o seguinte comando:
```
exit()
```
------
1. 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](https://wiki.python.org/moin/BeginnersGuide/Download) 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](https://docs.python.org/3.6/using/unix.html).
1. 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\$1VERSION)**.
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()
```
1. 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
```
------
1. Depois que o AWS IoT Device SDK for Python for instalado, navegue até a `samples` pasta e abra a `greengrass` pasta.
Para este tutorial, você copiará a função de exemplo `basicDiscovery.py`, que usa os certificados e as chaves baixadas em [Crie dispositivos cliente em um AWS IoT Greengrass grupo](device-group.md).
1. Copie `basicDiscovery.py` para a pasta que contém os certificados e chaves dos dispositivos HelloWorld \$1Publisher e HelloWorld \$1Subscriber.