TigerScale
Propósito
Sección titulada «Propósito»TigerScale responde a la eterna pregunta: ¿cuánto filamento queda? Pon una bobina en la báscula ESP32 de código abierto y el peso en directo fluye directamente a tu inventario: sin introducción manual, sin sacudir la bobina junto a la oreja.
Se pone la bobina y la báscula ya sabe qué es: el chip da la marca, el material y el color, la celda de carga da los gramos. Nada tecleado, nada adivinado.
El chip sabe lo que es el filamento; la báscula sabe cuánto queda. Juntos hacen que el inventario sea de verdad cierto: la identidad viene de TigerTag, la cantidad en directo de TigerScale.
TigerScale V3: la generación actual
Sección titulada «TigerScale V3: la generación actual»Tiger-Scale-V3, MIT. Esta es la que hay que construir.
- Sabe qué bobina tiene encima: dos lectores NFC PN532, uno por lado; una bobina con doble etiqueta se identifica la pongas como la pongas. Leer la etiqueta, pesar, restar el peso de la bobina vacía, sincronizar: sin teclear, sin adivinar.
- ESP32-S3 (16 MB de flash, PSRAM), pantalla táctil en color de 3,5″ y 480×320 (LVGL) con configuración completa en pantalla: selector de Wi-Fi + teclado, asistente de calibración, autodiagnóstico del hardware, actualizaciones OTA.
- Funciona con batería (PMIC AXP2101, estado de carga en pantalla), códec de audio.
- Pesaje de precisión: HX711 + celda de carga, filtrado por mediana + EMA adaptativo, ajustado para dar sensación de báscula de cocina.
- 8 idiomas de firmware, interfaz web en 9 idiomas.
- Seguimiento del peso en directo: las actualizaciones aparecen en tiempo real en Tiger Studio y Tiger NFC Connect a través de Firestore.
- Funciona con la calibración del peso de envases de Tiger Studio para que el peso neto de filamento siga siendo preciso por tipo de envase.
- Funciona sin conexión. La identificación de marca y material viene de una base de datos alojada en la propia flash del dispositivo, actualizada como máximo una vez al día: una consulta de etiqueta nunca espera a la red.
- La sincronización en la nube es opcional. La báscula es totalmente utilizable sin cuenta.
- Su propia interfaz web, servida desde el dispositivo, adaptada al móvil, en directo por WebSocket a 10 Hz: sin aplicación que instalar para manejarla desde un teléfono.
- Sin blobs binarios: todo se compila desde el código fuente.
En el banco: deja la bobina, se identifica y se pesa sola.
Construir una
Sección titulada «Construir una»¿No te va la electrónica? Una báscula USB y un TigerPOD hacen el mismo trabajo sin nada que cablear ni flashear: la alternativa oficial sin electrónica.
La báscula es un montaje casero, y los pasos que la gente espera que sean difíciles no lo son:
- Imprime la carcasa. Un proyecto
.3mfde Bambu Studio con las placas ya dispuestas — en MakerWorld. Ábrelo en Bambu Studio u Orca y pulsa Slice: nada que orientar, ningún soporte que colocar. - Cablea los componentes. Conecta la celda de carga, el HX711, el altavoz y los dos lectores PN532 a la placa siguiendo el diagrama de cableado de abajo: el mismo mapa de pines para cualquiera de las dos variantes de placa.
- Flashea desde tu navegador. El instalador web sirve siempre la versión actual; después la báscula se actualiza sola por aire.
Las piezas son corrientes:
| Cant. | Componente | Dónde |
|---|---|---|
| 1 | Waveshare ESP32-S3-Touch-LCD-3.5B — táctil IPS de 480×320 (la -3.5 sin la B también sirve) | -3.5B · -3.5 |
| 2 | Módulo NFC PN532 V3 — se requieren tira de pines y interruptor de modo | Amazon |
| 1 | Celda de carga de 5 kg + HX711 | Amazon |
| 1 | Cable USB-C de 4 pines + conector | cable · conector |
| 1 | Batería de iones de litio — opcional, la báscula funciona con USB | Amazon |
| — | Cables Dupont, tornillos autorroscantes M3 | cables · tornillos |
| — | 2× M4×30 y 2× M5×30 (celda de carga), 4× M2×6 (pantalla) | cualquier ferretería |
| 1 | Un pequeño altavoz | viene con la placa ESP32-S3 |
Algunos enlaces de esta tabla son enlaces de afiliado de Amazon: como Asociado de Amazon, TigerTag gana con las compras que cumplen los requisitos, sin coste adicional para ti. Ayuda a financiar el protocolo abierto. Comprar las mismas piezas en cualquier otro sitio funciona exactamente igual de bien.
La lista de materiales completa y con costes está en el repositorio.
Montaje
Sección titulada «Montaje»
Diagrama de cableado
Sección titulada «Diagrama de cableado»
Esquema interactivo en Cirkit Designer
Solución de problemas
Sección titulada «Solución de problemas»¿No se detecta ningún puerto COM para el ESP32-S3 en el instalador web?
Puede que falte un controlador para tu sistema. Sigue la guía de instalación del controlador.
¿Un peso atascado en 0 g o negativo, una lectura que deriva, lectores no detectados, el WiFi perdido tras volver a flashear?
El propio repositorio de la báscula mantiene la lista completa, síntoma por síntoma: solución de problemas de Tiger-Scale-V3.
Tuya para fabricar y vender
Sección titulada «Tuya para fabricar y vender»Cualquiera puede fabricar y vender hardware TigerScale. Sin tasa de licencia, sin regalías, sin registro. Constrúyela, flashea el firmware oficial, envíala.
La única condición para llamar TigerScale a tu producto es ejecutar ese firmware oficial sin modificar, para que cada unidad se comporte igual dentro del ecosistema. Bifúrcalo si quieres cambiarlo, y dale otro nombre a la bifurcación. Ese es todo el trato.
Dónde encaja
Sección titulada «Dónde encaja»
flowchart LR
SPOOL["Spool on the scale"] --> SCALE["TigerScale (ESP32)"]
SCALE -- "live weight" --> CLOUD[("Your TigerSystem account<br/>(Firebase)")]
CLOUD --> ST["Tiger Studio"] & CO["Connect"]
La historia hasta ahora
Sección titulada «La historia hasta ahora»Tres generaciones, y la forma de la cosa cambió en cada una:
| Lectura | Pantalla | Placa | Factor de forma | |
|---|---|---|---|---|
| V1 — nunca publicada | un PN532 | mini OLED | ESP32 | un soporte de bobina: un soporte central que atraviesa el centro de la bobina |
| V2 — Tiger-Scale, MIT | 2× RC522 | OLED de 0,96″ | ESP32-WROOM, alimentada por USB | una báscula plana |
| V3 — Tiger-Scale-V3, MIT | 2× PN532 | pantalla táctil en color de 3,5″ | ESP32-S3, batería | una báscula plana, autónoma |
La V1 ya llevaba esencialmente la electrónica de la V2 (ESP32, mini OLED, una placa HX711 con una celda de carga de 5 kg), pero con un único lector y un cuerpo completamente distinto.
La V3 es hardware distinto, no una actualización de firmware. Las dos no son intercambiables: una V2 que ya hayas construido conserva su propio repositorio y sigue funcionando. Simplemente ya no se desarrolla.
Las tres son totalmente de código abierto (MIT) con piezas corrientes: la prueba viva de que un ESP32 y un módulo lector NFC (clase PN532 / RC522) bastan para construir un dispositivo que lea TigerTag.
Una báscula USB y un TigerPOD, sin electrónica
Sección titulada «Una báscula USB y un TigerPOD, sin electrónica»
La alternativa oficial para quien no quiere construir una báscula. Una báscula USB estándar y un TigerPOD, ambos conectados al ordenador, y Tiger Studio hace el resto: nada que soldar, cablear ni flashear.
- Conecta la báscula a tu ordenador por USB.
- Coloca el TigerPOD encima: el Mini o el original.
- Tara la báscula, con el TigerPOD encima.
- Abre Tiger Studio.
- Pon una bobina en el TigerPOD. Lee los chips de la bobina y Tiger Studio abre su ficha.
- La báscula la pesa, y Tiger Studio actualiza el peso de la bobina por sí solo.
Qué básculas funcionan
Sección titulada «Qué básculas funcionan»
Tiger Studio lee los dispositivos USB «HID Scale» estándar (página de uso HID
0x8D, uso 0x20): empezando por la DYMO M5 y el resto de la serie DYMO M (M10,
M25… mismo protocolo), y cualquier HID Scale compatible, sea cual sea la marca. La
báscula es hardware de terceros, no un producto Tiger; la configuración a su
alrededor es oficial y cuenta con soporte.
Protocolo, validado en hardware real: Scale Data Reports de 6 bytes a ~1 Hz:
| Byte | Significado |
|---|---|
[0] |
id de informe 0x03 |
[1] |
estado: 1 fallo · 2 estable a cero · 3 en movimiento · 4 estable · 5 negativo · 6 sobrecapacidad |
[2] |
unidad (códigos HID PoS): 0x02 gramo · 0x0B onza · 0x0C libra |
[3] |
exponente de potencia de diez con signo aplicado al valor bruto |
[4..5] |
peso, LE16 (LSB, MSB) |
ID de fabricante de DYMO 0x0922; la M5 es pid 0x8009. Particularidad: el primer
fotograma justo después de una tara informa de la unidad 0x00.
La DYMO M2 no es compatible: no tiene puerto USB en absoluto, así que no hay nada que conectar a un ordenador. El protocolo es lo de menos.
Interacciones
Sección titulada «Interacciones»| Con | Cómo |
|---|---|
| Firebase (base de datos de la cuenta) | Escribe el peso en directo en la cuenta del usuario |
| Tiger Studio / Connect | Muestran el peso en directo; supervisión del estado |
Enlaces
Sección titulada «Enlaces»- V3 (actual): Tiger-Scale-V3 (MIT)
- Flashéala desde tu navegador: instalador web
- Imprime la carcasa: MakerWorld
- V2, ya no se desarrolla: Tiger-Scale (MIT)
Véase también: Inventario y sincronización en la nube