Το BLEmax τρέχει στον υπολογιστή του ταμείου και είναι συνδεδεμένο με τον ζυγό μέσω Bluetooth. Όσο είναι ανοιχτό, δίνει τη ζύγιση με ένα απλό αίτημα HTTP στον ίδιο υπολογιστή. Δεν χρειάζεται βιβλιοθήκη, driver ή σειριακή θύρα.
| Στοιχείο | Τιμή |
|---|---|
| Διεύθυνση | http://127.0.0.1:8770 |
| Μέθοδος | GET (μόνο ανάγνωση) |
| Πιστοποίηση | Καμία. Απαντά μόνο σε αιτήματα από τον ίδιο υπολογιστή. |
| Μορφή | JSON, UTF-8. Επιτρέπεται και από σελίδα browser (CORS *). |
| Ρυθμός | Σε συνεχή αποστολή ο ζυγός στέλνει περίπου 10 μετρήσεις το δευτερόλεπτο. Ρωτήστε 2–4 φορές το δευτερόλεπτο· αρκεί και για τους δύο τρόπους λειτουργίας του ζυγού. |
GET http://127.0.0.1:8770/weight
{
"app": "BLEmax",
"version": "1.0.3",
"mode": "stream",
"connected": true,
"device": "B0:81:84:FB:38:56",
"weight": 0.048,
"weight_text": "0.048",
"unit": "kg",
"stable": true,
"overload": false,
"net": false,
"status": "ST",
"type": "GS",
"unit_price": 14.2,
"total": 0.68,
"currency": "EUR",
"age_ms": 8,
"time": "2026-11-10T14:18:21"
}
| Πεδίο | Τύπος | Σημασία |
|---|---|---|
mode | string | "stream" = ο ζυγός στέλνει συνεχώς, "ask" = στέλνει μόνο όταν του ζητηθεί (δείτε παρακάτω). |
connected | boolean | Το BLEmax είναι συνδεδεμένο με τον ζυγό. |
weight | number ή null | Βάρος στη μονάδα unit. null όταν δεν υπάρχει πρόσφατη μέτρηση (αποσυνδεδεμένος ή σβηστός ζυγός). |
weight_text | string | Το βάρος ακριβώς όπως το στέλνει ο ζυγός (με τα δεκαδικά του), ή κενό. |
unit | string | kg ή g. |
stable | boolean | Το βάρος έχει σταθεροποιηθεί. Καταχωρήστε το βάρος μόνο όταν είναι true. |
overload | boolean | Υπερφόρτωση ζυγού. |
net | boolean | true = καθαρό βάρος (έχει οριστεί απόβαρο στον ζυγό), false = μικτό. |
status, type | string | Οι κωδικοί του ζυγού: ST σταθερό, US ασταθές, OL υπερφόρτωση· GS μικτό, NT καθαρό. |
unit_price | number ή null | Η τιμή κιλού που έχει γράψει ο χειριστής στο BLEmax (όχι του ζυγού). |
total | number ή null | Βάρος × τιμή κιλού, στρογγυλεμένο στο λεπτό. |
age_ms | number ή null | Πόσα χιλιοστά του δευτερολέπτου πριν ήρθε η μέτρηση. |
time | string | Τοπική ώρα του υπολογιστή τη στιγμή της απάντησης. |
Ο ζυγός μπορεί να είναι ρυθμισμένος να στέλνει το βάρος συνεχώς ή μόνο όταν του ζητηθεί. Το πρόγραμμά σας δεν χρειάζεται να ξέρει ποιο από τα δύο ισχύει: καλεί πάντα το ίδιο GET /weight.
mode | Τι κάνει το BLEmax σε κάθε κλήση | Χρόνος απάντησης |
|---|---|---|
"stream" | Επιστρέφει την πιο πρόσφατη μέτρηση που έστειλε ο ζυγός. | αμέσως |
"ask" | Ζητά εκείνη τη στιγμή νέα ζύγιση από τον ζυγό και επιστρέφει την απάντησή του. | συνήθως 0,1–0,3 δευτ., το πολύ περίπου 1,5 δευτ. |
"ask", το age_ms είναι πρακτικά 0: η μέτρηση είναι αυτή που μόλις ζητήθηκε.weight είναι null. Ξαναρωτήστε."ask" μην καλείτε πιο συχνά από 3–4 φορές το δευτερόλεπτο· κάθε κλήση είναι ένα αίτημα προς τον ζυγό.stable: ο ζυγός απαντά και όταν το βάρος δεν έχει σταθεροποιηθεί.Πού ορίζεται ο τρόπος (stream ή ask). Στο μενού του ίδιου του ζυγού, όχι από το API:
F3, μετά Enter → η οθόνη δείχνει F3 1.F3 2, μετά Enter.Send mode, μετά Enter.CONTINUS (συνεχής αποστολή → mode: "stream"), ASK (αποστολή μόνο σε αίτημα → mode: "ask"), OFF (ο ζυγός δεν στέλνει βάρος).Μετά την αλλαγή, ο χειριστής πατά Έλεγχος στο BLEmax ώστε το πεδίο mode να ακολουθήσει τη ρύθμιση του ζυγού. Με OFF το API επιστρέφει weight: null.
Μόνο το βάρος ως απλό κείμενο, π.χ. 0.048. Κενή απάντηση όταν δεν υπάρχει μέτρηση. Χρήσιμο για προγράμματα που δεν διαβάζουν JSON. Δεν λέει αν το βάρος είναι σταθερό.
| Κωδικός | Πότε |
|---|---|
| 200 | Κανονική απάντηση (ακόμα και χωρίς ζυγό: τότε connected: false, weight: null). |
| 403 | Η άδεια χρήσης του BLEmax έχει λήξει: {"error": "license"}. |
| Καμία απάντηση | Το BLEmax δεν είναι ανοιχτό. Χειριστείτε το ως «ζυγός μη διαθέσιμος». |
Γραμμή εντολών
curl http://127.0.0.1:8770/weight
JavaScript (σελίδα ή web εφαρμογή ταμείου)
async function readScale() {
const r = await fetch("http://127.0.0.1:8770/weight");
const s = await r.json();
if (s.connected && s.stable && s.weight !== null) return s.weight; // kg
return null; // περιμένετε και ξαναρωτήστε
}
C#
using var http = new HttpClient { Timeout = TimeSpan.FromSeconds(2) };
var json = await http.GetStringAsync("http://127.0.0.1:8770/weight");
using var doc = JsonDocument.Parse(json);
var s = doc.RootElement;
if (s.GetProperty("stable").GetBoolean())
{
decimal kg = s.GetProperty("weight").GetDecimal();
}
Python
import json, urllib.request
s = json.load(urllib.request.urlopen("http://127.0.0.1:8770/weight", timeout=2))
if s["stable"]:
print(s["weight"], s["unit"])
stable: true και overload: false.age_ms είναι πάνω από 2000, θεωρήστε τη μέτρηση παλιά.weight: null (και connected false ή, για λίγα δευτερόλεπτα, true). Συνεχίστε απλώς να ρωτάτε· δεν χρειάζεται καμία ενέργεια από το πρόγραμμά σας.weight_text και δικό σας υπολογισμό με δεκαδική αριθμητική, αν θέλετε διαφορετική στρογγυλοποίηση από του total.