Experimente o tutorial de conexão rápida do AWS IoT Core - AWS IoT Core

Experimente o tutorial de conexão rápida do AWS IoT Core

Neste tutorial, você criará seu primeiro objeto, conectará um dispositivo a ele e observará como ele envia mensagens MQTT.

Você deve levar de 15 a 20 minutos para concluir este tutorial.

Este tutorial é ideal para pessoas que desejam começar a usar o AWS IoT rapidamente para verificar seu funcionamento em um cenário limitado. Caso esteja procurando por um exemplo que o ajude a começar a explorar mais atributos e serviços, consulte Explore AWS IoT Core em um tutorial prático.

Neste tutorial, você baixará e executará um software em um dispositivo que se conecta a um recurso de objeto no AWS IoT Core como parte de uma solução de IoT muito pequena. O dispositivo pode ser um dispositivo de IoT, como um Raspberry Pi, como também pode ser um computador que execute Linux, OS e OSX ou Windows. Caso deseje conectar um dispositivo WAN de longo alcance (LoRaWAN) à AWS IoT, consulte o tutorial Conectar dispositivos e gateways ao AWS IoT Core para LoRaWAN.

Caso o seu dispositivo seja compatível com um navegador que execute o console do AWS IoT, recomendamos que você conclua este tutorial nesse dispositivo.

nota

Se o seu dispositivo não tiver um navegador compatível, conclua o tutorial em um computador. Quando o procedimento solicitar que você baixe o arquivo, baixe-o em seu computador e, depois, transfira o arquivo baixado para seu dispositivo através do Secure Copy (SCP) ou de um processo similar.

O tutorial requer que o seu dispositivo de IoT se comunique com a porta 8443 no endpoint de dados de dispositivo da sua Conta da AWS. Para testar se ele consegue acessar essa porta, conclua os procedimentos de Testar a conectividade com o endpoint de dados de um dispositivo.

Etapa 1. Inicie o tutorial

Se possível, realize este procedimento em seu dispositivo; caso contrário, esteja pronto para transferir um arquivo para seu dispositivo mais adiante neste procedimento.

Para iniciar o tutorial, inicie uma sessão no console do AWS IoT. Na página inicial do console do AWS IoT, à esquerda, selecione Conectar e, depois, selecione Conectar um dispositivo.

A página inicial deste console do AWS IoT mostra como conectar um dispositivo.

Etapa 2. Criar um objeto

  1. Na seção Preparar seu dispositivo, siga as instruções na tela para preparar seu dispositivo para conexão com o AWS IoT.

    Como preparar o dispositivo no console de AWS IoT.
  2. Na seção Registrar e proteger seu dispositivo, selecione Criar um objeto nova ou Selecionar um objeto existente. No campo Nome do objeto, digite o nome do objeto. O nome do objeto usado no exemplo é TutorialTestThing

    Importante

    Verifique o nome de objeto antes de continuar.

    Não é possível alterar o nome de um objeto depois da criação do objeto. Se você quiser alterar o nome de um objeto, será preciso criar um novo objeto com o nome correto e, em seguida, excluir o objeto com o nome incorreto.

    Na seção Configurações adicionais, personalize ainda mais seu recurso de objeto com as configurações opcionais listadas.

    Depois de fornecer um nome ao objeto e selecionar as configurações adicionais, selecione Próximo.

    Use o console de AWS IoT para registrar e proteger seu dispositivo.
  3. Na seção Escolher plataforma e SDK, selecione a plataforma e a linguagem do SDK do dispositivo do AWS IoT que você quer usar. Neste exemplo, as opções são a plataforma Linux/OSX e SDK Python. Assegure-se de ter o python3 e o pip3 instalados no dispositivo de destino antes de avançar para a próxima etapa.

    nota

    Não deixe de verificar a lista de pré-requisitos de software exigidos pelo SDK escolhido na parte inferior da página do console.

    É preciso ter o software necessário instalado no computador de destino antes de prosseguir para a próxima etapa.

    Depois de escolher a plataforma e linguagem do SDK do dispositivo, selecione Próximo.

    Use o console de AWS IoT para escolher plataforma e SDK.

Etapa 3. Baixe os arquivos no seu dispositivo

