Yazıcısız TSPL önizleme ve hata ayıklama

Yayın tarihi: 2026-08-27

TSPL işleri de ZPL işleri gibi sessizce bozulur. Yazıcı dosyayı kabul eder, bir etiket besler ve bir şey eksiktir ya da yanlış yerdedir. İşi önce ekranda okumak, bir şerit yanmış etiketi tek bir tarayıcı sekmesine indirir.

En küçük TSPL işi ve her satırın işi

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 fiziksel etiketi gerçek birimle bildirir — burada milimetre, birim yazılmazsa inç. GAP etiketler arasındaki boşluğu tarif eder; yazıcı birinin nerede bittiğini böyle bilir. CLS görüntü tamponunu temizler; olmazsa önceki işin içeriği yeniden basılabilir. İçerik komutları bu tampona çizer, PRINT onu işler. Eksik bir CLS ya da PRINT, "hiçbir şey olmadı" vakalarının en yaygın sebeplerindendir.

Tanı bulguları size ne söyler

Doğrulama işi okur ve tek bir geçti/kaldı yerine konum bilgili bulgular üretir. En sık karşılaşacaklarınız:

• Bilinmeyen komut — satır TSPL değildir; genelde yazım hatası ya da başka bir dilden sızmış satırdır.
• Yanlış alan sayısı — TEXT, BARCODE ve benzerleri sabit sayıda virgüllü argüman alır; eksik bir argüman sonraki her argümanı yanlış yuvaya kaydırır, bu yüzden komut yanlış çizilmek yerine atlanır.
• Desteklenen küme dışında barkod tipi — önizleme Code 128, Code 39, EAN-13 ve UPC-A'yı kapsar; diğer sembolojiler taklit edilmez, bildirilir.
• Geçersiz döndürme — TSPL 0, 90, 180 ve 270 kabul eder; başka bir değer düzeni sessizce değiştirecek bir yazım hatasıdır.
• Boş barkod verisi — boş dize sembol üretmez; kâğıtta bu "barkod basılmadı" diye okunur.
• Yazıcı davranışı komutu — bilgilendirme; aşağıya bakın.

Önizlemenin bilerek çizmediği komutlar

DIRECTION, OFFSET, BLINE, DENSITY, SPEED, SET ve CODEPAGE tanınır ve bildirilir ama çizilmez. Bunlar mekanizmanın davranışını değiştirir — besleme yönü, üstten kaydırma, siyah işaret izleme, yakma koyuluğu, baskı hızı, kod sayfası — ve ekran render'ı bunu dürüstçe üretemez. Bunları yazıcı davranışı bulgusu olarak görmek, önizlemenin doğru olduğu ve kalan sorunun donanıma ait olduğu anlamına gelir.

Pratik sonucu: ekrandaki etiket doğru ama basılan dönük ya da kaymışsa, düzene dokunmadan önce DIRECTION ve OFFSET satırlarına bakın.

İşe yarayan hata ayıklama sırası

1. Dili doğrulayın. TSPL, EPL ve CPCL dosyaları ilk bakışta hep "ZPL'e benzemiyor" görünür; dil tespit aracı bunu koddan çözer.
2. Render edin. Görüntü boşsa CLS, PRINT ve atlanmış içerik komutu var mı bakın.
3. Bulguları baştan sona okuyun — işin başındaki bir alan sayısı hatası çoğu zaman sonrasındaki her şeyi açıklar.
4. Yazıcı ayarlarını ancak bundan sonra ve teker teker değiştirin.

İki adım da burada: TSPL görüntüleyici işi render eder, TSPL doğrulayıcı bulguları listeler. Komut referansı motorun anladığı her komutu kapsam seviyesiyle gösterir.

Sık sorulan sorular

TSC yazıcısı olmadan TSPL etiketini önizleyebilir miyim?

Evet. Tarayıcı render'ı yazıcının çizeceği içerik komutlarının aynısını çizer — SIZE, GAP, CLS, TEXT, BARCODE, QRCODE, BOX, BAR, REFERENCE ve PRINT — ve tek bir geçti/kaldı yerine konum bilgili bulgular üretir.

TSPL işim neden hiçbir şey basmıyor?

Çoğunlukla eksik CLS ya da PRINT yüzünden. CLS görüntü tamponunu temizler, PRINT onu işler; PRINT yoksa yazıcı hiç çıktı vermez, CLS yoksa önceki işin içeriği geri gelebilir. İşin başındaki bir alan sayısı hatası da sonrasındaki her komutu atlatır.

İlgili yazılar

Kendi ZPL kodunuzu deneyin →