Eduard Diaz

IT-Techniker bei S-IE, einem offiziellen Zebra-Partner · Aktualisiert 4. Oktober 2026

TSPL vs ZPL: Unterschiede, Kompatibilität und Konvertierung

Eine Vorlage funktioniert auf einem Drucker, auf dem Ersatzgerät jedoch nicht. Prüfen Sie zunächst die Befehlssprache, bevor Sie Kabel austauschen oder das Layout neu erstellen. TSPL und ZPL können ähnliche Etiketten beschreiben, ihre Anweisungen sind aber nicht austauschbar. Manche Drucker bieten eine Emulation, andere benötigen eine konvertierte Vorlage oder eine andere Softwareausgabe. Diese Anleitung zeigt, wie Sie eine überschaubare und überprüfbare Migration vorbereiten.

Konzeptionelle Illustration zweier Thermodrucker mit TSPL- und ZPL-Codekarten

Was sind TSPL, TSPL2 und ZPL?

TSPL und TSPL2 sind von TSC dokumentierte Programmiersprachen für Etikettendrucker. Sie verwenden lesbare Befehle wie SIZE, CLS, TEXT, BARCODE und PRINT. TSPL2 ist kein anderer Name für ZPL: TSC beschreibt Unterschiede zwischen TSPL und TSPL2, unter anderem beim Schriftverhalten. Ein auf einem Gerät verfügbarer Befehl kann auf einem anderen abweichend arbeiten. Maßgeblich ist das Handbuch für das konkrete Modell und dessen Firmware.

ZPL steht für Zebra Programming Language. ZPL-II-Formate beginnen üblicherweise mit ^XA und enden mit ^XZ; ^FO positioniert Felder und ^FD enthält Daten. Beide Sprachfamilien beschreiben Inhalte, legen aber weder Papiergröße noch Anschluss oder Auflösung fest. USB und Ethernet können dieselbe Sprache übertragen. Ein anderes Kabel übersetzt keine Befehle und passt die Vorlage nicht automatisch an das neue Gerät an.

Praktische Unterschiede beim Etikettendesign

Der erste Unterschied ist die Syntax. TSPL nutzt Befehlsnamen mit häufig durch Kommas getrennten Parametern. ZPL verwendet kompakte Präfixe und Feldabschlusszeichen. Auch Schriften, Koordinaten und Geräteeinstellungen werden unterschiedlich interpretiert. Ein ähnlich aussehendes kurzes Wort beweist keine identischen Schriftmaße. Vergleichen Sie lange Produktnamen und kontrollieren Sie deren Zeilenumbrüche.

Keine Sprache ist für jeden Einsatz grundsätzlich besser. Eine zuverlässige TSPL-Anwendung kann für eine bestehende Installation passen. ZPL ist sinnvoll, wenn das System bereits entsprechende Vorlagen erzeugt. Prüfen Sie unterstützte Befehle, Softwareexporte und zukünftige Wartung. Berücksichtigen Sie Logos, Sonderzeichen, Barcode-Symbologien und gespeicherte Ressourcen, statt nur die sichtbaren Textfelder zu vergleichen.

Kann ein TSPL-Drucker ZPL drucken?

Einige TSC-Drucker bieten ZPL-Emulation über ihre Firmware; der Hersteller dokumentiert beispielsweise TSPL-EZ und TSPL-EZD. Emulation bedeutet, eine andere Sprache zu interpretieren. TSPL-Quelltext wird dadurch nicht zu ZPL, und nicht jeder Befehl muss sich exakt wie auf dem Originalgerät verhalten. Prüfen Sie die Sprachen der konkreten Gerätekonfiguration und testen Sie repräsentative Etiketten.

Trennen Sie drei Fragen: Welche Sprache enthält die Datei, welche versteht der Drucker und was sendet der Treiber? Nutzen Sie Konfigurationsbericht, Herstellerwerkzeug und Handbuch. Die Produktbeschreibung „Thermoetikettendrucker“ genügt nicht. Prüfen Sie vor einer Konvertierung, ob die erzeugende Anwendung die Zielsprache bereits exportieren kann. Das kann manuelle Pflege reduzieren und den Umgang mit variablen Daten besser erhalten.

Dieselbe Nachricht in TSPL und ZPL

Die Beispiele drucken HELLO auf einem ungefähr 50 × 30 mm großen Etikett bei 203 DPI. TSPL nennt Millimeter, ZPL verwendet 400 × 240 Punkte. Durch Rundung sind die Maße näherungsweise gleich. Die Beispiele zeigen dieselbe Absicht, keine identische Typografie: TSPL-Schrift 3 und ZPL-Schrift 0 besitzen unterschiedliche Metriken. Halten Sie diesen Versuch von echten Versanddaten getrennt.

SIZE legt in TSPL das Format fest, GAP den Materialabstand, CLS leert den Bildpuffer, TEXT positioniert Text und PRINT fordert die Ausgabe an. Passen Sie die beispielhaften 2 mm Abstand vor dem Druck an das Material an. Das ZPL-Beispiel richtet die Lückenerkennung nicht ein. Konfigurieren Sie Material und Kalibrierung separat am Zielgerät: Ein Sprachbeispiel ist keine vollständige Hardwareeinrichtung.

TSPL

SIZE 50 mm,30 mm
GAP 2 mm,0 mm
CLS
TEXT 30,30,"3",0,1,1,"HELLO"
PRINT 1,1

ZPL

^XA
^PW400
^LL240
^FO30,30^A0N,24,16^FDHELLO^FS
^XZ

DPI sind ebenso wichtig wie die Befehle

