

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á.

# Imagem do SDK do Hub de Integrações Gerenciadas no Raspberry Pi
<a name="raspberrypi-device-hub-sdk"></a>

**nota**  
 Essa implementação do AWS IoT Hub SDK no Raspberry Pi é um projeto de demonstração destinado apenas para fins de aprendizado e teste e não deve ser usada em ambientes de produção. Para fins desta demonstração, defina as seguintes configurações para facilitar o desenvolvimento:   
 **AWS armazenamento de credenciais**: somente para fins de demonstração, as credenciais e os certificados são armazenados em um local acessível para facilitar o teste e o desenvolvimento. Os ambientes de produção devem usar soluções de armazenamento seguro AWS Secrets Manager, como o Systems Manager Parameter Store. Eles devem implementar a criptografia em repouso e seguir as diretrizes AWS IoT de segurança.   
 **Privilégios de contêiner**: a demonstração é executada com privilégios elevados para permitir acesso irrestrito aos recursos do host e simplificar os fluxos de trabalho de desenvolvimento. Na produção, os contêineres devem operar com os privilégios mínimos necessários.   
 **Configuração da ponte de rede**: a demonstração usa uma configuração de ponte de rede que expõe o tráfego interno da rede para facilitar a depuração e o monitoramento. Em ambientes de produção, implemente o isolamento e a segmentação adequados da rede para evitar o acesso não autorizado ao tráfego interno da rede.   
 **Permissões do dispositivo USB**: o acesso irrestrito ao dispositivo USB é ativado para facilitar a conexão dos periféricos de desenvolvimento e dos dispositivos de teste. Para produção, implemente controles e validação rígidos de dispositivos USB para evitar ataques de falsificação de dispositivos.   
 Essas configurações permitem testes diretos e não devem ser usadas em ambientes de produção. Ao implantar na produção, siga as melhores práticas de segurança para evitar o comprometimento do sistema host e o acesso não autorizado às credenciais. 

## Pré-requisitos
<a name="deployment-prerequisites"></a>

