İçeriğe geç
TREN
Atlıhan Harita

Lixel OpenAPI Kullanım Kılavuzu

Hata Kodları

Bölüm 07 / 09Kılavuz sürümü v1.1.0Türkçe

İstek-yanıt mesajları sonucu, yanıtın Error error = 15 alanında taşır; bu alan code kodunu ve desc açıklamasını içerir. Bu sayfada OpenAPI tarafından sunulan hata kodları, sayısal değerleriyle birlikte kategoriye göre listelenir.

Değerden Ad Sorgulama

Hem Error.code hem de DeviceStatusReport.modeling_state alanları uint32 türündedir; istemci sarmalayıcı bunları ondalık tamsayıya çevirir. Tamsayıyı onaltılık sisteme dönüştürün, ardından adı aşağıdaki "Değer" sütununda arayın. Örneğin cihaz 302252033 döndürürse, bu değer onaltılık düzende 0x12040001 eder ve EC_Success değerine karşılık gelir; modeling_state değeri 302252332, yani 0x1204012C, EC_ScanReady (bekleme) değerine karşılık gelir.

code = rsp["error"]["code"]
print(hex(code))        # 0x12040001

Değerin yüksek 16 biti kategoriyi belirtir; aşağıdaki herkese açık hata kodları buna göre gruplandırılmıştır. Cihaz enum yapısı burada listelenmeyen değerler de içerir (yüksek 16 biti 0x2201, 0x2203, 0x3203 gibi olanlar); listelenmeyen bir değeri bilinmeyen olarak kabul edin ve bu değer için hata vermeyin. Kategoriyi yalnızca ad önekine bakarak belirlemeyin: EC_Scan ile başlayan adlar durum, uyarı ve hata kategorilerine yayılır; değere göre karar verin.

Yüksek 16 BitKategoriBu Sayfadaki Bölüm
0x1204Durum & BaşarıGenel durum, yükseltme durumu, etkinleştirme durumu, Ntrip durumu, tarama durumu
0x2204UyarıTarama uyarı kodları
0x3201Cihaz İstisnasıCihaz istisna kodları
0x3204HataGenel hatalar, Ntrip hataları, harici depolama hataları, tarama hataları
0x3205Kalibrasyon HatasıKalibrasyon hata kodları

Genel Durum Kodları

AdDeğer (hex, ondalık)Anlamı
EC_UnknownState0x12040000 (302252032)Bilinmeyen durum
EC_Success0x12040001 (302252033)Başarılı
EC_SuccessAndReboot0x12040002 (302252034)Başarılı, yeniden başlatma
EC_RequestSuccess0x12040001 (302252033)İstek başarılı (EC_Success ile aynı)

Genel Hata Kodları

AdDeğer (hex, ondalık)Anlamı
EC_UnknownError0x32040000 (839122944)Bilinmeyen hata
EC_ProtoError0x32040001 (839122945)Protokol hatası
EC_RequestError0x32040002 (839122946)İstek hatası

Yükseltme Durum Kodları

AdDeğer (hex, ondalık)Anlamı
EC_UpgradeOnGoing0x120400C8 (302252232)Yükseltme sürüyor
EC_UpgradeFileNotExist0x120400C9 (302252233)Dosya mevcut değil
EC_UpgradeFileBroken0x120400CA (302252234)Dosya bozuk
EC_UpgradeProtoError0x120400CB (302252235)Protokol hatası
EC_UpgradeFailed0x120400CC (302252236)Yükseltme başarısız oldu
EC_UpgradeSucceed0x120400CD (302252237)Yükseltme başarılı
EC_UpgradeLowBattery0x120400CE (302252238)Pil seviyesi çok düşük
EC_UpgradeInternalError0x120400CF (302252239)Dahili hata

Etkinleştirme Durum Kodları

AdDeğer (hex, ondalık)Anlamı
EC_Activated0x120401F4 (302252532)Etkinleştirildi
EC_Deactivated0x120401F5 (302252533)Etkinleştirilmedi

Ntrip Durum ve Hata Kodları

