Skip to content

Commit 27981a3

Browse files
committed
docs: TigerSpool as it ships today
The page described an older firmware. There is no confirm step - the assignment leaves when the spool is read, after the slot is tapped. Nine languages, not eight. A battery is declared in Settings, the board cannot detect one. The wiring caption had TX and RX on the wrong PN532 pins: the board's TX goes to SCL and RX to SDA, as the diagram shows. Elegoo and Anycubic are proven for reading, not yet for writing. The first printed shell is published, the screen draws accents, and the real limit is ten printers connected at once, which the FlashForge page overstated as 24.
1 parent 6fea766 commit 27981a3

4 files changed

Lines changed: 64 additions & 52 deletions

File tree

‎docs/compatibility/flashforge.md‎

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -63,8 +63,9 @@ between Cloud and local tools: both are live at once.
6363
The owner keeps every FlashForge Cloud feature, and gains the whole ecosystem
6464
on top: a free, open-source **filament and printer manager** on the desktop, a
6565
**phone that reads and writes spools**, and **[TigerSpool](../products/tigerspool.md)** —
66-
an open-source reader box that sits beside the machines and serves **up to 24
67-
printers at once**, one box for the whole shelf.
66+
an open-source reader box that sits beside the machines and keeps **up to 24
67+
printers** in its list, ten of them connected at once — one box for the whole
68+
shelf.
6869

6970
So a printer with no reader and no format of its own now reads the chip of any
7071
filament brand that uses TigerTag — and of the spools makers tag themselves at

‎docs/products/tigerspool.md‎

Lines changed: 26 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
# TigerSpool
22

3-
**A small box beside the printer. Hold a spool against it, tap a slot, and the
3+
**A small box beside the printer. Tap a slot, hold a spool against it, and the
44
filament is written into that slot — on any brand of printer.**
55

66
<img src="../assets/tigerspool-with-spool.webp" width="560" alt="A TigerSpool beside a filament spool, its screen listing the printer's slots with the brand loaded in each" />
77

88
*The box, a spool, and the printer's own slots on screen — each one showing
9-
what is loaded in it. Hold the spool against the box, pick a slot, done.*
9+
what is loaded in it. Pick a slot, hold the spool against the box, done.*
1010

1111
<div class="ts-cta ts-cta--hero">
1212
<a class="ts-cta-primary" href="https://tigertag-project.github.io/TigerSpool-RFID/">Install from your browser</a>
@@ -25,18 +25,19 @@ Open source under **MIT**, ESP32-S3, about **40 €** of common parts.
2525

2626
## What it does
2727

28-
1. **Hold the spool to the box.** The [TigerTag chip](../concepts/tigertag-chip.md)
29-
is read on contact.
30-
2. **Tap the slot** you want on the touchscreen — the same slot names the
28+
1. **Tap the slot** you want on the touchscreen — the same slot names the
3129
printer itself uses.
32-
3. **Confirm.** The assignment reaches the printer over that brand's own
33-
protocol: material, brand, colour and temperatures, in the right slot.
30+
2. **Hold the spool to the box.** The [TigerTag chip](../concepts/tigertag-chip.md)
31+
is read on contact, and the assignment leaves for the printer at once, over
32+
that brand's own protocol: material, brand, colour and temperatures, in the
33+
right slot. There is nothing to confirm.
34+
3. **Load the spool.** The box tells you which slot it went to.
3435

35-
It speaks eight languages, asks which one before anything else, and updates
36+
It speaks nine languages, asks which one before anything else, and updates
3637
itself over the air.
3738

3839
:::caution[Warning]
39-
Scanning a TigerTag and confirming a slot on the screen does not load
40+
Scanning a TigerTag onto a slot on the screen does not load
4041
anything — it only tells the printer what the spool *is*. **You still have
4142
to physically put the spool in that slot yourself** — the CFS, the AMS, the
4243
ACE unit, or whatever that printer calls its own tray. Skip that and the
@@ -80,7 +81,7 @@ the next sync.
8081
8182
## Which printers
8283

