1. Software Scheduling Layer Error Codes (LCC_MANAGER_*, 0x34041xxx / 0x24041xxx)
1.1 System and Resources
| Error Code | Name | Meaning |
|---|---|---|
0x34041100 | LCC_MANAGER_UNKNOWN_ERR | System unknown error |
0x34041000 | LCC_MANAGER_DISK_ERR | Insufficient disk space |
0x34041001 | LCC_MANAGER_GPU_ERR | GPU validation failed (driver/compatibility) |
0x34041002 | LCC_MANAGER_APP_ERR | Missing program component |
0x34041021 | LCC_MANAGER_NO_AUTH | Authorization not activated / scene count exceeded |
1.2 Scan Project Input Validation
| Error Code | Name | Meaning |
|---|---|---|
0x34041003 | LCC_MANAGER_SCAN_DATA_ERR | Scan project does not exist (wrong path) |
0x34041004 | LCC_MANAGER_PROJEC_DATA_ERR | Missing project_data directory |
0x34041005 | LCC_MANAGER_HBC_ERR | Missing or empty HBC/xbin file |
0x34041006 | LCC_MANAGER_ROSBAG_ERR | HBC file format/content error |
0x34041007 | LCC_MANAGER_POSES_ERR | Missing poses.csv |
0x34041008 | LCC_MANAGER_DEVICE_INFO_ERR | Missing project_data/log/device_info.txt |
0x34041009 | LCC_MANAGER_PROJECT_JSON_ERR | Missing project.json |
1.3 Fusion / Aerial-Ground / Aerial Validation
| Error Code | Name | Meaning |
|---|---|---|
0x34041014 | LCC_MANAGER_RTK_CONTROL_POINTS_ERR | Missing control points/RTK data (required for Map Fusion) |
0x34041015 | LCC_MANAGER_RTK_POINTS_ERR | Control points/RTK insufficient for fusion |
0x34041016 | LCC_MANAGER_DEVICETYPE_ERR | Fusion data comes from different device types |
0x34041017 | LCC_MANAGER_LIDAR_TYPE_ERR | Inconsistent lidar type in fusion data |
0x34041018 | LCC_MANAGER_PROJECT_MAX_ERR | Fusion project count exceeded (>50) |
0x34041019 | LCC_MANAGER_MAP_FUSION_MAX_LIMIT | Total fusion scan duration exceeded (>200 minutes) |
0x34041022 | LCC_MANAGER_DRONE_RTK_ERR | Aerial-Ground Map Fusion image RTK proportion < 80% |
0x34041025 | LCC_MANAGER_DRONE_IMAGE_COUNT_ERR | Drone image count/format error (100~10000, JPG/JPEG) |
0x34041026 | LCC_MANAGER_DRONE_IMAGE_PX_ERR | Drone image resolution < 1024×768 |
0x34041027 | LCC_MANAGER_DRONE_IMAGE_ERR | Inconsistent drone image resolution |
1.4 HD Supplementary Capture
| Error Code | Name | Meaning |
|---|---|---|
0x34041023 | LCC_MANAGER_HD_IMAGE_ERR | Inconsistent HD supplementary capture image resolution |
0x34041024 | LCC_MANAGER_HD_IMAGE_COUNT_ERR | HD supplementary capture count error (20~1000, JPG/JPEG/PNG) |
0x3404102D | LCC_MANAGER_HD_PATH_NOT_FOUND_ERR | HD supplementary capture directory does not exist |
0x3404102E | LCC_MANAGER_HD_PATH_INVALID_ERR | Illegal HD supplementary capture path (contains commas, etc.) |
1.5 Lifecycle / Cancellation / Queue
| Error Code | Name | Meaning |
|---|---|---|
0x34041020 | LCC_MANAGER_USER_STOP_ERR | User manually cancelled reconstruction |
0x34041029 | LCC_MANAGER_TASK_CANCELLED_ERR | Task cascade-cancelled because another stage under the same jobId failed |
0x3404102A | LCC_MANAGER_QUEUE_REJECT_ERR | Queue layer gives up: deterministic parameter/configuration failure, retrying is pointless |
1.6 Gaussian Points / Device Capability
| Error Code | Name | Meaning |
|---|---|---|
0x3404102B | LCC_MANAGER_GAUSSIAN_POINT_MAX_ERR | Gaussian point count exceeds the device/quality allowed upper limit |
0x3404102C | LCC_MANAGER_GAUSSIAN_POINT_RANGE_ERR | maximumGaussianPoint outside the valid range 8–50 |
0x3404102F | LCC_MANAGER_DEVICE_UNSUPPORTED_FEATURE_ERR | Current device does not support this feature (e.g., F1 does not support HD supplementary capture) |
0x34041028 | LCC_MANAGER_VIDEO_INPUT_ERR | Video reconstruction input validation failed (probe/frame rate/images non-compliant) |
1.7 Scheduling Layer Warnings (0x24041xxx, do not block reconstruction)
| Error Code | Name | Meaning |
|---|---|---|
0x24041000 | LCC_MANAGER_SCANTIME_WARN | Difference between scan duration and video duration > 2 minutes |
0x24041001 | LCC_MANAGER_CPU_USE_WARN | CPU load > 50% at startup |
0x24041201 | LCC_REBUILD_CONERNT_ERR | LCC data conversion processing failed |
2. Reconstruction Layer Error Codes (LCC_ALG_*)
2.1 Common Reconstruction Errors
| Error Code | Name | Exit Code | Meaning |
|---|---|---|---|
0x34040000 | LCC_ALG_UNKNOWN_ERR | 999 | Algorithm unknown error (crash/not refined) |
0x34040009 | LCC_ALG_NO_AUTH_ERR | 9 | Initialization exception / authorization validation timeout |
0x34040040 | LCC_ALG_APP_ERR | 64 | Internal parameter error |
0x34040041 | LCC_ALG_INPUT_ERR | 65 | Input missing or erroneous (data integrity) |
0x34040042 | LCC_ALG_DISK_ERR | 66 | Project directory full / hard disk error |
0x34040043 | LCC_ALG_PROJECT_DATA_ERR | 67 | Project file corrupted |
0x34040060 | LCC_ALG_MEMORY_SHORT_ERR | 96 | Insufficient system memory |
0x34040061 | LCC_ALG_DATA_TO_LARGE_ERR | 97 | Data scale too large (algorithm internal limit) |
0x34040070 | LCC_ALG_UNKNOWN_GPU_ERR | 112 | Unknown GPU call error (unstable driver) |
0x34040071 | LCC_ALG_GPU_MEM_ERR | 113 | Insufficient GPU VRAM |
2.2 Acquisition / Pose / Camera
| Error Code | Name | Exit Code | Meaning |
|---|---|---|---|
0x34040100 | LCC_ALG_PROJECT_DEMAGED_ERR | 12/16/14 | Project file corrupted |
0x34040101 | LCC_ALG_LIO_ERR | 10 | LIO/offline SLAM pose solving error |
0x34040102 | LCC_ALG_CAMERA_SYNC_ERR | 20 | External camera synchronization failed |
0x34040103 | LCC_ALG_CAMERA_DAMAGED_ERR | 17 | External camera file corrupted |
0x34040104 | LCC_ALG_SCAN_SHORT_ERR | 16 | Stationary during scanning / motion path too short |
0x34040105 | LCC_ALG_DRONE_NOT_RTK | 18 | Drone image has no RTK information or is corrupted |
0x34040106 | LCC_ALG_3DGS_DRONE_IMAGE_ERR | 17 | Input drone image corrupted |
0x34040107 | LCC_ALG_3DGS_PAGE_LOCKED_MEMORY_ERR | 63(0x3F) | Page-locked memory error |
0x34040108 | LCC_ALG_3DGS_NO_GAUSSIAN_PRIMITIVES_ERR | 10 | No Gaussian primitives detected during 3DGS generation |
0x34040109 | LCC_ALG_3DGS_UNSUPPORTED_GNSS_ERR | 10 | Unsupported GNSS type detected |
2.3 Fusion / SfM / 3DGS
| Error Code | Name | Exit Code | Meaning |
|---|---|---|---|
0x34040200 | LCC_ALG_MAP_FUSION_ERR / LCC_ALG_MAP_FUSION_RTK_ERR | 28 / 26 | Map Fusion error (insufficient RTK signal or control point error) |
0x34040201 | LCC_ALG_3DGS_MAP_RTK_POINT_ERR | 13 | Map merge failed (recommend prioritizing RTK or covering all control points) |
0x34040202 | LCC_ALG_3DGS_CONTROL_MAP_ALIG_ERR | 27 | Map alignment error (control point error) |
0x34040203 | LCC_ALG_IMAGE_SCAN_ENV_ERR | 16 | Image registration failed (scanning environment/technique issue) |
0x34040204 | LCC_ALG_3DGS_DATA_TOO_SHORT | 17 | Scan duration too short / decoding failed |
0x34040205 | LCC_ALG_3DGS_IMAGES_TO_LESS | 16 | Too few input images |
2.4 Reconstruction Warnings (0x24040xxx, do not block reconstruction)
| Error Code | Name | Meaning |
|---|---|---|
0x24040100 | LCC_ALG_MAP_FUSION_WARN | Insufficient data association in part of Map Fusion (overlap areas may be misaligned/ghosted) |
0x24040101 | LCC_ALG_DRONE_IMAGE_LSOT_WARN | Insufficient association of some drone images causing missing areas |
0x24040102 | LCC_ALG_IMAGE_LOST_WARN | Relocalization failed for some HD supplementary capture images |
0x24040103 | LCC_ALG_3DGS_LIMT_WARN | 3DGS triggered the VRAM upper limit, quality degraded |
0x24040104 | LCC_ALG_3DGS_DRONE_GNSS_LESS | Insufficient aerial GNSS information (result may lack absolute coordinates) |
3. Space Recognition Error Codes (0x33xxxxxx)
Only appear when the space recognition features (semantic segmentation/segmentation/OCR/enhancement/Scan2BIM, etc.) are enabled.
3.1 Common Error Codes (shared by all space recognition)
| Error Code | Name | Meaning |
|---|---|---|
0x33001001 | LCC_AI_COMMON_INIT_ERR | Failed to initialize AI inference environment |
0x33001002 | LCC_AI_COMMON_MODEL_FILE_ERR | Unable to open AI model file |
0x33001003 | LCC_AI_COMMON_CUDA_ERR | CUDA/GPU backend unavailable |
0x33001004 | LCC_AI_COMMON_OUTPUT_NOT_WRITABLE_ERR | Output path not writable |
0x33001005 | LCC_AI_COMMON_DISK_SPACE_ERR | Insufficient disk space at output path |
0x33001006 | LCC_AI_COMMON_USER_CANCEL_ERR | User cancelled |
0x33001007 | LCC_AI_COMMON_IMAGE_FILE_ERR | Unable to open input image file |
0x33001008 | LCC_AI_COMMON_IMAGE_FOLDER_ERR | Unable to open input image folder |
0x33001009 | LCC_AI_COMMON_IMAGE_INVALID_ERR | Image input error |
0x3300100A | LCC_AI_COMMON_INFER_ERR | Inference execution failed |
0x3300100B | LCC_AI_COMMON_BATCH_PARTIAL_ERR | Partial batch input failed |
4. Non-Standard Codes (Ad Hoc Short Codes & Status Words)
4.1 Ad Hoc Short Codes
| Value | Scenario |
|---|---|
0x00001 | Device does not support this feature (F1 HD supplementary capture/fusion) |
0x00002 | Gaussian point count exceeded (ad hoc legacy code, now standardized as 0x3404102B) |
0x00003 | Gaussian point count range illegal (ad hoc legacy code, now standardized as 0x3404102C) |
0X10001 | CheckSupportDevice failed: this device is not supported for now |
0x34041404 | C1 device lacks LiteCode, not supported |
4.2 Pure Status Words (Semantic Labels, Not Error Codes)
| Value | Scenario |
|---|---|
DOWNLOAD_FAILED | cloud input object storage download failed |
UPLOAD_FAILED | output result object storage upload failed |
USER_STOP | User manually stopped |
STALE_STATE | Task hung and forced to a terminal state by stop |
NODE_BUSY / ALREADY_RUNNING | Node busy / task already running (appears in the start response, not buildErrCode) |
5. Common Failure Quick Reference (Scenario → Error Code/Message)
| Symptom | Possible Error Code/Message | Handling Suggestion |
|---|---|---|
Http authentication failed immediately at startup | HTTP 403 | Check that accessKey matches the server configuration |
Single-map LAST TASK STILL IN PROGRESS when busy | bizCode 1 | Pass jobQueueEnabled:1 to queue, or wait for the current task to finish |
| Input directory cannot be opened/found | 0x34041003 or No such file or directory | Check the mount path inside the container and commas |
| Missing project_data / HBC / poses.csv / project.json | 0x34041004~0x34041009 | Check the integrity of the scan project files |
| Fusion has no RTK/control points | 0x34041014 / 0x34041015 | Fusion scenarios require valid RTK or control points |
| Inconsistent fusion device/lidar | 0x34041016 / 0x34041017 | Fusion data must come from the same device model |
| Drone images < 100 | 0x34041025 | At least 100 JPG/JPEG images |
| Gaussian points exceed limit | 0x3404102B / message "cannot exceed N" | Lower maximumGaussianPoint or switch to larger VRAM |
| Gaussian point range illegal | 0x3404102C | Pass 8–50 |
| Insufficient VRAM | 0x34040071 / 0x34041001 | Lower quality/point count or free GPU |
| Insufficient system memory | 0x34040060 | Close background applications or lower quality |
| Data scale too large | 0x34040061 | Reduce input data or lower quality |
| User cancelled | 0x34041020 | This is an active stop; can resume to continue |
| Upload failed | UPLOAD_FAILED (buildErrLog has the specific reason) | Check object storage credentials/network |
| Download failed | DOWNLOAD_FAILED | Check cloudInput endpoint/bucket/credentials |
This chapter is from the official XGRIDS user manual. Official source (opens in a new tab) · Updated:
