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

ÜCRETSİZ PLAN · KREDİ KARTI YOK · WINDOWS / MAC / LINUX / WEB

SORUN

One LabelInn cloud driving many label printers

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

TopicAmaç
labelinn/cmd/printEtiket veya parti bas
labelinn/cmd/statusYerel 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.

ÖRNEKJSON
{
  "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
PrintServiceSubmitJob tasarım+veri ya da ham ZPL/TPCL/ESC-Label basar ve sonucu döner; GetJobStatus iş numarasıyla sonucu okur
PrinterFleetServiceListPrinters yerel yazıcıları ve çevrimiçi olup olmadıklarını döner
VerifyServiceVerifyScan okutulan barkodu basılanla karşılaştırır
SystemServiceHealthCheck ve Ping

03 / MES

Baskı sunucusundan neden kolay?

Alışılmış yöntemLabelInn 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 unutHer iş için sonuç
Etiket düzeni PLC/MES kodunun içindeTasarı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/jobs ile 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.

EXAMPLESHELL
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
KonuKoddaki davranış
AnahtarMQTT 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 konularlabelinn/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 alanlarprinterId (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 önemlicopies JSON sayı olmalı. "copies": "2" dönüşümde patlar ve basmak yerine MQTT print failed: ... döndürür.
EşleştirmejobId gönderin; yoksa UUID üretilir. Yanıtın result alanı iş kimliğini taşır; başka eşleştirme alanı yoktur.
Yanıtlabelinn/cmd/response üzerinde {"requestTopic": "...", "action": "print", "result": { ... }} olarak yayınlanır. status aynı yolla printers, printerCount ve broker durumunu yanıtlar.
Boyut1 MiB'tan büyük ileti sessizce atılır.
İptalHenüz desteklenmiyor. labelinn/cmd/cancel alınır ve günlüğe yazılır; işi durdurmaz.
Giden olaylarlabelinn/print/job_completed, labelinn/print/job_failed, labelinn/printer/online, labelinn/printer/error, labelinn/verify/passed, labelinn/verify/failed.
Yüklerzpl 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
PrintServiceSubmitJob, GetJobStatus, CancelJob, StreamEvents (akış), SubmitBatch
PrinterFleetServiceListPrinters, GetPrinterHealth, DiscoverPrinters, StreamPrinterStatus (akış)
VerifyServiceVerifyScan, GetVerifyStatus, StreamVerifyEvents (akış)
WorkflowServiceTriggerWorkflow
SystemServiceHealthCheck, 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ı

  1. Hiç yanıt yok: MQTT kapalı, konu öneki labelinn'den farklı, JSON ayrıştırılamıyor, eylem print/status/cancel değil ya da ileti 1 MiB'tan büyük. Hepsi sessizdir.
  2. success: false yanıtı: error alanını okuyun. Eksik printerId, eksik payloadType ya da metin olarak gönderilmiş bir sayıdan doğan dönüşüm hatası.
  3. İş 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/error olayı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.

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

Ücretsiz başla →