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

Solução de problemas

Cada execução do conjunto de testes tem um ID de execução exclusivo que é usado para criar uma pasta chamada results/execution-id no diretório results. Os logs individuais do grupo de testes estão no diretório results/execution-id/logs. Use a saída do console do IDT para FreeRTOS para encontrar o ID de execução, o ID do caso de teste e o ID do grupo de testes do caso de teste que falhou, e abra o arquivo de log para esse caso de teste chamado results/execution-id/logs/test_group_id__test_case_id.log. As informações desse arquivo incluem:

Recomendamos o seguinte fluxo de trabalho para solucionar problemas:

Solução de problemas de configuração de dispositivos

Ao usar o IDT para FreeRTOS, é preciso obter os arquivos de configuração corretos antes de executar o binário. Se você estiver recebendo erros de análise e configuração, o primeiro passo deve ser localizar e usar um modelo de configuração apropriado para seu ambiente. Esses modelos estão localizados no diretório IDT_ROOT/configs.

Se você ainda estiver com problemas, consulte o processo de depuração a seguir.

Onde eu procuro?

Comece lendo a saída do console para encontrar informações, como o UUID de execução, que é referido como nesta documentação execution-id.

Depois, examine o arquivo FRQ_Report.xml no diretório /results/execution-id. Este arquivo contém todos os casos de teste que foram executados e os trechos com erros para cada falha. Para obter todos os logs de execução, procure o arquivo para cada caso de teste /results/execution-id/logs/test_group_id__test_case_id.log.

Códigos de erro de IDT

A tabela a seguir explica os códigos de erro gerados pelo IDT para FreeRTOS:

Depuração de erros de análise

Ocasionalmente, um erro ortográfico em uma configuração JSON pode resultar em erros de análise. Na maioria dos casos, o problema é resultado da omissão de um colchete, vírgula ou aspas de seu arquivo JSON. O IDT para FreeRTOS executa a validação do JSON e imprime as informações de depuração. Ele imprime a linha em que ocorreu o erro, o número da linha e o número da coluna do erro de sintaxe. Essas informações devem ser suficientes para ajudá-lo a corrigir o erro, mas se você ainda tiver problemas para localizar o erro, poderá realizar a validação manualmente em seu IDE, em um editor de texto como Atom ou Sublime ou por meio de uma ferramenta on-line como. JSONLint

Depuração de falhas na verificação de integridade

Ao executar o grupo de RTOSIntegrity teste Free e encontrar falhas, primeiro certifique-se de não ter modificado nenhum dos arquivos do freertos diretório. Se não fez isso e ainda está tendo problemas, verifique se está usando a ramificação correta. Se executar o comando list-supported-products do IDT, poderá descobrir qual ramificação marcada do repositório freertos deve ser usada.

Se clonou a ramificação marcada correta do repositório freertos e ainda tiver problemas, verifique se também executou o comando submodule update. O fluxo de trabalho de clonagem para o repositório freertos é o seguinte.

git clone --branch version-number https://github.com/aws/amazon-freertos.git
cd amazon-freertos
git submodule update --checkout —init —recursive

A lista de arquivos que o verificador de integridade procura está no arquivo checksums.json em seu diretório freertos. Para qualificar uma porta do FreeRTOS sem nenhuma modificação nos arquivos e na estrutura de pastas, verifique se nenhum dos arquivos listados nas seções "exhaustive" e "minimal" do arquivo checksums.json foi modificado. Para executar com um SDK configurado, verifique se nenhum dos arquivos na seção "minimal" foi modificado.

Se o IDT for executado com um SDK e alguns arquivos em seu diretório freertos tiverem sido modificados, certifique-se de configurar corretamente o SDK em seu arquivo userdata. Caso contrário, o verificador de integridade verificará todos os arquivos no diretório freertos.

Depurando falhas do grupo de teste FullWiFi

Se você observar falhas no grupo de FullWiFi teste e o teste "AFQP_WiFiConnectMultipleAP" falhar, isso pode ser porque os dois pontos de acesso não estão na mesma sub-rede do computador host que executa o IDT. Verifique se os dois pontos de acesso estão na mesma sub-rede do computador host que executa o IDT.

