Monitorar e solucionar problemas do status de uma tarefa FUOTA e dos dispositivos adicionados à tarefa - AWS IoT Wireless

Monitorar e solucionar problemas do status de uma tarefa FUOTA e dos dispositivos adicionados à tarefa

Após provisionar os dispositivos sem fio e criar um grupo de multicast que você queira usar, é possível iniciar uma sessão FUOTA realizando as seguintes etapas.

Status da tarefa FUOTA

Sua tarefa FUOTA pode ter uma das mensagens de status a seguir exibidas no AWS Management Console.

  • Pendente

    Esse status indica que uma tarefa FUOTA foi criada por você, mas ela ainda não tem uma sessão de atualização de firmware. Essa mensagem de status será exibida quando uma tarefa for criada. Durante esse período, é possível atualizar sua tarefa FUOTA e associar ou desassociar dispositivos ou grupos de multicast à tarefa. Após o status mudar de Pendente, dispositivos adicionais não poderão ser adicionados à tarefa.

  • Sessão FUOTA em espera

    Após os dispositivos serem adicionados com êxito à tarefa FUOTA, quando a tarefa tiver uma sessão de atualização de firmware agendada, essa mensagem de status será exibida. Durante esse período, não é possível atualizar ou adicionar dispositivos à sessão FUOTA. Se você cancelar a sessão FUOTA, o status do grupo será alterado para Pendente.

  • Em sessão FUOTA

    Quando a sessão FUOTA começar, essa mensagem de status será exibida. A sessão de fragmentação terá início e os dispositivos finais coletarão os fragmentos, reconstruirão a imagem de firmware, compararão a nova versão do firmware com a versão original e aplicarão a nova imagem.

  • FUOTA concluído

    Após os dispositivos finais informarem o AWS IoT Core for LoRaWAN que a nova imagem de firmware foi aplicada, ou com a expiração da sessão, a sessão FUOTA será marcada como concluída e esse status será exibido.

    Esse status também será exibido em qualquer um dos casos a seguir, portanto, verifique se a atualização de firmware foi aplicada corretamente aos dispositivos.

    • Quando o status da tarefa FUOTA é Sessão FUOTA em espera e há um erro no bucket do S3, como o link para o arquivo de imagem no bucket do S3 estar incorreto ou o AWS IoT Core for LoRaWAN não ter permissões suficientes para acessar o arquivo no bucket.

    • Quando o status da tarefa FUOTA é Sessão FUOTA em espera e há uma solicitação para iniciar uma sessão FUOTA, mas uma resposta não é recebida a partir dos dispositivos ou grupos de multicast na tarefa FUOTA.

    • Quando o status da tarefa FUOTA é Em sessão FUOTA e os dispositivos ou grupos de multicast não enviaram nenhum fragmento por um determinado período de tempo, o que resulta em esgotamento do tempo limite da sessão.

  • Espera de exclusão

    Se você excluir uma tarefa FUOTA que está em algum dos outros estados, esse status será exibido. Uma ação de exclusão é permanente e não pode ser desfeita. Essa ação pode levar tempo e o status da tarefa será Espera de exclusão até a tarefa FUOTA ser excluída. Depois que uma tarefa FUOTA entrar nesse estado, ela não poderá mudar para um dos outros estados.

Status de dispositivos em uma tarefa FUOTA

