Skip to main content

LCC Studio Linux Manual · v1.6.0 · Page 8 of 9

Appendix - Error Code List

1. Software Scheduling Layer Error Codes (LCC_MANAGER_*, 0x34041xxx / 0x24041xxx)

1.1 System and Resources

Error CodeNameMeaning
0x34041100LCC_MANAGER_UNKNOWN_ERRSystem unknown error
0x34041000LCC_MANAGER_DISK_ERRInsufficient disk space
0x34041001LCC_MANAGER_GPU_ERRGPU validation failed (driver/compatibility)
0x34041002LCC_MANAGER_APP_ERRMissing program component
0x34041021LCC_MANAGER_NO_AUTHAuthorization not activated / scene count exceeded

1.2 Scan Project Input Validation

Error CodeNameMeaning
0x34041003LCC_MANAGER_SCAN_DATA_ERRScan project does not exist (wrong path)
0x34041004LCC_MANAGER_PROJEC_DATA_ERRMissing project_data directory
0x34041005LCC_MANAGER_HBC_ERRMissing or empty HBC/xbin file
0x34041006LCC_MANAGER_ROSBAG_ERRHBC file format/content error
0x34041007LCC_MANAGER_POSES_ERRMissing poses.csv
0x34041008LCC_MANAGER_DEVICE_INFO_ERRMissing project_data/log/device_info.txt
0x34041009LCC_MANAGER_PROJECT_JSON_ERRMissing project.json
0x34041010LCC_MANAGER_K1_SYETEM_VERSION_ERRK1 firmware version lower than V1.2.0

1.3 Fusion / Aerial-Ground / Aerial Validation

Error CodeNameMeaning
0x34041014LCC_MANAGER_RTK_CONTROL_POINTS_ERRMissing control points/RTK data (required for Map Fusion)
0x34041015LCC_MANAGER_RTK_POINTS_ERRControl points/RTK insufficient for fusion
0x34041016LCC_MANAGER_DEVICETYPE_ERRFusion data comes from different device types
0x34041017LCC_MANAGER_LIDAR_TYPE_ERRInconsistent lidar type in fusion data
0x34041018LCC_MANAGER_PROJECT_MAX_ERRFusion project count exceeded (>50)
0x34041019LCC_MANAGER_MAP_FUSION_MAX_LIMITTotal fusion scan duration exceeded (>200 minutes)
0x34041022LCC_MANAGER_DRONE_RTK_ERRAerial-Ground Map Fusion image RTK proportion < 80%
0x34041025LCC_MANAGER_DRONE_IMAGE_COUNT_ERRDrone image count/format error (100~10000, JPG/JPEG)
0x34041026LCC_MANAGER_DRONE_IMAGE_PX_ERRDrone image resolution < 1024×768
0x34041027LCC_MANAGER_DRONE_IMAGE_ERRInconsistent drone image resolution

1.4 HD Supplementary Capture

Error CodeNameMeaning
0x34041023LCC_MANAGER_HD_IMAGE_ERRInconsistent HD supplementary capture image resolution
0x34041024LCC_MANAGER_HD_IMAGE_COUNT_ERRHD supplementary capture count error (20~1000, JPG/JPEG/PNG)
0x3404102DLCC_MANAGER_HD_PATH_NOT_FOUND_ERRHD supplementary capture directory does not exist
0x3404102ELCC_MANAGER_HD_PATH_INVALID_ERRIllegal HD supplementary capture path (contains commas, etc.)

1.5 Lifecycle / Cancellation / Queue

Error CodeNameMeaning
0x34041020LCC_MANAGER_USER_STOP_ERRUser manually cancelled reconstruction
0x34041029LCC_MANAGER_TASK_CANCELLED_ERRTask cascade-cancelled because another stage under the same jobId failed
0x3404102ALCC_MANAGER_QUEUE_REJECT_ERRQueue layer gives up: deterministic parameter/configuration failure, retrying is pointless

1.6 Gaussian Points / Device Capability