Depuração de erro de "parâmetro necessário ausente"

Como novos recursos estão sendo adicionados ao IDT para FreeRTOS, os arquivos de configuração podem sofrer alterações. O uso de um arquivo de configuração antigo pode danificar sua configuração. Se isso acontecer, o arquivo test_group_id__test_case_id.log no diretório results/execution-id/logs listará explicitamente todos os parâmetros ausentes. O IDT para FreeRTOS valida os esquemas do arquivo de configuração JSON para garantir que a versão compatível mais recente foi usada.

Depuração de erro de "não é possível iniciar teste"

Você pode encontrar erros que apontam para falhas ao iniciar o teste. Como existem várias causas possíveis, verifique se há algum problema nas seguintes áreas:

Depuração de erro de "não autorizado para acessar um recurso"

Você pode ver o erro "não user/role está autorizado a acessar este recurso” na saída do terminal ou no test_manager.log arquivo abaixo/results/execution-id/logs. Para resolver este problema, anexe a política gerenciada AWSIoTDeviceTesterForFreeRTOSFullAccess ao usuário de teste. Para obter mais informações, consulte .

Depuração de erros de teste de rede

Para testes com base em rede, o IDT inicia um servidor de eco que vincula a uma porta não reservada na máquina host. Se você estiver enfrentando erros devido a tempos limite ou conexões indisponíveis nos testes de soquetes seguros WiFi ou de soquetes seguros, certifique-se de que sua rede esteja configurada para permitir tráfego para portas configuradas na faixa de 1024 a 49151.

O teste de soquetes seguros usa as portas 33333 e 33334 por padrão. Os WiFi testes usam a porta 33335 por padrão. Se essas três portas estiverem em uso ou bloqueadas por firewall ou rede, opte por usar portas diferentes em userdata.json para testes. Para obter mais informações, consulte Configuração de parâmetros de compilação, atualização e teste. Você pode usar os seguintes comandos para verificar se uma porta específica está em uso:

Falhas de atualização de OTA devido à mesma carga útil de versão

Se os casos de teste OTA estiverem falhando por a mesma versão estar no dispositivo depois que uma OTA foi executada, pode ser que o seu sistema de compilação (por exemplo, cmake) não notou as alterações do IDT ao código-fonte do FreeRTOS e não criou um binário atualizado. Isso faz com que o OTA seja executado com o mesmo binário que está atualmente no dispositivo e o teste falhe. Para solucionar problemas de falhas de atualização OTA, comece certificando-se de que você está usando a versão mais recente com suporte do sistema de compilação.

Falha no teste de OTA no caso de teste de PresignedUrlExpired

Um pré-requisito deste teste é que o tempo de atualização OTA deve ser superior a 60 segundos, caso contrário o teste falharia. Se isso ocorrer, a seguinte mensagem de erro é encontrada no log: “Teste leva menos de 60 segundos (tempo expirado da url) para concluir. Por favor, entre em contato conosco."

Depuração erros de porta e de interface de dispositivo

Esta seção contém informações sobre as interfaces de dispositivo usadas pelo IDT para se conectar aos dispositivos.

Plataformas compatíveis

O IDT é compatível com Linux, macOS e Windows. Todas as três plataformas têm diferentes esquemas de nomenclatura para os dispositivos seriais que se conectam a elas:

Para verificar a porta do dispositivo:

Para verificar qual dispositivo está conectado a uma porta:

Interfaces de dispositivo

Cada dispositivo incorporado é diferente, o que significa que ele pode ter uma ou mais portas seriais. É comum que os dispositivos tenham duas portas quando conectados a uma máquina:

Leitura de dados de dispositivo

O IDT para FreeRTOS usa ferramentas individuais de compilação e atualização de dispositivos para especificar a configuração da porta. Se você estiver testando o dispositivo e não obtiver a saída, tente as seguintes configurações padrão:

