Decent Espresso

Einführung zu Half Decent Scale Web Apps

Half Decent Web-Apps

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 in der Praxis. Derzeit ist dies für Browser auf Desktop- und Laptop-Computern sowie für Android- und iOS-Geräte über die WLAN-Verbindung der Waage verfügbar.

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.

Cocktail Maker : Diese interaktive App führt Sie durch alle Schritte der Zubereitung klassischer Cocktails aus dem berühmten Buch „PDT Cocktail Book“.

Erste Schritte: Verbinden und verwenden

Das Verbinden Ihrer Half Decent Scale mit unseren Web-Apps ist ganz einfach. Befolgen Sie diese Schritte:

1. 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.

2. Öffnen Sie eine App:

Navigieren Sie zu einem der oben angegebenen App-Links.

3. Aktivieren Sie den Pairing-Modus:

Versetzen Sie Ihre Half Decent Scale in den Bluetooth-Pairing-Modus.

4. 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.
    • 5. 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.

    6. 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:

    Unsere Apps unterstützen auch eine direkte USB-C-Verbindung. Wenn Sie diese Methode wählen:

  • Verbinden Sie zunächst Ihr Gerät über ein USB-C-Kabel mit der Half Decent Scale.
  • Installieren Sie dann die CH34X-Serielltreiber auf Ihrem Gerät.
  • 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.

    • Nutzung der WLAN-Verbindung (Firmware 3.0.0 erforderlich) :

    Half Decent Scale nutzt nun WLAN für zusätzliche Funktionen und Konnektivität.

  • Um den WLAN-Modus zu aktivieren, rufen Sie das HDS-Einstellungsmenü auf und suchen Sie den Eintrag „WiFi Settings“.

    • Dort können Sie WLAN aktivieren oder deaktivieren und die aktuellen WLAN-Details einsehen.

  • Wenn Sie WLAN ein- oder ausschalten, müssen Sie die Waage neu starten, damit die neuen Einstellungen wirksam werden.

    • HDS eröffnet ein eigenes WLAN mit dem Namen „Decent Scale“. Es ist mit dem Passwort „12345678“ geschützt.

  • Sobald Sie mit diesem WLAN verbunden sind, rufen Sie über Ihren Browser die Adresse hds.local oder 192.168.1.1 auf, um die WLAN-Einstellungen zu ändern.

    • Verbinden Sie HDS mit Ihrem WLAN zu Hause (2,4 GHz), indem Sie die Seite hds.local aufrufen und Ihre WLAN-ID sowie Ihr Passwort eingeben.

    Starten Sie die Waage neu, um die neuen Einstellungen zu übernehmen. Speichern Sie Ihre WLAN-Einstellungen korrekt und halten Sie Ihre HDS in Reichweite des Signals. Andernfalls kehrt es zu seinem eigenen WLAN (Decent Scale) zurück, sodass Sie die Einstellungen bei Bedarf erneut ändern können.

    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.
  • Konnektivität:
  • Web Bluetooth API (Web BLE): Ermöglicht die drahtlose Kommunikation mit der Half Decent Scale.
  • Web USB API: Bietet eine alternative kabelgebundene Verbindungsmethode.
  • Browserkompatibilität: Verwenden Sie Google Chrome (Version 136 oder neuer) oder Microsoft Edge (Version 136 oder neuer), iOS und Safari über die WLAN-Verbindung der Waage.
  • WLAN (WebSocket): Aktualisieren Sie Half Decent Scale auf Firmware 3.0.0 und befolgen Sie anschließend die obigen Anweisungen, um sie einzuschalten. HDS überträgt nun Gewichtsdaten und empfängt Tara-Befehle über den WebSocket-Endpunkt. Beispielcode finden Sie hier. hier.
  • 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.
  • modules/reconnecting-websocket.js/ : Ein einfaches Modul, das Ihnen hilft, die WebSocket-Verbindung automatisch wiederherzustellen; empfohlen bei unzureichender WLAN-Signalstärke.

    • Ausführliche Informationen zu den Kommunikationsprotokollen der Waage finden Sie im Programmierhandbuch zur Half Decent Scale.

    Entwicklungsumgebung

    Um eine lokale Kopie zum Laufen zu bringen, befolgen Sie diese einfachen Schritte:

    1. 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:
  • Verwenden Sie ein Web-Tool wie DownGit oder github1s.
  • Rufen Sie die Website des Tools auf.
  • 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.
    • 2. Navigieren Sie zum Projektverzeichnis:

    cd web_apps/dosing_assistant

    3. 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.

  • Verwenden Sie NPX's.server:

    • npx http-server -p 8000

    Öffnen Sie dann Ihren Chrome-Browser und navigieren Sie zu einer der folgenden Adressen:


    http://localhost:8000/weigh_save.html


    http://localhost:8000/dosing_assistant.html

    Dieses Projekt ist Open Source, und wir ermutigen Entwickler, den Code zu erkunden, daraus zu lernen und dazu beizutragen.

    #App

    #OpenSource

    #Javascript

    #Webweigh

    #Halfdecentscale

    #Bluetooth

    #USB

    #DecentScale

    #Wiegen

    #WLAN



  • Dies ist eine Übersetzung von: Introducing Half Decent Scale web apps


    mirjam created 2025/07/14, mirjam updated 2026/05/13