¿Quieres probar estos comandos en un editor real? Abre
EditorZPL y copia el ejemplo.
^HF
Formato de Host
El comando ^HF permite recuperar un formato ZPL previamente almacenado en la memoria de la impresora y enviarlo de vuelta al host. Es útil para verificar o reutilizar formatos guardados con el comando ^DF.
Parámetros
- D (Dispositivo): Ubicación de memoria donde está almacenado el formato (R:, E:, B:, A: (por defecto R:))
- O (Nombre del objeto): Nombre del formato a recuperar (1 a 8 caracteres alfanuméricos (por defecto UNKNOWN))
- X (Extensión): Extensión del archivo (.ZPL (fijo))
Ejemplo
^XA
^HFB:ETIQUETA1.ZPL
^XZ
Nota: El formato se devuelve al host a través del emulador de terminal. Primero debe haberse guardado el formato con ^DF.
^HG
Gráfico de Host
El comando ^HG permite subir imágenes gráficas almacenadas en la impresora hacia el host. El gráfico puede guardarse para uso futuro o descargarse a cualquier otra impresora Zebra.
Parámetros
- D (Dispositivo): Ubicación de memoria donde está el objeto (R:, E:, B:, A: (por defecto prioridad de búsqueda))
- O (Nombre del objeto): Nombre del gráfico a subir (1 a 8 caracteres alfanuméricos (por defecto UNKNOWN))
- X (Extensión): Extensión del archivo (.GRF (fijo))
Ejemplo
^XA
^HGE:LOGO.GRF
^XZ
Nota: Este comando es útil para hacer copias de seguridad de gráficos o transferirlos entre impresoras.
^HH
Etiqueta de Configuración
El comando ^HH envía de vuelta al host toda la información de configuración de la impresora a través del emulador de terminal. Incluye datos como oscuridad, modo de impresión, tipo de sensor, ancho de impresión, velocidad, configuración de red y más.
Nota: La información devuelta incluye: oscuridad, modo de despegue, tipo de medio, tipo de sensor, método de impresión, ancho y longitud de etiqueta, velocidad, baudios, prefijos de comando, modo ZPL, resolución, firmware, dirección IP, etc.
^HT
Lista de Fuentes Enlazadas
El comando ^HT devuelve al host la lista completa de fuentes enlazadas configuradas en la impresora. El enlace de fuentes permite que una fuente base utilice caracteres de otras fuentes cuando el carácter solicitado no existe en la fuente principal.
Ejemplo
^XA
^HT
^XZ
// Respuesta típica:
// LIST OF FONT LINKS
// E:SWISS721.TTF
// E:ANMDJ.TTF
// E:MSGOTHIC.TTF
Nota: Disponible solo en impresoras con firmware V60.14.x, V50.14.x o posterior. Las fuentes se enlazan previamente con el comando ^FL.
^HV
Verificación de Host
El comando ^HV permite devolver datos de campos específicos al host, junto con un encabezado ASCII opcional. Se usa con campos que tienen un número asignado mediante ^FN o ^RF, siendo especialmente útil para verificar datos RFID escritos.
Parámetros
- # (Número de campo): Número del campo del que recuperar datos (debe coincidir con ^FN o ^RF) (0 a 9999 (por defecto 0))
- N (Bytes a devolver): Cantidad de bytes de datos a devolver (1 a 256 (por defecto 64))
- H (Encabezado): Texto de encabezado a incluir con los datos. Compatible con ^FH (0 a 3072 bytes (por defecto sin encabezado))
- T (Terminación): Caracteres de terminación tras los datos. Compatible con ^FH (0 a 3072 caracteres)
- A (Aplicar a): Si ^PQ>1 o hay etiqueta nula, enviar respuesta por formato o por etiqueta (F=formato, L=etiqueta (por defecto F))
Ejemplo
^XA
^FH_^HV0,8,EPC[,]_0D_0A,L^FS
^PQ2
^XZ
// Respuesta:
// EPC[12345678]
// EPC[55554444]
Nota: Muy útil para verificar la correcta escritura de datos RFID. Con a=L se obtiene una respuesta por cada etiqueta impresa.
^HW
Listado de Directorio
El comando ^HW transmite un listado formateado de los objetos almacenados en un área de memoria específica. El listado incluye nombre del archivo, extensión, tamaño y bytes libres disponibles en esa ubicación de memoria.
Parámetros
- D (Dispositivo): Ubicación de memoria a listar (R:, E:, B:, A:, Z: (por defecto R:))
- O (Nombre del objeto): Filtro de nombre de objeto (1 a 8 caracteres, * para todos, ? como comodín (por defecto *))
- X (Extensión): Filtro de extensión (Cualquier extensión Zebra válida, * para todas (por defecto *))
Ejemplo
^XA
^HWR:*.*
^XZ
// Respuesta típica:
// DIR R:*.*
// *LOGO.GRF 8420
// *FORMATO1.ZPL 2048
// -794292 bytes free R:RAM
Nota: Cada línea de objeto comienza con asterisco (*) seguido del nombre (8 caracteres), punto, extensión (3 caracteres), tamaño del objeto y flags opcionales.
^HY
Subir Gráficos
El comando ^HY es una extensión de ^HG que permite subir objetos gráficos desde la impresora en cualquier formato soportado (GRF o PNG). La imagen se devuelve en forma de comando ~DY con los datos codificados en formato ZB64.
Parámetros
- D (Dispositivo): Ubicación del objeto gráfico (R:, E:, B:, A: (por defecto prioridad de búsqueda))
- O (Nombre del objeto): Nombre del gráfico a subir (1 a 8 caracteres alfanuméricos (obligatorio))
- X (Extensión): Formato de salida del gráfico (G=.GRF (bitmap raw), P=.PNG (bitmap comprimido) (por defecto formato almacenado))
Ejemplo
^XA
^HYE:LOGO.GRF
^XZ
Nota: La imagen se devuelve como comando ~DY con datos en formato ZB64 (compresión Zlib + Base64), lo que permite transferir gráficos entre impresoras eficientemente.
^HZ
Información Descriptiva
El comando ^HZ devuelve información descriptiva de la impresora en formato XML. Puede solicitar parámetros de formato, directorios de objetos, datos de objetos individuales o información de estado de impresión.
Sintaxis
^HZb o ^HZO,d:o.x,l
Parámetros
- B (Tipo de información): Tipo de descripción a devolver (a=toda la info, f=configuración formato, l=listado directorio, o=datos objeto, r=estado impresora)
- D (Dispositivo): Ubicación del objeto (para ^HZO) (R:, E:, B:, A: (por defecto R:))
- O (Nombre objeto): Nombre del objeto a consultar (1-8 o 1-16 caracteres según parámetro l (por defecto UNKNOWN))
- X (Extensión): Tipo de objeto (.FNT, .GRF, .PNG, .ZPL, .DAT, .ZOB, .STO)
- L (Nombre largo): Soporte para nombres de 16 caracteres (Y=sí (solo firmware V60.13.0.5+), N=no (por defecto N))
Ejemplo
^XA
^HZf
^XZ
// Para obtener info de un objeto específico:
^XA
^HZO,R:LOGO.GRF
^XZ
Nota: La información se devuelve en formato XML estructurado. Con b=a se obtiene toda la información disponible de la impresora.
^JT
Prueba de Cabezal
El comando ^JT ejecuta una prueba del cabezal de impresión para detectar elementos quemados o defectuosos. Puede configurar qué acción tomar si se detectan problemas y cuántos elementos defectuosos son tolerables.
Parámetros
- A (Activar prueba): Activa o desactiva la prueba de cabezal (Y = activar, N = desactivar)
- B (Umbral de elementos): Número de elementos defectuosos permitidos antes de actuar (0-999)
- C (Acción): Acción a tomar cuando se excede el umbral (N = ninguna, P = pausar, E = error, W = advertencia)
Nota: La prueba de cabezal es importante en aplicaciones que requieren códigos de barras perfectamente legibles. Configure según la criticidad de su aplicación.
~HB
Estado de Batería
El comando ~HB devuelve información sobre el estado de la batería en impresoras móviles Zebra. La respuesta incluye la lectura de voltaje del cabezal, voltaje de la batería y temperatura de la batería en grados Celsius.
Ejemplo
~HB
// Respuesta típica:
// <STX>24.00,07.20,25<ETX><CR><LF>
// (voltaje cabezal, voltaje batería, temperatura °C)
Nota: Este comando solo responde en impresoras móviles con batería. No confundir con la memoria RAM respaldada por batería. Para lecturas de voltaje más precisas, use el comando SGD power.voltage.
~HD
Diagnóstico del Cabezal
El comando ~HD muestra información de diagnóstico de la impresora incluyendo temperatura del cabezal y ambiente, resultado del test del cabezal, ajuste de oscuridad, velocidades de impresión y retroceso, longitud de paso, interfaces detectadas y más.
Ejemplo
~HD
// Respuesta típica:
// Head Temp = 29
// Ambient Temp = 00
// Head Test = Passed
// Darkness Adjust = 23
// Print Speed = 2
// Slew Speed = 6
Nota: La información incluye: temperaturas, test del cabezal, ajuste de oscuridad, velocidades, longitud de paso estática y dinámica, prefijos de comando, interfaces detectadas y estado de la cinta.
~HI
Identificación de Host
El comando ~HI solicita a la impresora que devuelva información de identificación incluyendo el modelo, versión de software, resolución en puntos por milímetro, tamaño de memoria y opciones detectadas como cortador u otros accesorios.
Ejemplo
~HI
// Respuesta típica:
// ZT410-300,V75.19.15Z,12,4096KB,CUTTER DETECTED
Nota: El formato de respuesta es: MODELO,VERSION,dpm,MEMORIA,OPCIONES. Los valores dpm pueden ser 6, 8, 12 o 24 puntos/mm según el cabezal instalado.
~HM
Estado de Memoria RAM
El comando ~HM devuelve inmediatamente un mensaje con el estado de la memoria RAM de la impresora. La respuesta incluye tres valores: memoria total instalada, memoria máxima disponible para el usuario y memoria actualmente disponible.
Ejemplo
~HM
// Respuesta típica:
// 1024,0780,0780
// (total KB, máximo disponible KB, actualmente disponible KB)
Nota: La memoria ocupada por bitmaps se incluye en el valor de memoria disponible actualmente. Descargar gráficos, fuentes o guardar bitmaps afecta solo a la RAM disponible, no al total o máximo.
~HQ
Consulta de Host
El comando ~HQ permite solicitar diversos tipos de información de la impresora. Según el parámetro especificado, puede devolver estado de errores, dirección MAC, resultados de prueba del cabezal, alertas de mantenimiento, odómetro, historial del cabezal, número de serie y más.
Parámetros
- TIPO (Tipo de consulta): Especifica qué información solicitar (ES=estado, HA=dirección MAC, JT=test cabezal, MA=alertas mantenimiento, MI=info mantenimiento, OD=odómetro, PH=historial cabezal, PP=Plug and Play, SN=número serie, UI=info USB)
Ejemplo
~HQES
// Respuesta típica:
// PRINTER STATUS
// ERRORS: 0 00000000 00000000
// WARNINGS: 0 00000000 00000000
Nota: La respuesta comienza con STX, incluye CR LF entre líneas, y termina con ETX. Los flags de error y advertencia son valores hexadecimales que indican condiciones específicas de la impresora.
~HS
Estado de Host
El comando ~HS devuelve tres cadenas de datos con información completa del estado de la impresora: configuración de comunicación, flags de papel/pausa/buffer, longitud de etiqueta, estado del cabezal, cinta, modo de impresión, etiquetas en lote y más.
Ejemplo
~HS
// Respuesta típica (3 cadenas):
// <STX>030,0,0,0622,000,0,0,0,000,0,0,0<ETX>
// <STX>001,0,0,0,1,2,0,0,00000000,1,000<ETX>
// <STX>1234,0<ETX>
Nota: La impresora NO responde si está en condición de: MEDIA OUT, RIBBON OUT, HEAD OPEN, REWINDER FULL o HEAD OVER-TEMPERATURE. La primera cadena incluye velocidad de baudios, bits de datos, paridad y handshaking codificados.
~JN
Prueba de Cabezal Fatal
El comando ~JN ejecuta una prueba del cabezal de impresión. Si la prueba detecta elementos de cabezal defectuosos, la impresora detiene completamente la impresión hasta que se corrija el problema o se desactive la prueba.
Nota: Use este comando en aplicaciones críticas donde la calidad de impresión no puede verse comprometida. La impresora no imprimirá si detecta elementos del cabezal quemados o dañados.
~JO
Prueba de Cabezal No Fatal
El comando ~JO ejecuta una prueba del cabezal de impresión. A diferencia de ~JN, si detecta elementos defectuosos solo genera una advertencia pero permite continuar imprimiendo.
Nota: Útil para monitorear el estado del cabezal sin detener la producción. Las advertencias pueden enviarse al host o mostrarse en el panel de la impresora.
~WC
Imprimir Etiqueta de Configuración
El comando ~WC genera e imprime una etiqueta con la configuración actual de la impresora. Incluye información como tipo de sensor, ID de red, modo ZPL, versión de firmware y datos descriptivos de los dispositivos R:, E:, B: y A:.
Nota: Este comando solo funciona cuando la impresora está inactiva. La etiqueta muestra oscuridad, velocidad, tipo de medio, comunicaciones serie, prefijos de comando, modo ZPL y mucho más.
^WD
Imprimir Etiqueta de Directorio
El comando ^WD imprime una etiqueta listando códigos de barras, objetos almacenados en DRAM o fuentes. Para códigos de barras muestra el nombre; para fuentes muestra nombre, número para ^A y tamaño; para objetos muestra nombre, extensión, tamaño y flags.
Parámetros
- D (Dispositivo): Dispositivo de origen (R:, E:, B:, A:, Z: (por defecto: R:))
- O (Nombre): Nombre del objeto (1 a 8 caracteres, * o ? como comodín (por defecto: *))
- X (Extensión): Extensión del archivo (.FNT=fuente, .BAR=código barras, .ZPL=formato, .GRF=gráfico, .CO=caché, .DAT=codificación, .BAS/.BAE=programa ZBI, .STO=datos, .PNG=PNG, .TTF=TrueType, .TTE=TrueType Extension, *=todos (por defecto: *))
Nota: Use ^WDZ:*.BAR para listar códigos de barras residentes. Use ^WDZ:*.FNT para listar fuentes residentes. Las extensiones .TTF y .TTE solo están disponibles en firmware V60.14.x, V50.14.x o posterior.
~WQ
Consulta de Escritura
El comando ~WQ activa la impresora para imprimir una etiqueta con información de odómetro, alertas de mantenimiento e historial del cabezal de impresión. Soporta múltiples tipos de consulta.
Parámetros
- QUERY-TYPE (Tipo de consulta): Información a solicitar (ES = estado de errores/advertencias, HA = dirección MAC del servidor de impresión, JT = resultados de prueba del cabezal, MA = configuración de alertas de mantenimiento, MI = información de mantenimiento, OD = odómetro, PH = historial de vida del cabezal, PP = cadena Plug and Play, SN = número de serie, UI = ID producto USB y versión BCD)
Nota: Para ~WQES, los errores y advertencias se devuelven como flags hexadecimales (ej: cabezal abierto=4, medio agotado=1). Las unidades del odómetro se controlan con ^MA. ~WQSN devuelve el número de serie de la impresora.