Essas configurações são processadas pelo IDT para FreeRTOS. Você não precisa defini-los. No entanto, você pode usar o mesmo método para ler a saída do dispositivo manualmente. No Linux ou macOS, você pode fazer isso com o comando screen. No Windows, você pode usar um programa como TeraTerm.

Screen: screen /dev/cu.usbserial 115200

TeraTerm: Use the above-provided settings to set the fields explicitly in the GUI.

Problemas de cadeia de ferramentas de desenvolvimento

Esta seção aborda os problemas que podem ocorrer com a cadeia de ferramentas.

Code Composer Studio no Ubuntu

As versões mais recentes do Ubuntu (17.10 e 18.04) têm uma versão do pacote glibc que não é compatível com as versões 7.x do Code Composer Studio. Recomendamos que você instale o Code Composer Studio versão 8.2 ou mais recente.

Os sintomas de incompatibilidade podem incluir:

Registro em log

Os logs do IDT para FreeRTOS são armazenados em um único local. No diretório raiz do IDT, esses arquivos estão disponíveis em results/execution-id/:

FRQ_Report.xml e logs/test_group_id__test_case_id.log são os logs mais importantes a serem examinados. FRQ_Report.xml contém informações sobre quais casos de teste falharam com uma mensagem de erro específica. Depois, é possível usar logs/test_group_id__test_case_id.log para ver mais detalhes sobre o problema, a fim de obter um contexto melhor.

Erros do console

Quando AWS IoT Device Tester é executado, as falhas são reportadas ao console com mensagens breves. Examine results/execution-id/logs/test_group_id__test_case_id.log para saber mais sobre o erro.

Erros de logs

Cada execução do conjunto de testes tem um ID de execução exclusivo usado para criar uma pasta chamada results/execution-id. Os logs de casos de testes individuais estão no diretório results/execution-id/logs. Use a saída do console do IDT para FreeRTOS a fim de localizar o ID de execução, o ID de caso de teste e o ID de grupo de teste do caso de teste que falhou. Em seguida, use essas informações para localizar e abrir o arquivo de log desse caso de teste chamado results/execution-id/logs/test_group_id__test_case_id.log As informações nesse arquivo incluem a saída completa dos comandos de compilação e flash, a saída da execução do teste e a saída mais detalhada AWS IoT Device Tester do console.

Problemas de bucket do S3

Se pressionar CTRL+C enquanto executa o IDT, o IDT iniciará um processo de limpeza. Parte dessa limpeza é remover os recursos do Amazon S3 que foram criados como parte dos testes do IDT. Se a limpeza não puder ser concluída, você poderá ter um problema em que muitos buckets do Amazon S3 foram criados. Isso significa que na próxima vez que você executar o IDT, os testes começarão a falhar.

Se pressionar CTRL+C para interromper o IDT, deverá deixá-lo concluir o processo de limpeza para evitar este problema. Você também pode excluir os buckets do Amazon S3 da sua conta que foram criados manualmente.

Solução de erros de tempo limite

Se você encontrar erros de tempo limite ao executar um conjunto de testes, aumente o tempo limite especificando um fator multiplicador. Esse fator é aplicado ao valor de tempo limite padrão. Qualquer valor configurado para esse sinalizador deve ser maior que ou igual a 1.0. Para usar o multiplicador de tempo limite, use o sinalizador --timeout-multiplier ao executar o conjunto de testes.

Recurso e AWS cobranças do celular

Quando o Cellular recurso estiver configurado Yes em seu device.JSON arquivo, FullSecureSockets usará EC2 instâncias t.micro para executar testes e isso poderá gerar custos adicionais em sua AWS conta. Para obter mais informações, consulte os EC2 preços da Amazon.

Política de geração de relatórios de qualificação

Os relatórios de qualificação são gerados somente pelas versões AWS IoT Device Tester (IDT) que oferecem suporte às versões do FreeRTOS lançadas nos últimos dois anos. Se tiver dúvidas sobre a política de suporte, entre em contato com o AWS Support.