zplCloud Blog
App zplCloud pour Android : l'imprimante en USB, depuis le téléphone
! U1 setvar "device.reset" "on" - envoyé depuis l'appareil qui est dans votre poche, sans PC, sans driver, sans réseau.
L'imprimante n'est jamais à côté d'un ordinateur
Une imprimante en mauvais état est un problème physique : du charabia à l'écran, un réglage d'obscurité que quelqu'un a déplacé, une config Wi-Fi qui pointe vers le SSID de l'année dernière. La réparer signifie se tenir à côté de l'appareil - sur un chariot élévateur, dans un rack, au fond d'un camion - et le seul ordinateur à portée est un téléphone.
L'app zplCloud pour Android parle à l'imprimante via un simple câble USB. Pas de portable, pas d'adaptateur série, pas de droits admin sur quoi que ce soit, et pas de réseau fonctionnel sur l'imprimante - ce qui compte, car une config réseau cassée est exactement ce que vous êtes souvent là pour réparer.
Pourquoi ça marche sur Android et pas sur iOS
Android expose le mode hôte USB : avec un câble OTG, le téléphone devient l'hôte et peut revendiquer un appareil USB. L'app (basée sur Capacitor) l'utilise pour ouvrir un canal vers l'interface de commandes de l'imprimante.
iOS n'a pas d'API publique équivalente pour revendiquer des appareils USB arbitraires. Sur iPhone et iPad, les mêmes travaux passent par le chemin réseau - Weblink ou l'agent CLI. C'est une limitation de plateforme, pas un élément de roadmap.
Deux chemins USB
| Mode | Comment il se connecte | Quand l'utiliser |
|---|---|---|
| Zebra SDK | via le driver USB Zebra / la couche Link-OS SDK | l'imprimante se présente comme un appareil USB Zebra standard |
| USB série direct (CDC-ACM) | driver intégré, aucun composant Zebra nécessaire | l'imprimante est en mode USB-CDC ; Android demande une fois la permission USB |
Les deux aboutissent au même endroit : un canal bidirectionnel qui transporte SGD et ZPL. Si un chemin n'énumère pas l'appareil, essayez l'autre avant de supposer que le câble ou l'imprimante est en cause.
Les commandes qui comptent
Tout ce qui suit est du SGD standard sur le même canal - l'app est un clavier pour l'interface de commandes de l'imprimante, pas un protocole propriétaire.
Confirmez que vous parlez au bon appareil :
! U1 getvar "device.friendly_name"
Si ça renvoie le nom, le canal fonctionne et tout le reste aussi. Faites ceci d'abord ; ça sépare un problème de câble d'un problème de commande.
Réinitialisez à un état propre :
! U1 setvar "device.reset" "on"
Videz la configuration complète - utile avant de changer quoi que ce soit, pour pouvoir la remettre :
{}{"allconfig":null}
Vérifiez ce que l'imprimante pense de son propre stockage avant de téléverser des polices ou des graphiques :
! U1 getvar "memory.flash_free"
Les variables réseau et d'obscurité se règlent de la même façon. Le point est que rien ici n'est spécifique à l'app : les mêmes chaînes fonctionnent depuis la CLI (zplcloud send --usb --zpl "…") quand vous êtes de retour à un bureau.
Configuration
1. Installez l'app zplCloud sur le téléphone ou la tablette Android.
2. Connectez l'imprimante avec un câble USB/OTG et mettez-la sous tension.
3. Accordez la permission USB quand Android la demande, et choisissez le mode de connexion.
4. Interrogez, réglez ou réinitialisez.
Notes pratiques
- Utilisez un câble de données. Un câble USB de charge seule n'énumère rien, et le symptôme ressemble exactement à une imprimante non prise en charge.
- Lisez avant d'écrire.
getvard'abord,setvarensuite. Une config vidée est la différence entre une réparation de cinq minutes et une imprimante que personne ne peut restaurer. - Un reset n'est pas un reset d'usine.
device.resetredémarre l'imprimante ; il n'efface pas vos polices, formats ou réglages réseau. Sachez lequel vous voulez vraiment avant de taper. - Amenez le téléphone à l'imprimante, pas l'imprimante au bureau. C'est tout l'intérêt - une imprimante boulonnée dans un rack n'a pas besoin d'être démontée pour être reconfigurée.