Conceitos básicos do Device Advisor no console - AWS IoT Core

Conceitos básicos do Device Advisor no console

Este tutorial ajuda você nos conceitos básicos do AWS IoT Core Device Advisor no console. O Device Advisor oferece recursos como testes obrigatórios e relatórios de qualificação assinados. Você pode usar esses testes e relatórios para qualificar e listar dispositivos no Catálogo de dispositivos do parceiro da AWS, conforme detalhado no programa de qualificação do AWS IoT Core.

Para obter mais informações sobre o uso do Device Advisor, consulte Fluxo de trabalho do Device Advisor e Fluxo de trabalho detalhado do console do Device Advisor.

Para concluir este tutorial, siga as etapas descritas em Configurando.

nota

O Device Advisor é compatível com as seguintes Regiões da AWS:

  • Leste dos EUA (N. da Virgínia)

  • Oeste dos EUA (Oregon)

  • Ásia-Pacífico (Tóquio)

  • Europa (Irlanda)

Conceitos básicos

  1. No painel de navegação do console AWS IoT, em Teste, escolha Device Advisor. Em seguida, escolha o botão Iniciar passo a passo no console.

    O Device Advisor é um recurso de teste totalmente gerenciado para dispositivos de IoT para validar a interação segura com AWS IoT Core, identificar problemas de software e obter resultados de testes.

  2. A página Conceitos básicos do Device Advisor fornece uma visão geral das etapas necessárias para criar um conjunto de testes e executar testes no dispositivo. Você também pode encontrar o endpoint de teste do Device Advisor para sua conta aqui. Você deve configurar o firmware ou o software no dispositivo usado para o teste para se conectar a esse endpoint de teste.

    Para concluir as etapas neste tutorial, primeiro é preciso criar um objeto e um certificado. Depois de revisar as informações em Como funciona, escolha Próximo.

    Etapas para testar a conectividade dos dispositivos de IoT: selecione o protocolo, crie um conjunto de testes, defina as configurações do dispositivo.

  3. Na Etapa 1: selecionar um protocolo, selecione um protocolo nas opções listadas. Em seguida, escolha Próximo.

    Interface do Device Advisor mostrando opções para selecionar um protocolo de comunicação (MQTT 3.1.1, MQTT 3.1.1 sobre WebSocket, MQTT 5, MQTT 5 sobre WebSocket) para testar um dispositivo de IoT.

  4. Na Etapa 2, você cria e configura um conjunto de testes personalizado. Um conjunto de testes personalizado deve ter pelo menos um grupo de teste, e cada grupo de teste deve ter pelo menos um caso de teste. Adicionamos o caso de teste do MQTT Connect para você começar.

    Escolha Propriedades do conjunto de testes.

    A tela “Criar pacote de testes” no Device Advisors, na qual os usuários podem criar e configurar grupos e casos de teste para testar dispositivos de IoT com o protocolo MQTT.

    Forneça as propriedades do conjunto de testes ao criar o conjunto de testes. Você pode configurar as seguintes propriedades em nível de conjunto:

    • Nome do conjunto de testes: insira um nome para o conjunto de testes.

    • Tempo limite (opcional): o tempo limite (em segundos) para cada caso de teste no conjunto de testes atual. Se você não especificar um valor, o valor padrão será usado.

    • Tags (opcional): adicione tags ao conjunto de testes.

    Quando terminar, escolha Atualizar propriedades.

    Formulário para atualizar as propriedades de um pacote de testes, incluindo nome, tempo limite e capacidade de adicionar tags. Contém um botão “Atualizar propriedades”.

  5. (Opcional) Para atualizar a configuração do grupo do conjunto de testes, escolha o botão Editar ao lado do nome do grupo de teste.

    • Nome: insira um nome para o grupo de conjunto de teste.

    • Tempo limite (opcional): o tempo limite (em segundos) para cada caso de teste no conjunto de testes atual. Se você não especificar um valor, o valor padrão será usado.

    Ao terminar, escolha Concluído para continuar.

    Um grupo de teste chamado “Grupo de teste 1" é exibido com opções para configurar o tempo limite e adicionar grupos de teste.

  6. (Opcional) Para atualizar a configuração de um caso de teste, escolha o botão Editar ao lado do nome do caso de teste.

    • Nome: insira um nome para o grupo de conjunto de teste.

    • Tempo limite (opcional): o tempo limite (em segundos) para o caso de teste selecionado. Se você não especificar um valor, o valor padrão será usado.

    Ao terminar, escolha Concluído para continuar.

    A interface “Criar pacote de testes” que mostra opções para configurar um pacote de testes, grupos de teste e casos de teste individuais para testar dispositivos de IoT.

  7. (Opcional) Para adicionar mais grupos de teste ao conjunto de testes, escolha Adicionar grupo de teste e siga as instruções na Etapa 5.

  8. (Opcional) Para adicionar mais casos de teste, arraste os casos de teste na seção Casos de teste para qualquer um dos grupos de teste.

    A interface “Criar pacote de testes” em que os usuários podem configurar grupos de teste e casos de teste para teste de protocolo MQTT para dispositivos IoT.

  9. Você pode alterar a ordem dos grupos de teste e casos de teste. Para fazer alterações, arraste os casos de teste listados para cima ou para baixo na lista. O Device Advisor executa testes na ordem em que você os listou.

    Depois de configurar o conjunto de testes, escolha Próximo.

  10. Na Etapa 3, selecione um objeto ou certificado da AWS IoT para testar usando o Device Advisor. Se você não tiver nenhum objeto ou certificado existente, consulte Configuração.

    As opções de configuração que incluem selecionar um protocolo, criar um pacote de testes, definir as configurações do dispositivo e revisar as execuções e os resultados dos testes.

  11. Você pode configurar um perfil de dispositivo que o Device Advisor usa para realizar ações do MQTT da AWS IoT em nome do dispositivo de teste. Somente para o caso de teste do MQTT Connect, a ação Conectar é selecionada automaticamente. Isso ocorre porque o perfil do dispositivo exige essa permissão para executar o conjunto de testes. Para outros casos de teste, as ações correspondentes são selecionadas.

    Forneça os valores dos recursos para cada uma das ações selecionadas. Por exemplo, para a ação Conectar, forneça o ID do cliente que o dispositivo usa para se conectar ao endpoint do Device Advisor. Você pode fornecer vários valores com valores separados por vírgula e valores de prefixo com um caractere curinga (*). Por exemplo, para fornecer permissão para publicar em qualquer tópico que comece com MyTopic, insira MyTopic* como valor do recurso.

    A interface do Device Advisor, na qual você pode selecionar uma função de dispositivo e definir permissões para conectar, publicar, assinar e gerenciar tópicos e IDs de clientes do MQTT.

    Para usar um perfil de dispositivo criado anteriormente em Configuração, escolha Selecionar um perfil existente. Em seguida, escolha o perfil do dispositivo em Selecionar perfil.

    Uma interface de formulário web para selecionar uma função de dispositivo, com opções para criar uma função ou selecionar uma função existente chamada “DeviceAdvisorServiceRole”.

    Configure o perfil do dispositivo com uma das duas opções fornecidas e escolha Próximo.

  12. Na seção Endpoint de teste, selecione o endpoint que melhor se adapta ao caso de uso. Para executar vários conjuntos de testes simultaneamente com a mesma Conta da AWS, selecione Endpoint em nível de dispositivo. Para executar um conjunto de testes por vez, selecione Endpoint em nível de conta.

    Opções para selecionar o endpoint no nível da conta ou no nível do dispositivo para teste, com uma URL de endpoint fornecida e o botão Avançar.

  13. A Etapa 4 mostra uma visão geral do dispositivo de teste selecionado, do endpoint de teste, do conjunto de testes e do perfil do dispositivo de teste configurados. Selecione o botão Editar para qualquer seção que você deseja editar. Depois de confirmar a configuração de teste, escolha Executar para criar o conjunto de testes e executá-los.

    nota

    Para obter melhores resultados, você pode conectar o dispositivo de teste selecionado ao endpoint de teste do Device Advisor antes de iniciar a execução do conjunto de testes. Recomendamos que você tenha um mecanismo criado para que o dispositivo tente se conectar ao nosso endpoint de teste a cada cinco segundos por até um a dois minutos.

    Um console de configuração de dispositivos que mostra detalhes da função do dispositivo, endpoint de teste e opções para cancelar, voltar ou executar.
    Um console de configuração de dispositivos que mostra detalhes da função do dispositivo, endpoint de teste e opções para cancelar, voltar ou executar.

  14. No painel de navegação, em Teste, escolha Device Advisor e, em seguida, escolha Execuções e resultados de testes. Selecione uma execução do conjunto de testes para ver os detalhes e os logs da execução.

    A interface do conjunto de testes que indica que um teste MQTT 3.1.1 está em andamento para o dispositivo “MyThing”.

  15. Para acessar os logs do Amazon CloudWatch para a execução do conjunto:

    • Escolha Log do conjunto de teste para visualizar os logs do CloudWatch para a execução do conjunto de testes.

    • Escolha Log do caso de teste para qualquer caso de teste a fim de visualizar os logs do CloudWatch específicos do caso de teste.

  16. Com base nos resultados do teste, solucione os problemas do dispositivo até que todos os testes sejam aprovados.