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".
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.