Preencha estes requisitos antes de implantar a imagem do Raspberry Pi:
+ Baixe e instale o gerador de [imagens Raspberry Pi](https://www.raspberrypi.com/software/).
+ Obtenha um [cartão SD](https://www.amazon.com/dp/B0CWPPDS3D?ref=ppx_yo2ov_dt_b_fed_asin_title).
+ Configure um [Raspberry Pi 5 com CPU quad-core de 2,4 GHz e 64 bits](https://www.amazon.com/CanaKit-Raspberry-Starter-Kit-PRO/dp/B0CRSNCJ6Y/) (8 GB de RAM).
+ Conecte um [dongle USB Sonoff Zigbee](https://www.amazon.com/Plus-ZBDongle-Interface-Pre-Installed-Coordinated-Zigbee2MQTT/dp/B0B6P22YJC/).
+ [Firmware flash para dongle USB Sonoff Zigbee](supported-raspberry.md#sonoff-zigbee-firmware-flashing).
+ Conecte um dongle [SLUSB001A da Silicon Labs](https://www.digikey.com/en/products/detail/silicon-labs/SLUSB001A/9867108).
+ [Cadastre-se para criar uma AWS conta](https://docs.aws.amazon.com/iot-mi/latest/devguide/setting-up.html#sign-up-for-aws).
+ Instale a versão mais recente do [a AWS CLI partir da Referência de AWS CLI Comandos de Integrações Gerenciadas](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/).

## Flash uma imagem do Raspberry Pi em um novo cartão SD
<a name="image-deployment"></a>

Atualize a imagem das integrações gerenciadas em seu cartão SD usando estas etapas:

1. Baixe a imagem do [SDK do Raspberry Pi Hub para integrações gerenciadas](https://d2no7dt1utuyzo.cloudfront.net/IotMI-HubSDK-RaspberryPi/1.0.0/IotMI-HubSDK-RPi-Image-v1.0.0.img.gz).

1. Inicie o Raspberry Pi Imager em seu desktop.

1. Insira o cartão SD no leitor de cartão SD embutido do seu computador ou no leitor de cartão USB externo.

1. Selecione **Escolher dispositivo** → Raspberry Pi 5.

1. Selecione **Escolher sistema operacional** → Usar personalizado → Localizar o IotMI-HubSDK-RPi-Image-v1.0.0.img.gz arquivo → Abrir.

1. Selecione **Escolher armazenamento** → Selecione seu leitor de cartão SD.

1. Verifique se sua configuração corresponde à seguinte tela:  
![Tela de configuração do Raspberry Pi Imager mostrando as seleções de dispositivo, sistema operacional e armazenamento](https://docs.aws.amazon.com/pt_br/iot-mi/latest/devguide/images/raspberry-pi-imager-config.png)

1. Clique em **Next**.

1. Defina as configurações de personalização do sistema operacional:
   + **Nome do host:** Selecione **raspberrypi**.
   + **Nome de usuário e senha:**
     + Ativar **Definir nome de usuário e senha**:
     + Para **Nome de usuário:**, insira`hub123456`.
     + Para **Senha:**, insira`sh123456`.
   + **LAN sem fio:**
     + Ative **Configurar LAN sem fio**.
     + Digite o **SSID** e a **senha** do seu roteador.

       Exemplo de configurações:
       + **SSID:** `iotmi-tplink`
       + **Senha**: `********` (mínimo de 8 caracteres)
     + Defina **o país:** para`US`.
   + **Defina as configurações locais:**
     + Defina **o fuso horário:** para`America/Los Angeles`.
     + Defina **o layout do teclado:** para`US`.
   + **SSH:**
     + Escolha a guia **serviços**.
     + Marque **Ativar SSH.**
     + Escolha **Usar autenticação por senha**.

1. Confirme todos os pop-ups para personalização do sistema operacional e eliminação de dados.

1. Aguarde a conclusão do processo de escrita.

1. Verifique a conclusão bem-sucedida com a seguinte tela:  
![Tela de sucesso do Raspberry Pi Imager mostrando a operação de gravação concluída](https://docs.aws.amazon.com/pt_br/iot-mi/latest/devguide/images/raspberry-pi-write-success.png)

1. Clique em **Continue**.

1. Remova o cartão SD e insira-o no seu Raspberry Pi.

## Execute o Hub SDK no Raspberry Pi
<a name="hub-sdk-execution"></a>

Inicie os serviços Hub SDK em seu Raspberry Pi configurado:

1. Insira o cartão SD preparado no dispositivo Raspberry Pi 5.

1. Conecte o dongle USB Sonoff Zigbee e o dongle SLUSB001A da Silicon Labs ao Raspberry Pi.

1. Ligue o Raspberry Pi.

1. Certifique-se de que o Raspberry Pi e seu computador (do qual você usa o SSH) estejam na mesma rede.

1. Faça SSH no Raspberry Pi usando as credenciais que você definiu durante a implantação da imagem.

   ```
   ssh username@hostname
   ```

1. Navegue até o diretório do SDK do hub:

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

1. Conclua a [configuração de integração do Hub](https://docs.aws.amazon.com/iot-mi/latest/devguide/managedintegrations-sdk-v2-cookbook-hubsetup.html) para adicionar materiais de autenticação e configuração.
**nota**  
Você deve estar em `YUL` nossa `DUB` região para realizar essa etapa.

1. Execute o Hub SDK:

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

O sistema exibe a seguinte resposta para uma inicialização bem-sucedida do Hub SDK:

```
-------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----
```

## Próximas etapas
<a name="next-steps"></a>

Depois de iniciar com sucesso o Hub SDK, continue com a integração e o gerenciamento do dispositivo em. [Configuração guiada pelo usuário para integrar e operar dispositivos](managedintegrations-sdk-v2-cookbook-ugs.md)