Fehlercode-Referenz
Übersicht
Das MipMapEngine SDK verwendet ein standardisiertes Fehlercode-System, um Entwicklern dabei zu helfen, Probleme schnell zu lokalisieren und zu lösen. Fehlercodes sind in mehrere Kategorien unterteilt, einschließlich Rekonstruktions-Interface-Fehler, Lizenzfehler, Datei-I/O-Fehler und GPU-Fehler.
Rekonstruktions-Interface-Fehlercodes (ReconstructFull/ReconstructAT/Reconstruct3D)
Kernlogik-Klasse
| Fehlercode | Beschreibung |
|---|---|
| 0 | Rekonstruktion erfolgreich |
| 1000 | Rekonstruktion fehlgeschlagen, Log-Datei für Ursache analysieren |
| 1001 | Benutzer hat abgebrochen |
| 1002 | Koordinatensystem-Fehler |
| 1003 | AT-Ergebnis ist leer |
| 1004 | Punktwolken-Ergebnis ist leer |
| 1005 | Mesh-Ergebnis ist leer |
| 1006 | Unzureichende Nadir-Bilder, kann keine 2D-Produkte generieren |
Lizenz-Klasse
| Fehlercode | Beschreibung |
|---|---|
| 2000 | Lizenzfehler |
| 2001 | Lizenz-Aufzählung fehlgeschlagen |
| 2002 | Keine passende Lizenz gefunden |
| 2003 | Lizenz ist abgelaufen |
| 2004 | Lizenz nicht für diese Version anwendbar |
| 2005 | Lizenz-Feature-Modul-Konflikt |
| 2006 | Maximale von der Lizenz unterstützte Bildanzahl überschritten |
Datei-I/O-Klasse
| Fehlercode | Beschreibung |
|---|---|
| 3000 | Datei-Lese-/Schreibfehler |
| 3001 | JSON-Feld-Parsing-Fehler |
Computing-Device-Treiber-Klasse
| Fehlercode | Beschreibung |
|---|---|
| 4000 | GPU-Gerätefehler, prüfen Sie, ob GPU NVIDIA ist und Treiberversion Anforderungen erfüllt |
Lizenz-Engine-Fehlercodes
| Fehlercode | Beschreibung |
|---|---|
| 0 | Erfolg |
| 0x00000040 | Netzwerkfehler |
| 0x0000004A | Netzwerk-Anfrage-Timeout |
| 0x05000004 | Server nicht gefunden |
| 0x13000051 | Lizenz erfordert Online-Aktivierung |
| 0x02000003 | Verbindung fehlgeschlagen, Virbox-Software nicht installiert oder nicht mit Netzwerk verbunden |
| 0x51005001 | Ausnahme beim Abfragen des Autorisierungscode-Status aufgetreten |
| 0x51005002 | Ausnahme während der Autorisierungscode-Austausch-Anfrage aufgetreten |
| 0x51005003 | Autorisierungscode existiert nicht |
| 0x51005004 | Autorisierungscode-Lizenz-Abzug fehlgeschlagen |
| 0x51005013 | Kann nicht binden (Lizenz ist abgelaufen) |
| 0x51005014 | Kann nicht binden (gleichzeitiges Gerätelimit für Autorisierungscode erreicht) |
| 0x51005015 | Kann nicht binden (kumulatives Gerätelimit für Autorisierungscode erreicht) |
| 0x51005018 | Autorisierungscode-Terminal-Entbindung fehlgeschlagen, bitte kontaktieren Sie den Software-Anbieter |
| 0x51005019 | Server kann Bindungsdatensatz nicht finden, bitte kontaktieren Sie den Software-Anbieter |
| 0x51005021 | Autorisierungscode-Lizenz kann nicht gebunden werden, da Lizenz gesperrt ist, bitte kontaktieren Sie den Software-Anbieter |
| 0x51005025 | Autorisierungscode erlaubt keine Bindung |
| 0x51005033 | Vorübergehend nicht in der Lage, Lizenz zu aktivieren, Benutzer-Tool muss auf neueste Version aktualisiert werden |
| 0x51005034 | Software-Anbieter hat Nutzungsrechte für dieses Gerät widerrufen, aktueller Autorisierungscode kann nicht erneut binden, bitte kontaktieren Sie den Software-Anbieter |
| 0x5100612F | Autorisierungscode existiert nicht, bitte bestätigen Sie, ob Autorisierungscode korrekt ist |
| 0x51006130 | Ungültige Hardware-Informationsdaten |
| 0x51006134 | Autorisierungscode-Lizenz-Abzug fehlgeschlagen, bitte kontaktieren Sie den Software-Anbieter |
| 0x5100502C | Kann nicht entbinden (nicht gebunden) |
Fehlerdiagnose-Ablauf
Häufige Lösungen
Lizenzfehler (2000-2006)
-
Lizenzstatus prüfen:
license_engine -enum -
Lizenzablauf verifizieren:
license_engine -query -
Lizenz aktualisieren:
- Software-Anbieter für neuen Autorisierungscode kontaktieren
- Lizenz-Aktivierungs-Tool zum Aktualisieren verwenden
GPU-Fehler (4000)
-
GPU-Treiber prüfen:
nvidia-smi -
Treiber aktualisieren:
- Neuesten NVIDIA-Treiber herunterladen
- Sicherstellen, dass Treiberversion >= 470.xx
-
CUDA verifizieren:
nvcc --version
Datei-I/O-Fehler (3000-3001)
-
Berechtigungen prüfen:
ls -la /path/to/file
chmod 755 /path/to/file -
JSON-Format verifizieren:
task_json_check.exe -task_json config.json -
Festplattenspeicher prüfen:
df -h
Best Practices zur Fehlervermeidung
-
Vor-Flug-Prüfungen:
- Lizenz vor Rekonstruktion verifizieren
- GPU-Verfügbarkeit und -Speicher prüfen
- Eingabedatenqualität validieren
-
Überwachung:
- GPU-Speicherverbrauch überwachen
- Rekonstruktionsfortschritt verfolgen
- Log-Dateien regelmäßig prüfen
-
Ressourcenverwaltung:
- Ausreichend Festplattenspeicher sicherstellen (>3x Eingabedatengröße)
- GPU-Speicher verfügbar halten (>4GB empfohlen)
- Unnötige Anwendungen schließen
-
Datenvalidierung:
- Ordnungsgemäße Bildüberlappung verwenden (60-80%)
- GPS/EXIF-Datengenauigkeit verifizieren
- Koordinatensystem-Konsistenz prüfen