400 Punkte entsprechen bei 203 DPI ungefähr 50 mm, bei 300 DPI nur etwa 34 mm. Das betrifft Positionen, Schriftgrößen und Barcode-Module. Werden Befehle ohne Berücksichtigung der Auflösung übersetzt, kann eine sichtbare, aber physisch falsch skalierte Vorlage entstehen. Notieren Sie Quell- und Zielauflösung, bevor Sie die Layoutparameter bearbeiten.

Für gleiche physische Maße skalieren Sie Punktwerte mit Ziel-DPI geteilt durch Quell-DPI und prüfen anschließend Rundungen sowie Barcode-Anforderungen. Skalieren Sie keine kodierten Nutzdaten oder numerischen Artikelnummern. Millimeterangaben und Punktkoordinaten verlangen unterschiedliche Behandlung. Der aktuelle EditorZPL-Konverter rechnet physische SIZE-Werte mit 203 DPI um. Eine andere Vorschauauflösung berechnet nicht automatisch sämtliche Koordinaten neu.

TSPL mit EditorZPL in ZPL konvertieren

Bewahren Sie TSPL-Datei und einen korrekten Referenzdruck auf. Öffnen Sie den Konverter, fügen Sie ein vollständiges Etikett ein oder importieren Sie es und prüfen Sie den erzeugten ZPL-Code. Lesen Sie Warnungen und vergleichen Sie die Vorschau bei den vorgesehenen Maßen. Kontrollieren Sie jedes Feld: Eine falsche Chargennummer oder abgeschnittene Adresse kann ein ansonsten überzeugendes Etikett unbrauchbar machen.

Der Konverter verarbeitet übliche Layoutbefehle, kein vollständiges Druckerprogramm. Er nähert Schriftmaße an, lässt BITMAP-Grafiken aus und übernimmt nicht alle Einstellungen. DIRECTION, REFERENCE, CODEPAGE und PRINT werden derzeit übersprungen. Orientierung, Zeichensatz und Kopienzahl benötigen deshalb eine eigene Prüfung. REVERSE wird durch eine gefüllte Box angenähert. Das sind Grenzen des Konverters, nicht der Nachweis, dass ZPL diese Funktionen nicht darstellen könnte.

TSPL-zu-ZPL-Konverter öffnen

Checkliste vor dem Produktiveinsatz

Testen Sie lange Texte, Umlaute, leere Felder, gedrehte Elemente und echte Barcode-Daten. Meldet das Werkzeug eine unbekannte Symbologie, prüfen Sie die Zuordnung: Es kann ersatzweise Code 128 verwenden. Ein lesbarer Barcode ist nicht zwingend vom verlangten Typ oder mit dem erwarteten Inhalt versehen. Vergleichen Sie die Scannerlesung mit Quelldaten und Anforderungen des empfangenden Systems.

Drucken Sie eine kleine Probe auf dem Zielgerät mit dem vorgesehenen Material. Kontrollieren Sie Maße, Orientierung, Kontrast, abgeschnittene Bereiche und Ruhezonen. Fehlende Logos müssen eventuell neu erstellt oder separat installiert werden. Testen Sie ein Etikett vor einem Stapel und prüfen Sie die Mengen, statt die Übernahme von PRINT vorauszusetzen. Bewahren Sie die alte Vorlage auf und dokumentieren Sie Gerät, Firmware, DPI und Änderungen.

TSPL behalten, emulieren oder migrieren?

Behalten Sie TSPL, wenn Anwendung und Drucker zuverlässig damit arbeiten und keine Anforderung einen Wechsel rechtfertigt. Prüfen Sie dokumentierte Emulation beim Gerätetausch mit bestehenden Vorlagen. Konvertieren Sie, wenn der Zielablauf ZPL verlangt und ein nativer Export fehlt. Vergleichen Sie die Möglichkeiten anhand einer repräsentativen Vorlage statt nur anhand von Sprachalter oder Druckermarke.

Funktioniert ein einfaches Etikett, die Produktionsvorlage aber nicht, ergänzen Sie deren Elemente einzeln. Unterscheiden Sie Übertragungs- und Layoutprobleme: Ein Gerät ohne eingehenden Auftrag verlangt eine andere Untersuchung als ein unvollständiger Barcode. Das Ziel ist ein wiederholbarer Ablauf mit überprüfter Ausgabe, nicht bloß eine Datei, die den Konverter ohne Warnung durchläuft.

Häufige Fragen

Sind TSPL und ZPL dieselbe Sprache?

Nein. Syntax und Interpretation unterscheiden sich. Ähnliche Etiketten benötigen andere Befehle, sofern der Drucker keine passende Emulation bietet.

Versteht jeder TSC-Drucker ZPL?

Gehen Sie nicht davon aus. Prüfen Sie Modell, Firmware und aktivierte Emulation und testen Sie die tatsächliche Vorlage.

Kann ich TSPL online ansehen?

Das TSPL-zu-ZPL-Werkzeug übersetzt unterstützte Anweisungen und zeigt den resultierenden ZPL-Code als Vorschau. Es emuliert keine vollständige TSPL-Firmware; ausgelassene oder angenäherte Befehle beeinflussen das Ergebnis.

Konvertiert dieses Werkzeug auch ZPL in TSPL?

Es arbeitet in Richtung TSPL zu ZPL. Die Gegenrichtung benötigt eine andere Implementierung oder einen Export Ihrer Software. Eine geänderte Dateiendung übersetzt den Inhalt nicht.

Weitere Anleitungen

Offizielle Quellen

Quellen und Konverterverhalten am 4. Oktober 2026 geprüft. KI-generierte Illustration generischer Drucker.

Über den Autor