Os dispositivos em uma tarefa FUOTA podem ter uma das mensagens de status a seguir exibidas no AWS Management Console. É possível passar o mouse sobre cada mensagem de status para acessar mais informações sobre o que ela indica.

  • Inicial

    Quando for o horário de início da sessão FUOTA, o AWS IoT Core for LoRaWAN verifica se o dispositivo tem o pacote compatível para a atualização de firmware. Caso o dispositivo tenha o pacote compatível, a sessão FUOTA do dispositivo será iniciada. A imagem de firmware está fragmentada e os fragmentos são enviados para o dispositivo. Quando esse status é exibido, isso indica que a sessão FUOTA do dispositivo ainda não foi começou.

  • Pacote incompatível

    Caso o dispositivo não tenha o pacote FUOTA compatível, esse status será exibido. Se o pacote de atualização de firmware não for compatível, a sessão FUOTA do dispositivo não poderá ser iniciada. Para solucionar esse erro, verifique se o firmware do dispositivo pode receber atualizações de firmware usando o FUOTA.

  • Algoritmo de fragmentação incompatível

    No início da sessão FUOTA, o AWS IoT Core for LoRaWAN configura uma sessão de fragmentação para o dispositivo. Se esse status for exibido, o tipo de algoritmo de fragmentação usado não pode ser aplicado à atualização de firmware do dispositivo. O erro ocorre porque o dispositivo não tem o pacote FUOTA compatível. Para solucionar esse erro, verifique se o firmware do dispositivo pode receber atualizações de firmware usando o FUOTA.

  • Não há memória suficiente

    Após o AWS IoT Core for LoRaWAN enviar os fragmentos da imagem, os dispositivos finais coletam os fragmentos da imagem e reconstroem a imagem binária a partir desses fragmentos. Esse status é exibido quando o seu dispositivo não tem memória suficiente para juntar os fragmentos de entrada da imagem de firmware, o que pode resultar no encerramento prematuro da sessão de atualização de firmware. Para solucionar o erro, verifique se o hardware do dispositivo é capaz de receber essa atualização. Se o dispositivo não for capaz de receber essa atualização, use uma imagem delta para atualizar o firmware.

  • Índice de fragmentação incompatível

    O índice de fragmentação identifica uma das quatro sessões de fragmentação simultaneamente possíveis. Caso o dispositivo não seja compatível com o valor do índice de fragmentação indicado, esse status será exibido. Para solucionar esse erro, execute um ou mais dos seguintes procedimentos.

    • Inicie uma tarefa FUOTA nova para o dispositivo.

    • Se o erro persistir, mude do modo unicast para o modo multicast.

    • Se o erro ainda não for resolvido, verifique o firmware do seu dispositivo.

  • Erro de memória

    Esse status indica que o dispositivo apresentou um erro de memória ao receber os fragmentos recebidos do AWS IoT Core for LoRaWAN. Se esse erro ocorrer, pode ser que o dispositivo não seja capaz de receber essa atualização. Para solucionar o erro, verifique se o hardware do dispositivo é capaz de receber essa atualização. Se preciso, utilize uma imagem delta para atualizar o firmware do dispositivo.

  • Descritor incorreto

    O dispositivo é incompatível com o descritor indicado. O descritor é um campo que descreve o arquivo a ser transportado na sessão de fragmentação. Se você receber esse erro, entre em contato com o AWS Support Center.

  • Repetição da contagem de sessão

    Esse status indica que o dispositivo já usou essa contagem de sessões anteriormente. Para solucionar o erro, inicie uma nova tarefa FUOTA para o dispositivo.

  • Fragmentos ausentes

    Conforme o dispositivo coleta os fragmentos da imagem do AWS IoT Core for LoRaWAN, ele reconstrói a nova imagem de firmware a partir dos fragmentos codificados e independentes. Se o dispositivo não tiver recebido todos os fragmentos, a nova imagem não poderá ser reconstruída e esse status será exibido. Para solucionar o erro, inicie uma nova tarefa FUOTA para o dispositivo.

  • Erro de MIC

    Quando o seu dispositivo reconstrói a nova imagem de firmware a partir dos fragmentos coletados, ele executa um MIC (Verificação de Integridade da Mensagem) para verificar a autenticidade da imagem e se ela vem da origem correta. Caso o dispositivo detecte uma incompatibilidade no MIC após a remontagem dos fragmentos, esse status será exibido. Para solucionar o erro, inicie uma nova tarefa FUOTA para o dispositivo.

  • Com êxito

    A sessão FUOTA do dispositivo foi obteve êxito.

    nota

    Embora essa mensagem de status indique que os dispositivos reconstruíram a imagem a partir dos fragmentos e que ela foi verificada, o firmware do dispositivo pode não ter sido atualizado quando o dispositivo relata o status para o AWS IoT Core for LoRaWAN. Verifique se o firmware do seu dispositivo foi atualizado.

Próximas etapas

Você aprendeu sobre os diferentes status da tarefa FUOTA e seus dispositivos e como pode solucionar qualquer problema. Para acessar mais informações sobre cada um desses status, consulte a Especificação de transporte de blocos de dados fragmentados LoRaWAN, TS004-1.0.0.