Error CodeNameMeaning
0x3404102BLCC_MANAGER_GAUSSIAN_POINT_MAX_ERRGaussian point count exceeds the device/quality allowed upper limit
0x3404102CLCC_MANAGER_GAUSSIAN_POINT_RANGE_ERRmaximumGaussianPoint outside the valid range 8–50
0x3404102FLCC_MANAGER_DEVICE_UNSUPPORTED_FEATURE_ERRCurrent device does not support this feature (e.g., F1 does not support HD supplementary capture)
0x34041028LCC_MANAGER_VIDEO_INPUT_ERRVideo reconstruction input validation failed (probe/frame rate/images non-compliant)

1.7 Scheduling Layer Warnings (0x24041xxx, do not block reconstruction)

Error CodeNameMeaning
0x24041000LCC_MANAGER_SCANTIME_WARNDifference between scan duration and video duration > 2 minutes
0x24041001LCC_MANAGER_CPU_USE_WARNCPU load > 50% at startup
0x24041201LCC_REBUILD_CONERNT_ERRLCC data conversion processing failed

2. Reconstruction Layer Error Codes (LCC_ALG_*)

2.1 Common Reconstruction Errors

Error CodeNameExit CodeMeaning
0x34040000LCC_ALG_UNKNOWN_ERR999Algorithm unknown error (crash/not refined)
0x34040009LCC_ALG_NO_AUTH_ERR9Initialization exception / authorization validation timeout
0x34040040LCC_ALG_APP_ERR64Internal parameter error
0x34040041LCC_ALG_INPUT_ERR65Input missing or erroneous (data integrity)
0x34040042LCC_ALG_DISK_ERR66Project directory full / hard disk error
0x34040043LCC_ALG_PROJECT_DATA_ERR67Project file corrupted
0x34040060LCC_ALG_MEMORY_SHORT_ERR96Insufficient system memory
0x34040061LCC_ALG_DATA_TO_LARGE_ERR97Data scale too large (algorithm internal limit)
0x34040070LCC_ALG_UNKNOWN_GPU_ERR112Unknown GPU call error (unstable driver)
0x34040071LCC_ALG_GPU_MEM_ERR113Insufficient GPU VRAM

2.2 Acquisition / Pose / Camera

Error CodeNameExit CodeMeaning
0x34040100LCC_ALG_PROJECT_DEMAGED_ERR12/16/14Project file corrupted
0x34040101LCC_ALG_LIO_ERR10LIO/offline SLAM pose solving error
0x34040102LCC_ALG_CAMERA_SYNC_ERR20External camera synchronization failed
0x34040103LCC_ALG_CAMERA_DAMAGED_ERR17External camera file corrupted
0x34040104LCC_ALG_SCAN_SHORT_ERR16Stationary during scanning / motion path too short
0x34040105LCC_ALG_DRONE_NOT_RTK18Drone image has no RTK information or is corrupted
0x34040106LCC_ALG_3DGS_DRONE_IMAGE_ERR17Input drone image corrupted
0x34040107LCC_ALG_3DGS_PAGE_LOCKED_MEMORY_ERR63(0x3F)Page-locked memory error
0x34040108LCC_ALG_3DGS_NO_GAUSSIAN_PRIMITIVES_ERR10No Gaussian primitives detected during 3DGS generation
0x34040109LCC_ALG_3DGS_UNSUPPORTED_GNSS_ERR10Unsupported GNSS type detected

2.3 Fusion / SfM / 3DGS

Error CodeNameExit CodeMeaning
0x34040200LCC_ALG_MAP_FUSION_ERR / LCC_ALG_MAP_FUSION_RTK_ERR28 / 26Map Fusion error (insufficient RTK signal or control point error)
0x34040201LCC_ALG_3DGS_MAP_RTK_POINT_ERR13Map merge failed (recommend prioritizing RTK or covering all control points)
0x34040202LCC_ALG_3DGS_CONTROL_MAP_ALIG_ERR27Map alignment error (control point error)
0x34040203LCC_ALG_IMAGE_SCAN_ENV_ERR16Image registration failed (scanning environment/technique issue)
0x34040204LCC_ALG_3DGS_DATA_TOO_SHORT17Scan duration too short / decoding failed
0x34040205LCC_ALG_3DGS_IMAGES_TO_LESS16Too few input images

2.4 Reconstruction Warnings (0x24040xxx, do not block reconstruction)

