Half Decent Web-Apps nutzen barrierearme Technologien für erweiterte Waagefunktionen. Diese Sammlung umfasst drei Webanwendungen, die mit einfachem JavaScript, HTML und CSS erstellt wurden und verschiedene Funktionen demonstrieren, die über Web Bluetooth Low Energy (Web BLE) und Web USB verfügbar sind. Diese Apps sollen neue Möglichkeiten für die Interaktion mit Ihrer Half Decent Scale eröffnen und leistungsstarke Tools für die Qualitätskontrolle, präzises Wiegen und vereinfachtes Dosieren direkt über Ihren Webbrowser bieten.
Erleben Sie die Apps: Live-Demos
Testen Sie unsere Web-Tools selbst. (Derzeit verfügbar für Desktop-/Laptop-Browser und Android-Geräte. iOS wird aufgrund von Web-BLE-/USB-Einschränkungen auf dieser Plattform derzeit nicht unterstützt.
Wiegen und Speichern: Ihre App für allgemeine Wägeaufgaben. Messen Sie Artikel innerhalb eines festgelegten Zeitraums präzise und exportieren Sie die Ergebnisse ganz einfach zur Analyse oder Archivierung.
Qualitätskontrollassistent: Perfekt für die Gewährleistung von Konsistenz. Mit dieser App können Sie dieselben Artikel wiederholt wiegen, was die Datenverfolgung und Qualitätskontrollen vereinfacht.
Dosierassistent: Vereinfachen Sie Ihren Dosierprozess mit einer intuitiven Benutzeroberfläche, die für genaue und wiederholbare Messungen entwickelt wurde.
Erste Schritte: Verbinden und verwenden
Das Verbinden Ihrer Half Decent Scale mit unseren Web-Apps ist ganz einfach. Befolgen Sie diese Schritte:
Browser-Prüfung:
Stellen Sie sicher, dass Sie eine aktuelle Version von Google Chrome (Version 136 oder neuer) oder Microsoft Edge (Version 136 oder neuer) verwenden.
Öffnen Sie eine App:
Navigieren Sie zu einem der oben angegebenen App-Links.
Aktivieren Sie den Pairing-Modus:
Versetzen Sie Ihre Half Decent Scale in den Bluetooth-Pairing-Modus.
Verbinden über die App:
Klicken Sie in der Webanwendung auf die Schaltfläche „Connect“.
Es erscheint ein Popup-Fenster mit einer Liste der verfügbaren Bluetooth-Geräte.
Wählen Sie „Decent Scale” aus der Liste aus.
Verbindung bestätigt: Sobald die Verbindung hergestellt ist, wird die Schaltfläche „Connect” rot und der Text ändert sich zu „Disconnect”. Außerdem werden die aktuellen Gewichtswerte Ihrer Waage auf dem Bildschirm angezeigt.
Beginnen: Klicken Sie auf die Schaltfläche „Start” und befolgen Sie die Anweisungen auf dem Bildschirm für die von Ihnen verwendete App.
Verwendung einer USB-C-Verbindung (optional für „Wiegen und Speichern”): Die App „Wiegen und Speichern” unterstützt auch eine direkte USB-C-Verbindung. Wenn Sie sich für diese Methode entscheiden:
Verbinden Sie zunächst Ihr Gerät über ein USB-C-Kabel mit der Half Decent Scale.
Wählen Sie die USB-Verbindung aus dem Dropdown-Menü, klicken Sie auf „Connect“ und wählen Sie „USB Serial“ aus der Popup-Liste.
Nach der Verbindung werden die aktuellen Gewichtswerte live auf dem Bildschirm angezeigt.
Zweck und Zielgruppe
Diese Webanwendungen dienen zwei Hauptzwecken:
Für Waagenbenutzer: Bereitstellung praktischer, benutzerfreundlicher Tools, die die Funktionalität Ihrer Half Decent Scale für alltägliche Aufgaben verbessern.
Für Entwickler: Bereitstellung einer praxisnahen Demonstration der Funktionen von Web Bluetooth und Web USB, um die Erforschung und Innovation dieser Technologien zu fördern.
Diese Apps sind ideal für:
Besitzer einer Decent Espressomaschine und/oder einer Half Decent Scale: Verbessern Sie Ihre täglichen Routinen beim Wiegen und bei der Kaffeezubereitung.
Fachleute für Qualitätskontrolle: Optimieren Sie Wiegeprozesse, verbessern Sie die Konsistenz und vereinfachen Sie die Datenerfassung.
Entwickler und Technikbegeisterte: Entdecken Sie eine praktische Implementierung von Web BLE und Web USB im IoT-Kontext.
Für Entwickler: Technische Details
Der gesamte Code für diese Web-Apps ist im Verzeichnis „web_apps” des openscale-Repositorys verfügbar.
Grundlage: Erstellt mit Standard-HTML, CSS und JavaScript.
Styling:Tailwind CSS wird für einen Utility-First-Ansatz beim Styling verwendet, um eine reaktionsschnelle und moderne Benutzeroberfläche zu gewährleisten. (Hinweis: Tailwind ist zwar ein CSS-Framework, die Kernlogik bleibt jedoch in einfachem JavaScript, wodurch schwerfällige JS-Frameworks vermieden werden.
Web USB API: Bietet eine alternative kabelgebundene Verbindungsmethode.
Browserkompatibilität: Google Chrome (Version 136 oder neuer) oder Microsoft Edge (Version 136 oder neuer). Derzeit nicht auf iOS-Geräten unterstützt.
Datenspeicherung: Daten wie Messwerte und Voreinstellungen werden lokal im lokalen Speicher des Browsers gespeichert. Benutzer können ihre Daten als JSON- oder CSV-Dateien herunterladen.
Code-Struktur und wichtige Module
Die Codebasis ist so konzipiert, dass sie verständlich und anpassungsfähig ist. „Weigh and Save” und „Dosing Assistant” verfügen über eine modulare Struktur, während „Quality Control Assistant” eine monolithische Struktur verwendet, um einen potenziell einfacheren Überblick über die Funktionsinteraktionen zu ermöglichen.
Wichtige JavaScript-Module und ihre Funktionen:
scale.js: Verarbeitet das BLE-Protokoll, die Kommunikation mit der Half Decent Scale (HDS) und die Kernfunktionen des Dosiermodus.
constants.js: Speichert vorprogrammierte 10-Byte-Nachrichten für die HDS-Kommunikation und verschiedene Schwellenwerte.
state-machine.js: Implementiert die Kernlogik für „Dosing Assistant“ und „Quality Control Assistant“ unter Verwendung eines Finite-State-Machine-Modells.
export.js: Verwaltet die Funktionen zum Exportieren von Gewichtswerten und Auswertungsdaten als CSV- oder JSON-Dateien.
presets.js: Ermöglicht Benutzern in „Dosing Assistant“ und „Quality Control Assistant“ das Speichern von Zielgewichten als Voreinstellungen, die lokal vom Browser zwischengespeichert werden.
ui-controller.js: Verwaltet Aktualisierungen und Änderungen der HTML-Schnittstelle.
modules/connection/ (in „Wiegen und Speichern”): Enthält die spezifischen Implementierungen für BLE- und USB-Verbindungsmethoden.
Um eine lokale Kopie zum Laufen zu bringen, befolgen Sie diese einfachen Schritte:
Laden Sie das Verzeichnis web_apps herunter: GitHub bietet keinen direkten Download für Unterverzeichnisse an. Sie können hierfür ein spezielles Tool verwenden. Hier sind einige Optionen:
Fügen Sie die URL zum Verzeichnis „web_apps“ auf GitHub ein: https://github.com/decentespresso/openscale/tree/main/web_apps
Befolgen Sie die Anweisungen des Tools, um das Verzeichnis als ZIP-Datei herunterzuladen.
Entpacken Sie die heruntergeladene ZIP-Datei. Sie sollten nun einen Ordner „web_apps“ haben.
Navigieren Sie zum Projektverzeichnis:cd web_apps/dosing_assistant
Stellen Sie die Dateien mit einem lokalen HTTP-Server bereit:
Da es sich um Webanwendungen handelt, die Web BLE verwenden, müssen sie über https:// oder http://localhostgehen. Sie können einen einfachen NPX-HTTP-Server oder einen anderen lokalen Server Ihrer Wahl verwenden.