Essa página aparece após o AWS IoT criar o kit de conexão, que inclui estes arquivos e recursos necessários para o dispositivo:

  • Os arquivos de certificado do objeto, para autenticar o dispositivo

  • Um recurso de política, para autorizar seu objeto a interagir com o AWS IoT

  • O script, para baixar o SDK do dispositivo da AWS e executar o programa de exemplo no seu dispositivo

  1. Quando estiver pronto para continuar, selecione o botão Baixar kit de conexão para baixar o kit de conexão para a plataforma selecionada anteriormente.

    Esta é a página do console de AWS IoT para baixar o arquivo de certificado.
  2. Se estiver executando este procedimento no seu dispositivo, salve o arquivo do kit de conexão em um diretório a partir do qual você consiga executar comandos de linha de comando.

    Se não estiver executando este procedimento no seu dispositivo, salve o arquivo do kit de conexão em um diretório local e, em seguida, transfira o arquivo para seu dispositivo.

  3. Na seção Descompactar o kit de conexão no seu dispositivo, digite unzip connect_device_package.zip no diretório onde estão os arquivos do kit de conexão.

    Se estiver usando uma janela de comando do Windows PowerShell e o comando unzip não funcionar, substitua unzip por expand-archive e tente usar a linha de comando novamente.

  4. Depois de obter o arquivo do kit de conexão em seu dispositivo, prossiga com o tutorial selecionando Próximo.

    Página de download do arquivo de certificado do console do AWS IoT após o download do kit de conexão.

Etapa 4. Execute a amostra

Este procedimento deve ser realizado em um terminal ou janela de comando no seu dispositivo enquanto você segue as instruções exibidas no console. Os comandos do console são orientados para o sistema operacional selecionado em Etapa 2. Criar um objeto. Aqueles exibidos aqui são orientados para os sistemas operacionais Linux/OSX.

  1. Em um terminal ou janela de comando no seu dispositivo, no diretório com o arquivo do kit de conexão, realize as etapas exibidas no console do AWS IoT.

    Página de início rápido de instalação e execução do console de AWS IoT.
  2. Após inserir o comando da Etapa 2 no console, você deve poder observar uma saída no terminal ou na janela de comando do dispositivo semelhante à seguinte. Essa saída é oriunda das mensagens que o programa está enviando e das quais recebe de volta do AWS IoT Core.

    Saída de programa de exemplo do início rápido no console de AWS IoT.

    Enquanto o programa de exemplo estiver em execução, a mensagem de teste Hello World! também será exibida. A mensagem de teste é exibida no terminal ou na janela de comando do seu dispositivo.

    nota

    Para acessar mais informações sobre a assinatura e publicação de tópicos, consulte o código de exemplo do seu SDK escolhido.

  3. Para executar o programa de exemplo novamente, repita os comandos da Etapa 2 no console deste procedimento.

  4. (Opcional) Se você quiser ver as mensagens do seu cliente de IoT no console do AWS IoT, abra o cliente de teste MQTT na página Teste do console do AWS IoT. Se você selecionou o SDK de Python, no cliente de teste MQTT, em Filtro de tópicos, insira o tópico, como por exemplo, sdk/test/python, para assinar as mensagens do seu dispositivo. Os filtros de tópicos diferenciam maiúsculas de minúsculas e dependem da linguagem de programação do SDK selecionada na Etapa 1. Para acessar mais informações sobre a assinatura e publicação de tópicos, consulte o exemplo de código do seu SDK escolhido.

  5. Depois de assinar no tópico de teste, execute ./start.sh no seu dispositivo. Para obter mais informações, consulte Visualizar mensagens MQTT com o cliente MQTT do AWS IoT.

    Depois de executar ./start.sh, aparecerão mensagens no cliente MQTT, semelhantes à seguinte:

    { "message": "Hello World!" [1] }

    O número de sequence incluído entre [] aumenta em um cada vez que uma nova mensagem Hello World! é recebida e é interrompido quando você encerra o programa.

  6. Para concluir o tutorial e acessar um resumo, no console do AWS IoT, selecione Continuar.

    Página de conclusão de início rápido do console de AWS IoT.
  7. Um resumo do tutorial de conexão rápida do AWS IoT aparecerá agora.

    .Página de resumo do início rápido do console de AWS IoT.

Etapa 5. Explore mais

A seguir estão algumas ideias para explorar o AWS IoT ainda mais após concluir o início rápido.