Ratgeber › TSPL ohne Drucker prüfen und debuggen

TSPL ohne Drucker prüfen und debuggen

Veröffentlicht: 2026-08-27

TSPL-Aufträge scheitern genauso still wie ZPL-Aufträge. Der Drucker nimmt die Datei an, schiebt ein Etikett durch, und etwas fehlt oder sitzt falsch. Den Auftrag zuerst am Bildschirm zu lesen, ersetzt einen Streifen verbrannter Etiketten durch einen Browser-Tab.

Ein minimaler TSPL-Auftrag und wozu jede Zeile dient

SIZE 100 mm, 150 mm
GAP 3 mm, 0 mm
CLS
TEXT 100, 100, "3", 0, 1, 1, "HELLO"
BARCODE 100, 200, "128", 100, 1, 0, 3, 3, "123456"
PRINT 1

SIZE deklariert das physische Etikett in echten Einheiten — hier Millimeter, ohne Einheit Zoll. GAP beschreibt den Abstand zwischen Etiketten, damit der Drucker das Ende erkennt. CLS leert den Bildpuffer; fehlt es, kann der Inhalt des vorherigen Auftrags erneut gedruckt werden. Inhaltsbefehle zeichnen in diesen Puffer, PRINT gibt ihn aus. Ein fehlendes CLS oder PRINT ist einer der häufigsten Gründe für "es passiert nichts".

Was die Diagnose wirklich sagt

Die Prüfung liest den Auftrag und meldet Befunde mit Position statt eines einzelnen Bestanden/Nicht bestanden. Die häufigsten Kategorien:

Unbekannter Befehl — die Zeile ist gar kein TSPL, meist ein Tippfehler oder eine Zeile aus einer anderen Sprache.
Falsche Feldanzahl — TEXT, BARCODE und Verwandte erwarten eine feste Anzahl kommagetrennter Argumente; ein fehlendes verschiebt alle folgenden in den falschen Platz, deshalb wird der Befehl übersprungen statt falsch gezeichnet.
Barcodetyp außerhalb des unterstützten Satzes — die Vorschau deckt Code 128, Code 39, EAN-13 und UPC-A ab; andere Symbologien werden gemeldet, nicht vorgetäuscht.
Ungültige Drehung — TSPL akzeptiert 0, 90, 180 und 270; alles andere ist ein Tippfehler, der das Layout stumm ändert.
Leere Barcodedaten — eine leere Zeichenkette erzeugt kein Symbol; auf Papier liest sich das als "Barcode fehlt".
Druckerverhalten-Befehl — informativ, siehe unten.

Befehle, die eine Vorschau bewusst nicht zeichnet

DIRECTION, OFFSET, BLINE, DENSITY, SPEED, SET und CODEPAGE werden erkannt und gemeldet, aber nicht gezeichnet. Sie ändern das Verhalten der Mechanik — Vorschubrichtung, Kopfversatz, Schwarzmarken-Erkennung, Schwärzung, Geschwindigkeit, Codepage — und ein Bildschirm kann das nicht ehrlich reproduzieren. Erscheinen sie als Druckerverhalten-Befunde, ist die Vorschau korrekt und die verbleibende Frage gehört zur Hardware.

Praktische Folge: Stimmt das Etikett am Bildschirm, ist aber gedruckt gedreht oder versetzt, prüfen Sie DIRECTION und OFFSET, bevor Sie das Layout anfassen.

Eine Reihenfolge, die funktioniert

Sprache bestätigen. TSPL-, EPL- und CPCL-Dateien sehen auf den ersten Blick alle "nicht nach ZPL" aus; der Sprach-Detektor klärt es anhand des Codes.
Rendern. Ist das Bild leer, prüfen Sie CLS, PRINT und ob ein Inhaltsbefehl übersprungen wurde.
Befunde von oben nach unten lesen — ein früher Feldanzahl-Fehler erklärt oft alles danach.
Erst danach Druckereinstellungen ändern, und zwar einzeln.

Beide Schritte gibt es hier: der TSPL-Viewer rendert den Auftrag, der TSPL-Validator listet die Befunde. Die Befehlsreferenz zeigt jeden Befehl, den die Engine versteht, mit seinem Abdeckungsgrad.

Häufig gestellte Fragen

Kann ich ein TSPL-Etikett ohne TSC-Drucker prüfen?

Ja. Ein Browser-Renderer zeichnet dieselben Inhaltsbefehle wie ein Drucker — SIZE, GAP, CLS, TEXT, BARCODE, QRCODE, BOX, BAR, REFERENCE und PRINT — und meldet Befunde mit Position statt eines einzelnen Bestanden/Nicht bestanden.

Warum druckt mein TSPL-Auftrag nichts?

Meist fehlt CLS oder PRINT. CLS leert den Bildpuffer, PRINT gibt ihn aus; ohne PRINT druckt der Drucker nie, ohne CLS kann der vorherige Inhalt zurückkommen. Auch ein früher Feldanzahl-Fehler überspringt alle folgenden Befehle.