Scanner de cartes Magic — guide de fonctionnement

La machine dépile une pile de 150 à 200 cartes Magic, photographie chaque carte, la reconnaît et la range dans un bac dans l'ordre ; chaque photo est gardée pour que tu puisses corriger la reconnaissance après coup. Elle est conçue (plans 3D, électronique, logiciel) mais pas encore prototypée.

Vue d'ensemble

Tu poses une pile de cartes face visible dans la trémie, en haut, avec le poids presseur dessus. Un rouleau caoutchouté placé sous la pile pousse la carte du dessous à travers une fente de 0,45 mm qui ne laisse passer qu'une carte. Un second rouleau, le pinceur, l'arrache à la pile. La carte glisse ensuite par gravité sur un lit incliné à 35° et s'arrête contre un petit volet. Une caméra de 12 Mpx la photographie dans un capot noir, puis le volet s'efface et la carte tombe dans le bac, face visible, sur la précédente.

Un Raspberry Pi 5 stocke chaque photo avec son numéro d'ordre et reconnaît la carte en la comparant aux images de Scryfall. Il sert aussi une interface web Nuxt où tu vérifies les cas douteux, puis exportes la collection en CSV.

Vue isométrique : trémie en haut, capot noir de la caméra au-dessus du lit vert, bac de sortie en bas, boîtier électronique sous la trémie

Chiffre Valeur
Cartes 63 × 88 mm, 0,28 à 0,32 mm, non sleevées
Trémie 150 à 200 cartes, presseur ≈ 400 g
Bac de sortie ≈ 219 places, le logiciel s'arrête à 200
Débit ≈ 28 cartes/min simulé (≈ 2,1 s par carte), cible ≥ 20
Image ≈ 26 px/mm (≈ 660 dpi), caméra à 135 mm
Encombrement ≈ 371 × 208 × 324 mm
Impression ≈ 0,97 kg de filament, ≈ 88 h, plateau 220 × 220, sans support
Pièces 39 pièces imprimées (OpenSCAD paramétrique), prise à deux rangées incluse

Repères utilisés dans les plans : X est le sens d'avance de la carte, Y la largeur, Z la hauteur. X = 0 est la face intérieure du mur avant de la trémie, là où se trouve la porte.

Les sous-ensembles et leur rôle

La machine enchaîne huit sous-ensembles le long du trajet de la carte, pilotés par un seul moteur et un servo.

Coupe au milieu de la machine. Attention au sens : la trémie est à droite et la carte avance vers la gauche, passe sous la porte, dans le pinceur, sur la lèvre puis le lit, et tombe dans le bac en bas à gauche

Sous-ensemble Ce qu'il fait Pourquoi ce choix
Trémie et presseur Reçoit la pile face visible ; le presseur lesté à l'avant (≈ 300 g) plaque la carte du dessous sur le rouleau Seul le dos des cartes touche le rouleau. Le trou noir du presseur permet de détecter la trémie vide
Prise 2 rangées de moyeux à joints toriques NBR 26 × 3, sous la pile à X = −10 et X = −51, reliées par une courroie GT2, dépassant de 1 mm Friction par le dessous : pas d'élévateur, la gravité tient la pile
Seuil et porte Plancher rehaussé de 0,9 mm (réglable par cales) ; porte à 0,45 mm au-dessus, réglable à la molette (0,05 mm par cran) Une carte (0,31 mm) passe, deux (0,62 mm) butent
Pinceur d'extraction Rouleau + 2 galets à X = +32, sur les marges de la carte uniquement Tire la carte hors de la pile sans entraîner la suivante
Contre-guides et lèvre Rabattent la carte, raide, sur une lèvre courbe vers la pente Sans eux, la carte sort à l'horizontale et tape le capot
Lit et volet Lit vert mat incliné à 35°, rails latéraux, volet servo MG90S Transport par gravité ; position de photo répétable ; fond vert pour détourer
Caméra et éclairage Pi Camera Module 3 à 135 mm, normale au lit ; 2 barres LED IRC ≥ 90 latérales diffusées, capot noir Lumières loin de l'axe : le reflet des cartes vernies part sur le côté
Bac de sortie Parallèle au lit, 76 mm dessous ; la 1re carte est au fond Ordre conservé, cartes face visible

Pourquoi le moteur tourne en avant puis en arrière. Un seul moteur NEMA 17 entraîne la prise et le pinceur, reliés par deux engrenages 1:1 qui tournent en sens contraire. Chaque moyeu contient une roue libre (douille HF0612), comme la roue arrière d'un vélo. Moteur en avant, la prise pousse et le pinceur est débrayé. Moteur en arrière, le pinceur tire et la prise est débrayée, donc la carte suivante ne bouge pas. Bonus : une carte coincée se retire à la main vers l'avant, les deux rouleaux sont alors en roue libre.

Électronique. Le Raspberry Pi Pico (MicroPython) fait tout ce qui doit être précis à la milliseconde : pas du moteur via un driver TMC2209, servo, LED, capteurs, bouton STOP. Le Raspberry Pi 5 fait la photo, le stockage, la reconnaissance et l'interface web. Ils dialoguent en texte, ligne par ligne, par le câble USB (FEED, RELEASE, EVT DONE FEED…). L'alimentation est un bloc unique 12 V 5 A, avec fusible et protection contre l'inversion de polarité.