AdDeğer (hex, ondalık)Anlamı
EC_NtripLoginSuccess0x12040001 (302252033)Ntrip oturumu açıldı
EC_NtripLogoutSuccess0x12040001 (302252033)Ntrip oturumu kapatıldı
EC_NtripDisConnected0x12040191 (302252433)Ntrip hizmeti bağlantısı kesildi
EC_NtripLogoutFailed0x32040002 (839122946)Ntrip oturum kapatma başarısız oldu
EC_NtripNetworkError0x32040003 (839122947)Ntrip ağ hatası
EC_NtripAuthError0x32040004 (839122948)Ntrip kimlik doğrulaması başarısız oldu
EC_NtripTimeoutError0x32040005 (839122949)Ntrip yürütme zaman aşımı

Harici Depolama (Udisk) Hata Kodları

AdDeğer (hex, ondalık)Anlamı
EC_UdiskNotMounted0x3204000B (839122955)Harici depolama bağlı değil
EC_UdiskStorageLow0x3204000C (839122956)Harici depolama alanı yetersiz
EC_UdiskNoProject0x3204000D (839122957)Aktarılacak proje yok
EC_UdiskTransferError0x3204000E (839122958)Harici depolama aktarım hatası
EC_UdiskLowBattery0x3204000F (839122959)Harici depolama aktarımı için pil yetersiz

Cihaz istisna kodları

AdDeğer (hex, ondalık)Anlamı
EC_ExBatteryLow0x32011001 (838930433)Pil seviyesi düşük
EC_ExStorageLow0x32011002 (838930434)Depolama kapasitesi düşük
EC_ExImuAbnormal0x32011003 (838930435)IMU anormal
EC_ExImuHalt0x32011004 (838930436)IMU çalışmayı durdurdu
EC_ExEncoderAbnormal0x32011005 (838930437)Enkoder anormal
EC_ExEncoderHalt0x32011006 (838930438)Enkoder çalışmayı durdurdu
EC_ExCamera0Abnormal0x32011007 (838930439)Kamera 0 anormal
EC_ExCamera1Abnormal0x32011009 (838930441)Kamera 1 anormal
EC_ExCamera2Abnormal0x3201100D (838930445)Kamera 2 anormal
EC_ExCamera3Abnormal0x3201100B (838930443)Kamera 3 anormal
EC_ExCamera0Halt0x32011008 (838930440)Kamera 0 çalışmayı durdurdu
EC_ExCamera1Halt0x3201100A (838930442)Kamera 1 çalışmayı durdurdu
EC_ExCamera2Halt0x3201100E (838930446)Kamera 2 çalışmayı durdurdu
EC_ExCamera3Halt0x3201100C (838930444)Kamera 3 çalışmayı durdurdu
EC_ExBatteryEmpty0x3201100F (838930447)Pil bitti
EC_ExStorageEmpty0x32011010 (838930448)Depolama alanı doldu
EC_ExLidarAbnormal0x32011011 (838930449)LiDAR anormal
EC_ExLidarHalt0x32011012 (838930450)LiDAR çalışmayı durdurdu
EC_ExCpuTempHigh0x32011013 (838930451)CPU sıcaklığı çok yüksek
EC_ExSlipRingOverLife0x32011014 (838930452)Kayar halka kullanım ömrü doldu
EC_ExHardwareFault0x32011015 (838930453)Donanım arızası
EC_ExMagneticAbnormal0x32011016 (838930454)Manyetik sensör anormal
EC_ExMagneticHalt0x32011017 (838930455)Manyetometre verisi durdu
EC_ExSlamStopFailed0x32011018 (838930456)Algoritma durdurma istisnası
EC_ExBatteryTempHigh0x32011019 (838930457)Pil sıcaklığı çok yüksek
EC_ExUdiskLow0x3201101A (838930458)Harici depolama kapasitesi düşük
EC_ExUdiskEmpty0x3201101B (838930459)Harici depolama kapasitesi doldu
EC_ExUdiskRemove0x3201101C (838930460)Harici depolama çıkarıldı

Tarama Durum Kodları

AdDeğer (hex, ondalık)Anlamı
EC_ScanReady0x1204012C (302252332)Bekleme
EC_ScanStarting0x1204012D (302252333)Tarama başlatılıyor
EC_ScanModeling0x1204012E (302252334)Tarama
EC_ScanStopping0x1204012F (302252335)Tarama durduruluyor
EC_ScanStopped0x12040130 (302252336)Tarama tamamlandı

