ÜRETIM / MQTT / GRPC / YEREL AĞ
Etiket, Hat Söylediğinde Basılsın: PLC, MES ve Robotlar için MQTT ve gRPC
MQTT broker'ınızda labelinn/cmd/print konusuna bir JSON komutu yayınlayın (ya da 6633 portunda gRPC PrintService.SubmitJob çağırın); yazıcının yanındaki bilgisayar basar ve iş sonucuyla yanıt verir. Kendi jobId değerinizi gönderin: yanıtı komutunuza bağlayan tek değer odur.
{
"printerId": "<yazıcı id>",
"payloadType": "design",
"designId": "<tasarım id>",
"designDataRows": [
{ "sku": "A-1042", "lot": "L2610", "adet": "24" }
],
"copies": 1
}SORUN

Üretim hattında kontrolcü kolinin dolduğunu, paletin sarıldığını, parçanın kontrolden geçtiğini o an bilir. Sonra genellikle bir operatör etiketi basmak için bilgisayara yürür. Yanlış koliye yanlış etiket tam o yürüyüşte yapışır.
LabelInn'in edge çalışma ortamı ağınızdaki bir bilgisayarda durur ve baskı komutlarını MQTT (SCADA, ağ geçitleri ve Node-RED'in konuştuğu dil) ve gRPC (tipli çağrı isteyen MES yazılımları ve robot hücreleri için) üzerinden dinler. Etiketi oluşturur ve yazıcıya kendi dilinde gönderir. Baskı sunucusu yok, model başına Windows sürücüsü yok.
Etiketi hat tetiklesin, bilgisayara yürüyüş değil. Mesajı yayınlayın, etiket basılsın. Hattınızı konuşalım →
01 / MQTT
MQTT ile nasıl çalışır?
LabelInn'i mevcut broker'ınıza (Mosquitto, EMQX, HiveMQ) bağlayın ya da yerleşik broker'ı açın. TLS, kullanıcı adı ve şifre, QoS 0, 1 ve 2 desteklenir.
| Topic | Amaç |
|---|---|
labelinn/cmd/print | Etiket veya parti bas |
labelinn/cmd/status | Yerel yazıcıları ve broker durumunu listele |
Baskı komutu yazıcıyı ve ne basılacağını söyler: verinizle doldurulmuş kayıtlı bir LabelInn tasarımı ya da sisteminiz zaten üretiyorsa ham ZPL, TPCL veya ESC/Label.
{
"printerId": "<yazıcı id>",
"payloadType": "design",
"designId": "<tasarım id>",
"designDataRows": [
{ "sku": "A-1042", "lot": "L2610", "adet": "24" }
],
"copies": 1
}Her komutun yanıtı iş sonucu ve iş numarasıyla labelinn/cmd/response topic'ine gelir; kontrolcü koli ilerlemeden etiketi teyit eder.
02 / GRPC
gRPC: MES ve robot hücreleri için tipli çağrılar
Aynı çalışma ortamı yerel ağda bir gRPC sunucusu çalıştırır (varsayılan port 6633, doluysa otomatik başka port). LabelInn'in gRPC ayarlarından açın, uygulamayla birlikte başlar.
| Servis | Çağrılar |
|---|---|
| PrintService | SubmitJob tasarım+veri ya da ham ZPL/TPCL/ESC-Label basar ve sonucu döner; GetJobStatus iş numarasıyla sonucu okur |
| PrinterFleetService | ListPrinters yerel yazıcıları ve çevrimiçi olup olmadıklarını döner |
| VerifyService | VerifyScan okutulan barkodu basılanla karşılaştırır |
| SystemService | HealthCheck ve Ping |
03 / MES
Baskı sunucusundan neden kolay?
| Alışılmış yöntem | LabelInn edge |
|---|---|
| Windows baskı sunucusu, model başına sürücü | Yerel ZPL, TSPL, TPCL ve ESC/Label, sürücü yok |
| 9100 portuna gönder ve unut | Her iş için sonuç |
| Etiket düzeni PLC/MES kodunun içinde | Tasarım LabelInn'de görsel düzenlenir, id ile çağrılır |
04 / ENDÜSTRIYEL OTOMASYON
Hattınızı bağlamak
- PLC tarafında MQTT yayınlayan ya da gRPC çağıran her şey çalışır: MQTT destekli kontrolcü, SCADA, Node-RED, MES veya PLC önündeki bir protokol ağ geçidi.
- Sahada yazıcılara yakın bir bilgisayar LabelInn'i çalıştırır ve yazıcıları USB veya ağ üzerinden sürer.
- Düz HTTP mi tercih edersiniz? Aynı çalışma ortamı
POST /local/v1/print/jobsile de iş alır.
MQTT SÖZLEŞMESİ
Alanlar, türler ve yanıtlar, tam olarak
edge_mqtt_service.dart, edge_mqtt_command_bridge.dart ve edge_print_job_request.dart dosyalarından okundu. Bir PLC'ye karşı çalıştırılmadı; kodun sözleşmesi olarak alın ve broker'ınızda bir komut deneyin.
mosquitto_pub -h 192.168.1.20 -t labelinn/cmd/print -m '{
"printerId": "<yazıcı kimliği>",
"payloadType": "design",
"designId": "<tasarım kimliği>",
"designDataRows": [ { "sku": "A-1042", "lot": "L2610", "qty": "24" } ],
"copies": 1,
"jobId": "koli-000123"
}'
# yanıt labelinn/cmd/response üzerinde gelir| Konu | Koddaki davranış |
|---|---|
| Anahtar | MQTT varsayılan olarak kapalıdır. Uygulamanın MQTT ayarlarından açın (1883 portu, TLS ile 8883, önek labelinn) ya da yerleşik broker'ı kullanın. |
| Gelen konular | labelinn/cmd/print, labelinn/cmd/status, labelinn/cmd/cancel. Başka her eylem günlüğe yazılır ve yok sayılır, yanıt verilmez. |
| Zorunlu alanlar | printerId (boş olmayan) ve payloadType: zpl, escLabel, tpcl veya design (komut köprüsünün hata iletisinde saydığı değerler). Biri eksikse {"success": false, "error": "printerId is required"} döner. |
| Türler önemli | copies JSON sayı olmalı. "copies": "2" dönüşümde patlar ve basmak yerine MQTT print failed: ... döndürür. |
| Eşleştirme | jobId gönderin; yoksa UUID üretilir. Yanıtın result alanı iş kimliğini taşır; başka eşleştirme alanı yoktur. |
| Yanıt | labelinn/cmd/response üzerinde {"requestTopic": "...", "action": "print", "result": { ... }} olarak yayınlanır. status aynı yolla printers, printerCount ve broker durumunu yanıtlar. |
| Boyut | 1 MiB'tan büyük ileti sessizce atılır. |
| İptal | Henüz desteklenmiyor. labelinn/cmd/cancel alınır ve günlüğe yazılır; işi durdurmaz. |
| Giden olaylar | labelinn/print/job_completed, labelinn/print/job_failed, labelinn/printer/online, labelinn/printer/error, labelinn/verify/passed, labelinn/verify/failed. |
| Yükler | zpl ZPL metnini payloadData içinde alır; escLabel ve tpcl base64 bayt alır; design designId ve designDataRows alır. printPlan, serialStart ve serialStep de okunur. |
gRPC SÖZLEŞMESİ
Şemadaki servisler ve çağrılar
| Servis | Çağrılar |
|---|---|
PrintService | SubmitJob, GetJobStatus, CancelJob, StreamEvents (akış), SubmitBatch |
PrinterFleetService | ListPrinters, GetPrinterHealth, DiscoverPrinters, StreamPrinterStatus (akış) |
VerifyService | VerifyScan, GetVerifyStatus, StreamVerifyEvents (akış) |
WorkflowService | TriggerWorkflow |
SystemService | HealthCheck, GetMetrics, Ping |
Varsayılan port 6633'tür (HTTP 6631, WebSocket 6632). MQTT'nin aksine gRPC şeması CancelJob ve SubmitBatch tanımlar; bir çağrıya güvenmeden önce kendi sürümünüzde sonuç döndürdüğünü doğrulayın.
İLK BAKILACAKLAR
Hiçbir şey basılmadı: nereye bakmalı
- Hiç yanıt yok: MQTT kapalı, konu öneki
labelinn'den farklı, JSON ayrıştırılamıyor, eylemprint/status/canceldeğil ya da ileti 1 MiB'tan büyük. Hepsi sessizdir. success: falseyanıtı:erroralanını okuyun. EksikprinterId, eksikpayloadTypeya da metin olarak gönderilmiş bir sayıdan doğan dönüşüm hatası.- İş kimliği olan ama etiketsiz yanıt: iş kapalı ya da erişilemeyen bir yazıcı için kuyrukta; yazıcının durumuna ya da
labelinn/printer/errorolayına bakın.
SORULAR / SSS
Sık sorulan sorular
PLC ile LabelInn üzerinden etiket basılabilir mi?
Evet. MQTT mesajı yayınlayan ya da gRPC çağrısı yapan her şey basabilir: MQTT destekli kontrolcü, SCADA, Node-RED, MES veya PLC önündeki protokol ağ geçidi.
Hangi MQTT broker'larla çalışır?
Mosquitto, EMQX, HiveMQ gibi standart broker'larla; TLS, kullanıcı adı/şifre ve QoS 0-2 ile. LabelInn kendi yerleşik broker'ını da çalıştırabilir.
Hat etiketin basıldığını nasıl anlar?
Her MQTT komutu labelinn/cmd/response üzerinden iş sonucuyla yanıtlanır. gRPC'de SubmitJob sonucu doğrudan döner, GetJobStatus da iş numarasıyla okur.
LabelInn tasarımı yerine ham ZPL gönderebilir miyim?
Evet. Komut kayıtlı tasarım + veri ya da ham ZPL, TPCL veya ESC/Label taşıyabilir.
PLC'im yanıtı baskı komutuyla nasıl eşleştirir?
Komutta bir jobId gönderin. labelinn/cmd/response yanıtı işi result içinde taşır, böylece o kimlikle eşleştirebilirsiniz. Kendi jobId değeriniz yoksa uygulama bir tane üretir ve yalnızca geliş sırasıyla eşleştirebilirsiniz.
MQTT ile etiketi iptal edebilir miyim?
Şu anda hayır: iptal konusu kabul edilir ve günlüğe yazılır ama işi durdurmaz. gRPC şemasında bir CancelJob çağrısı vardır.
Komutum neden "MQTT print failed" döndürüyor?
Bir alanın JSON türü yanlış; çoğunlukla copies sayı yerine metin olarak gönderilmiştir.
DEVAMI
İlgili sayfalar
SONRAKİ ADIM / LABELINN
Etiketini hat kendisi bassın
LabelInn'i yazıcılarınızın yanında çalıştırın, hattı yöneten sistemlere bağlayın. · MQTT komutları ve gRPC servisleri · Her iş için sonuç · Yazıcının kendi dili, sürücü yok