Capteur Où Sert à
S_HOPPER (TCRT5000) sous la trémie refuser FEED et annoncer la fin de pile
S_EXIT (TCRT5000) juste après la porte, X = 14 piloter les deux phases du FEED, mesurer la longueur de la carte
AS5600 (angle magnétique) pivot du bras des galets mesurer l'épaisseur et détecter une double (> 0,48 mm)
S_BED (TCRT5000) sous le lit déclencher la photo, vérifier que le lit s'est vidé
S_OUT (TCRT5000) après le bord du lit confirmation facultative de sortie

Le cycle d'une carte

Une carte traverse la machine en ≈ 2,1 s, d'après le simulateur du firmware ; la photo et le traitement sont des estimations pour le Pi 5.

Chronogramme du cycle d'une carte : commandes série, moteur, capteurs, caméra et volet sur 2,4 s

  1. 0 ms, FEED, phase a. Le Pi envoie FEED. Le moteur tourne en avant : la prise pousse la carte du dessous vers la porte.
  2. ≈ 150 ms. Le bord avant passe la porte, S_EXIT se couvre (EVT EXIT). Le moteur continue de 61 mm : la tête s'engage dans le pinceur et se couche sur la pente, la queue reste sur la prise.
  3. ≈ 575 ms, phase b. Après 30 ms de pause, le moteur repart en arrière : le pinceur tire, la prise est débrayée. L'AS5600 mesure l'épaisseur (EVT DOUBLE si deux cartes).
  4. ≈ 890 ms. La queue sort du pinceur ; la carte glisse seule sur le lit et s'arrête contre le volet vers 1 150 ms.
  5. ≈ 1 300 ms. S_BED est stable : EVT DONE FEED. Le Pi attend que l'image soit stable, prend la photo 12 Mpx et attribue le numéro d'ordre.
  6. ≈ 1 600 ms, RELEASE. Le volet s'ouvre de 22°, la carte tombe dans le bac vers 1 750 ms, le volet se referme.
  7. ≈ 2 090 ms. EVT DONE RELEASE : la carte suivante peut partir.

Pendant ce temps, le Pi traite la photo précédente : détourage, redressement, contrôle qualité, empreintes d'image, lecture de la ligne de collection. Cela prend ≈ 0,4 s sans OCR, 1 à 2 s avec. Si le traitement prend du retard, la mécanique attend.

En cas de problème, le Pico s'arrête et envoie un échec (JAM_FEED, JAM_CHUTE, JAM_BED). Le Pi met le lot en pause et affiche la consigne dans l'interface.

Ordre des cartes, images et correction

Tout repose sur une règle : le scan n° N est la N-ième carte du bac, quel que soit l'incident. Le numéro est attribué à la photo, juste avant que la carte tombe sur la précédente ; la n° 1 est au fond.

  • Paquets. À 200 cartes, le scan s'arrête et l'interface donne l'étiquette du paquet (par exemple « Classeur rouge, paquet 2, cartes 201 à 400 »). Tu vides tout le bac, puis Reprendre.
  • Doubles. Deux cartes passées ensemble sont photographiées comme une seule et comptent pour 2 dans le bac ; l'interface affiche « ×2 ».
  • Reprises. Une carte n'est photographiée qu'une fois (numéro écrit en base de façon synchrone, qui survit à une coupure), et aucune carte n'entre dans le bac sans photo. Une carte bloquée avant le lit se pose sur le lit, jamais dans le bac. Chaque incident est couvert par un test automatique.

Stockage. Chaque lot a son dossier sur le Pi : raw/ (photo brute 12 Mpx), card/ (carte détourée et redressée, 630 × 880), thumb/ (vignette), plus une base SQLite (lots, scans, candidats, journal des corrections). Le nom de fichier est le numéro d'ordre. Garder les photos brutes permet de relancer la reconnaissance plus tard sans rescanner. Une microSD de 64 Go tient ≈ 15 000 cartes.

Correction dans l'interface Nuxt (http://<nom-du-pi>.local:8000) :

  1. Créer un lot, poser la pile, cliquer sur Démarrer (page Pilotage : dernière photo, cadence, capteurs, remplissage du bac).
  2. Ouvrir le lot : la grille est triée par confiance croissante, les cas douteux d'abord.
  3. Sur chaque carte à revoir : un coup d'œil, 1 à 5 pour choisir un candidat, Entrée pour valider et passer à la suivante. F marque un foil, R rejette, / cherche une autre carte, Z zoome.
  4. Exporter en CSV (ManaBox, Moxfield ou Cardmarket).

