Error-handling
Error list
This section shows a table of all of the possible error codes that can be returned by the scale. The error code is called RavasCode in the .proto file.
A RavasCode shows up in three places:
- as the
result payload of a Response, answering a command you sent;
- as the
status field of a weighing result, explaining why the weight may not be shown or used;
- as the
status field of an alibi entry, telling you whether the record is valid.
The numeric values are part of the protocol and will not change.
Weighing
| Error |
Value |
Meaning |
OK |
0 |
No error |
WEIGHT_NOT_STABILIZED |
1 |
The reading is still moving |
WEIGHT_OVERLOAD |
2 |
Load above the indication ceiling. Safety critical |
WEIGHT_UNDERLOAD |
92 |
Load below the indication floor |
TARE_WHILE_NEGATIVE |
3 |
Cannot tare a negative gross weight |
ZERO_OUT_OF_RANGE |
4 |
The load is outside the zero setting range |
MAXIMUM_FORK_ANGLE_EXCEEDED |
40 |
The platform is tilted past its limit |
TIP_LOAD |
71 |
The load is tipping off the forks. Safety critical |
SIDE_LOAD |
72 |
The load sits too far off centre sideways |
SYSTEM_WARM_UP_IN_PROGRESS |
224 |
The scale is still warming up |
TOO_MANY_DIGITS_FOR_DISPLAY |
211 |
The value does not fit the configured number of digits |
WEIGH_IN_MOTION_NOT_COMPLETED |
215 |
The weigh-in-motion measurement has not finished |
WEIGH_IN_MOTION_ZEROING_REQUIRED_OIML_R51 |
225 |
OIML R51 requires the scale to be zeroed before this measurement |
EXTERNAL_REDBOX_UNAVAILABLE |
253 |
A loadcell is on an external RedBox that is unbound, has sent nothing for 10 s, or refused this master |
Totalising
| Error |
Value |
Meaning |
TOTALIZING_ALREADY_FINALIZED |
220 |
The batch is already closed, or empty |
TOTALIZING_TOO_MUCH |
221 |
The batch is full (99 weighings), or the total no longer fits the display |
TOTALIZING_MUST_RETURN_TO_ZERO |
222 |
The scale has to return to zero between two additions |
TOTALIZING_IS_ZERO |
223 |
Not returned |
Legal for trade
| Error |
Value |
Meaning |
ERROR_OIML_RESTRICTION |
41 |
Refused by an OIML rule |
ERROR_NTEP_RESTRICTION |
42 |
Refused by an NTEP rule |
ERROR_NTEP_CANADA_RESTRICTION |
43 |
Refused by a Measurement Canada rule |
ERROR_LEGAL_FOR_TRADE_RESTRICTION |
217 |
Refused because the device runs in legal for trade mode |
PARAMETER_CHANGE_NOT_ALLOWED_IN_LEGAL_FOR_TRADE_MODE |
45 |
The parameter is legally relevant and the system is sealed |
ERROR_ALIBI_FULL |
46 |
The alibi memory cannot take another record |
ALIBI_NUMBER_OUT_OF_RANGE |
212 |
No record with that alibi number |
EVENT_LOG_FULL |
219 |
The event log cannot take another entry |
Parameters and requests
| Error |
Value |
Meaning |
UNKNOWN_REQUEST_TYPE |
201 |
The device does not know this request type |
PARAMETER_CHANGE_NOT_ALLOWED_READ_ONLY |
202 |
The parameter is read-only |
UNKNOWN_PARAMETER_ID |
203 |
No parameter with that id on this page |
INVALID_PARAMETER_TYPE |
204 |
The value you sent has the wrong type for this parameter |
UNKNOWN_SCALE_NUMBER |
205 |
No scale with that index |
UNKNOWN_PARAMETER_PAGE |
206 |
No such parameter page on this device |
INVALID_PAYLOAD_TYPE |
208 |
The payload does not match the request type |
VALUE_OUT_OF_RANGE |
214 |
The value is outside what this parameter accepts |
USER_LEVEL_TOO_LOW |
227 |
Your access level does not allow writing this parameter |
INVALID_PASSWORD |
216 |
Wrong password |
NOT_IMPLEMENTED |
229 |
Recognised, but not implemented on this device |
FEATURE_NOT_ENABLED |
238 |
The device is not licensed for the requested weighing mode |
MORE_DATA |
218 |
More responses follow for this request |
NO_MORE_DATA |
230 |
End of a multi-response answer |
Hardware and system
| Error |
Value |
Meaning |
COMMUNICATION_FAILURE_ADC |
25 |
No communication with the ADC |
COMMUNICATION_FAILURE_IMU |
39 |
No communication with the IMU |
COMMUNICATION_FAILURE_RTC |
209 |
No communication with the real-time clock |
RTC_TIME_NOT_CONFIGURED |
210 |
The clock has not been set |
LOADCELL_SELFTEST_FAILED |
228 |
A loadcell failed its self-test |
CALIBRATION_BUSY |
226 |
A calibration is in progress |
LOW_BATTERY |
60 |
The battery should be charged |
CRC_ERROR |
213 |
Checksum mismatch |
INTERNAL_ERROR |
207 |
Internal firmware error |
UNKNOWN_ERROR |
200 |
Unspecified error |
SAFE_MODE |
241 |
The device restarted in safe mode after repeated crashes and only serves login, logs, parameters and firmware updates |
STORAGE_UNAVAILABLE |
244 |
A flash partition did not mount, so what it holds can be neither read nor saved |
Firmware updates
| Error |
Value |
Meaning |
FIRMWARE_SIGNATURE_INVALID |
239 |
A firmware image failed its signature check and was not installed |
FIRMWARE_NOT_RELEASE |
240 |
A sealed instrument refused a firmware image that is not a release build |
OTA_NOTHING_TO_RESUME |
242 |
No interrupted firmware update of that size is waiting to be resumed |
FIRMWARE_WRONG_HARDWARE |
243 |
A firmware image built for other hardware was not installed |
Peripherals
| Error |
Value |
Meaning |
RBDISPLAY_CONNECTING |
231 |
The RedBox display is connecting |
RBDISPLAY_DISCONNECTED |
232 |
The RedBox display is not connected |
PRINTER_CONNECTING |
235 |
The printer is connecting |
PRINTER_CONNECTED |
236 |
The printer is paired and reachable |
PRINTER_DISCONNECTED |
237 |
No printer connected |