Yukarıdaki tablonun yanı sıra modeling_state alanı EC_ScanMappingAbort, EC_ScanNotAllowedInUsbMass ve EC_ScanProjectTransferring tarama uyarı kodlarını da alabilir. Örneğin USB yığın depolama modunda cihaz 0x2204013E bildirir; bu durumda EC_ScanReady değerini süresiz beklemek zaman aşımına uğrar.

Tarama hata kodları

AdDeğer (hex, ondalık)Anlamı
EC_ScanMountError0x32040131 (839123249)Bağlama hatası
EC_ScanStorageError0x32040132 (839123250)Depolama hatası
EC_ScanSlamError0x32040133 (839123251)Haritalama hatası
EC_ScanPreIDError0x32040134 (839123252)Proje öncesi hata
EC_ScanStorageEmpty0x32040135 (839123253)Disk kapasitesi boş
EC_ScanCameraError0x32040136 (839123254)Kamera hatası
EC_ScanRelocSuccess0x32040137 (839123255)Yeniden konumlandırma başarılı (adı Success içerir, ancak değer hata tabanından atandığı için 0x3204 ile başlar)
EC_ScanRelocFailed0x32040138 (839123256)Yeniden konumlandırma başarısız
EC_ScanSlamAbort0x32040139 (839123257)Algoritma durduruldu
EC_ScanStorageLow0x3204013A (839123258)Yetersiz disk alanı
EC_ScanMemoryLow0x3204013B (839123259)Yetersiz bellek
EC_ScanLidarError0x3204013C (839123260)LiDAR verisi anormal

Kalibrasyon hata kodları

AdDeğer (hex, ondalık)Anlamı
EC_CalibFailed0x32050001 (839188481)Kalibrasyon başarısız
EC_CalibMagRtkError0x32050002 (839188482)Manyetometre kalibrasyonu RTK durum hatası
EC_CalibMagLackDataError0x32050003 (839188483)Manyetometre kalibrasyonu veri toplama anormalliği
EC_CalibFileNotExists0x32050004 (839188484)Dosya mevcut değil
EC_CalibFileNotPermitted0x32050005 (839188485)Dosya işlemine izin verilmiyor

Tarama uyarı kodları

AdDeğer (hex, ondalık)Anlamı
EC_ScanMappingAbort0x2204013D (570687805)Haritalama durduruldu, yalnızca paket kaydı
EC_ScanNotAllowedInUsbMass0x2204013E (570687806)USB yığın depolama modunda taramaya izin verilmiyor
EC_ScanProjectTransferring0x2204013F (570687807)Proje aktarımı sırasında taramaya izin verilmiyor
EC_ScanPclRefineError0x22040140 (570687808)PCL iyileştirme başarısız
EC_ScanPcbinDataError0x22040141 (570687809)Pcbin verisi anormal (LAS dosyası oluşturmanın başarısız olmasına neden olur)
EC_ScanXbinDataError0x22040142 (570687810)Xbin verisi anormal (son işlemin başarısız olmasına neden olur)

Not: Bu sayfa yalnızca OpenAPI tarafından sunulan hata kodlarını listeler; cihazda daha fazla kod vardır ve bunlar firmware sürümleri arasında değişebilir. Listede olmayan bir kod için önce onaltılık değerden kategoriyi doğrulayın, ardından yanıttaki desc alanına bakın. Not: control_point için başarılı bir AC_ADD işleminde desc, metin açıklaması değil, noktanın poz numaralarıdır.

Bu bölüm XGRIDS'in resmî kullanım kılavuzundan Türkçeye çevrildi; ekran görüntüleri ve arayüz adları özgün haliyle İngilizcedir. İngilizce aslı (yeni sekmede açılır) · Güncelleme:

XGRIDS Türkiye

Kurulumda ve Sahada Yanınızdayız

Atlıhan Harita; cihaz kurulumu, firmware güncellemesi, yazılım kullanımı ve saha uygulamalarında eğitim ve teknik destek verir. Sorunuzu iletin, uzmanımız size dönsün.

+90 216 546 0804