

Aviso de fin de soporte: el 7 de octubre de 2026, AWS suspenderemos el soporte para AWS IoT Greengrass Version 1. Después del 7 de octubre de 2026, ya no podrá acceder a los AWS IoT Greengrass V1 recursos. Para obtener más información, visita [Migrar desde AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html).

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Instala la   SDK para dispositivos con AWS IoT para Python
<a name="IoT-SDK"></a>

Los dispositivos cliente pueden usar Python SDK para dispositivos con AWS IoT para comunicarse con AWS IoT los dispositivos AWS IoT Greengrass principales (mediante el lenguaje de programación Python). Para obtener más información, incluidos los requisitos, consulte el SDK para dispositivos con AWS IoT [Léame](https://github.com/aws/aws-iot-device-sdk-python) de Python en GitHub.

En este paso, instalará el SDK y obtendrá la función de ejemplo de `basicDiscovery.py`, que utilizan los dispositivos de cliente simulados en el equipo.

1. Para instalar el SDK con todos los componentes necesarios en el equipo, elija el sistema operativo:

------
#### [ Windows ]

   1. Abra un [símbolo del sistema elevado](https://technet.microsoft.com/en-us/library/cc947813(v=ws.10).aspx) y ejecute el siguiente comando:

      ```
      python --version
      ```

      Si no devuelve información sobre la versión o si la versión es inferior a 2.7 para Python 2 o a 3.3 para Python 3, siga las instrucciones de la página [Downloading Python (Descargar Python)](https://wiki.python.org/moin/BeginnersGuide/Download) para instalar Python 2.7\+ o Python 3.3\+. Para obtener más información acerca de los periodos de mantenimiento, consulte [Using Python on Windows](https://docs.python.org/3.6/using/windows.html).

   1. Descargue [SDK para dispositivos con AWS IoT para Python](https://github.com/aws/aws-iot-device-sdk-python) como un archivo `zip` y extráigalo en la ubicación adecuada del equipo.

      Anote la ruta del archivo en la carpeta `aws-iot-device-sdk-python-master` extraída que contiene el archivo `setup.py`. En el siguiente paso, la ruta de este archivo se indica con{{path-to-SDK-folder}}.

   1. Ejecute el siguiente comando desde el símbolo del sistema elevado:

      ```
      cd {{path-to-SDK-folder}}
      python setup.py install
      ```

------
#### [ macOS ]

   1. Abra una ventana de terminal y ejecute el siguiente comando:

      ```
      python --version
      ```

      Si no devuelve información sobre la versión o si la versión es inferior a 2.7 para Python 2 o a 3.3 para Python 3, siga las instrucciones de la página [Downloading Python (Descargar Python)](https://wiki.python.org/moin/BeginnersGuide/Download) para instalar Python 2.7\+ o Python 3.3\+. Para obtener más información acerca de los periodos de mantenimiento, consulte [Using Python on a Macintosh](https://docs.python.org/3/using/mac.html).

   1. En la ventana de terminal, ejecute los siguientes comandos para determinar la versión de OpenSSL:

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

      Anote el valor de versión de OpenSSL. 
**nota**  
Si está ejecutando Python 3, use **print(ssl.OPENSSL\_VERSION)**.

      Para cerrar manualmente el shell de Python, ejecute el siguiente comando:

      ```
      >>>exit()
      ```

      Si la versión de OpenSSL es 1.0.1 o posterior, vaya al [paso c](#step-c-install-python-sdk). De lo contrario, siga estos pasos:

      1. En la ventana de terminal, ejecute el siguiente comando para determinar si el equipo está utilizando Simple Python Version Management:

        ```
        which pyenv
        ```

      Si devuelve una ruta de archivo, elija la pestaña **Con `pyenv`**. Si no devuelve nada, elija la pestaña **Sin `pyenv`**.

------
#### [ Using pyenv ]

      1. Consulte [Python Releases for Mac OS X](https://www.python.org/downloads/mac-osx/) (o similar) para informarse acerca de la última versión de Python estable. En el ejemplo siguiente, este valor se indica mediante{{latest-Python-version}}.

      1. En una ventana de terminal, ejecute los siguientes comandos:

         ```
         pyenv install {{latest-Python-version}}
         pyenv global {{latest-Python-version}}
         ```

         Por ejemplo, si la última versión de Python 2 es 2.7.14, estos comandos son:

         ```
         pyenv install 2.7.14
         pyenv global 2.7.14
         ```

      1. Cierre y, a continuación, vuelva a abrir la ventana del terminal y, a continuación, ejecute los comandos siguientes:

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

         La versión de OpenSSL debe ser 1.0.1 o posterior. Si la versión es inferior a 1.0.1, entonces la actualización ha fallado. Compruebe el valor de la versión de Python utilizado en los comandos **pyenv global** y **pyenv install** e inténtelo de nuevo.

      1. Ejecute el siguiente comando para cerrar el shell de Python:

         ```
          exit()
         ```

------
#### [ Not using pyenv ]

      1. Desde una ventana de terminal, ejecute el siguiente comando para determinar si [brew](https://brew.sh/) está instalado.

         ```
         which brew
         ```

         Si no devuelve una ruta, instale `brew` de la siguiente manera:

         ```
         /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
         ```
**nota**  
Siga las instrucciones de instalación. La descarga de las herramientas de línea de comandos de Xcode pueden tardar algún tiempo.

      1. Ejecute los siguientes comandos :

         ```
         brew update
         brew install openssl
         brew install python@2
         ```

         El SDK para dispositivos con AWS IoT para Python requiere OpenSSL versión 1.0.1 (o posterior) compilado con el ejecutable de Python. El comando **brew install python** instala un ejecutable `python2` que cumple este requisito. El ejecutable `python2` se instala en el directorio `/usr/local/bin`, que debe ser parte de la variable de entorno `PATH`. Para confirmar, ejecute el siguiente comando:

         ```
         python2 --version
         ```

         Si se proporciona información de la versión de `python2`, vaya al siguiente paso. De lo contrario, agregue la siguiente línea a su perfil de shell para añadir de forma permanente la ruta `/usr/local/bin` a la variable de entorno `PATH`:

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

         Por ejemplo, si está utilizando `.bash_profile` o aún no dispone de un perfil de shell, ejecute este comando desde una ventana de terminal:

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

         A continuación, [ejecute el comando source](https://en.wikipedia.org/wiki/Source_(command)) en el perfil de shell y compruebe si `python2 --version` proporciona información de la versión. Por ejemplo, si está utilizando `.bash_profile`, ejecute los siguientes comandos.

         ```
         source ~/.bash_profile
         python2 --version
         ```

         Debe devolver información de la versión de `python2`.

      1. Agregue la siguiente línea a su perfil de shell:

         ```
         alias python="python2"
         ```

         Por ejemplo, si está utilizando `.bash_profile` o aún no dispone de un perfil de shell, ejecute este comando:

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

      1. A continuación, [ejecute el comando source](https://en.wikipedia.org/wiki/Source_(command)) en el perfil de shell. Por ejemplo, si está utilizando `.bash_profile`, ejecute el siguiente comando:

         ```
         source ~/.bash_profile
         ```

         Al invocar el comando **python** se ejecuta el ejecutable de Python que contiene la versión de OpenSSL necesaria (`python2`).

      1. Ejecute los siguientes comandos :

         ```
         python
          import ssl
          print ssl.OPENSSL_VERSION
         ```

         La versión de OpenSSL debe ser 1.0.1 o posterior.

      1. Para cerrar el shell de Python, ejecute siguiente comando:

         ```
          exit()
         ```

------

   1. <a name="step-c-install-python-sdk"></a>Ejecute los siguientes comandos para instalar el SDK para dispositivos con AWS IoT 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. En una ventana de terminal de , ejecute el siguiente comando:

      ```
      python --version
      ```

      Si no devuelve información sobre la versión o si la versión es inferior a 2.7 para Python 2 o a 3.3 para Python 3, siga las instrucciones de la página [Downloading Python (Descargar Python)](https://wiki.python.org/moin/BeginnersGuide/Download) para instalar Python 2.7\+ o Python 3.3\+. Para obtener más información acerca de los periodos de mantenimiento, consulte [Using Python on Unix platforms](https://docs.python.org/3.6/using/unix.html).

   1. En el terminal, ejecute los siguientes comandos para determinar la versión de OpenSSL:

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

      Anote el valor de versión de OpenSSL. 
**nota**  
Si está ejecutando Python 3, use **print(ssl.OPENSSL\_VERSION)**.

      Para cerrar manualmente el shell de Python, ejecute el siguiente comando:

      ```
       exit()
      ```

      Si la versión de OpenSSL es 1.0.1 o posterior, vaya al paso siguiente. De lo contrario, ejecute los comandos necesarios para actualizar OpenSSL según su distribución (por ejemplo, `sudo yum update openssl`, `sudo apt-get update`, etc.).

      Ejecute los siguientes comandos para determinar si la versión de OpenSSL es 1.0.1 o posterior:

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

   1. Ejecute los siguientes comandos para instalar el SDK para dispositivos con AWS IoT 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. Una vez instalado SDK para dispositivos con AWS IoT para Python, navegue hasta la `samples` carpeta y `greengrass` ábrala.

   Para este tutorial, copiará la función `basicDiscovery.py` de ejemplo, que utiliza los certificados y las claves que ha descargado en [Cree dispositivos cliente en un AWS IoT Greengrass grupo](device-group.md).

1. `basicDiscovery.py`Cópielo en la carpeta que contiene los certificados y las HelloWorld claves de los dispositivos HelloWorld \_Publisher y \_Subscriber.