docs: add TigerScale hardware photos, assembly gallery, and wiring diagram

docs/products/tigerscale.md

@@ -46,13 +46,16 @@ This is the one to build.
 
 ## Building one
 
-The scale is a DIY build, and the two steps people expect to be hard are not:
+The scale is a DIY build, and the steps people expect to be hard are not:
 
 1. **Print the enclosure.** One `.3mf` Bambu Studio project with the plates
  already laid out — [on MakerWorld](https://makerworld.com/en/models/3161869-tigerscale-v3-best-smart-filament-scale-with-nfc#profileId-3573543).
  Open it in Bambu Studio or Orca and press Slice: nothing to orient, no
  supports to place.
-2. **Flash from your browser.** The
+2. **Wire the components.** Connect the load cell, HX711, speaker and both
+ PN532 readers to the board following the [wiring diagram](#wiring-diagram)
+ below — the same pinout for either board variant.
+3. **Flash from your browser.** The
  [web installer](https://tigertag-project.github.io/Tiger-Scale-V3/) always
  serves the current release; after that the scale updates itself over the air.
 
@@ -62,13 +65,24 @@ The parts are commodity:
 |---|---|---|
 | 1 | Waveshare **ESP32-S3-Touch-LCD-3.5B** — 480×320 IPS touch (the **-3.5** without the B works too) | [-3.5B](https://link.amazon/B0gaANfF5) · [-3.5](https://link.amazon/B0dpgOlOQ) |
 | 2 | **PN532 V3** NFC module — pin header **and** mode switch required | [Amazon](https://link.amazon/B0iTXrhjd) |
-| 1 | 5 kg load cell + HX711 — must have 2× M4 and 2× M5 tapped holes | [Amazon](https://link.amazon/B09LOUuI1) |
+| 1 | 5 kg load cell + HX711 | [Amazon](https://link.amazon/B09LOUuI1) |
 | 1 | USB-C 4-pin cable + connector | [cable](https://link.amazon/B0aoW8qQx) · [connector](https://link.amazon/B0aiEyjLx) |
 | 1 | Li-ion battery — **optional**, the scale runs on USB | [Amazon](https://link.amazon/B0etKlE1i) |
 | — | Dupont wires, M3 self-tapping screws | [wires](https://link.amazon/B0bl6jvMs) · [screws](https://link.amazon/B0ekzxx1E) |
 | — | 2× M4×30 and 2× M5×30 (load cell), 4× M2×6 (display) | any hardware shop |
 | 1 | A small speaker | ships with the ESP32-S3 board |
 
+<div class="ts-photo-pair">
+<figure>
+<img src="../assets/tigerscale-board-esp32-s3-touch-lcd.jpg" alt="Waveshare ESP32-S3-Touch-LCD-3.5B board" />
+<figcaption><strong>Both variants work, but they need different firmware.</strong> Read the silkscreen: <strong>-3.5B</strong> or <strong>-3.5</strong>. The web installer asks which one you have; the wiring and the case are the same either way.</figcaption>
+</figure>
+<figure>
+<img src="../assets/tigerscale-load-cell-hx711.jpg" alt="5 kg load cell and HX711 amplifier board" />
+<figcaption><strong>Warning:</strong> the load cell must have 2× M4 and 2× M5 tapped holes, and the HX711 board must be identical to the one shown — otherwise it will not fit in its designated slot.</figcaption>
+</figure>
+</div>
+
 > Some links in this table are **Amazon affiliate links**: as an Amazon
 > Associate, TigerTag earns from qualifying purchases, **at no extra cost to
 > you**. It helps fund the open protocol. Buying the same parts anywhere else
@@ -77,11 +91,49 @@ The parts are commodity:
 The full costed bill of materials lives in the
 [repository](https://github.com/TigerTag-Project/Tiger-Scale-V3).
 
-> **One trap worth knowing.** The board exists as **-3.5B** and **-3.5**, and
-> the firmware picks its NFC transport at compile time. Flash the wrong build
-> and you get a scale that starts up perfectly and never sees a tag, with
-> nothing on screen to say why. The web installer asks which variant you have
-> — read the silkscreen before answering.
+### Assembly
+
+<div class="ts-photo-pair">
+<figure>
+<img src="../assets/tigerscale-assembly-front-quarter.png" alt="TigerScale V3 enclosure, front three-quarter view" />
+<figcaption>Front three-quarter</figcaption>
+</figure>
+<figure>
+<img src="../assets/tigerscale-assembly-rear-quarter.png" alt="TigerScale V3 enclosure, rear three-quarter view" />
+<figcaption>Rear three-quarter</figcaption>
+</figure>
+<figure>
+<img src="../assets/tigerscale-assembly-rear-quarter-close.png" alt="TigerScale V3 enclosure, rear three-quarter close-up" />
+<figcaption>Rear three-quarter, close</figcaption>
+</figure>
+<figure>
+<img src="../assets/tigerscale-assembly-side-elevation.png" alt="TigerScale V3 enclosure, side elevation view" />
+<figcaption>Side elevation</figcaption>
+</figure>
+</div>
+
+<div class="ts-photo-pair">
+<figure>
+<img src="../assets/tigerscale-rear-orientation.jpg" alt="TigerScale V3 assembled, correct rear orientation" />
+<figcaption>Scale position and orientation</figcaption>
+</figure>
+<figure>
+<img src="../assets/tigerscale-pn532-mounting.jpg" alt="PN532 reader mounted in its enclosure slot" />
+<figcaption>PN532 seated in its slot</figcaption>
+</figure>
+</div>
+
+### Wiring diagram
+
+<img src="../assets/tigerscale-wiring-hsu.jpg" width="100%" alt="TigerScale V3 wiring diagram" />
+
+*[Interactive schematic in Cirkit Designer](https://app.cirkitdesigner.com/project/c6aa6c0a-9462-498f-8923-9ad4454e0e69)*
+
+### Troubleshooting
+
+**No COM port detected for the ESP32-S3 in the [web installer](https://tigertag-project.github.io/Tiger-Scale-V3/)?**
+
+A driver might be missing for your system. [Follow the driver install guide](../tutorials/tigerscale-serial-port-driver.md).
 
 ## Yours to make and to sell
 
@@ -157,6 +209,20 @@ right after a tare reports unit `0x00`.
 | Firebase (account database) | Writes live weight to the user's account |
 | Tiger Studio / Connect | Display live weight; health monitoring |
 
+## Recommended setup
+
+<img src="../assets/tigerscale-dymo-tigerpod.jpg" width="100%" alt="A TigerPOD sitting on a DYMO scale, weighing a tagged spool" />
+
+1. **Plug your DYMO scale into your computer over USB.**
+2. **Set the TigerPOD Mini or the original on top of the scale.**
+3. **Tare the DYMO scale.**
+4. **Open Tiger Studio Manager.**
+5. **Put a spool on the TigerPOD.**
+6. **The TigerPOD reads the spool's NTAG chips and opens its card in Tiger
+ Studio Manager.**
+7. **The DYMO scale weighs the spool — Tiger Studio Manager updates its
+ weight automatically.**
+
 ## Links
 
 - **V3 (current)**: [Tiger-Scale-V3](https://github.com/TigerTag-Project/Tiger-Scale-V3) (MIT)

docs/tutorials/tigerscale-serial-port-driver.md

@@ -0,0 +1,75 @@
+# Getting the COM port to show up to flash the TigerScale V3
+
+The TigerScale V3 uses an **ESP32-S3** chip. To flash the firmware, your computer needs to see the board as a **COM port / serial port**.
+
+On most recent computers this port shows up **on its own** when you plug the board in.
+If no port appears in the flasher, a small driver is missing: follow the section for your system below.
+
+> **Before you start**
+> - Use a real **USB data cable** (some cables only charge and carry no data).
+
+## macOS — nothing to install
+
+No driver needed.
+Plug in the board, open the flasher, and the board shows up directly in the list. Select it and start the flash.
+
+If it doesn't appear: swap the USB cable and try again.
+
+## Windows — install the driver (if no COM port appears)
+
+If the flasher shows no port, the Espressif USB driver is missing. Here is how
+to install it, step by step:
+
+1. **Download the tool** — click this link, it downloads `idf-env.exe` straight
+ from Espressif's own server (by default it lands in your **Downloads**
+ folder):
+ **[https://dl.espressif.com/dl/idf-env/idf-env.exe](https://dl.espressif.com/dl/idf-env/idf-env.exe)**
+2. **Open PowerShell as administrator** — click the **Start** menu, type
+ `powershell`, right-click **Windows PowerShell** and choose **Run as
+ administrator**.
+3. **Copy this single line, paste it into PowerShell, then press Enter:**
+
+ ```powershell
+ cd $env:USERPROFILE\Downloads; .\idf-env.exe driver install --espressif
+ ```
+
+ > Saved the file somewhere other than Downloads? Replace only
+ > `$env:USERPROFILE\Downloads` with that folder — for example
+ > `C:\Users\yourname\Desktop`. The rest of the line stays the same.
+
+4. Wait for it to finish (a few seconds).
+5. **Unplug and plug the board back in.**
+6. Reopen the flasher: the port (e.g. `USB JTAG/serial debug unit (COM3)`) should now appear.
+
+> Downloading the tool yourself, rather than pasting a one-line command that
+> fetches and runs an executable with administrator rights, means you can see
+> what you are about to run and where it came from. It is one extra click.
+
+✓ Select this port and start the flash.
+
+## Linux — grant access to the serial port
+
+The port usually shows up on its own (`/dev/ttyACM0`), but your user needs permission to access it.
+
+1. Open a **terminal**.
+2. Add yourself to the group that manages serial ports:
+
+ ```bash
+ sudo usermod -aG dialout $USER
+ ```
+
+3. **Log out and log back in** (or reboot) for it to take effect.
+4. Plug the board back in and reopen the flasher.
+
+> Tip: if you use the flasher **in a browser** (Web Serial), use **Google Chrome** or **Microsoft Edge**; Firefox does not support this feature.
+
+## Still not working
+
+- **Swap the USB cable** (problem #1: a "charge-only" cable).
+- Try **another USB port** on the computer (preferably a direct port, not a hub).
+- On Windows, open **Device Manager**: if you see a device with a yellow exclamation mark, the driver is missing → redo the Windows section above.
+- To force flash mode: hold the **BOOT** button, press **RESET** once, then release **BOOT**, and try again.
+
+---
+
+**◀ Previous:** [TigerScale](../products/tigerscale.md) · **▲ [Documentation index](../../README.md)**

i18n/fr/products/tigerscale.md

@@ -1,5 +1,5 @@
 ---
-sourceHash: 56e746850cbc5eafc858668b8c24f2c2a86a848d6d4a2749353b58bba34e333e
+sourceHash: 99a114b3f076c157979f1a5f1649be27dc86a00c42d648bfbc825b98c34b55b1
 sourcePath: docs/products/tigerscale.md
 ---
 
@@ -56,14 +56,18 @@ C'est celle qu'il faut construire.
 
 ## En construire une
 
-La balance est un montage DIY, et les deux étapes qu'on redoute ne sont pas
+La balance est un montage DIY, et les étapes qu'on redoute ne sont pas
 difficiles :
 
 1. **Imprimez le boîtier.** Un seul projet Bambu Studio `.3mf` avec les
  plateaux déjà disposés — [sur MakerWorld](https://makerworld.com/en/models/3161869-tigerscale-v3-best-smart-filament-scale-with-nfc#profileId-3573543).
  Ouvrez-le dans Bambu Studio ou Orca et lancez le découpage : rien à orienter,
  aucun support à placer.
-2. **Flashez depuis votre navigateur.** L'
+2. **Câblez les composants.** Reliez la cellule de charge, le HX711, le
+ haut-parleur et les deux lecteurs PN532 à la carte en suivant le
+ [schéma de câblage](#schéma-de-câblage) ci-dessous — le même câblage pour
+ les deux variantes de carte.
+3. **Flashez depuis votre navigateur.** L'
  [installateur web](https://tigertag-project.github.io/Tiger-Scale-V3/) sert
  toujours la version courante ; ensuite la balance se met à jour toute seule,
  par OTA.
@@ -74,13 +78,24 @@ Les pièces sont courantes :
 |---|---|---|
 | 1 | Carte Waveshare **ESP32-S3-Touch-LCD-3.5B** — tactile IPS 480×320 (la **-3.5** sans le B convient aussi) | [-3.5B](https://link.amazon/B0gaANfF5) · [-3.5](https://link.amazon/B0dpgOlOQ) |
 | 2 | Module NFC **PN532 V3** — rangée de broches **et** interrupteur de mode indispensables | [Amazon](https://link.amazon/B0iTXrhjd) |
-| 1 | Cellule de charge 5 kg + HX711 — doit avoir 2 trous taraudés M4 et 2 M5 | [Amazon](https://link.amazon/B09LOUuI1) |
+| 1 | Cellule de charge 5 kg + HX711 | [Amazon](https://link.amazon/B09LOUuI1) |
 | 1 | Câble USB-C 4 broches + connecteur | [câble](https://link.amazon/B0aoW8qQx) · [connecteur](https://link.amazon/B0aiEyjLx) |
 | 1 | Batterie Li-ion — **facultative**, la balance fonctionne sur USB | [Amazon](https://link.amazon/B0etKlE1i) |
 | — | Fils Dupont, vis autotaraudeuses M3 | [fils](https://link.amazon/B0bl6jvMs) · [vis](https://link.amazon/B0ekzxx1E) |
 | — | 2× M4×30 et 2× M5×30 (cellule de charge), 4× M2×6 (écran) | n'importe quelle quincaillerie |
 | 1 | Un petit haut-parleur | fourni avec la carte ESP32-S3 |
 
+<div class="ts-photo-pair">
+<figure>
+<img src="../assets/tigerscale-board-esp32-s3-touch-lcd.jpg" alt="Carte Waveshare ESP32-S3-Touch-LCD-3.5B" />
+<figcaption><strong>Les deux variantes fonctionnent, mais avec un firmware différent.</strong> Lisez la sérigraphie : <strong>-3.5B</strong> ou <strong>-3.5</strong>. L'installateur web demande laquelle vous avez ; le câblage et le boîtier sont identiques dans les deux cas.</figcaption>
+</figure>
+<figure>
+<img src="../assets/tigerscale-load-cell-hx711.jpg" alt="Cellule de charge 5 kg et carte amplificatrice HX711" />
+<figcaption><strong>Attention :</strong> la cellule de charge doit avoir 2 trous taraudés M4 et 2 M5, et la carte HX711 doit être identique à celle montrée — sinon elle ne rentrera pas dans son emplacement dédié.</figcaption>
+</figure>
+</div>
+
 > Certains liens de ce tableau sont des **liens affiliés Amazon** : en tant que
 > Partenaire Amazon, TigerTag est rémunéré sur les achats remplissant les
 > conditions requises, **sans aucun surcoût pour vous**. Cela finance le
@@ -90,11 +105,49 @@ Les pièces sont courantes :
 La nomenclature complète et chiffrée est dans le
 [dépôt](https://github.com/TigerTag-Project/Tiger-Scale-V3).
 
-> **Un piège à connaître.** La carte existe en **-3.5B** et en **-3.5**, et le
-> firmware choisit son transport NFC à la compilation. Flashez la mauvaise
-> version et vous obtenez une balance qui démarre parfaitement et ne voit
-> jamais aucune puce, sans rien à l'écran pour l'expliquer. L'installateur web
-> demande quelle variante vous avez — lisez la sérigraphie avant de répondre.
+### Assemblage
+
+<div class="ts-photo-pair">
+<figure>
+<img src="../assets/tigerscale-assembly-front-quarter.png" alt="Boîtier TigerScale V3, vue de trois-quarts avant" />
+<figcaption>Trois-quarts avant</figcaption>
+</figure>
+<figure>
+<img src="../assets/tigerscale-assembly-rear-quarter.png" alt="Boîtier TigerScale V3, vue de trois-quarts arrière" />
+<figcaption>Trois-quarts arrière</figcaption>
+</figure>
+<figure>
+<img src="../assets/tigerscale-assembly-rear-quarter-close.png" alt="Boîtier TigerScale V3, gros plan trois-quarts arrière" />
+<figcaption>Trois-quarts arrière, gros plan</figcaption>
+</figure>
+<figure>
+<img src="../assets/tigerscale-assembly-side-elevation.png" alt="Boîtier TigerScale V3, vue de côté" />
+<figcaption>Vue de côté</figcaption>
+</figure>
+</div>
+
+<div class="ts-photo-pair">
+<figure>
+<img src="../assets/tigerscale-rear-orientation.jpg" alt="TigerScale V3 assemblée, orientation arrière correcte" />
+<figcaption>Position et orientation de la balance</figcaption>
+</figure>
+<figure>
+<img src="../assets/tigerscale-pn532-mounting.jpg" alt="Lecteur PN532 monté dans son emplacement du boîtier" />
+<figcaption>PN532 en place dans son emplacement</figcaption>
+</figure>
+</div>
+
+### Schéma de câblage
+
+<img src="../assets/tigerscale-wiring-hsu.jpg" width="100%" alt="Schéma de câblage de la TigerScale V3" />
+
+*[Schéma interactif sur Cirkit Designer](https://app.cirkitdesigner.com/project/c6aa6c0a-9462-498f-8923-9ad4454e0e69)*
+
+### Dépannage
+
+**Aucun port COM détecté pour l'ESP32-S3 dans l'[installateur web](https://tigertag-project.github.io/Tiger-Scale-V3/) ?**
+
+Il manque peut-être un pilote pour votre système. [Suivez le guide d'installation du pilote](../tutorials/tigerscale-serial-port-driver.md).
 
 ## À vous de la fabriquer, et de la vendre
 
@@ -175,6 +228,20 @@ l'unité `0x00`.
 | Firebase (base de données du compte) | Écrit le poids en direct dans le compte de l'utilisateur |
 | Tiger Studio / Connect | Affichent le poids en direct ; supervision de l'état |
 
+## Exemple d'utilisation recommandé
+
+<img src="../assets/tigerscale-dymo-tigerpod.jpg" width="100%" alt="Un TigerPOD posé sur une balance DYMO, en train de peser une bobine identifiée" />
+
+1. **Branchez votre balance DYMO à votre ordinateur en USB.**
+2. **Posez le TigerPOD Mini ou l'original sur la balance.**
+3. **Effectuez une tare de la balance DYMO.**
+4. **Ouvrez Tiger Studio Manager.**
+5. **Posez une bobine sur le TigerPOD.**
+6. **Le TigerPOD lit les puces NTAG de la bobine et ouvre sa fiche dans Tiger
+ Studio Manager.**
+7. **La balance DYMO pèse la bobine — Tiger Studio Manager met à jour son
+ poids automatiquement.**
+
 ## Liens
 
 - **V3 (actuelle)** : [Tiger-Scale-V3](https://github.com/TigerTag-Project/Tiger-Scale-V3) (MIT)