

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.

# Imagen del SDK de Managed Integrations Hub en Raspberry Pi
<a name="raspberrypi-device-hub-sdk"></a>

**nota**  
 Esta implementación del SDK de AWS IoT Hub en Raspberry Pi es un proyecto de demostración destinado únicamente a fines de aprendizaje y pruebas y no está destinado a ser utilizado en entornos de producción. Para esta demostración, defina las siguientes configuraciones para facilitar el desarrollo:   
 **AWS almacenamiento de credenciales**: solo con fines de demostración, las credenciales y los certificados se almacenan en un lugar accesible para facilitar las pruebas y el desarrollo. Los entornos de producción deben utilizar soluciones de almacenamiento seguras AWS Secrets Manager, como Systems Manager Parameter Store. Deben implementar el cifrado en reposo y seguir las pautas AWS IoT de seguridad.   
 **Privilegios de contenedor**: la demostración se ejecuta con privilegios elevados para permitir el acceso sin restricciones a los recursos del host y simplificar los flujos de trabajo de desarrollo. En producción, los contenedores deben funcionar con los privilegios mínimos requeridos.   
 **Configuración de puente de red**: la demostración utiliza una configuración de puente de red que expone el tráfico de red interno para facilitar la depuración y la supervisión. En los entornos de producción, implemente el aislamiento y la segmentación adecuados de la red para evitar el acceso no autorizado al tráfico de la red interna.   
 **Permisos de dispositivos USB**: se permite el acceso sin restricciones a los dispositivos USB para facilitar la conexión de los periféricos de desarrollo y los dispositivos de prueba. Para la producción, implemente controles y valide estrictamente los dispositivos USB para evitar ataques de suplantación de identidad.   
 Estas configuraciones permiten realizar pruebas sencillas y no deben utilizarse en entornos de producción. Al realizar la implementación en producción, siga las mejores prácticas de seguridad para evitar que el sistema anfitrión se vea comprometido y el acceso no autorizado a las credenciales. 

## Requisitos previos
<a name="deployment-prerequisites"></a>

