Settings
Scale settings
The driver, why you pick it by hand, and what is supported today.
A scale has one setting that matters, and it is not optional: the driver. Everything else is identity.
Deli scale
Virtual scale · Le Comptoir
Identity
Hardware
Driver
What is supported today
Kern serial scales. That is the current list:
| Manufacturer | Model | Connection |
|---|---|---|
| Kern | KCP | Serial (USB serial adapter or native serial) |
| Kern | KFB-TM | Serial (USB serial adapter or native serial) |
KCP is the protocol, not a product. Kern guarantees the same command set on every device that speaks it, and Raven sends nothing outside that set, so the one entry drives the whole range. The two entries drive a scale identically; which one to pick depends on the connector, not on the scale.
Drivers ship inside the connector, so a connector has to have been updated since KCP was added before it can drive that entry. Choosing it on a connector older than that saves without complaint and then fails every weighing with Unsupported scale model. If a connector has not been updated in a while, pick KFB-TM, which every connector that supports scales at all already knows.
GET /scales/models returns this catalogue from the running service. It is the same list the dashboard's dropdowns are built from and the same list validation accepts, so treat it as the authority rather than this page, which is a snapshot.
A scale that is not on the list is not supported. Contact Raven support to request it, before committing to the integration.
Why you have to pick it
Printers announce themselves well enough to be identified automatically. Serial scales do not: they answer in a vendor-specific frame format, and nothing about the port indicates which one. The manufacturer and model are therefore an operator input rather than a detection.
Until they are set, weigh and tare return 409. A guessed protocol can return a number that is a status code rather than a weight, or a weight off by a decimal place, and neither is distinguishable from a correct reading. An error is returned instead.
Identity and hardware
Name and description work as they do on every device type: name it by its position ("Deli counter"), not by its model.
Physical device is the serial port the scale is on. Discovery lists serial ports but cannot tell you what is plugged into them, so the technician usually confirms the right one by taking a reading.
Using the scale once it is configured is on Weighing.