Skip to content

Commit 3561850

Browse files
BenGlutclaude
andcommitted
Lead the TigerScale page with the current generation
The page opened on a generic photo and buried the three generations in one section, so a reader could not tell at a glance which scale to build. The V3 now has its own section at the top with its product shot and a bench photo, and the history moved into a table that says what actually changed between V1, V2 and V3 — reader, screen, board, body. Assets come from the Tiger-Scale-V3 repository. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
1 parent 3e98189 commit 3561850

4 files changed

Lines changed: 106 additions & 90 deletions

File tree

‎docs/assets/tigerscale-at-home.jpg‎

326 KB
Loading

‎docs/assets/tigerscale-v3.png‎

522 KB
Loading

‎docs/products/tigerscale.md‎

Lines changed: 40 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -10,21 +10,12 @@ your inventory — no manual entry, no shaking the spool next to your ear.
1010
> *left*.** Together they make the inventory actually true: identity from
1111
> [TigerTag](./tigertag.md), live quantity from TigerScale.
1212
13-
<img src="../assets/tigerscale-photo.jpg" width="480" alt="TigerScale — the open-source ESP32 filament scale" />
13+
<img src="../assets/tigerscale-v3.png" width="420" alt="TigerScale V3 — the open-source connected filament scale, colour touchscreen and dual NFC readers" />
1414

15-
## Where it sits
16-
17-
```mermaid
18-
flowchart LR
19-
SPOOL["Spool on the scale"] --> SCALE["TigerScale (ESP32)"]
20-
SCALE -- "live weight" --> CLOUD[("Your TigerSystem account<br/>(Firebase)")]
21-
CLOUD --> ST["Tiger Studio"] & CO["Connect"]
22-
```
15+
## TigerScale V3 — the current generation
2316

