Passa al contenuto principale

Riferimento Codici di Errore

Panoramica​

L'SDK MipMapEngine utilizza un sistema standardizzato di codici di errore per aiutare gli sviluppatori a localizzare e risolvere rapidamente i problemi. I codici di errore sono divisi in più categorie, inclusi errori dell'interfaccia di ricostruzione, errori di licenza, errori di I/O file e errori GPU.

Codici di Errore dell'Interfaccia di Ricostruzione (ReconstructFull/ReconstructAT/Reconstruct3D)​

Classe Logica Centrale​

Codice di ErroreDescrizione
0Ricostruzione riuscita
1000Ricostruzione fallita, analizzare il log per la ragione
1001Utente ha annullato
1002Errore del sistema di coordinate
1003Risultato AT è vuoto
1004Risultato nuvola di punti è vuoto
1005Risultato mesh è vuoto
1006Immagini nadir insufficienti, impossibile generare prodotti 2D

Classe Licenza​

Codice di ErroreDescrizione
2000Errore di licenza
2001Enumerazione licenza fallita
2002Nessuna licenza corrispondente trovata
2003La licenza è scaduta
2004Licenza non applicabile per questa versione
2005Disallineamento modulo funzionalità licenza
2006Superato il numero massimo di immagini supportate dalla licenza

Classe I/O File​

Codice di ErroreDescrizione
3000Errore di lettura/scrittura file
3001Errore di parsing campo JSON

Classe Driver Dispositivo di Calcolo​

Codice di ErroreDescrizione
4000Errore dispositivo GPU, verificare se la GPU è NVIDIA e la versione del driver soddisfa i requisiti

Codici di Errore del Motore di Licenza​

Codice di ErroreDescrizione
0Successo
0x00000040Errore di rete
0x0000004ATimeout richiesta di rete
0x05000004Server non trovato
0x13000051La licenza richiede attivazione online
0x02000003Connessione fallita, software Virbox non installato o non connesso alla rete
0x51005001Eccezione verificatasi durante la query dello stato del codice di autorizzazione
0x51005002Eccezione verificatasi durante la richiesta di scambio del codice di autorizzazione
0x51005003Il codice di autorizzazione non esiste
0x51005004Deduzione licenza codice di autorizzazione fallita
0x51005013Impossibile associare (licenza scaduta)
0x51005014Impossibile associare (limite dispositivo concorrente raggiunto per il codice di autorizzazione)
0x51005015Impossibile associare (limite dispositivo cumulativo raggiunto per il codice di autorizzazione)
0x51005018Disassociazione terminale codice di autorizzazione fallita, si prega di contattare il fornitore software
0x51005019Il server non può trovare il record di associazione, si prega di contattare il fornitore software
0x51005021La licenza del codice di autorizzazione non può essere associata perché la licenza è bloccata, si prega di contattare il fornitore software
0x51005025Il codice di autorizzazione non consente l'associazione
0x51005033Temporaneamente impossibile attivare la licenza, lo strumento utente deve essere aggiornato all'ultima versione
0x51005034Il fornitore software ha revocato i diritti di utilizzo per questo dispositivo, il codice di autorizzazione corrente non può associare nuovamente, si prega di contattare il fornitore software
0x5100612FIl codice di autorizzazione non esiste, si prega di confermare se il codice di autorizzazione è corretto
0x51006130Dati informazioni hardware non validi
0x51006134Deduzione licenza codice di autorizzazione fallita, si prega di contattare il fornitore software
0x5100502CImpossibile disassociare (non associato)

Flusso di Diagnosi Errori​

Soluzioni Comuni​

Errori di Licenza (2000-2006)​

  1. Controllare stato licenza:

    license_engine -enum

  2. Verificare scadenza licenza:

    license_engine -query

  3. Aggiornare licenza:

    • Contattare il fornitore software per un nuovo codice di autorizzazione
    • Utilizzare lo strumento di attivazione licenza per aggiornare

Errori GPU (4000)​

  1. Controllare driver GPU:

    nvidia-smi

  2. Aggiornare driver:

    • Scaricare l'ultimo driver NVIDIA
    • Assicurarsi che la versione del driver >= 470.xx

  3. Verificare CUDA:

    nvcc --version

Errori I/O File (3000-3001)​

  1. Controllare permessi:

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

  2. Verificare formato JSON:

    task_json_check.exe -task_json config.json

  3. Controllare spazio disco:

    df -h

Migliori Pratiche per la Prevenzione degli Errori​

  1. Controlli pre-volo:

    • Verificare la licenza prima della ricostruzione
    • Controllare disponibilità e memoria GPU
    • Validare qualità dati di input

  2. Monitoraggio:

    • Monitorare utilizzo memoria GPU
    • Tracciare progresso ricostruzione
    • Controllare file di log regolarmente

  3. Gestione risorse:

    • Assicurare spazio disco sufficiente (>3x dimensione dati di input)
    • Mantenere memoria GPU disponibile (>4GB raccomandato)
    • Chiudere applicazioni non necessarie

  4. Validazione dati:

    • Utilizzare sovrapposizione immagine appropriata (60-80%)
    • Verificare accuratezza dati GPS/EXIF
    • Controllare consistenza sistema di coordinate