Device Hub : installer, appairer et imprimer

Le pont local entre les apps du navigateur et le matériel de l’entrepôt : installez sur le PC, appairez une fois, connectez imprimantes/balances et surveillez la file au centre d’impression.

Qu’est-ce que Device Hub#

Le bac à sable du navigateur ne peut pas ouvrir de TCP brut / USB / série, donc le WMS web ne parle pas directement aux imprimantes ZPL ni aux balances. Device Hub est une app résidente dans la barre d’état, installée sur chaque PC d’entrepôt (Windows / Mac), qui fait le pont « navigateur ↔ matériel » : démarrage avec la machine, exécution discrète. Construit avec Tauri v2 : un code pour Windows + macOS (Intel et Apple Silicon).

Télécharger et installer#

1. Téléchargez-le depuis la page officielle (/zh/download ou /en/download) : la page recommande automatiquement le DMG Mac ou le MSI Windows (universel) selon votre plateforme.
2. Télécharger → installer → suivant-suivant-terminer. Zéro étape manuelle : pas de pilotes à la main, pas de commandes, pas de fichiers de configuration.
3. Assistant de premier lancement : ① il affiche un code d’appairage → ② il découvre les imprimantes automatiquement (mDNS + USB) ; cochez les appareils et définissez l’imprimante d’étiquettes par défaut → ③ terminé.
4. Démarre avec la machine et tourne discrètement en arrière-plan.

Appairage#

1. L’icône de la barre d’état affiche un code d’appairage à 6 chiffres.
2. Saisissez-le une fois côté web : dans la boîte d’appairage qui apparaît à l’impression, ou dans Admin → Print Devices (la gestion du Hub y est aussi).
3. Après appairage, un token est émis (stocké dans localStorage) ; chaque handshake WebSocket le porte ensuite. Par défaut, seul 127.0.0.1 est lié ; le mode LAN (impression depuis mobile) est opt-in et exige toujours le token.

Connecter les imprimantes#

• Imprimantes ZPL (Zebra et similaires) : USB ou réseau port 9100 ; le Hub envoie du ZPL brut et sonde l’état (plus de papier/ruban/couvercle ouvert).
• Tous les boutons d’impression web passent par le SDK vers le Hub. S’il n’est pas installé, le bouton affiche une carte « Device Hub non détecté » avec le lien de téléchargement ; le téléchargement du ZPL reste en secours.
• Imprimante d’étiquettes par défaut : marquez-la sur la page des appareils (is_default_label_printer).
• Les balances se connectent en série / USB-série, avec débit, préfixe/suffixe et unité configurables ; elles prennent en charge les protocoles courants de sortie continue (p. ex. Mettler Toledo, CAS, AND). Enregistrez-la sur la page des appareils comme type scale.

Canal d’impression cloud du mobile#

1. Touchez imprimer l’étiquette sur mobile → POST /api/wms/print-jobs → table print_jobs (queued, avec le contenu ZPL).
2. Le Device Hub du PC s’abonne à Supabase Realtime (avec sondage de 3 s en secours) → réclame le travail atomiquement (UPDATE … WHERE status=queued ; zéro ligne = annulé, pas d’impression ; évite les erreurs).
3. Imprime localement sur la Zebra → réécrit done/failed → le téléphone interroge le statut.

Centre d’impression (app Admin)#

• File d’impression : toute la table print_jobs ; filtres statut/entrepôt/imprimante/type d’étiquette/heure. Travaux non traités >5 min surlignés ; les queued peuvent être annulés, les failed réimprimés ; actualisation en direct ; après l’envoi depuis un bouton WMS vous recevez un lien ici.
• Appareils d’impression : toute la table devices ; en ligne/hors ligne selon le battement last_seen_at (seuil 2 min) ; type de connexion, marque d’imprimante par défaut, Hub propriétaire ; la gestion d’appairage du Hub est aussi ici.