Belirtiden nedene ZPL sorun giderme

Yayın tarihi: 2026-08-27 · Güncellendi: 2026-10-01

Termal etiket sorunları tersten teşhis edilir: önce fiziksel çıktıyı görürsünüz, sonra ona sebep olan ZPL satırına dönersiniz. Bu sayfa triyaj adımıdır — yazıcının gerçekte ne yaptığını eşleştirin, olağan nedeni alın, sonra onu doğrulayan kontrolü izleyin. Aşağıdaki her belirti tam bir anlatıma bağlanır.

Yazıcıdan değil dosyadan başlayın

İçgüdü bir yazıcı ayarını değiştirip yeniden basmak ve bakmaktır. Bu hem etiket yakar hem nedeni gizler: ayar değişikliği dosya kaynaklı bir sorunu tek iş için örtebilir, sonraki yazıcıda geri getirir. ZPL okunabilir bir metindir ve arızaların çoğu orada görünür — bildirilen ölçü, koordinatlar, alan sonlandırıcılar, yön harfleri. Önce dosyayı okuyun; yazıcıya ancak dosyanın temiz olduğu kanıtlandığında dokunun.

Belirti → olası neden

Gördüğünüz	Olağan neden	Anlatım
Her şey basıldı ama medyaya göre çok küçük	Dosya bir çözünürlüğün noktalarıyla yazıldı, farklı çözünürlüklü bir yazıcıya gitti (203'e karşı 300 dpi)	Etiket çok küçük basılıyor
Sağ kenar ya da alt kısım eksik	İçerik ^PW/^LL sınırını aşıyor ya da medya dosyanın varsaydığından dar	Etiket kırpılıyor
Bir metin satırı kenardan taşıyor ya da kaydırılan satırlar üst üste basılıyor	Alanda ^FB yok, yani hiçbir şey kaydırılmıyor; ya da ^FB metnin gerektirdiğinden az satıra izin veriyor ve fazlası son satırın üstüne basılıyor	Metin etiketten taşıyor
Barkod basılıyor ama okuyucu okumuyor	Çözünürlüğe göre modül genişliği çok küçük, sessiz bölge yok ya da sembolojinin kodlayamayacağı veri	Barkod okunmuyor
Tüm etiket 180° dönük ya da tek alan yan yatıyor	Üç ayrı anahtar döndürür: ^PO (tüm etiket), ^FW (sonraki tüm alanlar), ^A'daki yön harfi (tek alan)	Ters basılıyor
Türkçe/aksanlı karakterler bozuk çıkıyor	Kodlama uyuşmazlığı — dosya UTF-8 ama yazıcıya söylenmemiş (^CI28) ya da fontta o karakterin glifi yok	Özel karakterler basılmıyor
Her gerçek etiketten sonra fazladan boş etiket besleniyor	Bildirilen etiket uzunluğu medyayla uyuşmuyor ya da işte kimsenin istemediği bir ^PQ var	Fazladan boş etiket
Düzen doğru ama her şey kaymış duruyor	Küresel bir kaydırma devrede: ^LH, ^LS ya da ^LT — veya ^FT, ^FO sanılarak kullanılıyor	İçerik kaymış
Etiket bomboş çıkıyor	Yapısal: dengesiz ^XA/^XZ, sonraki komutları yutan kopuk ^FS zinciri ya da konumsuz veri	Bomboş basılıyor
Formatta birden çok grafik var, yalnız sonuncusu basılıyor	ZPL'i emülasyon katmanından geçiren mobil yazıcı — formatın kendisi çoğunlukla geçerli	Yalnız son grafik
Etiket yerine ham metin ve kontrol karakterleri	Feed düğmesi dizisinde tetiklenen dump modu — ya da EPL nesli yazıcıya gönderilmiş ZPL	Anlamsız karakterler
Yazıcı birdenbire ribon istiyor, medya davranışı işten işe değişiyor	Format ^MT taşıyor ve yazıcı iş tarafındaki yapılandırmaya itaat ediyor	Formattan gelen medya tipi
Durum sorgusu (~HS) çok uzun sürüyor ya da hiç dönmüyor	Beş yazıcı durumu sessizlikle cevap verir; açık bağlantının arkasındaki sorgu bekler	Yavaş ya da cevapsız durum
Ping cevap veriyor, 9100 portuna hiçbir şey ulaşmıyor	ICMP geçiyor ama ham servis kapalı, süzülmüş ya da başka bir bağlantıda	Ping var, 9100 yok
Beyaz olması gereken alanlar nokta nokta	Dosyadaki taranmış bitmap — ya da kafada koyuluk, kir ve aşınma	Beyaz alanda noktalar
Termal transfer baskı soluk, bulaşıyor ya da siliniyor	Ribon tipi etiket malzemesiyle uyuşmuyor ya da hız ribon sınırının üstünde	Soluk ya da bulaşan transfer baskı

Önizleme neyi kanıtlar, neyi kanıtlayamaz

Tarayıcı önizlemesi yazıcının çizeceği komutların aynısını çizer; bu yüzden büyük bir soru kümesini medya harcamadan kapatır: içerik bildirilen ölçüye sığıyor mu, koordinatlar sandığınız yere düşüyor mu, barkodun verisi kodlanabilir mi, ^FW ve alan başına ^A yönleri beklediğinizi yapıyor mu, komut akışı yapısal olarak sağlam mı.

Fiziksel katmanı kanıtlayamaz. Yazıcının içinde uygulanan baskı yönü (^PO), üstten kaydırma (^LT), medya izleme ve boşluk algılama, koyuluk ve hız, ribbon ile kafa durumu, RFID kodlaması — hepsi görüntü oluşturulduktan sonra gerçekleşir. Kusursuz görünen bir önizleme sorunu o katmana daraltır; bu bir başarısızlık değil, işe yarar bilgidir.

Önizleme doğru ama kağıt yanlış: kontrol listesi

"Görüntüleyicide doğru görünüyor ama boş (ya da dönük, ya da küçük) basıyor" ZPL hakkında en sık sorulan sorulardan biridir. Listeyi sırayla izleyin — her adım dosya ile kafa arasındaki bir katmanı eler:

1. Önizleme yazıcının yoğunluğunu mu kullanıyor? 203 dpi için yazılmış dosya 8 dpmm'de doğru görünür, 300 dpi kafada üçte iki boyutta basar — bkz. etiket küçük basıyor.
2. İş yazıcıya ham mı gidiyor? Windows ya da CUPS sürücüsü işi rasterleştirebilir, ölçekleyebilir, döndürebilir ya da sarmalayabilir; sürücü üzerinden basan ERP ve kargo sistemleri dönük kargo etiketlerinin olağan kaynağıdır — bkz. ZPL'i sürücüsüz basmak.
3. Yazıcı ZPL'i yorumluyor mu? Dump (tanı) modunda aldığı komutları metin olarak basar; yalnız EPL bilen bir yazıcı ise ZPL'den bozuk çıktı üretir — bkz. yazıcı anlamsız karakterler basıyor.
4. Yazıcıda saklı ayarlar dosyayı eziyor mu? Yön (^PO), üst kaydırma (^LT), etiket kaydırma (^LS) ve baskı genişliği yazıcı yapılandırmasına kaydedilebilir (^JUS); kaydedilmiş değer, onu kendisi belirtmeyen her işe uygulanır — bkz. etiket ters basıyor ve içerik kaymış.
5. Medya doğru algılanıyor mu? Önizleme doğruyken boş ya da atlanan etiketler boşluk/işaret algılamasını ve kalibrasyonu gösterir — bkz. fazladan boş etiket.
6. İş düşündüğünüz yazıcıya mı gitti? Artık başka bir cihazı gösteren kuyruk ya da IP "hiçbir şey olmadı" sonucunu verir — bkz. etiket yanlış yazıcıdan çıktı.

Çoğunu yakalayan üç kontrol

1. Dosya ölçüsünü bildiriyor mu, medyayla uyuşuyor mu? ^PW ve ^LL nokta cinsindendir; inç ya da milimetre değil. 4 inçlik etiket 203 dpi'de 812, 300 dpi'de 1218 noktadır.
2. Her alan kapatılmış mı? Eksik bir ^FS, sonraki komutları önceki alanın verisi hâline getirir; komutlar hata vermeden çıktıdan kaybolur.
3. Küresel kaydıran/döndüren bir şey var mı? Tek tek alanlara bakmadan önce dosyada ^LH, ^LS, ^LT, ^PO ve ^FW arayın — "her şey kaydı" vakalarının çoğunu bunlardan biri açıklar.

Bu kontrolleri tek seferde koşturmak ve sonucu görmek için etiketi ZPL önizleyicisine yapıştırın.

Sık sorulan sorular

ZPL etiketi yanlış basıldığında nereden başlamalıyım?

Yazıcıdan değil dosyadan başlayın. Bildirilen ölçü (^PW/^LL), koordinatlar, ^FS zinciri ve yön harfleri okunabilir metindir ve arızaların çoğu orada görünür. Bir yazıcı ayarını değiştirmek dosya kaynaklı sorunu tek iş için örter, sonraki yazıcıda geri getirir.

Tarayıcı önizlemesi etiketin neden yanlış bastığını kanıtlayabilir mi?

Oluşturma katmanını kapatır: içerik bildirilen ölçüye sığıyor mu, koordinatlar beklediğiniz yere düşüyor mu, barkod verisi kodlanabilir mi, komut akışı yapısal olarak sağlam mı. Fiziksel katmanı kanıtlayamaz — ^PO baskı yönü, ^LT üstten kaydırma, medya izleme, koyuluk, ribbon ve kafa durumu görüntü oluşturulduktan sonra devreye girer.

Bozuk bir ZPL etiketinde en hızlı kontroller neler?

Üç tane: dosya medyayla uyuşan bir ölçü bildiriyor mu (^PW/^LL nokta cinsindendir — 4 inç 203 dpi'de 812, 300 dpi'de 1218); her alan ^FS ile kapatılmış mı; küresel kaydıran ya da döndüren bir şey var mı (^LH, ^LS, ^LT, ^PO, ^FW).

İlgili yazılar

Kendi ZPL kodunuzu deneyin →