83-
**The six brands Tiger Studio integrates are covered** — written, and proven
84+
**The six brands Tiger Studio integrates are covered** — written, and tested
8485
on hardware. That is not every printer on the market, and *"any printer"*
8586
stays the goal; it is every brand this ecosystem speaks to today:
8687

@@ -90,8 +91,8 @@ stays the goal; it is every brand this ecosystem speaks to today:
9091
| [FlashForge](../compatibility/flashforge.md) | implemented, proven | HTTP |
9192
| [Bambu Lab](../compatibility/bambu-lab.md) | implemented, proven | MQTT over TLS |
9293
| [Snapmaker](../compatibility/snapmaker.md) | implemented, proven | Moonraker over WebSocket |
93-
| [Elegoo](../compatibility/elegoo.md) | implemented, proven | MQTT |
94-
| [Anycubic](../compatibility/anycubic.md) | implemented, proven | MQTT over TLS |
94+
| [Elegoo](../compatibility/elegoo.md) | implemented, reading proven — writing not yet confirmed on a printer | MQTT |
95+
| [Anycubic](../compatibility/anycubic.md) | implemented, reading proven — writing not yet confirmed; LAN mode only | MQTT over TLS |
9596

9697
Slot names follow the printer's own: `Ext.` and `1A`–`1D` on Creality and
9798
FlashForge, `A1`–`A4` then `B1`–`B4` on Bambu Lab, `E1`–`E4` on Snapmaker, `S1`–`S4` on
@@ -113,7 +114,7 @@ the shell changes, which is what keeps it to one firmware and one parts list.
113114
| 1 | **PN532 V3** NFC module — DIP switches, must support **HSU/UART**, both switches to `0` / OFF. A two-pack costs barely more than one | [Amazon](https://link.amazon/B0dyEfwKa) |
114115
| 1 | A USB-C cable **that carries data** — speed is irrelevant, any USB 2.0 data cable does | [Amazon](https://link.amazon/B00Xg3WT4) |
115116
| 1 | Magnetic USB-C connector — **recommended**: the port is the part handled every day, and the cable lets go instead of the socket | [Amazon](https://link.amazon/B0bWVIBa0) |
116-
| 1 | 3.7 V 1000 mAh LiPo cell, PH1.25 — **optional**, charged over USB; the box then runs cable-free and gains a Battery entry in Settings. Check the polarity | [Amazon](https://link.amazon/B0fL0jjf3) |
117+
| 1 | 3.7 V 1000 mAh LiPo cell, PH1.25 — **optional**, charged over USB; the box then runs cable-free. The board cannot detect a cell, so you declare it in Settings › Battery. Check the polarity | [Amazon](https://link.amazon/B0fL0jjf3) |
117118

118119
> Some links in this table are **Amazon affiliate links**: as an Amazon
119120
> Associate, TigerTag earns from qualifying purchases, **at no extra cost to
@@ -125,10 +126,11 @@ the whole harness. No level shifters: the PN532 runs at 3V3, same as the board.
125126
A battery is **optional** — the box normally sits beside a printer that is
126127
already plugged in, and the cell above is for the times it does not.
127128

128-
<img src="../assets/tigerspool-wiring.jpg" width="600" alt="Wiring: the ESP32-S3-Touch-LCD-2 board to the PN532 — 3V3 to VCC, GND to GND, TX to SDA, RX to SCL" />
129+
<img src="../assets/tigerspool-wiring.jpg" width="600" alt="Wiring: the ESP32-S3-Touch-LCD-2 board to the PN532 — 3V3 to VCC, GND to GND, TX to SCL, RX to SDA" />
129130

130131
*The whole harness. On the PN532 the two data pins are silkscreened `SDA` and
131-
`SCL` — in HSU mode they carry the UART, so that is where TX and RX go.
132+
`SCL` — in HSU mode they carry the UART: the board's **TX goes to `SCL`**, its
133+
**RX to `SDA`**, and both DIP switches sit at `0` / OFF.
132134
[Interactive schematic](https://app.cirkitdesigner.com/project/7a6c0887-8e44-4303-81b3-be51aab4b40a).*
133135

134136
**Flashing is done from the browser** — plug the board in, click Install, wait
@@ -161,15 +163,18 @@ Full parts list, wiring diagram and bring-up checklist:
161163

162164
Written down rather than discovered:
163165

164-
- **The printed shells are not published yet.** The rule that governs them is —
165-
same board, same reader, same four wires, same USB-C entry, so that one firmware
166-
image runs on every model and anyone can contribute a shell without touching
167-
code.
166+
- **The first printed shell is published**: a free-standing desktop stand,
167+
with the spool on the left or on the right, in
168+
[Model3D/](https://github.com/TigerTag-Project/TigerSpool-RFID/tree/main/Model3D).
169+
Cases that mount on a given printer follow the same rule — same board, same
170+
reader, same four wires, same USB-C entry — so one firmware image runs on
171+
every model and anyone can contribute one without touching code.
168172
- **The firmware is not signed.** Its update connection is verified against the
169173
root certificate store, so the box knows who it is talking to — but not who
170174
produced the image.
171-
- **On-screen text carries no accents**, the compiled font being ASCII plus
172-
degree and bullet.
175+
- **Ten printers connected at once, at most** — of the 24 an account can hand
176+
it — and no more than three that speak TLS (Bambu Lab, Anycubic), which cost
177+
the most memory.
173178

174179
---
175180

‎i18n/fr/compatibility/flashforge.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
sourceHash: 47248e2bcfb90f6f4c5088019068176f0bb0cf081f3b4484fb0dcab65b87212f
2+
sourceHash: 0da2b619f681b73709bf69f7a267703c5e222bb752d614aa97a95027294187e1
33
sourcePath: docs/compatibility/flashforge.md
44
---
55

@@ -71,8 +71,8 @@ Le possesseur conserve toutes les fonctions du Cloud FlashForge, et gagne l'éco
7171
entier par-dessus : un **gestionnaire de filaments et d'imprimantes** libre et gratuit
7272
sur le bureau, un **téléphone qui lit et écrit les bobines**, et
7373
**[TigerSpool](../products/tigerspool.md)** — un boîtier lecteur open source posé à côté
74-
des machines, qui en dessert **jusqu'à 24 en même temps**, un seul boîtier pour toute
75-
l'étagère.
74+
des machines, qui garde **jusqu'à 24 imprimantes** dans sa liste, dont dix connectées
75+
en même temps — un seul boîtier pour toute l'étagère.
7676

7777
Ainsi une imprimante sans lecteur et sans format propre lit désormais la puce de
7878
n'importe quelle marque de filament qui utilise TigerTag — et celle des bobines que les

‎i18n/fr/products/tigerspool.md‎

Lines changed: 32 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,18 @@
11
---
2-
sourceHash: 423e9b6139ecfa41d673751f5260ff4133b4a708eecfca104df49ab1933c0926
2+
sourceHash: 294aaa530d62c01a0b4adb5bb937b5b67296c4bdba2a643ee56dd32564c07bbe
33
sourcePath: docs/products/tigerspool.md
44
---
55

66
# TigerSpool
77

8-
**Un petit boîtier à côté de l'imprimante. Présentez une bobine, touchez un
9-
emplacement, et le filament y est inscrit — sur n'importe quelle marque
8+
**Un petit boîtier à côté de l'imprimante. Touchez un emplacement, présentez
9+
une bobine, et le filament y est inscrit — sur n'importe quelle marque
1010
d'imprimante.**
1111

1212
<img src="../assets/tigerspool-with-spool.webp" width="560" alt="Un TigerSpool à côté d'une bobine de filament, son écran listant les emplacements de l'imprimante avec la marque chargée dans chacun" />
1313

1414
*Le boîtier, une bobine, et les emplacements de l'imprimante à l'écran — chacun
15-
montrant ce qui y est chargé. Approchez la bobine, choisissez un emplacement,
15+
montrant ce qui y est chargé. Choisissez un emplacement, approchez la bobine,
1616
c'est fait.*
1717

1818
<div class="ts-cta ts-cta--hero">
@@ -33,19 +33,20 @@ courantes.
3333

3434
## Ce qu'il fait
3535

36-
1. **Présentez la bobine au boîtier.** La
37-
[puce TigerTag](../concepts/tigertag-chip.md) est lue au contact.
38-
2. **Touchez l'emplacement** voulu sur l'écran tactile — avec les noms
36+
1. **Touchez l'emplacement** voulu sur l'écran tactile — avec les noms
3937
d'emplacements qu'utilise l'imprimante elle-même.
40-
3. **Confirmez.** L'affectation part vers l'imprimante via le protocole propre
41-
à cette marque : matière, marque, couleur et températures, au bon
42-
emplacement.
43-
44-
Il parle huit langues, demande laquelle avant toute chose, et se met à jour
38+
2. **Présentez la bobine au boîtier.** La
39+
[puce TigerTag](../concepts/tigertag-chip.md) est lue au contact, et
40+
l'affectation part aussitôt vers l'imprimante via le protocole propre à
41+
cette marque : matière, marque, couleur et températures, au bon emplacement.
42+
Il n'y a rien à confirmer.
43+
3. **Chargez la bobine.** Le boîtier vous indique dans quel emplacement.
44+
45+
Il parle neuf langues, demande laquelle avant toute chose, et se met à jour
4546
tout seul par voie hertzienne.
4647

4748
:::caution[Avertissement]
48-
Scanner une TigerTag et confirmer un emplacement à l'écran ne charge rien —
49+
Scanner une TigerTag sur un emplacement à l'écran ne charge rien —
4950
cela indique seulement à l'imprimante ce qu'*est* la bobine. **Vous devez
5051
toujours placer physiquement la bobine dans cet emplacement vous-même** — le
5152
CFS, l'AMS, l'unité ACE, ou quel que soit le nom que cette imprimante donne
@@ -91,7 +92,7 @@ dans Tiger Studio et elle apparaît à la synchronisation suivante.
9192
## Quelles imprimantes
9293

9394
**Les six marques intégrées à Tiger Studio sont couvertes** — écrites, et
94-
éprouvées sur matériel. Ce n'est pas toute imprimante du marché, et *« n'importe
95+
testées sur matériel. Ce n'est pas toute imprimante du marché, et *« n'importe
9596
quelle imprimante »* reste l'objectif ; c'est toute marque à laquelle cet
9697
écosystème parle aujourd'hui :
9798

@@ -101,8 +102,8 @@ quelle imprimante »* reste l'objectif ; c'est toute marque à laquelle cet
101102
| [FlashForge](../compatibility/flashforge.md) | implémenté, éprouvé | HTTP |
102103
| [Bambu Lab](../compatibility/bambu-lab.md) | implémenté, éprouvé | MQTT sur TLS |
103104
| [Snapmaker](../compatibility/snapmaker.md) | implémenté, éprouvé | Moonraker sur WebSocket |
104-
| [Elegoo](../compatibility/elegoo.md) | implémenté, éprouvé | MQTT |
105-
| [Anycubic](../compatibility/anycubic.md) | implémenté, éprouvé | MQTT sur TLS |
105+
| [Elegoo](../compatibility/elegoo.md) | implémenté, lecture éprouvée — écriture pas encore confirmée sur une imprimante | MQTT |
106+
| [Anycubic](../compatibility/anycubic.md) | implémenté, lecture éprouvée — écriture pas encore confirmée ; mode LAN uniquement | MQTT sur TLS |
106107

107108
Les noms d'emplacements suivent ceux de l'imprimante : `Ext.` et `1A`–`1D`
108109
chez Creality et FlashForge, `A1`–`A4` puis `B1`–`B4` chez Bambu Lab,
@@ -125,7 +126,7 @@ firmware et qu'une liste de pièces.
125126
| 1 | Module NFC **PN532 V3** — interrupteurs DIP, doit gérer **HSU/UART**, les deux sur `0` / OFF. Un lot de deux coûte à peine plus qu'un seul | [Amazon](https://link.amazon/B0dyEfwKa) |
126127
| 1 | Un câble USB-C **qui transporte les données** — le débit n'a aucune importance, n'importe quel câble USB 2.0 de données suffit | [Amazon](https://link.amazon/B00Xg3WT4) |
127128
| 1 | Connecteur USB-C magnétique — **recommandé** : le port est la pièce manipulée tous les jours, et c'est le câble qui lâche plutôt que la prise | [Amazon](https://link.amazon/B0bWVIBa0) |
128-
| 1 | Accu LiPo 3,7 V 1000 mAh, PH1.25 — **optionnel**, chargé par l'USB ; le boîtier fonctionne alors sans câble et gagne une entrée Batterie dans les réglages. Vérifiez la polarité | [Amazon](https://link.amazon/B0fL0jjf3) |
129+
| 1 | Accu LiPo 3,7 V 1000 mAh, PH1.25 — **optionnel**, chargé par l'USB ; le boîtier fonctionne alors sans câble. La carte ne sait pas détecter un accu : vous le déclarez dans Réglages › Batterie. Vérifiez la polarité | [Amazon](https://link.amazon/B0fL0jjf3) |
129130

130131
> Certains liens de ce tableau sont des **liens affiliés Amazon** : en tant que
131132
> partenaire Amazon, TigerTag perçoit une commission sur les achats
@@ -138,11 +139,12 @@ et c'est tout le faisceau. Pas d'adaptateur de niveau : le PN532 fonctionne en
138139
normalement posé à côté d'une imprimante déjà branchée, et l'accu ci-dessus est
139140
pour les fois où il ne l'est pas.
140141

141-
<img src="../assets/tigerspool-wiring.jpg" width="600" alt="Câblage : la carte ESP32-S3-Touch-LCD-2 vers le PN532 — 3V3 vers VCC, GND vers GND, TX vers SDA, RX vers SCL" />
142+
<img src="../assets/tigerspool-wiring.jpg" width="600" alt="Câblage : la carte ESP32-S3-Touch-LCD-2 vers le PN532 — 3V3 vers VCC, GND vers GND, TX vers SCL, RX vers SDA" />
142143

143144
*Tout le faisceau. Sur le PN532, les deux broches de données sont sérigraphiées
144-
`SDA` et `SCL` — en mode HSU, ce sont elles qui portent l'UART, c'est donc là
145-
que vont TX et RX.
145+
`SDA` et `SCL` — en mode HSU, ce sont elles qui portent l'UART : le **TX de la
146+
carte va sur `SCL`**, son **RX sur `SDA`**, et les deux interrupteurs DIP sont
147+
sur `0` / OFF.
146148
[Schéma interactif](https://app.cirkitdesigner.com/project/7a6c0887-8e44-4303-81b3-be51aab4b40a).*
147149

148150
**Le flashage se fait depuis le navigateur** — branchez la carte, cliquez sur
@@ -178,15 +180,19 @@ Liste complète des pièces, schéma de câblage et procédure de mise en route
178180

179181
Écrit noir sur blanc plutôt que découvert :
180182

181-
- **Les coques imprimées ne sont pas encore publiées.** La règle qui les
182-
gouverne, elle, l'est — même carte, même lecteur, mêmes quatre fils, même
183-
entrée USB-C, afin qu'un seul firmware tourne sur tous les modèles et que
184-
n'importe qui puisse proposer une coque sans toucher au code.
183+
- **La première coque imprimée est publiée** : un support de bureau
184+
autoportant, bobine à gauche ou à droite, dans
185+
[Model3D/](https://github.com/TigerTag-Project/TigerSpool-RFID/tree/main/Model3D).
186+
Les coques qui se fixent sur une imprimante donnée suivent la même règle —
187+
même carte, même lecteur, mêmes quatre fils, même entrée USB-C — afin qu'un
188+
seul firmware tourne sur tous les modèles et que n'importe qui puisse en
189+
proposer une sans toucher au code.
185190
- **Le firmware n'est pas signé.** Sa connexion de mise à jour est vérifiée
186191
contre le magasin de certificats racines, donc le boîtier sait à qui il
187192
parle — mais pas qui a produit l'image.
188-
- **Le texte à l'écran ne porte pas d'accents**, la police compilée étant de
189-
l'ASCII plus le degré et la puce.
193+
- **Dix imprimantes connectées en même temps, au plus** — sur les 24 qu'un
194+
compte peut lui confier — dont trois au plus qui parlent TLS (Bambu Lab,
195+
Anycubic), les plus gourmandes en mémoire.
190196

191197
---
192198

0 commit comments

Comments
 (0)