Error CodeNameMeaning
0x24040100LCC_ALG_MAP_FUSION_WARNInsufficient data association in part of Map Fusion (overlap areas may be misaligned/ghosted)
0x24040101LCC_ALG_DRONE_IMAGE_LSOT_WARNInsufficient association of some drone images causing missing areas
0x24040102LCC_ALG_IMAGE_LOST_WARNRelocalization failed for some HD supplementary capture images
0x24040103LCC_ALG_3DGS_LIMT_WARN3DGS triggered the VRAM upper limit, quality degraded
0x24040104LCC_ALG_3DGS_DRONE_GNSS_LESSInsufficient 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 CodeNameMeaning
0x33001001LCC_AI_COMMON_INIT_ERRFailed to initialize AI inference environment
0x33001002LCC_AI_COMMON_MODEL_FILE_ERRUnable to open AI model file
0x33001003LCC_AI_COMMON_CUDA_ERRCUDA/GPU backend unavailable
0x33001004LCC_AI_COMMON_OUTPUT_NOT_WRITABLE_ERROutput path not writable
0x33001005LCC_AI_COMMON_DISK_SPACE_ERRInsufficient disk space at output path
0x33001006LCC_AI_COMMON_USER_CANCEL_ERRUser cancelled
0x33001007LCC_AI_COMMON_IMAGE_FILE_ERRUnable to open input image file
0x33001008LCC_AI_COMMON_IMAGE_FOLDER_ERRUnable to open input image folder
0x33001009LCC_AI_COMMON_IMAGE_INVALID_ERRImage input error
0x3300100ALCC_AI_COMMON_INFER_ERRInference execution failed
0x3300100BLCC_AI_COMMON_BATCH_PARTIAL_ERRPartial batch input failed

4. Non-Standard Codes (Ad Hoc Short Codes & Status Words)

4.1 Ad Hoc Short Codes

ValueScenario
0x00001Device does not support this feature (F1 HD supplementary capture/fusion)
0x00002Gaussian point count exceeded (ad hoc legacy code, now standardized as 0x3404102B)
0x00003Gaussian point count range illegal (ad hoc legacy code, now standardized as 0x3404102C)
0X10001CheckSupportDevice failed: this device is not supported for now
0x34041404C1 device lacks LiteCode, not supported

4.2 Pure Status Words (Semantic Labels, Not Error Codes)

ValueScenario
DOWNLOAD_FAILEDcloud input object storage download failed
UPLOAD_FAILEDoutput result object storage upload failed
USER_STOPUser manually stopped
STALE_STATETask hung and forced to a terminal state by stop
NODE_BUSY / ALREADY_RUNNINGNode busy / task already running (appears in the start response, not buildErrCode)

5. Common Failure Quick Reference (Scenario → Error Code/Message)

SymptomPossible Error Code/MessageHandling Suggestion
Http authentication failed immediately at startupHTTP 403Check that accessKey matches the server configuration
Single-map LAST TASK STILL IN PROGRESS when busybizCode 1Pass jobQueueEnabled:1 to queue, or wait for the current task to finish
Input directory cannot be opened/found0x34041003 or No such file or directoryCheck the mount path inside the container and commas
Missing project_data / HBC / poses.csv / project.json0x34041004~0x34041009Check the integrity of the scan project files
Fusion has no RTK/control points0x34041014 / 0x34041015Fusion scenarios require valid RTK or control points
Inconsistent fusion device/lidar0x34041016 / 0x34041017Fusion data must come from the same device model
Drone images < 1000x34041025At least 100 JPG/JPEG images
Gaussian points exceed limit0x3404102B / message "cannot exceed N"Lower maximumGaussianPoint or switch to larger VRAM
Gaussian point range illegal0x3404102CPass 8–50
Insufficient VRAM0x34040071 / 0x34041001Lower quality/point count or free GPU
Insufficient system memory0x34040060Close background applications or lower quality
Data scale too large0x34040061Reduce input data or lower quality
User cancelled0x34041020This is an active stop; can resume to continue
Upload failedUPLOAD_FAILED (buildErrLog has the specific reason)Check object storage credentials/network
Download failedDOWNLOAD_FAILEDCheck cloudInput endpoint/bucket/credentials

XGRIDS documentation, reproduced as published and captured on October 27, 2026. Read this page on docs.xgrids.com

Stuck on a Step?

QRC supports every scanner and software seat it sells. Send us the page you are on and we will walk you through it.

Contact Us
Request a Quote