Este tópico descreve os códigos de erro que o IoT Platform pode retornar aos dispositivos.
Códigos de erro comuns
|
Código de erro |
Causa |
Solução de problemas |
|
400 |
Ocorreu um erro durante o processamento da solicitação. |
Envie um ticket. |
|
429 |
O limitador de tráfego foi acionado devido à alta frequência de solicitações. |
Envie um ticket. |
|
460 |
Os dados enviados pelo dispositivo estão vazios, o formato do parâmetro é inválido ou a quantidade de parâmetros excede o limite permitido. |
Verifique os parâmetros com base nos formatos de dados descritos no tópico Protocolo Alink. |
|
500 |
Ocorreu um erro desconhecido no IoT Platform. |
Envie um ticket. |
|
5005 |
Falha ao consultar as informações do produto. |
Verifique as informações do produto no console do IoT Platform e certifique-se de que o ProductKey seja válido. |
|
5244 |
Erro na consulta dos metadados do produto baseado em LoRaWAN. |
Envie um ticket. |
|
6100 |
Problema ao buscar dados sobre o dispositivo especificado. |
Confira as informações do dispositivo na página Devices do console do IoT Platform. |
|
6203 |
O sistema encontrou uma falha ao analisar o tópico. |
Envie um ticket. |
|
6250 |
Não foi possível obter os detalhes do produto. |
Valide as informações do produto no console do IoT Platform e confirme se o ProductKey está correto. |
|
6204 |
O dispositivo indicado está desativado, impedindo a execução de operações. |
Consulte o status do dispositivo na página Devices do console do IoT Platform. |
|
6450 |
O parâmetro method está ausente após a conversão dos dados personalizados para o formato padrão Alink. |
Na página Device Log do console do IoT Platform ou no arquivo de log local do dispositivo, verifique se os dados enviados contêm o parâmetro method. |
|
6760 |
Uma exceção do sistema foi detectada. |
Envie um ticket. |
Código de erro | Causa | Solução de problemas |
26001 | O sistema não localizou um script de análise. | Acesse a página Data Parsing no console do IoT Platform e garanta que o script tenha sido enviado. Nota Não é possível executar scripts que não foram enviados. |
26002 | O script executa conforme esperado, mas seu conteúdo é inválido. Por exemplo, pode conter erros de sintaxe. | Utilize os mesmos dados para testar o script. Analise a mensagem de erro e modifique-o conforme necessário. Recomendamos testar o script em um dispositivo local antes de enviá-lo ao IoT Platform. |
26006 | A execução do script ocorre normalmente, porém o conteúdo apresenta inconsistências. É obrigatório incluir os métodos protocolToRawData e rawDataToProtocol. A ausência desses métodos gera erro. | Navegue até a página Data Parsing do console do IoT Platform e confirme a existência dos métodos protocolToRawData e rawDataToProtocol. |
26007 | Embora o script execute corretamente, o formato da resposta é inválido. Os métodos protocolToRawData e rawDataToProtocol são obrigatórios. O método protocolToRawData deve retornar um array byte[], enquanto rawDataToProtocol precisa retornar um objeto JSON. Respostas fora desse padrão causam falhas. | Teste o script no console do IoT Platform ou em um dispositivo local para validar o formato da resposta. |
26010 | O excesso de requisições ativou o controle de fluxo. | Envie um ticket. |
Código de erro | Causa | Solução de problemas |
5159 | Falha na consulta das propriedades definidas durante a validação de parâmetros pelo modelo TSL. | Envie um ticket. |
5160 | Impossível recuperar os eventos configurados ao verificar parâmetros via modelo TSL. | Envie um ticket. |
5161 | Erro ao buscar serviços definidos na etapa de verificação de parâmetros do modelo TSL. | Envie um ticket. |
6207 | Os dados Alink enviados pelo dispositivo ou resultantes da análise de dados personalizados não estão no formato JSON. | Consulte os formatos de dados no tópico Propriedades, eventos e serviços do dispositivo e envie os dados seguindo os padrões exigidos. |
6300 | O parâmetro method, exigido pelo protocolo Alink, não consta nos dados padrão ou nos dados personalizados analisados enviados pelo dispositivo. | Na página Device Log do console do IoT Platform ou no arquivo de log local, confirme se os dados transmitidos incluem o parâmetro method. |
6301 | Durante a validação baseada no modelo TSL, o tipo de dado foi definido como array, mas o dispositivo enviou dados em outro formato. | Acesse a aba Define Feature do produto no console do IoT Platform e revise o tipo de dado definido no modelo TSL. Envie os dados respeitando o tipo especificado. |
6302 | Os parâmetros de entrada obrigatórios do serviço não foram fornecidos. | Faça login no console do IoT Platform e examine o modelo TSL. Assegure-se de que todos os parâmetros de entrada necessários estejam definidos. |
6306 | Ao validar parâmetros segundo o modelo TSL, podem ocorrer as seguintes falhas:
| Acesse o console do IoT Platform e revise o modelo TSL. Confirme se os tipos de dados dos parâmetros de entrada correspondem às definições do modelo e se os valores estão dentro dos intervalos permitidos. |
6307 | Os parâmetros de entrada não atendem às especificações de ponto flutuante de 32 bits do modelo TSL. Durante a validação, podem surgir estes problemas:
| |
6308 | Os parâmetros de entrada violam as regras de dados booleanos do modelo TSL. Na verificação baseada no modelo, podem ocorrer:
| |
6310 | Os parâmetros de entrada não cumprem as especificações de texto do modelo TSL. Ao validar conforme o modelo, podem ser detectados:
| |
6322 | Os parâmetros de entrada não seguem as especificações de ponto flutuante de 64 bits do modelo TSL. Durante a validação, podem ocorrer:
| |
6304 | Os parâmetros de entrada não existem na estrutura definida pelo modelo TSL. | Entre no console do IoT Platform e verifique o modelo TSL. Certifique-se de que os tipos de dados dos parâmetros de entrada sejam válidos. |
6309 | Os parâmetros de entrada não obedecem às especificações de enumeração do modelo TSL. | |
6311 | Os parâmetros de entrada não respeitam as especificações de data do modelo TSL. Na validação baseada no modelo, podem ocorrer:
| |
6312 | Os parâmetros de entrada não estão em conformidade com as especificações de estrutura do modelo TSL. Durante a verificação, podem ser identificados:
| |
6320 | A propriedade especificada não foi encontrada na consulta aos dados TSL do dispositivo. | Faça login no console do IoT Platform e verifique se a propriedade existe no modelo TSL. Caso não exista, adicione-a. |
6321 | O identificador da propriedade, evento ou serviço não foi especificado. | Envie um ticket. |
6317 | Parâmetros obrigatórios do modelo TSL não foram configurados, como type e specs. | Envie um ticket. |
6324 | Os parâmetros de entrada não seguem as especificações de array do modelo TSL. Durante a validação, podem ocorrer:
|
|
6325 | Os tipos de dados dos elementos do array não são suportados pelo IoT Platform. Apenas os seguintes tipos são aceitos: integer, ponto flutuante de 32 bits, ponto flutuante de 64 bits, double, texto e estrutura. | Verifique se os tipos de dados dos elementos são compatíveis com o IoT Platform. |
6326 | O formato do campo de tempo enviado pelo dispositivo é inválido. | Consulte os formatos de dados no tópico Propriedades, eventos e serviços do dispositivo e envie os dados nos formatos exigidos. |
6328 | O valor do parâmetro de entrada não é um array. | Entre no console do IoT Platform e revise o modelo TSL. Garanta que o tipo de dado do parâmetro de entrada seja array. |
6318 | Ocorreu um erro de sistema durante a análise do modelo TSL. | Envie um ticket. |
6313 | ||
6329 | ||
6323 | ||
6316 | ||
6314 | ||
6301 |
Códigos de erro para registro de dispositivos
-
Registrar dispositivos conectados diretamente
Tópico de solicitação:
/sys/${productKey}/${deviceName}/thing/sub/registerTópico de resposta:
/sys/${productKey}/${deviceName}/thing/sub/register_reply
Códigos de erro: 460, 5005, 5244, 500, 6288, 6100, 6619, 6292 e 6203
A tabela abaixo detalha causas e soluções para erros comuns durante o registro de dispositivos conectados diretamente. Para outros códigos, consulte a seção "Códigos de erro comuns" deste tópico.
Código de erro
Causa
Solução de problemas
6288
O registro dinâmico está desabilitado para este dispositivo.
Faça login no console do IoT Platform e ative o registro dinâmico na página de detalhes do produto.
6619
O dispositivo já está vinculado a outro gateway.
Acesse a aba Device Details no console do IoT Platform e verifique se há vínculo com algum gateway.
-
Registro dinâmico de dispositivos conectados diretamente com autenticação por certificado único por produto
Códigos de erro: 460, 6250, 6288, 6600, 6289, 500 e 6292
A tabela a seguir apresenta causas e resoluções para falhas no registro dinâmico baseado em certificado único por produto. Consulte a seção "Códigos de erro comuns" para informações sobre outros códigos.
Código de erro
Causa
Solução de problemas
6288
Registro dinâmico desativado para o dispositivo.
Entre no console do IoT Platform e ative o registro dinâmico nos detalhes do produto.
6292
O algoritmo usado para calcular a assinatura não é suportado pelo IoT Platform.
Utilize um algoritmo compatível com o parâmetro signMethod. Saiba mais em Registro de dispositivos.
6600
Falha na verificação da assinatura.
Calcule a assinatura usando um algoritmo suportado e tente novamente. Detalhes em Registrar dispositivos.
6289
O dispositivo já foi ativado.
Consulte o status do dispositivo no console do IoT Platform.
Códigos de erro para relações topológicas
-
Adicionar relações topológicas
Tópico de solicitação:
/sys/${productKey}/${deviceName}/thing/topo/addTópico de resposta:
/sys/${productKey}/${deviceName}/thing/topo/add_reply
Códigos de erro: 460, 429, 6402, 6100, 401, 6204, 6400 e 6203
A tabela abaixo lista causas e soluções para erros ao adicionar relações topológicas entre gateway e subdispositivo. Veja a seção "Códigos de erro comuns" para demais códigos.
Código de erro
Causa
Solução de problemas
401
A verificação da assinatura falhou ao tentar adicionar a relação topológica.
Recalcule a assinatura com um algoritmo suportado e valide novamente. Mais informações em Gerenciar relações topológicas.
6402
Gateway e subdispositivo são o mesmo dispositivo. Não é permitido adicionar o próprio gateway como seu subdispositivo.
Revise as informações de todos os subdispositivos existentes e verifique se há duplicidade com o gateway.
6400
O número de subdispositivos adicionados ao gateway ultrapassou o limite.
No console do IoT Platform, confira a quantidade atual de subdispositivos na aba Sub-device Management. Consulte Limites para saber os limites aplicáveis.
-
Excluir relações topológicas
Tópico de solicitação:
/sys/${productKey}/${deviceName}/thing/topo/deleteTópico de resposta:
/sys/${productKey}/${deviceName}/thing/topo/delete_reply
Códigos de erro: 460, 429, 6100, 6401 e 6203
A tabela a seguir descreve causa e solução para erros na exclusão de relações topológicas entre gateway e subdispositivo. Outros códigos estão na seção "Códigos de erro comuns".
Código de erro
Causa
Solução de problemas
6401
A relação topológica não existe.
No console do IoT Platform, clique em Devices no painel de navegação à esquerda. Em seguida, acesse a aba Sub-device Management na página Device Details do gateway para visualizar as informações do subdispositivo.
-
Obter relações topológicas
Tópico de solicitação:
/sys/${productKey}/${deviceName}/thing/topo/getTópico de resposta:
/sys/${productKey}/${deviceName}/thing/topo/get_reply
Códigos de erro: 460, 429, 500 e 6203
Para detalhes sobre esses códigos, consulte a seção "Códigos de erro comuns" deste tópico.
-
Gateway envia informações sobre subdispositivo detectado
Tópico de solicitação:
/sys/${productKey}/${deviceName}/thing/list/foundTópico de resposta:
/sys/${productKey}/${deviceName}/thing/list/found_reply
Códigos de erro: 460, 500, 6250, 6280 e 6203
A tabela abaixo indica causa e solução para erros quando um gateway reporta um subdispositivo detectado. Demais códigos constam na seção "Códigos de erro comuns".
Código de erro
Causa
Solução de problemas
6280
O nome do subdispositivo enviado pelo gateway é inválido. Deve ter entre 4 e 32 caracteres, contendo apenas letras, dígitos e underscores (_).
Valide o nome do subdispositivo informado pelo gateway.
Códigos de erro para conexão e desconexão de subdispositivos
-
Subdispositivo fica online
Tópico para envio de mensagens de erro:
/ext/session/{productKey}/{deviceName}/combine/logout_replyCódigos de erro: 460, 429, 6100, 6204, 6287, 6401, 500, 9241 e 9240
-
Subdispositivo fica offline
Tópico para envio de mensagens de erro:
/ext/session/{productKey}/{deviceName}/combine/logout_replyCódigos de erro: 460, 520 e 500
-
Subdispositivo forçado a ficar offline
Tópico para envio de mensagens de erro:
/ext/error/{productKey}/{deviceName}Códigos de erro: 427, 521, 522 e 6401
-
Falha no envio de mensagem pelo subdispositivo
Tópico para envio de mensagens de erro:
/ext/error/{productKey}/{deviceName}Código de erro: 520
-
Gateway falha ao enviar múltiplas mensagens de subdispositivos ao IoT Platform
Tópico para envio de mensagens de erro:
/sys/${productKey}/${deviceName}/proxy/batch_post_replyCódigo de erro: 9242
A tabela a seguir descreve causas e soluções para erros durante a transição de status online/offline de subdispositivos. Consulte a seção "Códigos de erro comuns" para outros casos.
Código de erro | Causa | Solução de problemas |
427 | O dispositivo foi forçado a ficar offline porque seu certificado está sendo usado por outro dispositivo. O IoT Platform identifica dispositivos exclusivamente pelas informações do certificado (ProductKey, DeviceName e DeviceSecret).
|
|
428 | A quantidade de subdispositivos associados ao gateway excedeu o limite permitido. Saiba mais em Limites. | Verifique quantos subdispositivos estão vinculados ao gateway. |
521 | O dispositivo foi excluído. | Acesse a página Devices no console do IoT Platform e confirme se o dispositivo foi removido. |
522 | O dispositivo está desabilitado. | Verifique o status na página Devices do console do IoT Platform. |
520 | Erro na sessão entre o subdispositivo e o IoT Platform.
| |
6287 | Falha na verificação da assinatura baseada no ProductSecret ou DeviceSecret. | Calcule a assinatura com um algoritmo suportado e valide novamente. Consulte Conectar ou desconectar subdispositivos. |
1914 | O número de subdispositivos conectados ou desconectados simultaneamente excede o limite máximo de cinco. | Verifique se a quantidade de subdispositivos sendo conectados ou desconectados ao mesmo tempo respeita o limite. |
1913 | O gateway perdeu a conexão com o IoT Platform. | Analise os logs para identificar o motivo da desconexão do gateway. |
9242 | O gateway enviou mais de 50 mensagens de subdispositivos de uma só vez, ultrapassando o limite. | Confira se o volume de mensagens de subdispositivos enviadas está dentro do limite. |
9241 | Não é possível alterar o tipo de dispositivo de um dispositivo online ao conectá-lo via gateway. Para entender os tipos de dispositivo, consulte o parâmetro conntype em Conectar um cliente MQTT ao IoT Platform. | Verifique se o gateway e o subdispositivo estão online. |
9240 | Ao conectar ou desconectar múltiplos subdispositivos, o total de subdispositivos no gateway em modo relacionado a status superou o limite de 10.000. | Confirme se a quantidade de subdispositivos conectados ou desconectados simultaneamente está dentro do limite. |
Códigos de erro para propriedades, eventos e serviços
-
Dispositivo envia propriedades
-
Formato de dados pass-through:
Tópico de solicitação:
/sys/{productKey}/{deviceName}/thing/model/up_rawTópico de resposta:
/sys/${productKey}/${deviceName}/thing/model/up_raw_reply
-
Formato de dados Alink:
Tópico de solicitação:
/sys/${productKey}/${deviceName}/thing/event/property/postTópico de resposta:
/sys/${productKey}/${deviceName}/thing/event/property/post_reply
Códigos de erro: 460, 500, 6250, 6203, 6207, 6313, 6300, 6320, 6321, 6326, 6301, 6302, 6317, 6323, 6316, 6306, 6307, 6322, 6308, 6309, 6310, 6311, 6312, 6324, 6328, 6325, 6200, 6201, 26001, 26002, 26006 e 26007
A tabela abaixo mostra causa e solução para erros no envio de propriedades por dispositivos. Outros códigos estão na seção "Códigos de erro comuns".
Código de erro
Causa
Solução de problemas
6106
O dispositivo enviou mais propriedades do que o permitido. O limite é de 200 propriedades simultâneas.
No console do IoT Platform, escolha e verifique a quantidade de propriedades enviadas. Também é possível consultar o arquivo de log local do dispositivo.
-
-
Dispositivo envia eventos
-
Formato de dados pass-through:
Tópico de solicitação:
/sys/{productKey}/{deviceName}/thing/model/up_rawTópico de resposta:
/sys/${productKey}/${deviceName}/thing/model/up_raw_reply
-
Formato de dados Alink:
-
Módulo padrão
Tópico de solicitação:
/sys/${productKey}/${deviceName}/thing/event/${tsl.event.identifier}/postTópico de resposta:
/sys/${productKey}/${deviceName}/thing/event/${tsl.event.identifier}/post_reply
-
Módulo personalizado
Tópico de solicitação:
/sys/${productKey}/${deviceName}/thing/event/${tsl.functionBlockId}:${tsl.event.identifier}/postTópico de resposta:
/sys/${productKey}/${deviceName}/thing/event/${tsl.functionBlockId}:${tsl.event.identifier}/post_reply
Códigos de erro: 460, 500, 6250, 6203, 6207, 6313, 6300, 6320, 6321, 6326, 6301, 6302, 6317, 6323, 6316, 6306, 6307, 6322, 6308, 6309, 6310, 6311, 6312, 6324, 6328, 6325, 6200, 6201, 26001, 26002, 26006 e 26007
Para mais informações sobre esses códigos, veja a seção "Códigos de erro comuns" deste tópico.
-
-
Gateway envia dados de múltiplos subdispositivos simultaneamente
-
Formato de dados pass-through:
Tópico de solicitação:
/sys/{productKey}/{deviceName}/thing/model/up_rawTópico de resposta:
/sys/${productKey}/${deviceName}/thing/model/up_raw_reply
-
Formato de dados Alink:
Tópico de solicitação:
/sys/${productKey}/${deviceName}/thing/event/property/pack/postTópico de resposta:
/sys/${productKey}/${deviceName}/thing/event/property/pack/post_reply
Códigos de erro: 460, 6401, 6106, 6357, 6356, 6100, 6207, 6313, 6300, 6320, 6321, 6326, 6301, 6302, 6317, 6323, 6316, 6306, 6307, 6322, 6308, 6309, 6310, 6311, 6312, 6324, 6328, 6325, 6200, 6201, 26001, 26002, 26006 e 26007
A tabela a seguir lista causas e soluções para erros no envio simultâneo de dados de múltiplos subdispositivos pelo gateway. Consulte a seção "Códigos de erro comuns" para outros códigos.
Código de erro
Causa
Solução de problemas
6401
Relação topológica inexistente.
Acesse a aba Sub-device Management no console do IoT Platform e verifique as informações do subdispositivo.
6106
Quantidade de propriedades enviadas pelo dispositivo acima do limite de 200 simultâneas.
No console do IoT Platform, selecione e confira o volume de propriedades enviadas. Alternativamente, consulte o log local do dispositivo.
6357
Volume de dados enviados pelo gateway excede o permitido. Um gateway pode transmitir dados de até 20 subdispositivos simultaneamente.
Analise os registros no arquivo de log local do dispositivo.
6356
Número de eventos enviados pelo gateway ultrapassa o limite de 200 simultâneos.
Revise os registros no arquivo de log local do dispositivo.
-
Códigos de erro ao definir valores desejados de propriedades do dispositivo
-
Dispositivo obtém valores desejados de propriedades
Tópico de solicitação:
/sys/${productKey}/${deviceName}/thing/property/desired/get.Tópico de resposta:
/sys/${productKey}/${deviceName}/thing/property/desired/get_reply.
Códigos de erro: 460, 6104, 6661 e 500
A tabela abaixo detalha causas e soluções para erros no gerenciamento de valores desejados de propriedades. Outros códigos encontram-se na seção "Códigos de erro comuns".
Código de erro
Causa
Solução de problemas
6104
A solicitação contém mais propriedades do que o limite de 200.
No console do IoT Platform, navegue por e verifique a quantidade de propriedades nos dados enviados. O log local do dispositivo também pode ser consultado.
6661
Falha ao consultar valores desejados de propriedades devido a exceção do sistema.
Envie um ticket.
-
Dispositivo limpa valores desejados de propriedades
Tópico de solicitação:
/sys/${productKey}/${deviceName}/thing/property/desired/delete.Tópico de resposta:
/sys/${productKey}/${deviceName}/thing/property/desired/delete_reply.
Códigos de erro: 460, 6104, 6661, 500, 6207, 6313, 6300, 6320, 6321, 6326, 6301, 6302, 6317, 6323, 6316, 6306, 6307, 6322, 6308, 6309, 6310, 6311, 6312, 6324, 6328 e 6325
Códigos de erro para tags de dispositivo
-
Dispositivo envia informações de tag
Tópico de solicitação:
/sys/${productKey}/${deviceName}/thing/deviceinfo/updateTópico de resposta:
/sys/${productKey}/${deviceName}/thing/deviceinfo/update_reply
Códigos de erro: 460 e 6100
-
Dispositivo exclui informações de tag
Tópico de solicitação:
/sys/${productKey}/${deviceName}/thing/deviceinfo/deleteTópico de resposta:
/sys/${productKey}/${deviceName}/thing/deviceinfo/delete_reply
Códigos de erro: 460 e 500
Códigos de erro ao obter modelos TSL
Tópico de solicitação:
/sys/${productKey}/${deviceName}/thing/dsltemplate/getTópico de resposta:
/sys/${productKey}/${deviceName}/thing/dsltemplate/get_reply
Códigos de erro: 460, 5159, 5160 e 5161
Códigos de erro ao solicitar informações de pacote de atualização
Tópico de solicitação:
/sys/${productKey}/${deviceName}/thing/ota/firmware/getTópico de resposta:
/sys/${productKey}/${deviceName}/thing/ota/firmware/get_reply
Códigos de erro: 429, 9112 e 500
A tabela abaixo descreve causa e solução para erros na solicitação de pacotes de atualização. Consulte a seção "Códigos de erro comuns" para outros casos.
Código de erro
Causa
Solução de problemas
9112
Falha ao consultar informações do dispositivo especificado.
Na página Devices do console do IoT Platform, valide as informações do dispositivo.
Códigos de erro ao solicitar dados de configuração
Tópico de solicitação:
/sys/${productKey}/${deviceName}/thing/config/getTópico de resposta:
/sys/${productKey}/${deviceName}/thing/config/get_reply
Códigos de erro: 460, 500, 6713 e 6710
A tabela a seguir apresenta causas e soluções para erros na solicitação de dados de configuração. Veja a seção "Códigos de erro comuns" para demais códigos.
Código de erro
Causa
Solução de problemas
6713
Serviços de configuração remota indisponíveis. O recurso de configuração remota está desativado para o produto.
No console do IoT Platform, acesse e ative a configuração remota para o produto.
6710
Impossível consultar informações de configuração remota.
Entre no console do IoT Platform, vá em e verifique se o arquivo de configuração do produto foi editado.
-