zplCloud Blog
App zplCloud per Android: la stampante via USB, dal telefono
! U1 setvar "device.reset" "on" - inviato dal dispositivo che hai in tasca, senza PC, senza driver, senza rete.
La stampante non è mai vicino a un computer
Una stampante in cattivo stato è un problema fisico: spazzatura sul display, un'impostazione di oscurità che qualcuno ha spostato, una config Wi-Fi che punta all'SSID dell'anno scorso. Sistemarla significa stare accanto al dispositivo - su un carrello elevatore, in un rack, in fondo a un camion - e l'unico computer a portata di mano è un telefono.
L'app zplCloud per Android parla con la stampante via un normale cavo USB. Niente laptop, niente adattatore seriale, niente diritti di amministratore su nulla, e nessuna rete funzionante sulla stampante - il che conta, perché una config di rete rotta è esattamente ciò che spesso sei lì a sistemare.
Perché funziona su Android e non su iOS
Android espone la modalità host USB: con un cavo OTG il telefono diventa l'host e può reclamare un dispositivo USB. L'app (basata su Capacitor) lo usa per aprire un canale verso l'interfaccia di comandi della stampante.
iOS non ha un'API pubblica equivalente per reclamare dispositivi USB arbitrari. Su iPhone e iPad gli stessi lavori girano sul percorso di rete - Weblink o l'agente CLI. Questa è una limitazione di piattaforma, non una voce di roadmap.
Due percorsi USB
| Modalità | Come si collega | Quando usarla |
|---|---|---|
| Zebra SDK | tramite il driver USB Zebra / il layer Link-OS SDK | la stampante si presenta come un dispositivo USB Zebra standard |
| USB seriale diretta (CDC-ACM) | driver integrato, nessun componente Zebra necessario | la stampante è in modalità USB-CDC; Android chiede una volta il permesso USB |
Entrambe finiscono nello stesso posto: un canale bidirezionale che trasporta SGD e ZPL. Se un percorso non enumera il dispositivo, prova l'altro prima di presumere che il cavo o la stampante sia il colpevole.
I comandi che contano
Tutto ciò che segue è SGD standard sullo stesso canale - l'app è una tastiera per l'interfaccia di comandi della stampante, non un protocollo proprietario.
Conferma che stai parlando con il dispositivo giusto:
! U1 getvar "device.friendly_name"
Se restituisce il nome, il canale funziona e funzionerà anche tutto il resto. Fallo per primo; separa un problema di cavo da un problema di comando.
Ripristina a uno stato pulito:
! U1 setvar "device.reset" "on"
Scarica la configurazione completa - utile prima di cambiare qualsiasi cosa, così puoi rimetterla a posto:
{}{"allconfig":null}
Controlla cosa pensa la stampante del suo stesso storage prima di caricare font o grafiche:
! U1 getvar "memory.flash_free"
Le variabili di rete e oscurità si impostano allo stesso modo. Il punto è che qui nulla è specifico dell'app: le stesse stringhe funzionano dalla CLI (zplcloud send --usb --zpl "…") quando torni a una scrivania.
Configurazione
1. Installa l'app zplCloud sul telefono o tablet Android.
2. Collega la stampante con un cavo USB/OTG e accendila.
3. Concedi il permesso USB quando Android lo chiede, e scegli la modalità di connessione.
4. Interroga, imposta o ripristina.
Note pratiche
- Usa un cavo dati. Un cavo USB solo di ricarica non enumera nulla, e il sintomo sembra esattamente una stampante non supportata.
- Leggi prima di scrivere.
getvarprima,setvardopo. Una config scaricata è la differenza tra una riparazione da cinque minuti e una stampante che nessuno può ripristinare. - Un reset non è un factory reset.
device.resetriavvia la stampante; non cancella i tuoi font, formati o impostazioni di rete. Sappi quale vuoi davvero prima di digitare. - Porta il telefono alla stampante, non la stampante alla scrivania. Questo è tutto il punto - una stampante imbullonata in un rack non deve essere smontata per essere riconfigurata.