Présentation des applications Web Half Decent Scale
Applications Web Half Decent
Les applications Web Half Decent exploitent une technologie accessible pour offrir des fonctionnalités avancées. Cette collection 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. (Actuellement disponible pour les navigateurs de bureau/ordinateurs portables et les appareils Android. iOS n'est pas pris en charge pour le moment en raison des limitations Web BLE/USB sur cette plateforme.)
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.
Pour commencer : comment connecter et utiliser
La connexion de votre Half Decent Scale à nos applications Web est très simple. Suivez les étapes suivantes :
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).
Ouvrez une application : accédez à l'un des liens vers l'application fournis ci-dessus.
Activez le mode d'appairage : mettez votre Half Decent Scale en mode d'appairage Bluetooth.
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.
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.
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 (facultatif pour « Weigh and Save ») : L'application « Weigh and Save » prend é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.
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.
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.)
API Web USB : fournit une méthode de connexion filaire alternative.
Compatibilité avec les navigateurs : Google Chrome (version 136 ou plus récente) ou Microsoft Edge (version 136 ou plus récente). Actuellement non pris en charge sur les appareils iOS.
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.
Pour obtenir une copie locale et la rendre opérationnelle, suivez ces étapes simples :
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 :
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.
Accédez au répertoire du projet :cd web_apps/dosing_assistant
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.