Pular para o conteúdo principal

Referência de Códigos de Erro

Visão Geral​

O SDK MipMapEngine usa um sistema padronizado de códigos de erro para ajudar os desenvolvedores a localizar e resolver problemas rapidamente. Os códigos de erro são divididos em múltiplas categorias, incluindo erros de interface de reconstrução, erros de licença, erros de E/S de arquivo e erros de GPU.

Códigos de Erro da Interface de Reconstrução (ReconstructFull/ReconstructAT/Reconstruct3D)​

Classe de Lógica Central​

Código de ErroDescrição
0Reconstrução bem-sucedida
1000Reconstrução falhou, analisar log para a razão
1001Usuário cancelou
1002Erro do sistema de coordenadas
1003Resultado AT está vazio
1004Resultado da nuvem de pontos está vazio
1005Resultado da malha está vazio
1006Imagens nadir insuficientes, não é possível gerar produtos 2D

Classe de Licença​

Código de ErroDescrição
2000Erro de licença
2001Falha na enumeração de licença
2002Nenhuma licença correspondente encontrada
2003A licença expirou
2004Licença não aplicável para esta versão
2005Incompatibilidade do módulo de recurso da licença
2006Excedido o número máximo de imagens suportadas pela licença

Classe de E/S de Arquivo​

Código de ErroDescrição
3000Erro de leitura/escrita de arquivo
3001Erro de análise de campo JSON

Classe de Driver de Dispositivo de Computação​

Código de ErroDescrição
4000Erro do dispositivo GPU, verificar se a GPU é NVIDIA e a versão do driver atende aos requisitos

Códigos de Erro do Motor de Licença​

Código de ErroDescrição
0Sucesso
0x00000040Erro de rede
0x0000004ATimeout de solicitação de rede
0x05000004Servidor não encontrado
0x13000051A licença requer ativação online
0x02000003Conexão falhou, software Virbox não instalado ou não conectado à rede
0x51005001Exceção ocorreu ao consultar status do código de autorização
0x51005002Exceção ocorreu durante solicitação de troca de código de autorização
0x51005003Código de autorização não existe
0x51005004Dedução de licença do código de autorização falhou
0x51005013Não é possível vincular (licença expirou)
0x51005014Não é possível vincular (limite de dispositivo concorrente atingido para código de autorização)
0x51005015Não é possível vincular (limite de dispositivo cumulativo atingido para código de autorização)
0x51005018Desvinculação do terminal do código de autorização falhou, por favor contate o fornecedor de software
0x51005019Servidor não consegue encontrar registro de vinculação, por favor contate o fornecedor de software
0x51005021Licença do código de autorização não pode ser vinculada porque a licença está bloqueada, por favor contate o fornecedor de software
0x51005025Código de autorização não permite vinculação
0x51005033Temporariamente incapaz de ativar licença, ferramenta do usuário precisa ser atualizada para a versão mais recente
0x51005034Fornecedor de software revogou direitos de uso para este dispositivo, código de autorização atual não pode vincular novamente, por favor contate o fornecedor de software
0x5100612FCódigo de autorização não existe, por favor confirme se o código de autorização está correto
0x51006130Dados de informação de hardware inválidos
0x51006134Dedução de licença do código de autorização falhou, por favor contate o fornecedor de software
0x5100502CNão é possível desvincular (não vinculado)

Fluxo de Diagnóstico de Erro​

Soluções Comuns​

Erros de Licença (2000-2006)​

  1. Verificar status da licença:

    license_engine -enum

  2. Verificar expiração da licença:

    license_engine -query

  3. Atualizar licença:

    • Contatar fornecedor de software para novo código de autorização
    • Usar ferramenta de ativação de licença para atualizar

Erros de GPU (4000)​

  1. Verificar driver da GPU:

    nvidia-smi

  2. Atualizar driver:

    • Baixar o driver NVIDIA mais recente
    • Garantir que a versão do driver >= 470.xx

  3. Verificar CUDA:

    nvcc --version

Erros de E/S de Arquivo (3000-3001)​

  1. Verificar permissões:

    ls -la /path/to/file
    chmod 755 /path/to/file

  2. Verificar formato JSON:

    task_json_check.exe -task_json config.json

  3. Verificar espaço em disco:

    df -h

Melhores Práticas de Prevenção de Erros​

  1. Verificações pré-voo:

    • Verificar licença antes da reconstrução
    • Verificar disponibilidade e memória da GPU
    • Validar qualidade dos dados de entrada

  2. Monitoramento:

    • Monitorar uso de memória da GPU
    • Acompanhar progresso da reconstrução
    • Verificar arquivos de log regularmente

  3. Gerenciamento de recursos:

    • Garantir espaço suficiente em disco (>3x tamanho dos dados de entrada)
    • Manter memória da GPU disponível (>4GB recomendado)
    • Fechar aplicações desnecessárias

  4. Validação de dados:

    • Usar sobreposição de imagem apropriada (60-80%)
    • Verificar precisão dos dados GPS/EXIF
    • Verificar consistência do sistema de coordenadas