Complete estos requisitos antes de implementar la imagen de Raspberry Pi:
+ Descargue e instale el generador de [imágenes de Raspberry Pi.](https://www.raspberrypi.com/software/)
+ Obtenga una [tarjeta SD.](https://www.amazon.com/dp/B0CWPPDS3D?ref=ppx_yo2ov_dt_b_fed_asin_title)
+ Configura una [Raspberry Pi 5 con una CPU de cuatro núcleos y 64 bits a 2,4 GHz (8](https://www.amazon.com/CanaKit-Raspberry-Starter-Kit-PRO/dp/B0CRSNCJ6Y/) GB de RAM).
+ Conecta un [dongle USB Sonoff Zigbee](https://www.amazon.com/Plus-ZBDongle-Interface-Pre-Installed-Coordinated-Zigbee2MQTT/dp/B0B6P22YJC/).
+ [Instale el firmware en el dongle USB Sonoff Zigbee](supported-raspberry.md#sonoff-zigbee-firmware-flashing).
+ Conecte un dongle [SLUSB001A de Silicon Labs](https://www.digikey.com/en/products/detail/silicon-labs/SLUSB001A/9867108).
+ [Regístrese para obtener una cuenta](https://docs.aws.amazon.com/iot-mi/latest/devguide/setting-up.html#sign-up-for-aws). AWS 
+ Instale la última versión de [AWS CLI desde la Referencia de AWS CLI comandos de Managed Integrations](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/).

## Coloca una imagen de Raspberry Pi en una nueva tarjeta SD
<a name="image-deployment"></a>

Instala la imagen de las integraciones gestionadas en tu tarjeta SD siguiendo estos pasos:

1. Descarga la imagen del [SDK de Raspberry Pi Hub para integraciones gestionadas](https://d2no7dt1utuyzo.cloudfront.net/IotMI-HubSDK-RaspberryPi/1.0.0/IotMI-HubSDK-RPi-Image-v1.0.0.img.gz).

1. Inicie Raspberry Pi Imager en su escritorio.

1. Inserta la tarjeta SD en el lector de tarjetas SD integrado en tu ordenador o en un lector de tarjetas USB externo.

1. Selecciona **Elegir dispositivo** → Raspberry Pi 5.

1. Seleccione **Elegir sistema operativo** → Usar personalizado → Buscar el IotMI-HubSDK-RPi-Image-v1.0.0.img.gz archivo → Abrir.

1. Seleccione **Elegir almacenamiento** → Seleccione su lector de tarjetas SD.

1. Verifica que tu configuración coincida con la siguiente pantalla:  
![Pantalla de configuración del Raspberry Pi Imager que muestra las selecciones de dispositivo, sistema operativo y almacenamiento](https://docs.aws.amazon.com/es_es/iot-mi/latest/devguide/images/raspberry-pi-imager-config.png)

1. Haga clic en **Next (Siguiente)**.

1. Configure los ajustes de personalización del sistema operativo:
   + **Nombre de host:** selecciona **raspberrypi**.
   + **Nombre de usuario y contraseña:**
     + Habilite **Establecer nombre de usuario y contraseña**:
     + Para el **nombre de usuario:**, introduzca`hub123456`.
     + Para **la contraseña:**, introduzca`sh123456`.
   + **LAN inalámbrica:**
     + Active la opción **Configurar LAN inalámbrica**.
     + Introduzca el **SSID** y la **contraseña** de su router.

       Ejemplo de configuración:
       + **SSID**: `iotmi-tplink`
       + **Contraseña**: `********` (mínimo 8 caracteres)
     + Establece **el país:** para`US`.
   + **Establecer la configuración regional:**
     + Establecer **zona horaria:** a. `America/Los Angeles`
     + Defina la **distribución del teclado:** a`US`.
   + **SSH:**
     + Selecciona la pestaña **de servicios**.
     + Marca **Habilitar SSH.**
     + Selecciona **Usar autenticación por contraseña**.

1. Confirme todas las ventanas emergentes para personalizar el sistema operativo y borrar los datos.

1. Espere a que se complete el proceso de escritura.

1. Compruebe que se ha completado correctamente con la siguiente pantalla:  
![Pantalla de éxito del Raspberry Pi Imager que muestra la operación de escritura completada](https://docs.aws.amazon.com/es_es/iot-mi/latest/devguide/images/raspberry-pi-write-success.png)

1. Haga clic en **Continue (Continuar)**.

1. Extrae la tarjeta SD e insértala en tu Raspberry Pi.

## Ejecuta el Hub SDK en la Raspberry Pi
<a name="hub-sdk-execution"></a>

Inicie los servicios del SDK de Hub en su Raspberry Pi configurada:

1. Inserta la tarjeta SD preparada en el dispositivo Raspberry Pi 5.

1. Conecta el dongle USB Sonoff Zigbee y el dongle SLUSB001A de Silicon Labs a la Raspberry Pi.

1. Enciende la Raspberry Pi.

1. Asegúrate de que la Raspberry Pi y tu ordenador (desde el que utilizas SSH) estén en la misma red.

1. Utilice SSH para conectarse a la Raspberry Pi con las credenciales que configuró durante la implementación de la imagen.

   ```
   ssh username@hostname
   ```

1. Navega hasta el directorio del SDK del hub:

   ```
   cd /data/aws/iotmi
   ```

1. Complete la [configuración de incorporación de Hub](https://docs.aws.amazon.com/iot-mi/latest/devguide/managedintegrations-sdk-v2-cookbook-hubsetup.html) para añadir materiales de autenticación y configuración.
**nota**  
Debes estar en nuestra `YUL` `DUB` región para realizar este paso.

1. Ejecuta el SDK de Hub:

   ```
   cd /data/aws/iotmi
   bash start_hub_sdk.sh
   ```

El sistema muestra la siguiente respuesta para que el Hub SDK se inicie correctamente:

```
-------Stopping SDK running processes---
-------Starting Hub SDK-------------
-------Creating logs directory----------
Logs directory created.
-------Verifying Middleware paths-------
All middleware libraries exist
-------Verifying Middleware pre reqs---
AIPC and KVstroage directories exist
-------Starting HubOnboarding-----------
-------Starting MQTT Proxy-----------
-------Staring Log Daemon---
-------Starting Event Manager-----------
-------Starting Zigbee Service----------
--Checking Zigbee network information--
-------Starting Zwave Service----------
/data/aws/iotmi/middleware/AceZwave/bin /data/aws/iotmi
/data/aws/iotmi
-------Starting CDMB--------------------
-------Starting Agent--------------------
-------Starting Provisioner--------------
-------Checking SDK status---------------
hub1234+    1780  0.2  0.1 1093936 16368 pts/1   Sl+  16:34   0:00 ./iotmi_mqtt_proxy -C /data/aws/iotmi/config/iotmi_config.json
Process 'iotmi_mqtt_proxy' is running.
hub1234+    1884  0.0  0.0 236272  2624 pts/1    Sl+  16:34   0:00 ./middleware/AceCommon/bin/ace_eventmgr
Process 'ace_eventmgr' is running.
hub1234+    1892  9.1  0.1 393040  8352 pts/1    Sl+  16:34   0:04 ./middleware/AceZigbee/bin/ace_zigbee_service
Process 'ace_zigbee_service' is running.
hub1234+    1923  0.0  0.1 1570736 12736 pts/1   Sl+  16:34   0:00 ./zwave_svc
Process 'zwave_svc' is running.
hub1234+    1958  0.0  0.0 1067632 5776 pts/1    Sl+  16:34   0:00 ./iotmi_cdmb
Process 'iotmi_cdmb' is running.
hub1234+    2001  0.2  0.2 2017712 21264 pts/1   Sl+  16:35   0:00 ./iotmi_device_agent
Process 'iotmi_device_agent' is running.
hub1234+    2045  0.0  0.1 1457824 12624 pts/1   Sl+  16:35   0:00 ./iotmi_lpw_provisioner
Process 'iotmi_lpw_provisioner' is running.
hub1234+    1813  0.0  0.0 875152  6848 pts/1    Sl+  16:34   0:00 ./iotmi_log_daemon
Process 'iotmi_log_daemon' is running.
------Successfully Started Hub SDK----
```

## Siguientes pasos
<a name="next-steps"></a>

Tras iniciar correctamente el SDK de Hub, continúa con la integración y la administración del dispositivo en[Configuración guiada por el usuario para incorporar y operar dispositivos](managedintegrations-sdk-v2-cookbook-ugs.md).