Saltar al contenido principal

Referencia de Códigos de Error

Descripción General​

El SDK de MipMapEngine utiliza un sistema estandarizado de códigos de error para ayudar a los desarrolladores a localizar y resolver problemas rápidamente. Los códigos de error se dividen en múltiples categorías, incluyendo errores de interfaz de reconstrucción, errores de licencia, errores de E/S de archivos y errores de GPU.

Códigos de Error de Interfaz de Reconstrucción (ReconstructFull/ReconstructAT/Reconstruct3D)​

Clase de Lógica Central​

Código de ErrorDescripción
0Reconstrucción exitosa
1000Reconstrucción falló, analizar log para la razón
1001Usuario canceló
1002Error del sistema de coordenadas
1003Resultado AT está vacío
1004Resultado de nube de puntos está vacío
1005Resultado de malla está vacío
1006Imágenes nadir insuficientes, no se pueden generar productos 2D

Clase de Licencia​

Código de ErrorDescripción
2000Error de licencia
2001Falló la enumeración de licencia
2002No se encontró licencia coincidente
2003La licencia ha expirado
2004Licencia no aplicable para esta versión
2005Desajuste del módulo de características de licencia
2006Excedido el número máximo de imágenes soportadas por la licencia

Clase de E/S de Archivos​

Código de ErrorDescripción
3000Error de lectura/escritura de archivo
3001Error de análisis de campo JSON

Clase de Controlador de Dispositivo de Cómputo​

Código de ErrorDescripción
4000Error de dispositivo GPU, verificar si la GPU es NVIDIA y la versión del controlador cumple los requisitos

Códigos de Error del Motor de Licencia​

Código de ErrorDescripción
0Éxito
0x00000040Error de red
0x0000004ATiempo de espera de solicitud de red
0x05000004Servidor no encontrado
0x13000051La licencia requiere activación en línea
0x02000003Conexión falló, software Virbox no instalado o no conectado a la red
0x51005001Ocurrió excepción al consultar el estado del código de autorización
0x51005002Ocurrió excepción durante la solicitud de intercambio de código de autorización
0x51005003El código de autorización no existe
0x51005004Falló la deducción de licencia del código de autorización
0x51005013No se puede vincular (la licencia ha expirado)
0x51005014No se puede vincular (límite de dispositivo concurrente alcanzado para el código de autorización)
0x51005015No se puede vincular (límite de dispositivo acumulativo alcanzado para el código de autorización)
0x51005018Falló la desvinculación del terminal del código de autorización, por favor contacte al proveedor de software
0x51005019El servidor no puede encontrar el registro de vinculación, por favor contacte al proveedor de software
0x51005021La licencia del código de autorización no se puede vincular porque la licencia está bloqueada, por favor contacte al proveedor de software
0x51005025El código de autorización no permite vinculación
0x51005033Temporalmente no se puede activar la licencia, la herramienta del usuario necesita actualizarse a la última versión
0x51005034El proveedor de software ha revocado los derechos de uso para este dispositivo, el código de autorización actual no puede vincular nuevamente, por favor contacte al proveedor de software
0x5100612FEl código de autorización no existe, por favor confirme si el código de autorización es correcto
0x51006130Datos de información de hardware inválidos
0x51006134Falló la deducción de licencia del código de autorización, por favor contacte al proveedor de software
0x5100502CNo se puede desvincular (no vinculado)

Flujo de Diagnóstico de Errores​

Soluciones Comunes​

Errores de Licencia (2000-2006)​

  1. Verificar estado de licencia:

    license_engine -enum

  2. Verificar expiración de licencia:

    license_engine -query

  3. Actualizar licencia:

    • Contactar al proveedor de software para nuevo código de autorización
    • Usar herramienta de activación de licencia para actualizar

Errores de GPU (4000)​

  1. Verificar controlador de GPU:

    nvidia-smi

  2. Actualizar controlador:

    • Descargar el último controlador NVIDIA
    • Asegurar que la versión del controlador >= 470.xx

  3. Verificar CUDA:

    nvcc --version

Errores de E/S de Archivos (3000-3001)​

  1. Verificar permisos:

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

  2. Verificar formato JSON:

    task_json_check.exe -task_json config.json

  3. Verificar espacio en disco:

    df -h

Mejores Prácticas de Prevención de Errores​

  1. Verificaciones previas al vuelo:

    • Verificar licencia antes de la reconstrucción
    • Verificar disponibilidad y memoria de GPU
    • Validar calidad de datos de entrada

  2. Monitoreo:

    • Monitorear uso de memoria de GPU
    • Rastrear progreso de reconstrucción
    • Verificar archivos de log regularmente

  3. Gestión de recursos:

    • Asegurar espacio suficiente en disco (>3x tamaño de datos de entrada)
    • Mantener memoria de GPU disponible (>4GB recomendado)
    • Cerrar aplicaciones innecesarias

  4. Validación de datos:

    • Usar superposición de imagen apropiada (60-80%)
    • Verificar precisión de datos GPS/EXIF
    • Verificar consistencia del sistema de coordenadas