## Aplicaciones web Half Decent
Esta colección presenta tres aplicaciones web creadas con JavaScript, HTML y CSS sencillos. Muestran diversas funcionalidades disponibles a través de Web Bluetooth Low Energy (Web BLE), Wi-Fi y Web USB. Estas aplicaciones abrirán nuevas formas de interactuar con su Half Decent Scale. Proporcionan potentes herramientas para el control de calidad, el pesaje preciso y la dosificación simplificada directamente desde su navegador web.
Pruebe las aplicaciones: demostraciones en vivo
Pruebe nuestras herramientas web. Actualmente están disponibles para navegadores de ordenadores de sobremesa y portátiles, dispositivos Android e iOS a través de la conexión Wi-Fi de la báscula.
Weigh and Save: su aplicación imprescindible para tareas generales de pesaje. Mida con precisión los artículos en un plazo determinado y exporte fácilmente los resultados para su análisis o registro.
Quality Control Assistant: perfecta para garantizar la consistencia. Esta aplicación le permite pesar repetidamente los mismos artículos, lo que simplifica el seguimiento de los datos y los controles de calidad.
Dosing Assistant: simplifique su proceso de dosificación con una interfaz intuitiva diseñada para lograr mediciones precisas y repetibles.
Cocktail Maker : esta aplicación interactiva le guiará a través de todos los pasos para preparar cócteles clásicos del famoso «PDT Cocktail Book».
Introducción: cómo conectar la báscula y utilizar la aplicación
Conectar su báscula Half Decent Scale a nuestras aplicaciones web es muy sencillo. Siga los siguientes pasos:
1. Comprobación del navegador:
es esencial comprobar el navegador. Utilice únicamente la última versión de Google Chrome (versión 136 o posterior) o Microsoft Edge (versión 136 o posterior).
2. Abrir una aplicación:
Vaya a uno de los enlaces de aplicaciones proporcionados anteriormente.
3. Habilitar el modo de emparejamiento:
Ponga su Half Decent Scale en modo de emparejamiento Bluetooth.
4. Conectarse a través de la aplicación:
Haga clic en el botón «Connect » (Conectar) de la aplicación web.
Aparecerá una ventana emergente con una lista de los dispositivos Bluetooth disponibles.
Seleccione «Decent Scale» en la lista.
5. Conexión confirmada:
una vez conectado, el botón «Connect » (Conectar) se volverá rojo y cambiará su texto a « Disconnect » (Desconectar). También verá las actualizaciones de peso en tiempo real de su báscula en la pantalla.
6. Comience:
haga clic en el botón «Start» (Iniciar) y siga las instrucciones en pantalla específicas de la aplicación que esté utilizando.
Uso de la conexión USB-C:
Nuestras aplicaciones también admiten una conexión USB-C directa. Si elige este método:
En primer lugar, conecte su dispositivo a la Half Decent Scale mediante un cable USB-C.
A continuación, instale los controladores serie CH34X en su dispositivo.
Seleccione la conexión USB en el menú desplegable, haga clic en «Connect » (Conectar) y elija « USB Serial » (Serie USB) en la lista emergente.
Conéctela y las actualizaciones de peso en tiempo real aparecerán en la pantalla.
Utilice la conexión WiFi (se requiere el firmware 3.0.0):
Half Decent Scale ahora utiliza WiFi para ofrecer funciones adicionales y conectividad.
Para activar el modo WiFi, vaya al menú de configuración de HDS y busque la entrada «WiFi settings » (Configuración WiFi).
Allí podrá activar o desactivar el WiFi y ver los detalles actuales de la conexión WiFi.
Si activa o desactiva el WiFi, es necesario reiniciar la báscula para que los nuevos ajustes surtan efecto.
HDS abrirá su propia red WiFi, llamada «Decent Scale». Está protegida con una contraseña: «12345678».
Una vez conectado a esta red WiFi, vaya a hds.local o 192.168.1.1 con su navegador para cambiar la configuración WiFi.
Conecte HDS a la red WiFi de su hogar (2,4 GHz) accediendo a la página hds.local e introduciendo su ID y contraseña WiFi.
Reinicie la báscula para aplicar la nueva configuración. Guarde correctamente la configuración WiFi y mantenga su HDS dentro del alcance de la señal.
Si no lo hace, volverá a su propia red WiFi (Decent Scale), lo que le permitirá cambiar la configuración de nuevo si es necesario.
Objetivo y público
Estas aplicaciones web tienen dos objetivos principales:
Para usuarios de básculas: nuestras herramientas Half Decent Scale son prácticas y fáciles de usar. Mejoran la funcionalidad de la báscula para las tareas cotidianas.
Para desarrolladores: una demostración real de las capacidades de Web Bluetooth y Web USB es esencial para fomentar la exploración y la innovación con estas tecnologías.
Estas aplicaciones son ideales para:
Propietarios de máquinas de espresso y/o Half Decent Scale: maximicen sus rutinas diarias de pesaje y preparación de café.
Profesionales del control de calidad: optimicen los procesos de pesaje, mejoren la consistencia y simplifiquen la recopilación de datos.
Desarrolladores y entusiastas de la tecnología: exploren una implementación práctica de Web BLE y Web USB en un contexto de IoT.
Para desarrolladores: información técnica detallada
El código de estas aplicaciones web está disponible en el directorio web_apps del repositorio openscale.
Fundamentos: está construido con HTML, CSS y JavaScript estándar.
Estilo: Tailwind CSS es el enfoque de estilo que da prioridad a la utilidad, lo que garantiza una interfaz moderna y con capacidad de respuesta. Nota: Tailwind es un marco de CSS, pero su lógica central está en JavaScript simple, lo que evita marcos JS pesados.
Conectividad:
API Bluetooth web (Web BLE): permite la comunicación inalámbrica con la Half Decent Scale.
API USB web: proporciona un método de conexión por cable alternativo.
Compatibilidad con navegadores: utilicen Google Chrome (versión 136 o posterior) o Microsoft Edge (versión 136 o posterior), iOS y Safari con la conexión Wi-Fi de la báscula.
WIFI (Websocket): Actualice Half Decent Scale al firmware 3.0.0 y, a continuación, siga las instrucciones anteriores para encenderla. HDS ahora transmitirá los datos de peso y recibirá el comando de tara a través del punto final WebSocket. Vea el código de ejemplo aquí.
Almacenamiento de datos: Los datos, como las lecturas y los ajustes preestablecidos, se almacenan localmente en el almacenamiento local del navegador. Los usuarios pueden descargar sus datos como archivos JSON o CSV.
Estructura del código y módulos clave
El código base está diseñado para ser comprensible y adaptable. Las funciones «Weigh and Save» (Pesar y guardar) y «Dosing Assistant» (Asistente de dosificación) cuentan con una estructura modular, mientras que «Quality Control Assistant» (Asistente de control de calidad) utiliza una estructura monolítica, lo que ofrece una visión general potencialmente más sencilla de las interacciones entre funciones.
Módulos JavaScript clave y sus funciones:
scale.js: Gestiona el protocolo BLE, la comunicación con la Half Decent Scale (HDS) y la funcionalidad básica del modo de dosificación.
constants.js: Almacena mensajes preprogramados de 10 bytes para la comunicación con la HDS y diversos valores umbral.
state-machine.js: Implementa la lógica básica de « Dosing Assistant » y « Quality Control Assistant » utilizando un modelo de máquina de estados finitos.
export.js: gestiona la funcionalidad para exportar lecturas de peso y datos de evaluación como archivos CSV o JSON.
presets.js: permite a los usuarios del « Dosing Assistant » y del « Quality Control Assistant » guardar los pesos objetivo como preajustes, almacenados en la caché local del navegador.
ui-controller.js: gestiona las actualizaciones y los cambios en la interfaz HTML.
modules/connection : contiene las implementaciones específicas para los métodos de conexión BLE y USB.
modules/reconnecting-websocket.js/ : Un módulo sencillo que le ayuda a volver a conectar el websocket automáticamente. Se recomienda su uso si la intensidad de la señal wifi no es lo suficientemente fuerte.
Consulte la Guía para los programadores de Half Decent Scale para obtener información detallada sobre los protocolos de comunicación de la Half Decent Scale.
Configuración de desarrollo
Siga estos sencillos pasos para obtener una copia local y ponerla en funcionamiento:
1. Descargue el web_apps Directorio: GitHub no ofrece descargas directas para subdirectorios. Utilice una herramienta especializada para ello. Aquí tiene un par de opciones:
Utilice una herramienta web como DownGit o github1s.
Vaya al sitio web de la herramienta.
Pegue la URL del directorio web_apps en GitHub: https://github.com/decentespresso/openscale/tree/main/web_apps
Siga las instrucciones de la herramienta para descargar el directorio como un archivo ZIP.
Extraiga el archivo ZIP descargado. Esto creará una carpeta web_apps.
2. Navegue hasta el directorio del proyecto:
cd web_apps/dosing_assistant
3. Sirva los archivos con un servidor HTTP local:
1. Dado que se trata de aplicaciones web que utilizan Web BLE, deben servirse a través de https:// o http://localhost
2. Puede utilizar un servidor HTTP NPX sencillo o cualquier otro servidor local que prefiera.
Utilizando http.server de NPX:
npx http-server -p 8000
1. A continuación, abra su navegador Chrome y navegue a:
http://localhost:8000/weigh_save.html
http://localhost:8000/dosing_assistant.html
Este proyecto es de código abierto, y animamos encarecidamente a los desarrolladores a que exploren, aprendan y contribuyan al código base.
#aplicación
#códigoabierto
#javascript
#webweigh
#halfdecentscale
#bluetooth
#usb
#decentscale
#pesaje
#WIFI