Decent Espresso

Présentation des applications Web Half Decent Scale

Applications Web Half Decent

La collection suivante comprend trois applications Web développées à l'aide de JavaScript, HTML et CSS, qui illustrent les différentes fonctionnalités disponibles via Web Bluetooth Low Energy (Web BLE) et Web USB. Ces applications visent à ouvrir de nouvelles possibilités d'interaction avec votre balance Half Decent Scale, en fournissant des outils puissants pour le contrôle qualité, la pesée précise et le dosage simplifié directement depuis votre navigateur Web.

Découvrez les applications : démonstrations en direct

Essayez nos outils Web. Ils sont actuellement disponibles sur les navigateurs des ordinateurs de bureau et portables, ainsi que sur les appareils Android et iOS via la connexion Wi-Fi de la balance.

Weigh and Save : votre application incontournable pour les tâches de pesage générales. Mesurez avec précision des articles dans un délai défini et exportez facilement les résultats pour les analyser ou les enregistrer.

Quality Control Assistant : l'application idéale pour garantir la cohérence. Elle vous permet de peser plusieurs fois les mêmes articles, ce qui simplifie le suivi des données et les contrôles qualité.

Dosing Assistant : simplifiez votre processus de dosage grâce à une interface intuitive conçue pour obtenir des mesures précises et reproductibles.

Cocktail Maker : Cette application interactive vous guidera à travers toutes les étapes de la préparation de cocktails classiques tirés du célèbre livre « PDT Cocktail Book ».

Pour commencer : comment connecter et utiliser

La connexion de votre Half Decent Scale à nos applications Web est très simple. Suivez les étapes suivantes :

1. Vérification du navigateur :

assurez-vous que vous utilisez une version à jour de Google Chrome (version 136 ou plus récente) ou Microsoft Edge (version 136 ou plus récente).

2. Ouvrez une application :

accédez à l'un des liens vers l'application fournis ci-dessus.

3. Activez le mode d'appairage :

mettez votre Half Decent Scale en mode d'appairage Bluetooth.

