TSPL vs ZPL: differenze, compatibilità e conversione
Un modello funziona su una stampante, ma non su quella che la sostituisce. Prima di cambiare cavi o rifare il layout, verifica il linguaggio di comando. TSPL e ZPL possono descrivere etichette simili, ma le istruzioni non sono intercambiabili. Alcuni dispositivi offrono emulazione; altri richiedono un modello convertito o un’esportazione diversa dal programma. Questa guida aiuta a distinguere i casi e preparare una migrazione verificabile.
Che cosa sono TSPL, TSPL2 e ZPL?
TSPL e TSPL2 sono linguaggi documentati da TSC per stampanti di etichette. Utilizzano comandi leggibili come SIZE, CLS, TEXT, BARCODE e PRINT. TSPL2 non è un altro nome di ZPL: TSC documenta differenze fra TSPL e TSPL2, comprese le caratteristiche dei font. Un comando disponibile su un dispositivo può comportarsi diversamente su un altro. Consulta il manuale del modello e del firmware effettivi.
ZPL significa Zebra Programming Language. I formati ZPL II iniziano normalmente con ^XA e terminano con ^XZ, con ^FO per la posizione e ^FD per i dati. Entrambe le famiglie descrivono contenuti, senza determinare carta, collegamento o risoluzione. USB ed Ethernet possono trasportare lo stesso linguaggio. Cambiare cavo non traduce le istruzioni e non adatta il disegno alla stampante.
Le differenze che incidono sul risultato
La prima differenza è la sintassi. TSPL usa nomi di comandi seguiti da parametri, spesso separati da virgole. ZPL impiega prefissi compatti e delimitatori di campo. Cambia anche l’interpretazione di font, coordinate e impostazioni. Una parola breve simile non dimostra metriche identiche. Confronta nomi di prodotto lunghi e verifica se le interruzioni di riga rimangono corrette.
Non esiste un linguaggio migliore in ogni situazione. Un’applicazione TSPL affidabile può essere adatta all’impianto esistente. ZPL si inserisce bene in un sistema che genera già quei modelli. Valuta comandi supportati, esportazioni disponibili e manutenzione futura. Considera loghi, caratteri speciali, simbologie e risorse memorizzate, oltre ai campi di testo più evidenti.
Una stampante TSPL può stampare ZPL?
Alcune stampanti TSC includono emulazione ZPL nel firmware; il produttore documenta famiglie come TSPL-EZ e TSPL-EZD. Emulare significa interpretare un altro linguaggio. Non rende il sorgente TSPL identico a ZPL né garantisce che ogni comando si comporti esattamente come sul dispositivo originale. Verifica i linguaggi disponibili nella configurazione specifica e prova etichette rappresentative.
Distingui tre domande: quale linguaggio contiene il file, quale accetta la stampante e che cosa invia il driver? Consulta rapporto di configurazione, utilità del produttore e manuale. La descrizione commerciale “stampante termica” non basta. Prima di convertire, controlla se l’applicazione originale esporta già il linguaggio di destinazione: può ridurre gli interventi manuali e preservare meglio la gestione dei dati variabili.
Lo stesso messaggio in TSPL e ZPL
Gli esempi stampano HELLO su un’etichetta di circa 50 × 30 mm a 203 DPI. TSPL dichiara millimetri; ZPL usa 400 × 240 punti. Gli arrotondamenti rendono le misure approssimative. Mostrano un’intenzione equivalente, non caratteri identici: il font 3 di TSPL e il font 0 di ZPL hanno metriche diverse. Tieni la prova separata dai dati reali delle spedizioni.
In TSPL, SIZE stabilisce il formato, GAP lo spazio del supporto, CLS pulisce il buffer, TEXT colloca il testo e PRINT richiede la stampa. Adatta i 2 mm di spazio al rotolo reale prima di stampare. L’esempio ZPL non configura il rilevamento degli spazi. Prepara supporto e calibrazione separatamente sul dispositivo finale: un esempio di linguaggio non è una procedura completa di configurazione hardware.
TSPL
SIZE 50 mm,30 mm
GAP 2 mm,0 mm
CLS
TEXT 30,30,"3",0,1,1,"HELLO"
PRINT 1,1ZPL
^XA
^PW400
^LL240
^FO30,30^A0N,24,16^FDHELLO^FS
^XZI DPI contano quanto i comandi
A 203 DPI, 400 punti misurano circa 50 mm; a 300 DPI, circa 34 mm. Cambiano posizioni, font e moduli dei codici a barre. Tradurre i comandi senza considerare la risoluzione può generare un’etichetta visibile ma fisicamente errata. Annota i DPI di origine e destinazione prima di modificare i parametri del layout.
Per mantenere le dimensioni, moltiplica le misure in punti per DPI di destinazione diviso DPI di origine, poi verifica arrotondamenti e requisiti dei codici. Non scalare dati codificati o identificativi numerici dei prodotti. Millimetri e coordinate in punti richiedono trattamenti distinti. Il convertitore TSPL attuale di EditorZPL interpreta le misure fisiche SIZE a 203 DPI; scegliere altri DPI per l’anteprima non ricalcola tutte le coordinate.
Come convertire TSPL in ZPL con EditorZPL
Conserva il file TSPL e una stampa corretta di riferimento. Apri il convertitore, incolla o importa un’etichetta completa ed esamina il ZPL generato. Leggi gli avvisi e confronta l’anteprima alle dimensioni previste. Controlla ogni campo: un numero di lotto o un indirizzo troncato può invalidare l’etichetta anche se il resto del disegno appare corretto.
Il convertitore gestisce comandi comuni di layout, non un programma completo della stampante. Approssima i font, omette BITMAP e non conserva tutte le impostazioni. Attualmente ignora DIRECTION, REFERENCE, CODEPAGE e PRINT: orientamento, caratteri e copie richiedono verifica. REVERSE viene approssimato con un rettangolo pieno. Sono limiti del convertitore, non una dimostrazione che ZPL non possa rappresentare quelle funzioni.
Apri il convertitore TSPL in ZPLControlli prima della produzione
Prova testi lunghi, accenti, campi vuoti, elementi ruotati e dati reali dei codici. Se compare un avviso per una simbologia sconosciuta, controlla la corrispondenza: il convertitore può sostituirla con Code 128. Un codice leggibile non è necessariamente del tipo richiesto né contiene i dati attesi. Confronta la scansione con l’origine e i requisiti del sistema ricevente.
Stampa un campione sul dispositivo finale con il supporto reale. Verifica dimensioni, orientamento, contrasto, tagli e margini liberi. I loghi mancanti possono richiedere ricostruzione o installazione separata. Prova un’etichetta prima di un lotto e controlla le quantità senza presumere che PRINT sia stato conservato. Salva il vecchio modello e annota dispositivo, firmware, DPI e modifiche per la manutenzione.
Quando mantenere TSPL, emulare o migrare
Mantieni TSPL se applicazione e stampante lo gestiscono bene e nessun requisito giustifica un cambiamento. Valuta l’emulazione documentata per sostituire il dispositivo conservando i modelli. Converti quando il flusso ricevente richiede ZPL e manca un’esportazione nativa. Confronta le opzioni con un’etichetta rappresentativa, senza decidere soltanto in base all’età del linguaggio o alla marca.
Se un esempio semplice funziona ma il modello produttivo no, reintroduci gli elementi uno alla volta. Separa comunicazione e layout: una stampante che non riceve lavori presenta un problema diverso da un codice a barre incompleto. Cerca un processo ripetibile e verificato, non soltanto un file che supera la conversione senza avvisi.
Domande frequenti
TSPL e ZPL sono lo stesso linguaggio?
No. Sintassi e interpretazione differiscono. Etichette simili richiedono istruzioni diverse, salvo un’emulazione appropriata nella stampante.
Tutte le stampanti TSC accettano ZPL?
Non darlo per scontato. Verifica modello, firmware ed emulazione attiva e valida il modello reale di etichetta.
Posso visualizzare TSPL online?
Lo strumento TSPL in ZPL converte le istruzioni supportate e mostra il risultato ZPL. Non emula l’intero firmware TSPL: omissioni e approssimazioni incidono sull’anteprima.
Questo strumento converte ZPL in TSPL?
La direzione disponibile è TSPL in ZPL. L’inversa richiede un’altra implementazione o un’esportazione dal tuo software. Cambiare estensione non converte il contenuto.
Guide correlate
Riferimenti ufficiali
- TSC: TSPL/TSPL2 Programming Manual
- TSC: Customizable Printer Language Firmware
- TSC: FAQs — TSPL-EZ / TSPL-EZC
- Zebra: ^XA — Start Format
Fonti e comportamento del convertitore verificati il 4 ottobre 2026. Illustrazione di stampanti generiche generata con IA.
Informazioni sull'autore
Eduard Diaz
Eduard Diaz è tecnico IT (sviluppo) presso S-IE, partner ufficiale Zebra con oltre 20 anni nei servizi di identificazione ed etichettatura. Sviluppa e mantiene EditorZPL per rendere più facile il lavoro con ZPL e le stampanti di etichette Zebra.
s-ie.cat