مرجع رموز الأخطاء
نظرة عامة
يستخدم MipMapEngine SDK نظام رموز أخطاء موحد لمساعدة المطورين على تحديد وحل المشكلات بسرعة. تنقسم رموز الأخطاء إلى فئات متعددة، بما في ذلك أخطاء واجهة إعادة البناء وأخطاء الترخيص وأخطاء الإدخال/الإخراج للملفات وأخطاء GPU.
رموز أخطاء واجهة إعادة البناء (ReconstructFull/ReconstructAT/Reconstruct3D)
فئة المنطق الأساسي
| رمز الخطأ | الوصف |
|---|---|
| 0 | نجحت إعادة البناء |
| 1000 | فشلت إعادة البناء، تحليل السجل للسبب |
| 1001 | ألغى المستخدم |
| 1002 | خطأ في نظام الإحداثيات |
| 1003 | نتيجة AT فارغة |
| 1004 | نتيجة السحابة النقطية فارغة |
| 1005 | نتيجة الشبكة فارغة |
| 1006 | صور نظير غير كافية، لا يمكن إنشاء منتجات ثنائية الأبعاد |
فئة الترخيص
| رمز الخطأ | الوصف |
|---|---|
| 2000 | خطأ في الترخيص |
| 2001 | فشل في تعداد الترخيص |
| 2002 | لم يتم العثور على ترخيص مطابق |
| 2003 | انتهت صلاحية الترخيص |
| 2004 | الترخيص غير قابل للتطبيق لهذا الإصدار |
| 2005 | عدم تطابق وحدة ميزة الترخيص |
| 2006 | تجاوز الحد الأقصى لعدد الصور المدعوم بواسطة الترخيص |
فئة الإدخال/الإخراج للملفات
| رمز الخطأ | الوصف |
|---|---|
| 3000 | خطأ في قراءة/كتابة الملف |
| 3001 | خطأ في تحليل حقل JSON |
فئة برنامج تشغيل جهاز الحوسبة
| رمز الخطأ | الوصف |
|---|---|
| 4000 | خطأ في جهاز GPU، تحقق مما إذا كان GPU من NVIDIA وإصدار برنامج التشغيل يلبي المتطلبات |
رموز أخطاء محرك الترخيص
| رمز الخطأ | الوصف |
|---|---|
| 0 | نجاح |
| 0x00000040 | خطأ في الشبكة |
| 0x0000004A | مهلة طلب الشبكة |
| 0x05000004 | لم يتم العثور على الخادم |
| 0x13000051 | يتطلب الترخيص التنشيط عبر الإنترنت |
| 0x02000003 | فشل الاتصال، برنامج Virbox غير مثبت أو غير متصل بالشبكة |
| 0x51005001 | حدث استثناء عند الاستعلام عن حالة رمز التفويض |
| 0x51005002 | حدث استثناء أثناء طلب تبادل رمز التفويض |
| 0x51005003 | رمز التفويض غير موجود |
| 0x51005004 | فشل خصم ترخيص رمز التفويض |
| 0x51005013 | لا يمكن الربط (انتهت صلاحية الترخيص) |
| 0x51005014 | لا يمكن الربط (تم الوصول إلى حد الجهاز المتزامن لرمز التفويض) |
| 0x51005015 | لا يمكن الربط (تم الوصول إلى حد الجهاز التراكمي لرمز التفويض) |
| 0x51005018 | فشل إلغاء ربط طرف رمز التفويض، يرجى الاتصال بمورد البرامج |
| 0x51005019 | لا يمكن للخادم العثور على سجل الربط، يرجى الاتصال بمورد البرامج |
| 0x51005021 | لا يمكن ربط ترخيص رمز التفويض لأن الترخيص مقفل، يرجى الاتصال بمورد البرامج |
| 0x51005025 | رمز التفويض لا يسمح بالربط |
| 0x51005033 | غير قادر مؤقتًا على تنشيط الترخيص، يحتاج أداة المستخدم إلى الترقية إلى أحدث إصدار |
| 0x51005034 | ألغى مورد البرامج حقوق الاستخدام لهذا الجهاز، لا يمكن لرمز التفويض الحالي الربط مرة أخرى، يرجى الاتصال بمورد البرامج |
| 0x5100612F | رمز التفويض غير موجود، يرجى التأكد من صحة رمز التفويض |
| 0x51006130 | بيانات معلومات الأجهزة غير صالحة |
| 0x51006134 | فشل خصم ترخيص رمز التفويض، يرجى الاتصال بمورد البرامج |
| 0x5100502C | لا يمكن إلغاء الربط (غير مرتبط) |
تدفق تشخيص الأخطاء
الحلول الشائعة
أخطاء الترخيص (2000-2006)
-
تحقق من حالة الترخيص:
license_engine -enum -
تحقق من انتهاء صلاحية الترخيص:
license_engine -query -
تحديث الترخيص:
- اتصل بمورد البرامج للحصول على رمز تفويض جديد
- استخدم أداة تنشيط الترخيص للتحديث
أخطاء GPU (4000)
-
تحقق من برنامج تشغيل GPU:
nvidia-smi -
تحديث برنامج التشغيل:
- قم بتنزيل أحدث برنامج تشغيل NVIDIA
- تأكد من أن إصدار برنامج التشغيل >= 470.xx
-
تحقق من CUDA:
nvcc --version
أخطاء الإدخال/الإخراج للملفات (3000-3001)
-
تحقق من الأذونات:
ls -la /path/to/file
chmod 755 /path/to/file -
تحقق من تنسيق JSON:
task_json_check.exe -task_json config.json -
تحقق من مساحة القرص:
df -h
أفضل ممارسات منع الأخطاء
-
فحوصات ما قبل الرحلة:
- تحقق من الترخيص قبل إعادة البناء
- تحقق من توفر GPU والذاكرة
- التحقق من جودة بيانات الإدخال
-
المراقبة:
- مراقبة استخدام ذاكرة GPU
- تتبع تقدم إعادة البناء
- فحص ملفات السجل بانتظام
-
إدارة الموارد:
- تأكد من وجود مساحة قرص كافية (>3x حجم بيانات الإدخال)
- حافظ على توفر ذاكرة GPU (يُوصى بـ >4GB)
- أغلق التطبيقات غير الضرورية
-
التحقق من صحة البيانات:
- استخدم تداخل صور مناسب (60-80%)
- تحقق من دقة بيانات GPS/EXIF
- تحقق من اتساق نظام الإحداثيات