Key Features

1. Device registry with per-interface connection parameters
2. Pluggable protocol parsers (ASCII Continuous, Mettler-Toledo SICS, Generic JSON)
3. Live OWL reader widget with stable-frame detection and Capture button
4. Append-only scale.reading audit log with daily retention cron
5. Token-authenticated HTTP push endpoint for headless agents
6. Multi-company isolation through standard Odoo record rules
7. Reusable scale_reader OWL service for downstream modules

Register a Scale Device

1. Go to :menuselection:`Scale Reader --> Scales` and click :guilabel:`New`.
2. Fill in the :guilabel:`Name` of the device.
3. Pick the :guilabel:`Interface Type`:
   • Web Serial for USB / RS-232 bench scales
   • Web Bluetooth for Bluetooth Low Energy scales
   • Web USB for raw USB devices
   • WebSocket for IP-attached scales
4. Pick the :guilabel:`Protocol` (ASCII Continuous, Mettler-Toledo SICS or Generic JSON).
5. Fill in the interface-specific parameters (baudrate, service UUID, vendor/product id, or WebSocket URL).
6. Set :guilabel:`Unit of Measure` and :guilabel:`Stable Only` if you want to reject unstable frames.
7. Save and click :guilabel:`Read Now` to test.

Retention

Open :menuselection:`Scale Reader --> Configuration --> Settings` and set :guilabel:`Reading Retention (days)` (default: 90). A daily cron deletes readings older than this threshold.

Capturing a Reading from the UI

1. Open the device form.
2. Click :guilabel:`Read Now` - the live reader widget opens.
3. Watch the live weight stream until the stability indicator turns green.
4. Click :guilabel:`Capture` - a scale.reading is persisted and the dialog closes.

HTTP Push from a Headless Agent

A Raspberry Pi or industrial PC can post readings without opening a browser.

curl -X POST https://your-odoo/scale/reading \
     -H "Content-Type: application/json" \
     -H "X-Scale-Token: <auth_token>" \
     -d '{"weight": 12.34, "uom": "kg", "stable": true, "raw": "ST,GS,12.34kg"}'

The endpoint validates the token against scale.device.auth_token, resolves the UoM, persists the reading and returns {"reading_id": <id>, "device_id": <id>}.

Use the :guilabel:`Rotate Token` action on the device form to invalidate the old token.

Integration for Downstream Modules

Other Odoo modules consume the same drivers via the scale_reader OWL service:

import { useService } from "@web/core/utils/hooks";

const reader = useService("scale_reader");
const session = await reader.openSession(deviceId);
for await (const frame of session.frames()) {
    // frame = { weight, uom, stable, raw }
}
await reader.recordReading(deviceId, capturedFrame);

This is exactly how :doc:`grev_od_pos_scale_reader </../grev_od_pos_scale_reader/doc/index>` plugs into Odoo POS without rewriting the Scale Screen.