4. Connectez-vous via l'application :
  • Cliquez sur le bouton « Connect » dans l'application web.
  • Une fenêtre contextuelle apparaîtra, répertoriant les appareils Bluetooth disponibles.
  • Sélectionnez « Decent Scale » dans la liste.
    • 5. Connexion confirmée :

    une fois connecté, le bouton « Connect » deviendra rouge et son texte sera remplacé par « Disconnect ». Vous verrez également le poids affiché en temps réel sur votre balance s'afficher à l'écran.

    6. Commencer :

    cliquez sur le bouton « Start » et suivez les instructions à l'écran spécifiques à l'application que vous utilisez.

    Utilisation d'une connexion USB-C :

    Nos applications prennent également en charge une connexion USB-C directe. Si vous optez pour cette méthode :

  • Commencez par connecter votre appareil à la balance Half Decent Scale à l'aide d'un câble USB-C.
  • Installez ensuite les pilotes série CH34X sur votre appareil.
  • Sélectionnez la connexion USB dans le menu déroulant, cliquez sur « Connect » (Connecter), puis choisissez « USB Serial » (Série USB) dans la liste contextuelle.
  • Une fois la connexion établie, le poids s'affiche en temps réel à l'écran.

    • Utilisation de la connexion Wi-Fi (firmware 3.0.0 requis) :

    Half Decent Scale utilise désormais le Wi-Fi pour offrir des fonctionnalités supplémentaires et une meilleure connectivité.

  • Pour activer le mode Wi-Fi, accédez au menu de configuration de la HDS et recherchez l'entrée « WiFi settings ».

    • Vous pouvez y activer ou désactiver le Wi-Fi et consulter les détails actuels de la connexion Wi-Fi.

  • Si vous activez ou désactivez le Wi-Fi, vous devez redémarrer la balance pour que les nouveaux paramètres prennent effet.

    • HDS ouvrira son propre réseau Wi-Fi, appelé « Decent Scale ». Il est protégé par un mot de passe : « 12345678 ».

  • Une fois connecté à ce réseau Wi-Fi, rendez-vous sur hds.local ou 192.168.1.1 à l'aide de votre navigateur pour modifier les paramètres Wi-Fi.

    • Connectez HDS au Wi-Fi de votre domicile (2,4 GHz) en vous rendant sur la page hds.local et en saisissant votre identifiant et votre mot de passe Wi-Fi.

    Redémarrez la balance pour appliquer les nouveaux paramètres. Enregistrez correctement vos paramètres Wi-Fi et veillez à ce que votre HDS reste à portée du signal. Si ce n'est pas le cas, elle se reconnectera à son propre réseau Wi-Fi (Decent Scale), ce qui vous permettra de modifier à nouveau les paramètres si nécessaire.

    Objectif et public

    Ces applications Web ont deux objectifs principaux :

  • Pour les utilisateurs de balances : fournir des outils pratiques et faciles à utiliser qui améliorent les fonctionnalités de votre Half Decent Scale pour les tâches quotidiennes.
  • Pour les développeurs : offrir une démonstration concrète des capacités du Web Bluetooth et du Web USB, afin d'encourager l'exploration et l'innovation avec ces technologies.

    • Ces applications sont idéales pour :

  • Les propriétaires d'une machine à expresso Decent et/ou d'une balance Half Decent : améliorez vos routines quotidiennes de pesée et de préparation du café.
  • Les professionnels du contrôle qualité : rationalisez les processus de pesée, améliorez la cohérence et simplifiez la collecte de données.
  • Les développeurs et les passionnés de technologie : explorez une mise en œuvre pratique de Web BLE et Web USB dans un contexte IoT.

    • Pour les développeurs : informations techniques détaillées
  • Tout le code de ces applications Web est disponible dans le répertoire web_apps du dépôt openscale.
  • Fondation : construit avec HTML, CSS et JavaScript standard.
  • Stylisation : Tailwind CSS est utilisé pour une approche de la stylisation axée sur l'utilité, garantissant une interface réactive et moderne. (Remarque : bien que Tailwind soit un framework CSS, la logique de base reste en JavaScript simple, évitant ainsi les frameworks JS lourds.)
  • Connectivité :
  • API Web Bluetooth (Web BLE) : permet la communication sans fil avec la Half Decent Scale.
  • API Web USB : fournit une méthode de connexion filaire alternative.
  • Compatibilité avec les navigateurs : utilisez Google Chrome (version 136 ou plus récente) ou Microsoft Edge (version 136 ou plus récente), iOS et Safari via la connexion Wi-Fi de la balance.
  • WIFI (Websocket): Mettez à jour la balance Half Decent Scale vers la version 3.0.0 du micrologiciel, puis suivez les instructions ci-dessus pour l'activer. HDS diffusera désormais les données de poids et recevra la commande de tare via le point de terminaison WebSocket. Consultez l'exemple de code ici. ici.
  • Stockage des données : les données telles que les lectures et les préréglages sont stockées localement dans le stockage local du navigateur. Les utilisateurs peuvent télécharger leurs données sous forme de fichiers JSON ou CSV.

    • Structure du code et modules clés

    Le code source est conçu pour être compréhensible et adaptable. Les fonctionnalités « Weigh and Save » et « Dosing Assistant » présentent une structure modulaire, tandis que le « Quality Control Assistant » utilise une structure monolithique pour une vue d'ensemble potentiellement plus simple des interactions entre les fonctions.

    Modules JavaScript clés et leurs rôles :

  • scale.js: gère le protocole BLE, la communication avec la Half Decent Scale (HDS) et les fonctionnalités de base du mode de dosage.
  • constants.js: stocke les messages préprogrammés de 10 octets pour la communication HDS et diverses valeurs seuils.
  • state-machine.js: implémente la logique de base de « Dosing Assistant » et « Quality Control Assistant » à l'aide d'un modèle de machine à états finis.
  • export.js: gère la fonctionnalité d'exportation des mesures de poids et des données d'évaluation sous forme de fichiers CSV ou JSON.
  • presets.js: permet aux utilisateurs de « Dosing Assistant » et « Quality Control Assistant » d'enregistrer les poids cibles en tant que préréglages, mis en cache localement par le navigateur.
  • ui-controller.js: gère les mises à jour et les modifications de l'interface HTML.
  • modules/connection/ (dans « Weigh and Save ») : contient les implémentations spécifiques pour les méthodes de connexion BLE et USB.
  • modules/reconnecting-websocket.js/ : un module simple qui vous aide à vous reconnecter automatiquement à WebSocket ; son utilisation est recommandée si le signal Wi-Fi n'est pas assez puissant.

    • Pour plus de détails sur les protocoles de communication de la balance, consultez le Guide pour les programmeurs de Half Decent Scale.

    Configuration du développement

    Pour obtenir une copie locale et la rendre opérationnelle, suivez ces étapes simples :

    1. Téléchargez le répertoire web_apps: GitHub ne propose pas de téléchargement direct pour les sous-répertoires. Vous pouvez utiliser un outil spécialisé à cet effet. Voici quelques options :
  • Utilisez un outil web tel que DownGit ou github1s.
  • Rendez-vous sur le site web de l'outil.
  • Collez l'URL du répertoire web_apps sur GitHub : https://github.com/decentespresso/openscale/tree/main/web_apps
  • Suivez les instructions de l'outil pour télécharger le répertoire sous forme de fichier ZIP.
  • Extrayez le fichier ZIP téléchargé. Vous devriez obtenir un dossier web_apps.
    • 2. Accédez au répertoire du projet :

    cd web_apps/dosing_assistant

    3. Servez les fichiers avec un serveur HTTP local :

    comme il s'agit d'applications web utilisant Web BLE, elles doivent être servies viahttps:// ou http://localhost

    Vous pouvez utiliser un simple serveur HTTP NPX ou tout autre serveur local de votre choix.

  • En utilisant NPX's http.server:

    • npx http-server -p 8000

    Ensuite, ouvrez votre navigateur Chrome et accédez à l'une des adresses suivantes :


    http://localhost:8000/weigh_save.html


    http://localhost:8000/dosing_assistant.html

    Ce projet est open source, et nous encourageons les développeurs à explorer, apprendre et contribuer au code source.

    #app

    #opensource

    #javascript

    #webweigh

    #halfdecentscale

    #bluetooth

    #usb

    #decentscale

    #pesage

    #WIFI



  • Ce texte est une traduction de : Introducing Half Decent Scale web apps


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