zplCloud Blog
GK420 + Raspberry Pi: una impresora USB clásica como impresora en la nube
Compra Link-OS cuando compres. Conserva lo que funciona mientras funcione. Ambos acaban en la misma plataforma.
La recomendación honesta primero
Si hoy vas a comprar una impresora de etiquetas, compra una Zebra con Link-OS - ZD421, ZD621 o más grande. Cloud Connect / Weblink viene integrado, tiene Wi-Fi, un cabezal más rápido, variantes de 300 dpi y RFID, y gestión remota de firmware y ajustes. Conectarla a zplCloud es un one-liner y sigue siendo gestionable durante años.
Esa no es la pregunta de la mayoría de los talleres y pequeños almacenes. La suya es:
"Hay una GK420d en la mesa de empaquetado. Ha impreso etiquetas de envío cada día desde 2014 y nunca ha fallado, pero solo tiene USB. ¿Tenemos que desecharla para imprimir desde la nube?"
No.
Lo que estas impresoras pueden y no pueden hacer
La GK420d/GK420t, GC420, LP2844 y la serie TLP antigua son mecánicamente excelentes y sencillas: 203 dpi, térmica directa o transferencia térmica, EPL2 y ZPL II. Millones siguen en servicio.
Les falta exactamente una cosa: conectividad. Sin Link-OS, por tanto sin Weblink y sin Cloud Connect. Muchas son solo USB. Desde el punto de vista de la nube, no existen.
Aún tienen todo lo que cuesta dinero reemplazar: un cabezal que funciona, el rodillo y el sensor de medio - y un dispositivo que tu equipo ya conoce.
Las piezas
| Pieza | Coste | Nota |
|---|---|---|
| Raspberry Pi Zero 2 W, 3, 4 o 5 | ~20–80 € | cualquier Raspberry Pi OS de 64 bits; una Zero 2 W maneja una o dos impresoras |
| Fuente, microSD, cable USB | ~15 € | el cable existente de la impresora funciona (Pi Zero: adaptador micro-USB OTG) |
| Agente CLI de zplCloud | incluido | Starter incluye 1 agente de impresora remota, Pro 5 |
| Total | menos de 100 € | frente a varios cientos por una impresora Link-OS de escritorio nueva |
El agente consume vatios de un solo dígito, se ejecuta como servicio systemd, se reconecta solo tras un corte de luz, y no necesita puertos de entrada, VPN ni cambios de cortafuegos - abre una conexión saliente a api.zplcloud.com.
Configuración, unos 20 minutos
1. Prepara la Pi
Graba Raspberry Pi OS Lite (64-bit) con el Raspberry Pi Imager. Activa SSH y Wi-Fi en los ajustes del imager antes de escribir la tarjeta, arranca, inicia sesión.
2. Conecta la impresora
lsusb
# Bus 001 Device 004: ID 0a5f:0084 Zebra Technologies ...
El ID de fabricante 0a5f es Zebra. Esa es toda la historia del driver: el agente habla con la impresora a través de la clase de impresora USB (libusb). Sin CUPS, sin spooler, sin driver del fabricante.
Si no aparece nada: usa un cable de datos, no uno solo de carga, y dale a una Pi Zero un hub con alimentación si la impresora consume más de lo que ofrece el puerto.
3. Instala la CLI
curl -fsSL https://zplcloud.com/install-cli.sh | sh
zplcloud --version
zplcloud usb list
El instalador elige la compilación correcta: linux-arm64 para Pi OS de 64 bits, linux-arm para 32 bits. usb list debería mostrar el dispositivo de clase impresora Zebra.
4. Imprime una etiqueta de prueba desde la Pi
zplcloud send --usb --zpl "^XA^FO50,50^A0N,32,32^FDHello from the Pi^FS^XZ"
Si sale una etiqueta, la parte de hardware está terminada.
Si no pasa nada, comprueba el modo de lenguaje. Una GK420 puede estar ejecutando EPL2, en cuyo caso el ZPL llega como texto y se ignora. La etiqueta de configuración te dice qué modo está activo. El acceso USB también necesita permisos - sudo está bien para la prueba; para el servicio, una regla udev que dé el dispositivo a un grupo es la solución limpia.
5. Ejecuta el agente como servicio
Crea una clave API en la plataforma (pestaña API) y luego:
sudo zplcloud proxy --agent "Packing table Pi" --service-install --api-key sk_zplcloud_xxxx
systemctl status zplcloud-agent
journalctl -u zplcloud-agent -f
Esto instala zplcloud-agent.service con Restart=always. La Pi ahora se conecta al arrancar y reenvía cada trabajo a la impresora USB.
Docker también funciona: mapea /dev/bus/usb al contenedor y establece ZPLCLOUD_API_KEY y ZPLCLOUD_AGENT (ver docker-compose.agent.yml). Una Pi puede servir varias impresoras USB e impresoras LAN por TCP 9100 al mismo tiempo.
6. Imprime desde cualquier lugar
El agente aparece en Remote Printers con su impresora USB, y desde ahí es una impresora zplCloud normal: diseñador, API REST, trabajos por lotes desde CSV/JSON, fuentes de datos Kafka o SQL, Print Views para el equipo de empaquetado, cola con reintentos, webhooks en éxito o fallo.
Tres cosas que saber sobre impresoras antiguas
Fuentes. Una GK420 tiene unos pocos megabytes de flash. La fuente Unicode de 11 MB de ZPLCloud no cabe y la variante slim de 7 MB va justa. Comprueba antes de enviar nada:
zplcloud send --usb --zpl '! U1 getvar "memory.flash_free"'
Usa Liberation Sans (0.4 MB) para texto latino acentuado, o deja que zplCloud renderice el texto como gráfico - el diseñador lo hace automáticamente para campos de texto en modo imagen. Para CJK en una GK420, el modo imagen es la respuesta. Una fuente de iconos construida desde SVGs solo ocupa unos pocos KB y cabe cómodamente.
Resolución y velocidad. 203 dpi, unas 4 ips. Suficiente para envíos, productos y estanterías; no para códigos 2D densos en electrónica pequeña.
Sin RFID, sin 300 dpi, sin Wi-Fi en la impresora. Si necesitas eso, es el momento de comprar nueva - y el cambio es barato, porque los diseños, bindings, Print Views y llamadas API siguen siendo idénticos. Solo cambia la entrada de la impresora.
Por qué conservarla es la respuesta defendible
Una impresora que funciona en un contenedor de basura es el peor resultado posible: la energía incorporada de la mecánica y la electrónica, más el envío de un reemplazo. Una GK420 que aún imprime bien necesita un cabezal cada pocos años - una pieza de repuesto, no un dispositivo nuevo. La Pi añade aproximadamente el consumo de una bombilla LED.
Compra Link-OS cuando compres. Conserva lo que funciona mientras funciona. zplCloud trata a ambas igual.