BLEmax API

Οδηγός για προγραμματιστές · ανάγνωση ζύγισης από ζυγό T-Scale Bluetooth · BLEmax για Windows 1.0.3

Με δυο λόγια

Το BLEmax τρέχει στον υπολογιστή του ταμείου και είναι συνδεδεμένο με τον ζυγό μέσω Bluetooth. Όσο είναι ανοιχτό, δίνει τη ζύγιση με ένα απλό αίτημα HTTP στον ίδιο υπολογιστή. Δεν χρειάζεται βιβλιοθήκη, driver ή σειριακή θύρα.

ΣτοιχείοΤιμή
Διεύθυνσηhttp://127.0.0.1:8770
ΜέθοδοςGET (μόνο ανάγνωση)
ΠιστοποίησηΚαμία. Απαντά μόνο σε αιτήματα από τον ίδιο υπολογιστή.
ΜορφήJSON, UTF-8. Επιτρέπεται και από σελίδα browser (CORS *).
ΡυθμόςΣε συνεχή αποστολή ο ζυγός στέλνει περίπου 10 μετρήσεις το δευτερόλεπτο. Ρωτήστε 2–4 φορές το δευτερόλεπτο· αρκεί και για τους δύο τρόπους λειτουργίας του ζυγού.

GET /weight

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"
}
ΠεδίοΤύποςΣημασία
modestring"stream" = ο ζυγός στέλνει συνεχώς, "ask" = στέλνει μόνο όταν του ζητηθεί (δείτε παρακάτω).
connectedbooleanΤο BLEmax είναι συνδεδεμένο με τον ζυγό.
weightnumber ή nullΒάρος στη μονάδα unit. null όταν δεν υπάρχει πρόσφατη μέτρηση (αποσυνδεδεμένος ή σβηστός ζυγός).
weight_textstringΤο βάρος ακριβώς όπως το στέλνει ο ζυγός (με τα δεκαδικά του), ή κενό.
unitstringkg ή g.
stablebooleanΤο βάρος έχει σταθεροποιηθεί. Καταχωρήστε το βάρος μόνο όταν είναι true.
overloadbooleanΥπερφόρτωση ζυγού.
netbooleantrue = καθαρό βάρος (έχει οριστεί απόβαρο στον ζυγό), false = μικτό.
status, typestringΟι κωδικοί του ζυγού: ST σταθερό, US ασταθές, OL υπερφόρτωση· GS μικτό, NT καθαρό.
unit_pricenumber ή nullΗ τιμή κιλού που έχει γράψει ο χειριστής στο BLEmax (όχι του ζυγού).
totalnumber ή nullΒάρος × τιμή κιλού, στρογγυλεμένο στο λεπτό.
age_msnumber ή nullΠόσα χιλιοστά του δευτερολέπτου πριν ήρθε η μέτρηση.
timestringΤοπική ώρα του υπολογιστή τη στιγμή της απάντησης.

Ζυγός που στέλνει «με αίτημα»

Ο ζυγός μπορεί να είναι ρυθμισμένος να στέλνει το βάρος συνεχώς ή μόνο όταν του ζητηθεί. Το πρόγραμμά σας δεν χρειάζεται να ξέρει ποιο από τα δύο ισχύει: καλεί πάντα το ίδιο GET /weight.

modeΤι κάνει το BLEmax σε κάθε κλήσηΧρόνος απάντησης
"stream"Επιστρέφει την πιο πρόσφατη μέτρηση που έστειλε ο ζυγός.αμέσως
"ask"Ζητά εκείνη τη στιγμή νέα ζύγιση από τον ζυγό και επιστρέφει την απάντησή του.συνήθως 0,1–0,3 δευτ., το πολύ περίπου 1,5 δευτ.

Πού ορίζεται ο τρόπος (stream ή ask). Στο μενού του ίδιου του ζυγού, όχι από το API:

  1. Κουμπί με το γρανάζι (ρυθμίσεις) στον ζυγό.
  2. 2 φορές βελάκι κάτω μέχρι να δείξει F3, μετά Enter → η οθόνη δείχνει F3 1.
  3. Βελάκι κάτω → F3 2, μετά Enter.
  4. Βελάκι κάτω → εμφανίζεται Send mode, μετά Enter.
  5. Επιλογές: CONTINUS (συνεχής αποστολή → mode: "stream"), ASK (αποστολή μόνο σε αίτημα → mode: "ask"), OFF (ο ζυγός δεν στέλνει βάρος).

Μετά την αλλαγή, ο χειριστής πατά Έλεγχος στο BLEmax ώστε το πεδίο mode να ακολουθήσει τη ρύθμιση του ζυγού. Με OFF το API επιστρέφει weight: null.

GET /weight.txt

Μόνο το βάρος ως απλό κείμενο, π.χ. 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"])

Καλές πρακτικές

Το API δεν στέλνει εντολές στον ζυγό: μηδένισμα και απόβαρο γίνονται από τα πλήκτρα του ζυγού.
Χρειάζεστε πρόσβαση από άλλον υπολογιστή του δικτύου, άλλη θύρα ή άλλη μορφή δεδομένων; Επικοινωνήστε με την ITnow: [email protected].