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á. # Tutorial: Preparando seus dispositivos para o AWS IoT Device Client Este tutorial orienta você na inicialização do Raspberry Pi para prepará-lo para os tutoriais subsequentes neste percurso de aprendizado. O objetivo desse tutorial é instalar a versão atual do sistema operacional do dispositivo e garantir que você possa se comunicar com o dispositivo no contexto do ambiente de desenvolvimento. **Pré-requisitos** Antes de começar este tutorial, verifique se você tem os itens listados em [Pré-requisitos para criar demonstrações com o Device Client AWS IoT](iot-tutorials-dc-intro.md#iot-dc-tutorial-overview) disponíveis e prontos para uso. A conclusão desse tutorial requer cerca de 90 minutos. **Neste tutorial, você vai:** + Instalar e atualizar o sistema operacional do dispositivo. + Instalar e verificar qualquer software adicional necessário para executar os tutoriais. + Testar a conectividade do dispositivo e instalar os certificados necessários. Depois de concluir este tutorial, o próximo tutorial prepara seu dispositivo para as demonstrações que usam o AWS IoT Device Client. **Topics** + [Instalar e atualizar o sistema operacional do dispositivo](iot-dc-prepare-device-sys.md) + [Instalar e verificar o software necessário no seu dispositivo](iot-dc-prepare-device-sw.md) + [Testar o dispositivo e salvar o certificado de CA da Amazon](iot-dc-prepare-device-test.md) # Instalar e atualizar o sistema operacional do dispositivo Os procedimentos nesta seção descrevem como inicializar o cartão microSD que o Raspberry Pi usa como unidade do sistema. O cartão microSD do Raspberry Pi contém o software do sistema operacional (OS), bem como espaço para o armazenamento de arquivos da aplicação. Se você não estiver usando um Raspberry Pi, siga as instruções do dispositivo para instalar e atualizar o software do sistema operacional do dispositivo. Depois de concluir esta seção, você poderá iniciar o dispositivo de IoT e conectar-se a ele por meio do programa de terminal no computador host local. **Equipamentos necessários:** + O ambiente local de desenvolvimento e testes + Um Raspberry Pi, ou dispositivo de IoT, que pode se conectar à Internet + Um cartão de memória microSD com capacidade de pelo menos 8 GB ou armazenamento suficiente para o sistema operacional e o software necessário. **nota** Ao selecionar um cartão microSD para esses exercícios, escolha um que seja tão grande quanto necessário, mas tão pequeno quanto possível. Um cartão SD pequeno será mais rápido de fazer backup e atualizar. No Raspberry Pi, você não precisará de mais do que um cartão microSD de 8 GB para esses tutoriais. Se você precisar de mais espaço para a aplicação específica, os arquivos de imagem menores salvos nesses tutoriais poderão redimensionar o sistema de arquivos em um cartão maior para usar todo o espaço compatível do cartão que você escolher. **Equipamento opcional:** + Um teclado USB conectado ao Raspberry Pi + Um monitor HDMI e um cabo para conectar o monitor ao Raspberry Pi **Topics** + [Carregue o sistema operacional do dispositivo no cartão microSD](#iot-dc-prepare-device-sys-step1) + [Inicie o dispositivo de IoT com o novo sistema operacional](#iot-dc-prepare-device-sys-step2) + [Conectar o computador host local ao dispositivo](#iot-dc-prepare-device-sys-step3) ## Carregue o sistema operacional do dispositivo no cartão microSD Esse procedimento usa o computador host local para carregar o sistema operacional do dispositivo em um cartão microSD. **nota** Se o dispositivo não usar uma mídia de armazenamento removível para o sistema operacional, instale o sistema operacional usando o procedimento para esse dispositivo e continue na [Inicie o dispositivo de IoT com o novo sistema operacional](#iot-dc-prepare-device-sys-step2). **Para instalar o sistema operacional no Raspberry Pi** 1. No computador host local, baixe e descompacte a imagem do sistema operacional Raspberry Pi que você deseja usar. As versões mais recentes estão disponíveis em [ https://www.raspberrypi.com/software/sistemas operacionais/](https://www.raspberrypi.com/software/operating-systems/) **Como escolher uma versão do sistema operacional Raspberry Pi** Este tutorial usa a versão **Raspberry Pi OS Lite** porque é a menor versão compatível com esses tutoriais neste percurso de aprendizado. Essa versão do sistema operacional Raspberry Pi tem apenas uma interface de linha de comando e não tem uma interface gráfica de usuário. Uma versão do sistema operacional Raspberry Pi mais recente com uma interface gráfica de usuário também funcionará com esses tutoriais; no entanto, os procedimentos descritos neste percurso de aprendizado usam somente a interface da linha de comando para realizar operações no Raspberry Pi. 1. Insira o cartão microSD no computador host local. 1. Usando uma ferramenta de imagem de cartão SD, grave o arquivo de imagem do sistema operacional descompactado no cartão microSD. 1. Depois de gravar a imagem do sistema operacional Raspberry Pi no cartão microSD: 1. Abra a partição BOOT no cartão microSD em uma janela da linha de comando ou janela do explorador de arquivos. 1. Na partição BOOT do cartão microSD, no diretório raiz, crie um arquivo vazio chamado `ssh` sem extensão de arquivo e sem conteúdo. Isso faz com que o Raspberry Pi ative as comunicações SSH na primeira vez em que for iniciado. 1. Ejete o cartão microSD e remova-o com segurança do computador host local. O cartão microSD está pronto para [Inicie o dispositivo de IoT com o novo sistema operacional](#iot-dc-prepare-device-sys-step2). ## Inicie o dispositivo de IoT com o novo sistema operacional Este procedimento instala o cartão microSD e inicia o Raspberry Pi pela primeira vez usando o sistema operacional baixado. **Para iniciar o dispositivo de IoT com o novo sistema operacional** 1. Com a alimentação desconectada do dispositivo, insira o cartão microSD da etapa anterior, [Carregue o sistema operacional do dispositivo no cartão microSD](#iot-dc-prepare-device-sys-step1), no Raspberry Pi. 1. Conecte o dispositivo a uma rede com fios. 1. Esses tutoriais interagirão com o Raspberry Pi por meio do computador host local usando um terminal SSH. Se você também quiser interagir diretamente com o dispositivo, você pode: 1. Conectar um monitor HDMI a ele para assistir às mensagens do console do Raspberry Pi antes de conectar a janela do terminal do computador host local ao Raspberry Pi. 1. Conectar um teclado USB a ele se quiser interagir diretamente com o Raspberry Pi. 1. Conectar a alimentação ao Raspberry Pi e esperar cerca de um minuto para que ele seja inicializado. Se você tiver um monitor conectado ao Raspberry Pi, poderá ver processo de inicialização nele. 1. Descubra o endereço IP do dispositivo: + Se você conectou um monitor HDMI ao Raspberry Pi, o endereço IP aparecerá nas mensagens exibidas no monitor + Se você tiver acesso ao roteador ao qual o Raspberry Pi está conectado, poderá ver o endereço na interface de administração do roteador. Depois de ter o endereço IP do Raspberry Pi, você estará pronto para [Conectar o computador host local ao dispositivo](#iot-dc-prepare-device-sys-step3). ## Conectar o computador host local ao dispositivo Este procedimento usa o programa de terminal no computador host local para se conectar ao Raspberry Pi e alterar a senha padrão. **Para conectar o computador host local ao dispositivo** 1. No computador host local, abra o programa do terminal SSH: + Windows: `PuTTY` + Linux/macOS: `Terminal` **nota** O PuTTY não é instalado automaticamente no Windows. Se não estiver no computador, talvez seja necessário baixá-lo e instalá-lo. 1. Conecte o programa do terminal ao endereço IP do Raspberry Pi e faça login usando as credenciais padrão. ``` username: pi password: raspberry ``` 1. Depois de fazer login no Raspberry Pi, altere a senha do usuário `pi`. ``` passwd ``` Siga os prompts para alterar a senha. ``` Changing password for pi. Current password: raspberry New password: YourNewPassword Retype new password: YourNewPassword passwd: password updated successfully ``` Depois de inserir o prompt da linha de comando do Raspberry Pi na janela do terminal e alterar a senha, você estará pronto para continuar em [Instalar e verificar o software necessário no seu dispositivo](iot-dc-prepare-device-sw.md). # Instalar e verificar o software necessário no seu dispositivo Os procedimentos nesta seção continuam com [a seção anterior](iot-dc-prepare-device-sys.md) para atualizar o sistema operacional do Raspberry Pi e instalar o software no Raspberry Pi que será usado na próxima seção para criar e instalar o AWS IoT Device Client. Depois de concluir esta seção, seu Raspberry Pi terá um sistema up-to-date operacional, o software exigido pelos tutoriais neste plano de aprendizado, e será configurado para sua localização. **Equipamentos necessários:** + O ambiente local de desenvolvimento e teste da [seção anterior](iot-dc-prepare-device-sys.md) + O Raspberry Pi usado na [seção anterior](iot-dc-prepare-device-sys.md) + O cartão de memória microSD da [seção anterior](iot-dc-prepare-device-sys.md) **nota** O Raspberry Pi Model 3\$1 e o Raspberry Pi Model 4 podem executar todos os comandos descritos neste percurso de aprendizado. Se seu dispositivo de IoT não conseguir compilar o software ou executar o AWS Command Line Interface, talvez seja necessário instalar os compiladores necessários no computador host local para criar o software e depois transferi-lo para o dispositivo de IoT. Para obter mais informações sobre como instalar e compilar software para o dispositivo, consulte a documentação do software do dispositivo. **Topics** + [Atualizar o software do sistema operacional](#iot-dc-prepare-device-sw-step1) + [Instale as aplicações e bibliotecas obrigatórias](#iot-dc-prepare-device-sw-step2) + [(Opcional) Salve a imagem do cartão microSD](#iot-dc-prepare-device-sw-step3) ## Atualizar o software do sistema operacional Esse procedimento atualiza o software do sistema operacional. **Para atualizar o software do sistema operacional no Raspberry Pi** Execute essas etapas na janela do terminal do computador host local. 1. Digite esses comandos para atualizar o software do sistema no Raspberry Pi. ``` sudo apt-get -y update sudo apt-get -y upgrade sudo apt-get -y autoremove ``` 1. Atualize as configurações de localidade e fuso horário do Raspberry Pi (opcional). Digite esse comando para atualizar as configurações de localidade e fuso horário do dispositivo. ``` sudo raspi-config ``` 1. Para definir a localidade do dispositivo: 1. Na tela **Ferramenta de Configuração do Software Raspberry Pi (raspi-config)**, escolha a opção **5**. **`5 Localisation Options Configure language and regional settings`** Use a tecla Tab para ir para **** e, em seguida, pressione a space bar. 1. Na lista de opções de localidade, escolha as localidades que você deseja instalar no Raspberry Pi usando as teclas de seta para rolar e space bar para marcar as que deseja. Nos Estados Unidos, **`en_US.UTF-8`** é uma boa opção. 1. Depois de selecionar as localidades para o dispositivo, use a tecla Tab para escolher **** e pressione a space bar para exibir a página de confirmação de **Configuração de localidades**. 1. Para definir o fuso horário do dispositivo: 1. Na tela **raspi-config**, escolha a opção **5**. **`5 Localisation Options Configure language and regional settings`** Use a tecla Tab para ir para **** e, em seguida, pressione a space bar. 1. No menu **Configuração de tzdata**, escolha a área geográfica na lista. Use a tecla Tab para ir para **** e, em seguida, pressione a space bar. 1. Na lista de cidades, use as teclas de seta para escolher uma cidade no fuso horário. Para definir o fuso horário, use a tecla Tab para ir para **** e, em seguida, pressione a space bar. 1. Quando terminar de atualizar as configurações, use a tecla Tab para acessar **** e pressione a space bar para fechar a aplicação **raspi-config**. 1. Digite este comando para reiniciar o Raspberry Pi. ``` sudo shutdown -r 0 ``` 1. Aguarde a reinicialização do Raspberry Pi. 1. Depois que o Raspberry Pi for reiniciado, reconecte a janela do terminal no computador host local ao Raspberry Pi. O software do sistema Raspberry Pi agora está configurado e você está pronto para continuar na [Instale as aplicações e bibliotecas obrigatórias](#iot-dc-prepare-device-sw-step2). ## Instale as aplicações e bibliotecas obrigatórias Esse procedimento instala o software da aplicação e as bibliotecas que os tutoriais subsequentes usam. Se você estiver usando um Raspberry Pi ou se puder compilar o software necessário no dispositivo de IoT, execute essas etapas na janela do terminal no computador host local. Se você precisar compilar software para o dispositivo de IoT no computador host local, analise a documentação do software do dispositivo de IoT para obter informações sobre como executar essas etapas no dispositivo. **Para instalar o software da aplicação e as bibliotecas no Raspberry Pi** 1. Digite esse comando para instalar o software da aplicação e as bibliotecas. ``` sudo apt-get -y install build-essential libssl-dev cmake unzip git python3-pip ``` 1. Insira esses comandos para confirmar que a versão correta do software foi instalada. ``` gcc --version cmake --version openssl version git --version ``` 1. Confirme se essas versões do software da aplicação estão instaladas: + `gcc` 9.3.0 ou posterior + `cmake` 3.10.x ou posterior + `OpenSSL`: 1.1.1 ou posterior + `git`: 2.20.1 ou posterior Se o Raspberry Pi tiver versões aceitáveis do software da aplicação necessário, você está pronto para continuar na [(Opcional) Salve a imagem do cartão microSD](#iot-dc-prepare-device-sw-step3). ## (Opcional) Salve a imagem do cartão microSD Ao longo dos tutoriais deste percurso de aprendizado, você encontrará esses procedimentos para salvar uma cópia da imagem do cartão microSD do Raspberry Pi em um arquivo no computador host local. Embora incentivadas, elas não são tarefas obrigatórias. Ao salvar a imagem do cartão microSD onde sugerido, você pode pular os procedimentos que precedem o ponto de salvamento neste percurso de aprendizado, o que pode economizar tempo se você precisar tentar algo novamente. A consequência de não salvar a imagem do cartão microSD periodicamente é que talvez você precise reiniciar os tutoriais do percurso de aprendizado desde o início se o cartão microSD estiver danificado ou se você acidentalmente definir uma aplicação ou as configurações incorretamente. Neste ponto, o cartão microSD do Raspberry Pi tem um sistema operacional atualizado e o software básico da aplicação carregado. Você pode economizar o tempo necessário para concluir as etapas anteriores salvando o conteúdo do cartão microSD em um arquivo agora. Ter a imagem atual da imagem do cartão microSD do dispositivo permite que você comece a partir deste ponto para continuar ou repetir um tutorial ou procedimento sem a necessidade de instalar e atualizar o software do zero. **Para salvar a imagem do cartão microSD em um arquivo** 1. Digite este comando para desligar o Raspberry Pi. ``` sudo shutdown -h 0 ``` 1. Depois que o Raspberry Pi for desligado completamente, desligue a energia. 1. Remova o cartão microSD do Raspberry Pi. 1. No computador host local: 1. Insira o cartão microSD. 1. Usando uma ferramenta de imagem de cartão SD, grave a imagem do cartão microSD em um arquivo. 1. Depois que a imagem do cartão microSD for salva, ejete o cartão do computador host local. 1. Com a alimentação desconectada do Raspberry Pi, insira o cartão microSD no Raspberry Pi. 1. Ligue o Raspberry Pi. 1. Depois de esperar cerca de um minuto, no computador host local, reconecte a janela do terminal no computador host local que estava conectado ao Raspberry Pi. e, em seguida, faça login no Raspberry Pi. # Testar o dispositivo e salvar o certificado de CA da Amazon Os procedimentos nesta seção continuam com a [seção anterior para instalar o](iot-dc-prepare-device-sw.md) AWS Command Line Interface e o certificado da Autoridade de Certificação usado para autenticar suas conexões com AWS IoT Core. Depois de concluir esta seção, você saberá que seu Raspberry Pi tem o software de sistema necessário para instalar o AWS IoT Device Client e que ele tem uma conexão ativa com a Internet. **Equipamentos necessários:** + O ambiente local de desenvolvimento e teste da [seção anterior](iot-dc-prepare-device-sw.md) + O Raspberry Pi usado na [seção anterior](iot-dc-prepare-device-sw.md) + O cartão de memória microSD da [seção anterior](iot-dc-prepare-device-sw.md) **Topics** + [Instale o AWS Command Line Interface](#iot-dc-prepare-device-test-step1) + [Configure suas Conta da AWS credenciais](#iot-dc-prepare-device-test-step2) + [Fazer download do certificado da CA raiz da Amazon](#iot-dc-prepare-device-test-step3) + [(Opcional) Salve a imagem do cartão microSD](#iot-dc-prepare-device-test-step4) ## Instale o AWS Command Line Interface Este procedimento instala o AWS CLI em seu Raspberry Pi. Se você estiver usando um Raspberry Pi ou se puder compilar o software no dispositivo de IoT, execute essas etapas na janela do terminal no computador host local. Se você precisar compilar software para o dispositivo de IoT no computador host local, analise a documentação do software do dispositivo de IoT para obter informações sobre as bibliotecas que ele requer. **Para instalar o AWS CLI em seu Raspberry Pi** 1. Use esses comandos para baixar e instalar a AWS CLI. ``` export PATH=$PATH:~/.local/bin # configures the path to include the directory with the AWS CLI git clone https://github.com/aws/aws-cli.git # download the AWS CLI code from GitHub cd aws-cli && git checkout v2 # go to the directory with the repo and checkout version 2 pip3 install -r requirements.txt # install the prerequisite software ``` 1. Execute este comando para instalar AWS CLI o. Este comando pode levar até 15 minutos para ser concluído. ``` pip3 install . # install the AWS CLI ``` 1. Execute esse comando para confirmar se a versão correta do AWS CLI foi instalada. ``` aws --version ``` A versão do AWS CLI deve ser 2.2 ou posterior. Se AWS CLI exibiu sua versão atual, você está pronto para continuar[Configure suas Conta da AWS credenciais](#iot-dc-prepare-device-test-step2). ## Configure suas Conta da AWS credenciais Neste procedimento, você obterá Conta da AWS as credenciais e as adicionará para uso em seu Raspberry Pi. **Para adicionar suas Conta da AWS credenciais ao seu dispositivo** 1. Obtenha um **ID de chave** de **acesso e uma chave de acesso secreta** Conta da AWS para autenticá-los AWS CLI em seu dispositivo. Se você é novo no AWS IAM, o [ https://aws.amazon.com/premiumsupport/knowledge-center/create-access-key/](https://aws.amazon.com/premiumsupport/knowledge-center/create-access-key/)descreve o processo a ser executado no AWS console para criar credenciais do AWS IAM para usar em seu dispositivo. 1. Na janela do terminal no computador host local que está conectado ao Raspberry Pi e com as credenciais de **ID da chave de acesso** e **Chave de acesso secreta** do dispositivo: 1. Execute o aplicativo AWS configure com este comando: ``` aws configure ``` 1. Insira as credenciais e informações de configuração quando solicitado: ``` AWS Access Key ID: your Access Key ID AWS Secret Access Key: your Secret Access Key Default region name: your Região da AWS code Default output format: json ``` 1. Execute esse comando para testar o acesso do seu dispositivo ao seu Conta da AWS AWS IoT Core terminal. ``` aws iot describe-endpoint --endpoint-type iot:Data-ATS ``` Ele deve retornar seu endpoint AWS IoT de dados Conta da AWS específico, como este exemplo: ``` { "endpointAddress": "a3EXAMPLEffp-ats.iot.us-west-2.amazonaws.com" } ``` Se você ver seu endpoint Conta da AWS de AWS IoT dados específico, seu Raspberry Pi tem a conectividade e as permissões para continuar. [Fazer download do certificado da CA raiz da Amazon](#iot-dc-prepare-device-test-step3) **Importante** Suas Conta da AWS credenciais agora estão armazenadas no cartão microSD do seu Raspberry Pi. Embora isso facilite as interações futuras para você e para o software que você criará nesses tutoriais, elas também serão salvas e duplicadas em qualquer imagem de cartão microSD que você criar após essa etapa, por padrão. AWS Para proteger a segurança de suas Conta da AWS credenciais, antes de salvar mais imagens do cartão microSD, considere apagar as credenciais `aws configure` executando novamente e inserindo caracteres aleatórios para o ID da chave de acesso e **a chave de acesso** **secreta** para evitar Conta da AWS que suas credenciais sejam comprometidas. Se você descobrir que salvou suas Conta da AWS credenciais inadvertidamente, poderá desativá-las no console do IAM. AWS ## Fazer download do certificado da CA raiz da Amazon Este procedimento baixa e salva uma cópia de um certificado da Autoridade de Certificação (CA) raiz da Amazon. O download desse certificado o salva para uso nos tutoriais subsequentes e também testa a conectividade do dispositivo com os serviços da AWS . **Para fazer download do certificado da CA raiz da Amazon** 1. Execute o comando a seguir a fim de criar um diretório para o certificado. ``` mkdir ~/certs ``` 1. Execute este comando para fazer download do certificado da CA raiz da Amazon. ``` curl -o ~/certs/AmazonRootCA1.pem https://www.amazontrust.com/repository/AmazonRootCA1.pem ``` 1. Execute esses comandos para definir o acesso ao diretório do certificado e o arquivo. ``` chmod 745 ~ chmod 700 ~/certs chmod 644 ~/certs/AmazonRootCA1.pem ``` 1. Execute esse comando para ver o arquivo de certificado da CA no novo diretório. ``` ls -l ~/certs ``` Você deve ver uma entrada como essa. A data e a hora serão diferentes; no entanto, o tamanho do arquivo e todas as outras informações deverão ser iguais às mostradas aqui. ``` -rw-r--r-- 1 pi pi 1188 Oct 28 13:02 AmazonRootCA1.pem ``` Se o tamanho do arquivo não for `1188`, verifique os parâmetros do comando **curl**. Você pode ter baixado um arquivo incorreto. ## (Opcional) Salve a imagem do cartão microSD Neste ponto, o cartão microSD do Raspberry Pi tem um sistema operacional atualizado e o software básico da aplicação carregado. **Para salvar a imagem do cartão microSD em um arquivo** 1. Na janela do terminal do computador host local, limpe as credenciais da AWS . 1. Execute o aplicativo AWS configure com este comando: ``` aws configure ``` 1. Substitua as credenciais quando solicitado. Você pode deixar o **Nome da região padrão** e o **Formato de saída padrão** como estão pressionando **Enter**. ``` AWS Access Key ID [****************YT2H]: XYXYXYXYX AWS Secret Access Key [****************9plH]: XYXYXYXYX Default region name [us-west-2]: Default output format [json]: ``` 1. Digite este comando para desligar o Raspberry Pi. ``` sudo shutdown -h 0 ``` 1. Depois que o Raspberry Pi for desligado completamente, remova o conector de alimentação. 1. Remova o cartão microSD do dispositivo. 1. No computador host local: 1. Insira o cartão microSD. 1. Usando uma ferramenta de imagem de cartão SD, grave a imagem do cartão microSD em um arquivo. 1. Depois que a imagem do cartão microSD for salva, ejete o cartão do computador host local. 1. Com a alimentação desconectada do Raspberry Pi, insira o cartão microSD no Raspberry Pi. 1. Ligue o dispositivo. 1. Após cerca de um minuto, no computador host local, reinicie a sessão da janela do terminal e faça login no dispositivo. **Não insira novamente suas Conta da AWS credenciais ainda.** Depois de reiniciar e fazer login no Raspberry Pi, você estará pronto para continuar em [Tutorial: Instalando e configurando o AWS IoT Device Client](iot-dc-install-dc.md).