تكامل وحدة التحكم

تستخدم وحدة التحكم Plato محول الطابعة WIN_DRIVER لبرنامج تشغيل الطابعة بالكمبيوتر.

سجل الطابعة

تقوم وحدة التحكم بتخزين الطابعات في قاعدة بيانات IndexedDB تسمى printer-database. تتضمن سجلات الطابعة ما يلي:

نوع الطابعة
حالة
الخطأ الأخير
التكوين
عرض الورق
فئات
أنواع الطلب
شعار

النوع ذو الصلة:

type PrinterType =
  | "EPSON"
  | "WIN_DRIVER"
  | "USB"
  | "BUILT_IN"
  | "ANDROID_DRIVER"
  | "SUNMI";

سائق URL

يبني محول WIN_DRIVER قاعدة URL من تكوين الطابعة:

http://<driverIpAddress>:<driverPort>
https://<driverIpAddress>:<driverPort>

إذا كان driverPort فارغًا، فسيقوم المحول بحذف المنفذ. وهذا مفيد لـ HTTPS على المنفذ 443.

هدف الطابعة

يرسل المحول هدف الطابعة الفعلية بشكل منفصل عن برنامج التشغيل URL.

حقل التكوين	حقل الطلب	ملحوظات
`driverIpAddress`	المضيف URL	الآلة تعمل بنظام `plato-printer.exe`.
`driverPort`	منفذ URL	منفذ السائق HTTP/HTTPS.
`driverUseHttps`	بروتوكول URL	يستخدم `https` عندما يكون صحيحًا.
`ipAddress`	`ip_address`	IP الطابعة المادية.
`port`	`port`	منفذ TCP للطابعة الفعلية.
`vendor`	`vendor_id`	معرف البائع المعين.
`productId`	`product_id`	أرسلت للتوافق.
`beep`	`beep`	تمكين تسلسل الصفير بعد الطباعة.

إذا كان عنوان IP الخاص بالطابعة مفقودًا أو يساوي 192.168.0.0، يرسل المحول ip_address: null وport: null، وهو ما يرفضه برنامج التشغيل الحالي باستخدام Missing printer address.

معرفات البائعين

يقوم المحول بتعيين البائعين:

بائع	معرف البائع
`EPSON`	`0x04b8`
`BIRCH`	`0x1fc9`
`PHILIPS`	`0x0471`
`SUNMI`	`0x04b8`
`OSCAR`	`0x04b8`

تحضير الطباعة

تدفق طباعة وحدة التحكم:

تقديم DOM إلى PNG blob.
تحميل النقطة في القماش.
تحويل وحدات البكسل القماشية إلى صفوف نقطية سوداء/بيضاء.
قم بتقسيم الصفوف النقطية إلى أجزاء مكونة من 128 صفًا.
قم بتشفير كل قطعة على هيئة بايتات نقطية ESC/POS.
يقوم Base64 بتشفير كل قطعة بايت.
أرسل POST /print.

لا يتلقى برنامج التشغيل HTML مطلقًا. يتلقى قطع ESC/POS القابلة للطباعة.

قائمة انتظار المتصفح

تحتوي وحدة التحكم على قائمة انتظار متصفح محلية قبل أن تصل الطلبات إلى برنامج تشغيل الكمبيوتر.

يتم تخزين الوظائف في IndexedDB.
تنتقل الوظائف من pending إلى printing.
يتم وضع علامة failed على المهام الفاشلة.
يتم استرداد مهمة printing التي لا معنى لها بعد 60 ثانية.
يتم فحص المهام المجدولة كل 30 ثانية.
تتم إعادة محاولة المهام الفاشلة كل 60 ثانية.

لدى برنامج تشغيل الطابعة PC قائمة انتظار Redis الخاصة به بعد قبول طلب HTTP. يعني هناك صفين:

طابور	موقع	غاية
قائمة انتظار المتصفح	Plato وحدة التحكم مفهرسةDB	يحتفظ بمهام الطباعة على جانب POS حتى يقبلها برنامج التشغيل.
قائمة انتظار السائق	Redis/BullMQ	يحتفظ بالمهام المقبولة حتى تستقبلها الطابعة الفعلية.

رسم خرائط الحالة

تستدعي وحدة التحكم POST /status.

يؤدي فشل HTTP إلى إرجاع OFFLINE.
الاستجابة مع ok: true وstatus وليس offline ترجع ONLINE.
يتم تخزين استجابات برنامج التشغيل الأخرى كـ lastError.

درج النقود

تستدعي وحدة التحكم POST /cash-drawer لكل طابعة عبر الإنترنت تم تكوينها باستخدام درج النقود.

​تكامل وحدة التحكم

​سجل الطابعة

​سائق URL

​هدف الطابعة

​معرفات البائعين

​تحضير الطباعة

​قائمة انتظار المتصفح

​رسم خرائط الحالة

​درج النقود