zplCloud Blog
App zplCloud para Android: la impresora por USB, desde el teléfono
! U1 setvar "device.reset" "on" - enviado desde el dispositivo que llevas en el bolsillo, sin PC, sin driver, sin red.
La impresora nunca está junto a un ordenador
Una impresora en mal estado es un problema físico: basura en la pantalla, un ajuste de oscuridad que alguien movió, una configuración Wi-Fi que apunta al SSID del año pasado. Arreglarla significa estar de pie junto al dispositivo - en una carretilla, en un rack, en el fondo de un camión - y el único ordenador a mano es un teléfono.
La app zplCloud para Android habla con la impresora por un cable USB normal. Sin portátil, sin adaptador serie, sin derechos de administrador en nada, y sin red funcionando en la impresora - lo que importa, porque una configuración de red rota es exactamente lo que a menudo estás allí para arreglar.
Por qué esto funciona en Android y no en iOS
Android expone el modo host USB: con un cable OTG el teléfono se convierte en el host y puede reclamar un dispositivo USB. La app (basada en Capacitor) lo usa para abrir un canal a la interfaz de comandos de la impresora.
iOS no tiene una API pública equivalente para reclamar dispositivos USB arbitrarios. En iPhone y iPad los mismos trabajos se ejecutan por la ruta de red - Weblink o el agente CLI. Esa es una limitación de plataforma, no un elemento de roadmap.
Dos rutas USB
| Modo | Cómo se conecta | Cuándo usarlo |
|---|---|---|
| Zebra SDK | a través del driver USB de Zebra / la capa Link-OS SDK | la impresora se presenta como un dispositivo USB Zebra estándar |
| USB serie directo (CDC-ACM) | driver integrado, sin componentes Zebra | la impresora está en modo USB-CDC; Android pide una vez permiso USB |
Ambos terminan en el mismo lugar: un canal bidireccional que transporta SGD y ZPL. Si una ruta no enumera el dispositivo, prueba la otra antes de asumir que el cable o la impresora son los culpables.
Los comandos que importan
Todo lo siguiente es SGD estándar sobre el mismo canal - la app es un teclado para la interfaz de comandos de la impresora, no un protocolo propietario.
Confirma que hablas con el dispositivo correcto:
! U1 getvar "device.friendly_name"
Si devuelve el nombre, el canal funciona y todo lo demás también. Haz esto primero; separa un problema de cable de un problema de comando.
Reinicia a un estado limpio:
! U1 setvar "device.reset" "on"
Vuelca la configuración completa - útil antes de cambiar nada, para poder restaurarla:
{}{"allconfig":null}
Comprueba lo que la impresora piensa sobre su propio almacenamiento antes de subir fuentes o gráficos:
! U1 getvar "memory.flash_free"
Las variables de red y oscuridad se configuran igual. El punto es que nada aquí es específico de la app: las mismas cadenas funcionan desde la CLI (zplcloud send --usb --zpl "…") cuando vuelves a un escritorio.
Configuración
1. Instala la app zplCloud en el teléfono o tablet Android.
2. Conecta la impresora con un cable USB/OTG y enciéndela.
3. Concede el permiso USB cuando Android lo pida, y elige el modo de conexión.
4. Consulta, configura o reinicia.
Notas prácticas
- Usa un cable de datos. Un cable USB solo de carga no enumera nada, y el síntoma se ve exactamente como una impresora no soportada.
- Lee antes de escribir.
getvarprimero,setvardespués. Una configuración volcada es la diferencia entre un arreglo de cinco minutos y una impresora que nadie puede restaurar. - Un reset no es un factory reset.
device.resetreinicia la impresora; no borra tus fuentes, formatos ni ajustes de red. Sepa cuál quieres realmente antes de teclear. - Lleva el teléfono a la impresora, no la impresora al escritorio. Ese es todo el punto - una impresora atornillada a un rack no necesita desmontarse para reconfigurarse.