24-
## Two generations
25-
26-
**TigerScale V3** — the current generation
27-
([Tiger-Scale-V3](https://github.com/TigerTag-Project/Tiger-Scale-V3), MIT):
17+
[Tiger-Scale-V3](https://github.com/TigerTag-Project/Tiger-Scale-V3), MIT.
18+
This is the one to build.
2819

2920
- **It knows which spool is on it**: **dual PN532 NFC readers**, one per
3021
side — a [twin-tagged spool](../concepts/tigertag-chip.md) is identified
@@ -37,29 +28,46 @@ flowchart LR
3728
- Precision weighing: HX711 + load cell, median + adaptive EMA filtering —
3829
tuned for a kitchen-scale feel.
3930
- **8 firmware languages**, 9-language web UI.
40-
41-
**TigerScale V2** — the previous generation
42-
([Tiger-Scale](https://github.com/TigerTag-Project/Tiger-Scale), MIT):
43-
ESP32-WROOM, 0.96″ OLED, 2× RC522 readers, USB-powered. **V3 is different
44-
hardware, not a firmware update** — the two are not interchangeable; V2
45-
builders keep using the V2 repository.
46-
47-
> **Heritage — the V1.** A first generation existed but was never released
48-
> as a public repository. It carried essentially the V2's electronics —
49-
> ESP32, mini OLED, an HX711 board with a 5 kg load cell — but a **single**
50-
> PN532 reader, in a completely different form factor: a **spool-holder
51-
> design**, with a central support passing through the middle of the spool.
52-
53-
## Features (both generations)
54-
55-
- Fully open source (MIT) — commodity parts, the living proof that an ESP32
56-
and an NFC reader module (PN532 / RC522 class) are enough to build a
57-
TigerTag-reading device.
5831
- **Live weight tracking** — updates appear in real time in Tiger Studio and
5932
Tiger NFC Connect via Firestore.
6033
- Works with Tiger Studio's **container weight calibration** so net filament
6134
weight stays accurate per container type.
6235

36+
<img src="../assets/tigerscale-at-home.jpg" width="100%" alt="A TigerScale V3 in use on a workbench, a spool resting on it" />
37+
38+
*On the bench: put the spool down, it identifies itself and weighs itself.*
39+
40+
## Where it sits
41+
42+
```mermaid
43+
flowchart LR
44+
SPOOL["Spool on the scale"] --> SCALE["TigerScale (ESP32)"]
45+
SCALE -- "live weight" --> CLOUD[("Your TigerSystem account<br/>(Firebase)")]
46+
CLOUD --> ST["Tiger Studio"] & CO["Connect"]
47+
```
48+
49+
## The story so far
50+
51+
Three generations, and the shape of the thing changed at each one:
52+
53+
| | Reading | Screen | Board | Form factor |
54+
|---|---|---|---|---|
55+
| **V1** — never released publicly | **one** PN532 | mini OLED | ESP32 | a **spool holder**: a central support passing through the middle of the spool |
56+
| **V2** — [Tiger-Scale](https://github.com/TigerTag-Project/Tiger-Scale), MIT | 2× RC522 | 0.96″ OLED | ESP32-WROOM, USB-powered | a flat scale |
57+
| **V3** — [Tiger-Scale-V3](https://github.com/TigerTag-Project/Tiger-Scale-V3), MIT | 2× PN532 | 3.5″ colour touchscreen | ESP32-S3, battery | a flat scale, self-contained |
58+
59+
The V1 already carried essentially the V2's electronics — ESP32, mini OLED,
60+
an HX711 board with a 5 kg load cell — but a **single** reader, and a
61+
completely different body.
62+
63+
> **V3 is different hardware, not a firmware update.** The two are not
64+
> interchangeable: a V2 you already built keeps its own repository and keeps
65+
> working. It is simply no longer developed.
66+
67+
All three are fully open source (MIT) on commodity parts — the living proof
68+
that an ESP32 and an NFC reader module (PN532 / RC522 class) are enough to
69+
build a TigerTag-reading device.
70+
6371
## Third-party scales — USB HID (DYMO M series and friends)
6472

6573
TigerScale is the first-party scale — but Tiger Studio also reads standard
@@ -91,7 +99,7 @@ right after a tare reports unit `0x00`.
9199
## Links
92100

93101
- **V3 (current)**: [Tiger-Scale-V3](https://github.com/TigerTag-Project/Tiger-Scale-V3) (MIT)
94-
- V2: [Tiger-Scale](https://github.com/TigerTag-Project/Tiger-Scale) (MIT)
102+
- V2, no longer developed: [Tiger-Scale](https://github.com/TigerTag-Project/Tiger-Scale) (MIT)
95103

96104
---
97105

‎i18n/fr/products/tigerscale.md‎

Lines changed: 66 additions & 58 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
sourceHash: 342d08a205f44936692066f8d3410b81f74aac45d9cdd4dd99a400663d0b98d5
2+
sourceHash: b1285803ebbd496b0e46df78100d223db9c8637a0ed689e4f6f2c95b4aaaa484
33
sourcePath: docs/products/tigerscale.md
44
---
55

@@ -8,15 +8,42 @@ sourcePath: docs/products/tigerscale.md
88
## Objectif
99

1010
**TigerScale répond à l'éternelle question : combien reste-t-il de filament ?**
11-
Posez une bobine sur la balance ESP32 open source et le poids en direct part
12-
droit dans votre inventaire — pas de saisie manuelle, pas besoin de secouer la
13-
bobine près de votre oreille.
11+
Posez une bobine sur cette balance ESP32 open source et le poids en direct
12+
part droit dans votre inventaire — aucune saisie manuelle, plus besoin de
13+
secouer la bobine près de son oreille.
1414

15-
> **La puce sait ce qu'*est* le filament ; la balance sait combien il en
16-
> *reste*.** Ensemble, elles rendent l'inventaire réellement juste : l'identité
15+
> **La puce sait ce que le filament *est* ; la balance sait ce qu'il en
16+
> *reste*.** Ensemble, ils rendent l'inventaire réellement juste : l'identité
1717
> vient de [TigerTag](./tigertag.md), la quantité en direct de TigerScale.
1818
19-
<img src="../assets/tigerscale-photo.jpg" width="480" alt="TigerScale — la balance à filament ESP32 open source" />
19+
<img src="../assets/tigerscale-v3.png" width="420" alt="TigerScale V3 — la balance à filament connectée open source, écran tactile couleur et double lecteur NFC" />
20+
21+
## TigerScale V3 — la génération actuelle
22+
23+
[Tiger-Scale-V3](https://github.com/TigerTag-Project/Tiger-Scale-V3), MIT.
24+
C'est celle qu'il faut construire.
25+
26+
- **Elle sait quelle bobine est posée dessus** : **double lecteur NFC
27+
PN532**, un par face — une [bobine à deux puces](../concepts/tigertag-chip.md)
28+
est identifiée quel que soit le sens dans lequel vous la posez. Lire la
29+
puce, peser, soustraire le poids de la bobine vide, synchroniser — rien à
30+
taper, rien à deviner.
31+
- **ESP32-S3** (16 Mo de flash, PSRAM), **écran tactile couleur 3,5″
32+
480×320** (LVGL) avec toute la configuration à l'écran : sélecteur WiFi et
33+
clavier, assistant de calibration, autotest matériel, mises à jour OTA.
34+
- **Alimentée par batterie** (PMIC AXP2101, état de charge à l'écran), codec
35+
audio.
36+
- Pesée de précision : HX711 + cellule de charge, filtrage médian et EMA
37+
adaptatif — réglé pour donner la sensation d'une balance de cuisine.
38+
- **8 langues dans le firmware**, interface web en 9 langues.
39+
- **Suivi du poids en direct** — les mises à jour apparaissent en temps réel
40+
dans Tiger Studio et Tiger NFC Connect via Firestore.
41+
- Fonctionne avec la **calibration du poids des contenants** de Tiger Studio,
42+
pour que le poids net de filament reste juste selon le type de contenant.
43+
44+
<img src="../assets/tigerscale-at-home.jpg" width="100%" alt="Une TigerScale V3 en usage sur un établi, une bobine posée dessus" />
45+
46+
*Sur l'établi : on pose la bobine, elle s'identifie et se pèse.*
2047

2148
## Où cela se situe
2249

@@ -27,59 +54,39 @@ flowchart LR
2754
CLOUD --> ST["Tiger Studio"] & CO["Connect"]
2855
```
2956

30-
## Deux générations
57+
## L'histoire jusqu'ici
3158

32-
**TigerScale V3** — la génération actuelle
33-
([Tiger-Scale-V3](https://github.com/TigerTag-Project/Tiger-Scale-V3), MIT) :
59+
Trois générations, et la forme de l'objet a changé à chaque fois :
3460

35-
- **Elle sait quelle bobine est posée dessus** : **deux lecteurs NFC PN532**,
36-
un par côté — une [bobine à double puce](../concepts/tigertag-chip.md) est
37-
identifiée quel que soit le sens dans lequel vous la posez. Lecture du tag,
38-
pesée, soustraction du poids de la bobine vide, synchronisation — sans rien
39-
taper, sans rien deviner.
40-
- **ESP32-S3** (16 Mo de flash, PSRAM), **écran tactile couleur 3,5″ 480×320**
41-
(LVGL) avec configuration intégralement à l'écran : sélecteur WiFi + clavier,
42-
assistant de calibration, autotest matériel, mises à jour OTA.
43-
- **Alimentation par batterie** (PMIC AXP2101, état de charge à l'écran), codec
44-
audio.
45-
- Pesée de précision : HX711 + cellule de charge, filtrage médian + EMA
46-
adaptatif — réglé pour donner la sensation d'une balance de cuisine.
47-
- **8 langues dans le firmware**, interface web en 9 langues.
61+
| | Lecture | Écran | Carte | Forme |
62+
|---|---|---|---|---|
63+
| **V1** — jamais publiée | **un seul** PN532 | mini OLED | ESP32 | un **porte-bobine** : un support central qui traverse le milieu de la bobine |
64+
| **V2** — [Tiger-Scale](https://github.com/TigerTag-Project/Tiger-Scale), MIT | 2× RC522 | OLED 0,96″ | ESP32-WROOM, alimentée en USB | une balance plate |
65+
| **V3** — [Tiger-Scale-V3](https://github.com/TigerTag-Project/Tiger-Scale-V3), MIT | 2× PN532 | écran tactile couleur 3,5″ | ESP32-S3, batterie | une balance plate, autonome |
4866

49-
**TigerScale V2** — la génération précédente
50-
([Tiger-Scale](https://github.com/TigerTag-Project/Tiger-Scale), MIT) :
51-
ESP32-WROOM, OLED 0,96″, 2 lecteurs RC522, alimentation USB. **La V3 est un
52-
matériel différent, pas une mise à jour du firmware** — les deux ne sont pas
53-
interchangeables ; ceux qui construisent une V2 continuent d'utiliser le dépôt
54-
V2.
55-
56-
> **Héritage — la V1.** Une première génération a existé, mais n'a jamais été
57-
> publiée sous forme de dépôt public. Elle embarquait pour l'essentiel
58-
> l'électronique de la V2 — ESP32, mini OLED, une carte HX711 avec une cellule
59-
> de charge de 5 kg — mais un **seul** lecteur PN532, dans un format totalement
60-
> différent : une conception **porte-bobine**, avec un support central passant
61-
> au milieu de la bobine.
62-
63-
## Fonctionnalités (les deux générations)
64-
65-
- Entièrement open source (MIT) — composants courants, la preuve vivante qu'un
66-
ESP32 et un module lecteur NFC (de la classe PN532 / RC522) suffisent à
67-
construire un appareil capable de lire un TigerTag.
68-
- **Suivi du poids en direct** — les mises à jour apparaissent en temps réel
69-
dans Tiger Studio et Tiger NFC Connect via Firestore.
70-
- Fonctionne avec la **calibration du poids des contenants** de Tiger Studio,
71-
pour que le poids net de filament reste juste par type de contenant.
67+
La V1 embarquait déjà pour l'essentiel l'électronique de la V2 — ESP32, mini
68+
OLED, une carte HX711 avec une cellule de charge de 5 kg — mais **un seul**
69+
lecteur, et un corps complètement différent.
70+
71+
> **La V3, c'est un matériel différent, pas une mise à jour de firmware.**
72+
> Les deux ne sont pas interchangeables : une V2 déjà construite garde son
73+
> propre dépôt et continue de fonctionner. Elle n'est simplement plus
74+
> développée.
75+
76+
Les trois sont entièrement open source (MIT) et faites de composants
77+
courants — la preuve vivante qu'un ESP32 et un module de lecture NFC (classe
78+
PN532 / RC522) suffisent à construire un appareil qui lit les TigerTag.
7279

7380
## Balances tierces — USB HID (série DYMO M et compagnie)
7481

75-
TigerScale est la balance maison — mais Tiger Studio lit aussi les appareils
76-
**USB « HID Scale » standard** (page d'usage HID `0x8D`, usage `0x20`) : à
77-
commencer par la **DYMO M5** et le reste de la série DYMO M (M10, M25… même
78-
protocole), et **n'importe quelle HID Scale conforme**, quelle que soit la
79-
marque. Une option tierce, pas un produit Tiger.
82+
TigerScale est la balance maison — mais Tiger Studio lit aussi les
83+
**périphériques USB « HID Scale »** standards (page d'usage HID `0x8D`, usage
84+
`0x20`) : à commencer par la **DYMO M5** et le reste de la série M de DYMO
85+
(M10, M25… même protocole), et **toute HID Scale conforme**, quelle que soit
86+
la marque. Une option tierce, pas un produit Tiger.
8087

81-
Protocole, validé sur du matériel réel — *Scale Data Reports* de 6 octets à
82-
~1 Hz :
88+
Protocole, validé sur du matériel réel — des *Scale Data Reports* de 6 octets
89+
à environ 1 Hz :
8390

8491
| Octet | Signification |
8592
|---|---|
@@ -89,20 +96,21 @@ Protocole, validé sur du matériel réel — *Scale Data Reports* de 6 octets
8996
| `[3]` | exposant signé de puissance de dix appliqué à la valeur brute |
9097
| `[4..5]` | poids, LE16 (LSB, MSB) |
9198

92-
Identifiant fabricant DYMO `0x0922` ; la M5 porte le pid `0x8009`. Particularité :
93-
la toute première trame juste après une tare annonce l'unité `0x00`.
99+
Identifiant fabricant DYMO `0x0922` ; la M5 porte le pid `0x8009`.
100+
Particularité : la toute première trame juste après une tare annonce
101+
l'unité `0x00`.
94102

95103
## Interactions
96104

97105
| Avec | Comment |
98106
|---|---|
99-
| Firebase (base de données des comptes) | Écrit le poids en direct dans le compte de l'utilisateur |
100-
| Tiger Studio / Connect | Affichent le poids en direct ; suivi de l'état de santé |
107+
| Firebase (base de données du compte) | Écrit le poids en direct dans le compte de l'utilisateur |
108+
| Tiger Studio / Connect | Affichent le poids en direct ; supervision de l'état |
101109

102110
## Liens
103111

104112
- **V3 (actuelle)** : [Tiger-Scale-V3](https://github.com/TigerTag-Project/Tiger-Scale-V3) (MIT)
105-
- V2 : [Tiger-Scale](https://github.com/TigerTag-Project/Tiger-Scale) (MIT)
113+
- V2, qui n’est plus développée : [Tiger-Scale](https://github.com/TigerTag-Project/Tiger-Scale) (MIT)
106114

107115
---
108116

0 commit comments

Comments
 (0)