Error Codes
Robots report errors as numeric codes. This page documents the codes Bumper
currently maps; unrecognized numeric codes remain visible without an invented
description.
Code meanings can vary by robot family. The sections below group codes by the
component or fault area suggested by their names and available reference data;
they do not imply that every code applies to every robot.
Robot components
Code
Name
Description
0
ERROR_NO
No error
101
ERROR_BATTERY_LOW
Battery low
102
ERROR_HANG
The unit hangs
103
ERROR_WHEEL
Wheel abnormal
104
ERROR_DOWNSENSORABNORMAL
Down sensor abnormal
105
ERROR_STUCK
Stuck
106
ERROR_SIDEBRUSHEXHAUSTED
Side brush exhausted
107
ERROR_DUSTCASEHEAPEXHAUSTED
Dust case exhausted
108
ERROR_SIDEABNORMAL
Side brush abnormal
109
ERROR_ROLLABNORMAL
Roller abnormal
110
ERROR_NODUSTBOX
No dust box
111
ERROR_BUMPABNORMAL
Bumper abnormal
112
ERROR_LDSABNORMAL
Laser distance sensor abnormal
113
ERROR_MAINBRUSHEXHAUSTED
Main brush exhausted
114
ERROR_DUSTCASEEXHAUSTED
Dust case filled
115
ERROR_BATTERYERROR
Battery error
116
ERROR_FORWARDLOOKINGERROR
Forward looking sensor error
117
ERROR_GYROSCOPEERROR
Gyroscope error
118
ERROR_STRAINERBLOCK
Strainer blocked
119
ERROR_FANERROR
Fan error
120
ERROR_WATERBOX_ERROR
Water box error
121
ERROR_PLATE_JAMMED
Plate jammed
125
ERROR_HARDWIPE_TANK_MACHINERY_ERROR
Hard wipe tank machinery error
126
ERROR_NO_HARDWIPE_TANK
No hard wipe tank
127
ERROR_NO_HARDWIPE_BRUSH
No hard wipe brush
128
ERROR_SET_HARDWIPE_BRUSH
Hard wipe brush not set
129
ERROR_BIND_HARDWIPE_BRUSH
Hard wipe brush not bound
Appliance components
Code
Name
Description
201
ERROR_AIRFILTERUNISTALL
Air filter not installed
202
ERROR_ULTRASONICCOMPONENTABNORMAL
Ultrasonic component abnormal
203
ERROR_SMALLWHEELERROR
Small wheel error
204
ERROR_WHEEL_HANG
Wheel hang
205
ERROR_ION_STERILIZE_EXHAUSTED
Ion sterilize exhausted
206
ERROR_ION_STERILIZE_ABNORMAL
Ion sterilize abnormal
207
ERROR_ION_STERILIZE_FAULT
Ion sterilize fault
209
ERROR_DTOF_ABNORMAL
dToF sensor abnormal
Mop station
Code
Name
Description
301
ERROR_MCD_NO_CLEANWATER
Mop station: no clean water
302
ERROR_MCD_FULL_DIRTYWATER
Mop station: dirty water full
303
ERROR_MCD_NO_CLEANWATER_TANK
Mop station: no clean water tank
304
ERROR_MCD_NO_DIRTYWATER_TANK
Mop station: no dirty water tank
305
ERROR_MCD_CLEANTANK_ERROR
Mop station: clean tank error
306
ERROR_MCD_NO_CLEANTANK_WEB
Mop station: clean tank not connected
307
ERROR_MCD_MACHINERY_ERROR
Mop station: machinery error
308
ERROR_MCD_CONNECTION_ERROR
Mop station: connection error
309
ERROR_TANK_TOOHOT_ERROR
Water tank too hot
Base station
Code
Name
Description
310
ERROR_AUTO_EMPTY_OPEN
Auto empty station: lid open
311
ERROR_AUTO_EMPTY_UNINSTALL
Auto empty station: not installed
312
ERROR_AUTO_EMPTY_FULL
Auto empty station: dust bag full
313
ERROR_AUTO_EMPTY_UNKNOWN
Auto empty station: unknown error
314
ERROR_BASE_STATION_WATER_UNINSTALL
Base station: water filter not installed
315
ERROR_BASE_STATION_SILVER_UNINSTALL
Base station: silver module not installed
316
ERROR_BASE_STATION_FULL_UNINSTALL
Base station: dust bag not installed
317
ERROR_BASE_STATION_UD_WATER_UNINSTALL
Base station: undiluted water module not installed
318
ERROR_BASE_STATION_UD_WATER_FULL
Base station: undiluted water full
319
ERROR_BASE_STATION_CLEAN_WATER_EMPTY
Base station: clean water empty
GOAT mower
Code
Name
Description
401
ERROR_TILT
Tilt
402
ERROR_OVERHANG
Overhang
403
ERROR_SENSOR
Sensor
404
ERROR_BATTERY
Battery
405
ERROR_LEFT_DRIVING_WHEEL
Left driving wheel
406
ERROR_ROTATION_CUTTER_HEAD
Rotation cutter head
407
ERROR_BUMP_PLATE
Bump plate
408
ERROR_TO_ERASE
To erase
409
ERROR_CLEAN_LENS
Clean lens
410
ERROR_GET_LOST
Get lost
411
ERROR_STATION_LOCATION
Station location
412
ERROR_BEACON_LOCATION
Beacon location
414
ERROR_RGBD_DIRTY
RGBD dirty
415
ERROR_PANORAMIC_CAMEAR_DIRTY
Panoramic camera dirty
416
ERROR_BATTERY_HIGH_TEMPERATURE
Battery high temperature
417
ERROR_BATTERY_LOW_TEMPERATURE
Battery low temperature
418
ERROR_IN_FORBIDDEN_AREA
In forbidden area
420
ERROR_OUT_OF_MAP_RANGE
Out of map range
421
ERROR_BEACON_SINGAL
Beacon signal
422
ERROR_GPS_SIGNAL_WEAK_BACK
GPS signal weak back
423
ERROR_GPS_SIGNAL_WEAK_WAIT
GPS signal weak wait
424
ERROR_RIGHT_DRIVING_WHEEL
Right driving wheel
430
ERROR_SENSOR430
Sensor 430
431
ERROR_SENSOR431
Sensor 431
432
ERROR_SENSOR432
Sensor 432
433
ERROR_SENSOR433
Sensor 433
434
ERROR_SENSOR434
Sensor 434
435
ERROR_SENSOR435
Sensor 435
520
ERROR_TRAPPED
Trapped
Camera and vision
Code
Name
Description
601
ERROR_ClosedAIVISideAbnormal
Closed AI vision: side abnormal
602
ERROR_ClosedAIVIRollAbnormal
Closed AI vision: roller abnormal
Code reference
The mapping is maintained in bumper/utils/device_errors.py:
from bumper.utils.device_errors import describe
describe ( 312 )
This returns Auto empty station: dust bag full (312). The app-compatible
api/pim/eventdetail.html?errcode=... page uses the same mapping. Guidance is
curated for some codes; other codes receive safe, general recommendations that
are identified as generic rather than official Ecovacs instructions.