Sur de vraies cartes, prévois 70 à 90 % d'acceptation automatique. Le reste part « à revoir » : surtout les réimpressions d'une même illustration (l'édition se lit sur la ligne de collection, présente depuis 2015), les foils à reflets et les cartes anciennes.

Réglages, entretien et dépannage

La plupart des réglages se font une fois au montage ; le détail est dans 05-impression-montage.md et 04-electronique.md.

Réglage Valeur cible Comment
Hauteur joints / seuil joints +0,1 à +0,2 mm au-dessus du seuil ajouter ou retirer une bande de clinquant de 0,1 mm
Jeu de porte 0,45 mm (plage 0,40–0,50) cale sur le seuil ; contrôle « une carte passe, deux bloquent » ; ±1 cran = ±0,05 mm
Précharge des galets 3,5 N (jamais > 4 N) peson, vis de précharge + nylstop
Capteurs TCRT5000 1,8 à 3,0 mm selon le capteur pré-réglage sur gabarit avant montage
Volet doigt dépassant de 6 mm, ouverture 22° servo_closed_deg / servo_open_deg
Caméra 135 mm, mise au point sur une carte posée page Caméra de l'interface, puis photo du lit vide
Driver moteur Vref = 1,13 V (0,8 A) tournevis sur le TMC2209

Entretien. Nettoyer les joints à l'isopropanol toutes les 500 cartes (une carte PVC humectée passe dans le pinceur). Contrôler la porte toutes les quelques centaines de cartes. Changer les joints toriques vers 10 000 à 20 000 cartes. Archiver les lots terminés quand la microSD se remplit.

Symptôme Cause probable Action
Doubles fréquentes porte trop haute, cartes collées (statique) −1 cran de porte, aérer la pile, vérifier les bandes alu à la masse
La carte ne sort pas de la porte (JAM_FEED phase=exit) joints sales, porte trop basse, seuil trop haut nettoyer, +1 cran, refaire la mesure joints/seuil
Carte coincée sous la porte en phase b (phase=pull) le pinceur patine carte de nettoyage, vérifier la précharge, +30 pas de feed_fwd_extra_steps
Carte suspendue sur la lèvre (JAM_CHUTE) carte cintrée, contre-guides mal réglés cale de 1,5 mm entre contre-guide et lèvre ; poser la carte sur le lit, Reprendre
Carte restée sur le lit (JAM_BED) volet qui ne s'efface pas tester FLAP OPEN, régler servo_open_deg
Photo floue mise au point faite sur le lit vide refaire la calibration avec une carte posée
Reflets sur les foils carte cintrée, capot mal assis vérifier diffuseurs et capot ; corriger à la main
Trémie vide non détectée trou du presseur obturé, S_HOPPER mal réglé presseur seul : STATUS doit donner hopper=0
Sous-tension (UNDERVOLTAGE) convertisseur 5 V trop bas, câble USB-C trop fin 5,15 V à vide ; plan B : alimentation officielle 27 W sur le Pi

Le guide complet (20 lignes de dépannage, procédures d'entretien) est docs/07-fonctionnement.md.

Coûts, état du projet et décisions

La cible de 200 € n'est pas tenue : la pénurie de RAM de 2026 a fait grimper le prix des Raspberry Pi 5, et la machine coûte déjà ≈ 180 € hors calculateur et caméra.

Variante Calcul Total
Référence retenue : Pi 5 1 Go tout sur la machine ≈ 303 €
Option Pi 5 2 Go tout sur la machine, plus de marge de RAM ≈ 353 €
Pi 4 1 Go tout sur la machine, boîtier à adapter ≈ 261 €
Pi Zero 2 W + ton PC le PC reconnaît et sert l'interface ≈ 203 € (≈ 181 € avec récupération)

État. Plans 3D complets (39 pièces, sans collision, sans support), firmware Pico (66 tests), logiciel Pi et interface Nuxt (97 tests, build OK), nomenclature chiffrée de 60 lignes. Deux tours de relecture indépendante ont trouvé 6 défauts bloquants et 46 majeurs, tous corrigés ou documentés. Rien n'a encore été imprimé ni monté.

Le point le plus sensible est l'adhérence de la prise. Avec deux rangées de rouleaux, sa marge calculée est de 1,8 à 2,1 pile pleine avec des joints propres, et descend vers 1,15 avec peu de cartes et des joints usés (1,0 = elle patine). Un test au banc (5b) la valide.

Décisions prises le 16/11/2026 (détail dans docs/09-decisions-ouvertes.md) :

  • Calculateur : Raspberry Pi 5 1 Go
  • Prise à deux rangées de rouleaux dès le départ
  • Cartes nues uniquement en V1
  • Export aux trois formats (ManaBox, Moxfield, Cardmarket), choisis à l'export
  • Foil saisi à la main (touche F)
  • Reste à faire : créer un dépôt GitHub pour versionner le projet

Tous les fichiers (plans OpenSCAD, STL, rendus, schémas, firmware, logiciel, docs détaillées) sont dans le dossier mtg-scanner/ du projet ; commence par son README.md.

Pour imprimer (mise à jour du 21/11) : prends les STL uniquement dans le dossier a-imprimer, qui contient les versions vérifiées des pièces du banc. Le zip du 16/11 et les anciennes versions sont rangés dans mtg-scanner/ancien et ne doivent plus servir.