Request-response messages carry the result in the Error error = 15 field of the response, holding the code code and description desc. This page lists the error codes exposed by the OpenAPI, by category, with their numeric values.
Looking up a name from a value
Both Error.code and DeviceStatusReport.modeling_state are uint32; the client wrapper decodes them into decimal integers. Convert the integer to hexadecimal, then look up the name in the "Value" column below. For example, the device returns 302252033, which is 0x12040001 in hex and corresponds to EC_Success; a modeling_state of 302252332, i.e. 0x1204012C, corresponds to EC_ScanReady (standby).
code = rsp["error"]["code"]
print(hex(code)) # 0x12040001
The high 16 bits of the value indicate the category; the public error codes below are grouped accordingly. The device enum also contains values not listed here (with high 16 bits such as 0x2201, 0x2203, 0x3203); treat an unlisted value as unknown and do not error out on it. Do not judge the category by the name prefix alone: names starting with EC_Scan span status, warning, and error categories — rely on the value.
| High 16 bits | Category | Section on this page |
|---|
0x1204 | Status & success | General status, upgrade status, activation status, Ntrip status, scan status |
0x2204 | Warning | Scan warning codes |
0x3201 | Device exception | Device exception codes |
0x3204 | Error | General errors, Ntrip errors, external-storage errors, scan errors |
0x3205 | Calibration error | Calibration error codes |
General status codes
| Name | Value (hex, decimal) | Meaning |
|---|
EC_UnknownState | 0x12040000 (302252032) | Unknown state |
EC_Success | 0x12040001 (302252033) | Success |
EC_SuccessAndReboot | 0x12040002 (302252034) | Success and reboot |
EC_RequestSuccess | 0x12040001 (302252033) | Request successful (same as EC_Success) |
General error codes
| Name | Value (hex, decimal) | Meaning |
|---|
EC_UnknownError | 0x32040000 (839122944) | Unknown error |
EC_ProtoError | 0x32040001 (839122945) | Protocol error |
EC_RequestError | 0x32040002 (839122946) | Request error |
Upgrade status codes
| Name | Value (hex, decimal) | Meaning |
|---|
EC_UpgradeOnGoing | 0x120400C8 (302252232) | Upgrade in progress |
EC_UpgradeFileNotExist | 0x120400C9 (302252233) | File does not exist |
EC_UpgradeFileBroken | 0x120400CA (302252234) | File is corrupted |
EC_UpgradeProtoError | 0x120400CB (302252235) | Protocol error |
EC_UpgradeFailed | 0x120400CC (302252236) | Upgrade failed |
EC_UpgradeSucceed | 0x120400CD (302252237) | Upgrade succeeded |
EC_UpgradeLowBattery | 0x120400CE (302252238) | Battery level too low |
EC_UpgradeInternalError | 0x120400CF (302252239) | Internal error |
Activation status codes
| Name | Value (hex, decimal) | Meaning |
|---|
EC_Activated | 0x120401F4 (302252532) | Activated |
EC_Deactivated | 0x120401F5 (302252533) | Not activated |
Ntrip status and error codes
| Name | Value (hex, decimal) | Meaning |
|---|
EC_NtripLoginSuccess | 0x12040001 (302252033) | Ntrip login successful |
EC_NtripLogoutSuccess | 0x12040001 (302252033) | Ntrip logout successful |
EC_NtripDisConnected | 0x12040191 (302252433) | Ntrip service disconnected |
EC_NtripLogoutFailed | 0x32040002 (839122946) | Ntrip logout failed |
EC_NtripNetworkError | 0x32040003 (839122947) | Ntrip network error |
EC_NtripAuthError | 0x32040004 (839122948) | Ntrip authentication failed |
EC_NtripTimeoutError | 0x32040005 (839122949) | Ntrip execution timeout |
External storage (Udisk) error codes
| Name | Value (hex, decimal) | Meaning |
|---|
EC_UdiskNotMounted | 0x3204000B (839122955) | External storage not mounted |
EC_UdiskStorageLow | 0x3204000C (839122956) | External storage space insufficient |
EC_UdiskNoProject | 0x3204000D (839122957) | No project to transfer |
EC_UdiskTransferError | 0x3204000E (839122958) | External storage transfer error |
EC_UdiskLowBattery | 0x3204000F (839122959) | Insufficient battery for external storage transfer |
Device exception codes
| Name | Value (hex, decimal) | Meaning |
|---|
EC_ExBatteryLow | 0x32011001 (838930433) | Low battery level |
EC_ExStorageLow | 0x32011002 (838930434) | Low storage capacity |
EC_ExImuAbnormal | 0x32011003 (838930435) | IMU abnormal |
EC_ExImuHalt | 0x32011004 (838930436) | IMU stopped working |
EC_ExEncoderAbnormal | 0x32011005 (838930437) | Encoder abnormal |
EC_ExEncoderHalt | 0x32011006 (838930438) | Encoder stopped working |
EC_ExCamera0Abnormal | 0x32011007 (838930439) | Camera 0 abnormal |
EC_ExCamera1Abnormal | 0x32011009 (838930441) | Camera 1 abnormal |
EC_ExCamera2Abnormal | 0x3201100D (838930445) | Camera 2 abnormal |
EC_ExCamera3Abnormal | 0x3201100B (838930443) | Camera 3 abnormal |
EC_ExCamera0Halt | 0x32011008 (838930440) | Camera 0 stopped working |
EC_ExCamera1Halt | 0x3201100A (838930442) | Camera 1 stopped working |
EC_ExCamera2Halt | 0x3201100E (838930446) | Camera 2 stopped working |
EC_ExCamera3Halt | 0x3201100C (838930444) | Camera 3 stopped working |
EC_ExBatteryEmpty | 0x3201100F (838930447) | Battery depleted |
EC_ExStorageEmpty | 0x32011010 (838930448) | Storage depleted |
EC_ExLidarAbnormal | 0x32011011 (838930449) | LiDAR abnormal |
EC_ExLidarHalt | 0x32011012 (838930450) | LiDAR stopped working |
EC_ExCpuTempHigh | 0x32011013 (838930451) | CPU temperature too high |
EC_ExSlipRingOverLife | 0x32011014 (838930452) | Slip ring service life expired |
EC_ExHardwareFault | 0x32011015 (838930453) | Hardware fault |
EC_ExMagneticAbnormal | 0x32011016 (838930454) | Magnetic sensor abnormal |
EC_ExMagneticHalt | 0x32011017 (838930455) | Magnetometer data stopped |
EC_ExSlamStopFailed | 0x32011018 (838930456) | Algorithm stop exception |
EC_ExBatteryTempHigh | 0x32011019 (838930457) | Battery temperature too high |
EC_ExUdiskLow | 0x3201101A (838930458) | External storage capacity low |
EC_ExUdiskEmpty | 0x3201101B (838930459) | External storage capacity depleted |
EC_ExUdiskRemove | 0x3201101C (838930460) | External storage removed |
Scan status codes
| Name | Value (hex, decimal) | Meaning |
|---|
EC_ScanReady | 0x1204012C (302252332) | Standby |
EC_ScanStarting | 0x1204012D (302252333) | Starting scan |
EC_ScanModeling | 0x1204012E (302252334) | Scanning |
EC_ScanStopping | 0x1204012F (302252335) | Stopping scan |
EC_ScanStopped | 0x12040130 (302252336) | Scan finished |
Besides the table above, modeling_state may also take the scan warning codes EC_ScanMappingAbort, EC_ScanNotAllowedInUsbMass, and EC_ScanProjectTransferring. For example, in USB mass storage mode the device reports 0x2204013E; waiting indefinitely for EC_ScanReady then times out.
Scan error codes
| Name | Value (hex, decimal) | Meaning |
|---|
EC_ScanMountError | 0x32040131 (839123249) | Mount error |
EC_ScanStorageError | 0x32040132 (839123250) | Storage error |
EC_ScanSlamError | 0x32040133 (839123251) | Mapping error |
EC_ScanPreIDError | 0x32040134 (839123252) | Pre-project error |
EC_ScanStorageEmpty | 0x32040135 (839123253) | Disk capacity empty |
EC_ScanCameraError | 0x32040136 (839123254) | Camera error |
EC_ScanRelocSuccess | 0x32040137 (839123255) | Relocation successful (the name contains Success, but the value starts with 0x3204, assigned from the error base) |
EC_ScanRelocFailed | 0x32040138 (839123256) | Relocation failed |
EC_ScanSlamAbort | 0x32040139 (839123257) | Algorithm aborted |
EC_ScanStorageLow | 0x3204013A (839123258) | Insufficient disk space |
EC_ScanMemoryLow | 0x3204013B (839123259) | Insufficient memory |
EC_ScanLidarError | 0x3204013C (839123260) | LiDAR data abnormal |
Calibration error codes
| Name | Value (hex, decimal) | Meaning |
|---|
EC_CalibFailed | 0x32050001 (839188481) | Calibration failed |
EC_CalibMagRtkError | 0x32050002 (839188482) | Magnetometer calibration RTK state error |
EC_CalibMagLackDataError | 0x32050003 (839188483) | Magnetometer calibration data acquisition abnormal |
EC_CalibFileNotExists | 0x32050004 (839188484) | File does not exist |
EC_CalibFileNotPermitted | 0x32050005 (839188485) | File operation not permitted |
Scan warning codes
| Name | Value (hex, decimal) | Meaning |
|---|
EC_ScanMappingAbort | 0x2204013D (570687805) | Mapping aborted, packet recording only |
EC_ScanNotAllowedInUsbMass | 0x2204013E (570687806) | Scan not allowed in USB mass storage mode |
EC_ScanProjectTransferring | 0x2204013F (570687807) | Scan not allowed during project transfer |
EC_ScanPclRefineError | 0x22040140 (570687808) | PCL refine failed |
EC_ScanPcbinDataError | 0x22040141 (570687809) | Pcbin data abnormal (causes LAS file generation to fail) |
EC_ScanXbinDataError | 0x22040142 (570687810) | Xbin data abnormal (causes post-processing to fail) |
Note: this page lists only the error codes exposed by the OpenAPI; the device has more, and they may change across firmware versions. For an unlisted code, first confirm the category from the hex value, then refer to the desc in the response. Note: on a successful AC_ADD for control_point, desc is the pose numbers of the point, not a text description.
