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, refused this master, or whose samples cannot be lined up in time with the scale's first loadcell |
SUM_SCALE_INVALID |
258 |
The scale adds up other scales, and that setup is invalid: the scales it adds differ in intervals or unit, or are not ordinary scales |
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 |
NOT_ON_A_SUM_SCALE |
257 |
The scale adds up other scales, is not legal for trade and stores no alibi record |
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. As a weight status: the scale has no loadcells |
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 this request or parameter write. See Login |
INVALID_PASSWORD |
216 |
Wrong username or password, or too many failed logins on this connection for now |
LEGACY_LOGIN_DISABLED |
250 |
USER_LOGIN is switched off on this link |
LEGACY_LOGIN_DEPRECATED |
251 |
Sent with message_id 0 after a successful USER_LOGIN: the login works, but will be switched off on this link |
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 |