Barcode Scanner Emulator
ماسحات الباركود USB HID مقابل التسلسلي
يكتب ماسح إسفين لوحة مفاتيح USB HID الباركود المفكوك في التطبيق صاحب التركيز. يكشف الماسح التسلسلي عبر USB عن واجهة تسلسلية، غالبًا كمنفذ COM افتراضي، وعلى التطبيق أن يفتح ذلك المنفذ ويقرأ البايتات. USB هو الكابل والناقل. HID والتسلسلي طريقتان مختلفتان لعرض البيانات.
اختر الواجهة التي يستطيع التطبيق قراءتها فعلًا. حقل الدفع الذي يقبل الكتابة أصلًا مسألة إسفين لوحة مفاتيح. الخدمة التي يجب أن تستلم المسح بلا حقل نص مركّز، أو التي يجب أن تفصل بايتات الماسح عن لوحة المفاتيح، مسألة تسلسلية. كثير من الماسحات يقدّم أحد الوضعين فقط. بعضها يستطيع التبديل. دليل ذلك الطراز هو قائمة الأوضاع التي يمكنك اختبارها.
يشرح دليل إسفين لوحة مفاتيح HID مسار ضغطات المفاتيح بالتفصيل. يتناول كيف تعمل ماسحات الباركود الالتقاط وفك الترميز. تقارن هذه الصفحة واجهتي المضيف والاختبارات التي تخص كل واحدة.
ما هو وضع إسفين لوحة مفاتيح USB HID؟
في وضع لوحة مفاتيح USB HID يعدّد الماسح نفسه كلوحة مفاتيح. يحمّل نظام التشغيل برنامج تشغيل لوحة المفاتيح المعتاد. بعد فك الترميز يرسل الماسح الأحرف كضغطات مفاتيح إلى عنصر التحكم الذي يملك تركيز لوحة المفاتيح. يستطيع نموذج ويب أو حقل صنف في POS أو مربع نص على سطح المكتب قبول ذلك الإدخال من دون شفرة خاصة بالماسح.
التركيز يقرر الوجهة. إذا لم يكن الحقل المقصود مركّزًا، تقع الأحرف في عنصر تحكم آخر أو تضيع. الماسح لا ينقر، ولا يحرّك المؤشر.
قد تتبع الحمولة لاحقة مهيّأة. Enter يرسل كثيرًا من النماذج ذات الحقل الواحد. Tab ينقل التركيز إلى عنصر التحكم التالي. لا يُضمن أي من المفتاحين. خيارات اللاحقة موضحة في لاحقات ENTER وTAB.
أحداث لوحة المفاتيح العادية لا تتضمن بائع الماسح ولا رقمه التسلسلي ولا علامة تقول إن المفاتيح جاءت من ماسح. المتصفحات التي تنفّذ WebHID ترفض واجهات لوحة المفاتيح أيضًا، فلا تستطيع الصفحة فتح جهاز الإسفين وقراءة تقارير HID الخام.
ما هو وضع ماسح الباركود التسلسلي عبر USB؟
في الوضع التسلسلي عبر USB لا يكتب الماسح. يكشف عن واجهة تسلسلية عبر USB. يعرض نظام التشغيل تلك الواجهة عادة كمنفذ COM افتراضي: اسم COM على Windows، أو جهاز cu أو tty على macOS، أو جهاز ttyACM أو ttyUSB على Linux. الاسم يعيّنه برنامج التشغيل ويمكن أن يتغير بعد فصل الماسح.
منفذ COM الافتراضي ليس منفذ RS-232 ماديًا. RS-232 واجهة كهربائية، بموصلها ومستويات جهدها، يقرأها الحاسوب عبر UART. التسلسلي عبر USB يستخدم كابل USB. التطبيق يفتح منفذًا تسلسليًا ويقرأ بايتات، لكن الإشارة على السلك هي USB. بعض المنتجات ماسح RS-232 حقيقي مع محوّل USB إلى تسلسلي. أخرى تنفّذ USB CDC ولا تتحدث RS-232 أصلًا. عامل المنفذ الذي يعرضه نظام التشغيل كنقطة التكامل، ولا تفترض أن التفاصيل الكهربائية تتطابق.
يفتح التطبيق المنفذ، ويقرأ تدفق البايتات، ويقرر أين تبدأ الرسالة وأين تنتهي. الإطار الشائع هو نص الباركود متبوعًا بـ CR (0x0D) أو LF (0x0A) أو CR ثم LF. ذلك الإطار إعداد للجهاز، لا قاعدة من قواعد USB. بايت بادئة مثل STX ممكن أيضًا. يفصل دليل البادئة واللاحقة تلك البايتات عن مفتاح Enter الذي يرسله ماسح الإسفين.
معدل الباود وبتات البيانات والتكافؤ وبتات التوقف تهم على UART حقيقي وعلى كثير من محولات USB إلى تسلسلي. المعدل الخاطئ ينتج بيانات مشوّهة لا خطأ واضحًا. بعض أجهزة COM الافتراضية عبر USB CDC تتجاهل معدل الباود الذي يطلبه المضيف وتسلّم البايتات مع ذلك. لا يوجد إعداد واحد يناسب كل ماسح تسلسلي افتراضي. استخدم المعدل والإطار المذكورين في دليل ذلك الطراز، ثم أكّدهما بباركود معروف.
العملية التي تبقي المنفذ مفتوحًا هي التي تستلم البيانات. تركيز لوحة المفاتيح لا يختار الوجهة. برنامج آخر فتح المنفذ أصلًا يمنع فتحًا ثانيًا. فصل الماسح يزيل المنفذ. إعادة توصيله قد تنشئ اسمًا جديدًا، وعلى التطبيق أن يفتح ذلك المنفذ من جديد.
HID مقابل التسلسلي
| الميزة | إسفين لوحة مفاتيح HID | USB التسلسلي |
|---|---|---|
| تسليم البيانات | إدخال بأسلوب لوحة المفاتيح | تدفق بايتات تسلسلي |
| الحاجة إلى تركيز الإدخال | نعم. تتبع ضغطات المفاتيح عنصر التحكم المركّز | لا. تذهب البايتات إلى العملية التي فتحت المنفذ |
| التكامل مع المتصفح | إدخال عادي وأحداث لوحة مفاتيح | Web Serial حيث يدعمه المتصفح، أو برنامج خارج الصفحة |
| تحكم التطبيق | محدود بسلوك لوحة المفاتيح والتركيز واللاحقات | التطبيق يقرأ التدفق ويؤطره |
| التعرف على الجهاز | غير متاح من أحداث لوحة المفاتيح العادية | يستطيع نظام التشغيل إظهار اسم منفذ. الهوية الثابتة تظل معتمدة على برنامج التشغيل |
| التهيئة | إعدادات الماسح، بما فيها اللاحقة وتخطيط لوحة المفاتيح | إعدادات الماسح إضافة إلى إعدادات منفذ المضيف التي يستخدمها الجهاز فعلًا |
| الاستخدام المعتاد | النماذج وإدخال أصناف POS | تكاملات مخصصة تملك الجهاز |
هذه الحالات المعتادة. قد يختلف طراز معيّن ونظام تشغيل وبرنامج تشغيل. ماسح Bluetooth في وضع لوحة مفاتيح HID يتبع عمود الإسفين في طبقة التطبيق. Bluetooth SPP يتبع العمود التسلسلي.
كيف تعمل ماسحات HID في تطبيقات الويب
مسح الإسفين يحدّث العنصر المركّز. الأحرف القابلة للطباعة تطلق keydown ثم input. Enter وTab يطلقان keydown ولا يدرجان حرفًا في إدخال نص عادي. event.key هو "Enter" أو "Tab" لهذين المفتاحين، وسلسلة من حرف واحد للحرف القابل للطباعة. event.code يسمّي المفتاح المادي ويمكن أن يبقى كما هو حين يغيّر اختلاف تخطيط لوحة المفاتيح event.key.
المستمع أدناه يثبت الحقل فقط عند وصول Enter. ماسح بلا لاحقة Enter يترك النص في الحقل.
const field = document.querySelector('#barcode')
if (!(field instanceof HTMLInputElement)) {
throw new Error('Barcode field was not found.')
}
field.addEventListener('keydown', (event) => {
if (event.key !== 'Enter') {
return
}
event.preventDefault()
const value = field.value.trim()
if (!value) {
return
}
console.log(value)
field.value = ''
})
ركّز #barcode قبل المسح. preventDefault() يمنع النموذج الأب من الإرسال مرة ثانية. إذا أرسل الماسح Tab بدل ذلك، اقرأ القيمة في keydown ذلك ودع المتصفح ينقل التركيز. إذا لم يرسل أيًا منهما، أرسل الحقل من زر أو من إجراء صريح آخر. الوقفة في الكتابة مجرد تخمين تقريبي لنهاية المسح.
لا شيء في تلك الأحداث يتعرّف على جهاز USB. شخص أو ماكرو أو المحاكي يستطيع إنتاج التسلسل نفسه. التحقق يخص الحمولة. سير عمل المتصفح، بما فيه Tab والإدخال الفارغ، موجود في كيفية اختبار ماسحات الباركود في تطبيقات الويب.
كيف تعمل الماسحات التسلسلية في التطبيقات
التكامل التسلسلي يفتح منفذًا، ويقرأ البايتات، ويقسمها إلى رسائل، ويعالج اختفاء المنفذ. على سطح المكتب ذلك هو واجهة المنفذ التسلسلي في نظام التشغيل أو مكتبة البائع. في المتصفح الخيار المضمّن الوحيد هو Web Serial API، وفي المتصفحات التي تنفّذه فقط.
Web Serial متاح في المتصفحات المبنية على Chromium. Firefox وSafari لا يوفّرانه. يجب أن تكون الصفحة سياقًا آمنًا، أي HTTPS أو localhost. يجب أن يُستدعى requestPort() من إيماءة مستخدم، وعلى المستخدم اختيار المنفذ في مطالبة المتصفح. ماسح إسفين لوحة المفاتيح لا يظهر في تلك القائمة، لأنه ليس جهازًا تسلسليًا. Web Serial لا يرى أيضًا منفذًا تسلسليًا لم يكشفه نظام التشغيل.
معدل الباود في المثال نقطة بداية تستبدلها بقيمة الدليل. تعالج الحلقة CR أو LF كنهاية الرسالة وتستهلك زوج CRLF كمنهِ واحد. إذا استخدم ماسحك إطارًا مختلفًا، فهذا التقسيم خاطئ حتى حين يكون المنفذ مفتوحًا.
<button id="open-serial" type="button">Open scanner port</button>
<p id="status" role="status"></p>
<script>
const button = document.querySelector('#open-serial')
const status = document.querySelector('#status')
function takeLine(buffer) {
const cr = buffer.indexOf('\r')
const lf = buffer.indexOf('\n')
const end = cr < 0 ? lf : lf < 0 ? cr : Math.min(cr, lf)
if (end < 0) {
return null
}
const line = buffer.slice(0, end).trim()
let rest = buffer.slice(end + 1)
if (buffer[end] === '\r' && rest.startsWith('\n')) {
rest = rest.slice(1)
}
return { line, rest }
}
button.addEventListener('click', async () => {
if (!('serial' in navigator)) {
status.textContent = 'This browser does not provide Web Serial.'
return
}
let port
try {
port = await navigator.serial.requestPort()
await port.open({ baudRate: 9600 })
} catch (error) {
status.textContent = 'The port was not opened.'
return
}
const reader = port.readable.getReader()
const decoder = new TextDecoder()
let buffer = ''
try {
while (true) {
const { value, done } = await reader.read()
if (done) {
break
}
buffer += decoder.decode(value, { stream: true })
let next = takeLine(buffer)
while (next) {
if (next.line) {
status.textContent = next.line
}
buffer = next.rest
next = takeLine(buffer)
}
}
} catch (error) {
status.textContent = 'The serial read stopped.'
} finally {
reader.releaseLock()
await port.close()
}
})
</script>
تعمل حلقة القراءة حتى ينتهي التدفق أو تفشل القراءة. فصل الماسح يرفض القراءة عادة. يعمل releaseLock() وclose() داخل finally. المنافذ التي وُوفق عليها سابقًا لهذا الأصل يمكن سردها بـ navigator.serial.getPorts() من دون إظهار المطالبة مرة أخرى. الموافقة الأولى ما زالت تتطلب المستخدم.
يتبع تطبيق سطح المكتب الفكرة نفسها بواجهة المنفذ التسلسلي للمنصة: افتح، واقرأ، وأطّر، وأعد الفتح بعد عودة الجهاز. هذه الصفحة لا تخترع أوامر البائع. إذا كان الماسح يتوقع بروتوكولًا خاصًا، فذلك البروتوكول في وثائق الشركة المصنّعة.
أيهما أفضل: HID أم التسلسلي؟
لا يوجد وضع أفضل لكل منتج. استخدم الوضع الذي يقدّمه الماسح فعلًا والوضع الذي يستطيع التطبيق قراءته.
اختر HID حين
- يقبل التطبيق أصلًا إدخال لوحة المفاتيح في حقل مركّز.
- تريد أن يعمل نموذج أو شاشة POS من دون شفرة للجهاز.
- يستطيع سير العمل ضمان التركيز قبل كل مسح.
- يطابق Enter أو Tab طريقة تثبيت ذلك النموذج أو الانتقال فيه.
فكّر في التسلسلي حين
- يجب أن تصل المسوح والتركيز في حوار أو على زر أو في لا مكان.
- يجب أن تبقى بايتات الماسح منفصلة عن الكتابة.
- يستطيع التطبيق فتح منفذ وتأطير الرسائل والتعافي عند فصل الجهاز.
- يستطيع المضيف منح الإذن لذلك المنفذ ولا تحتاج عملية أخرى إليه في الوقت نفسه.
الماسح الذي يعدّد نفسه كلوحة مفاتيح فقط لا يمكن تحويله إلى تسلسلي ببرنامج على المضيف. أكّد الأوضاع في الدليل قبل تصميم التكامل.
التبديل بين HID والتسلسلي
بعض الماسحات يغيّر الوضع عند مسح باركود تهيئة من دليل تلك الشركة، أو عند كتابة ملف تعريف بأداة البائع. أخرى مبنية كواجهة واحدة وليس فيها ما يُبدَّل.
لا يوجد باركود تهيئة يغيّر كل العلامات التجارية. تسلسل مطبوع لطراز مختلف قد لا يفعل شيئًا، أو قد يترك الماسح في وضع غير متوقع. بعد أي تغيير، تحقق مما يعرضه نظام التشغيل: لوحة مفاتيح، أو منفذ COM، أو الاثنان. ثم اختبر المسار الذي يستخدمه تطبيقك. يصف دليل التهيئة مجموعات الإعداد المعتادة. هو لا يغني عن الدليل.
اختبار ماسح HID
- وصّل الماسح وأكّد أنه في وضع إسفين لوحة المفاتيح. يجب أن يستلم محرر نص الأحرف حين يكون حقل في ذلك المحرر مركّزًا.
- افتح فاحص إدخال الباركود.
- انقر بدء الاختبار، أو انقر منطقة المسح. تتحول إلى الأزرق عندما تكون جاهزة. لا تأخذ الصفحة التركيز من تلقاء نفسها.
- امسح باركودًا تعرف حمولته مسبقًا.
- قارن القيمة الملتقطة وعدد الأحرف بتلك الحمولة.
- اقرأ اللاحقة: ENTER أو TAB أو لا شيء. Enter وTab ليسا جزءًا من سلسلة الباركود.
يسجّل الفاحص أحداث لوحة المفاتيح التي يراها المتصفح. لا يستطيع قراءة منفذ تسلسلي، ولا يستطيع التعرف على جهاز USB. حين يكون متوسط الفاصل بين الأحرف أقل من 100 مللي ثانية، يبلغ عن ذلك التوقيت. التوقيت ليس تعريفًا للجهاز. لكل keydown، بما فيه key وcode، استخدم فاحص أحداث لوحة المفاتيح. جولة QA أوسع موجودة في كيفية اختبار إدخال ماسح الباركود.
اختبار ماسح تسلسلي
فاحص إدخال الباركود لا يفتح منفذ COM. الاختبار التسلسلي يحتاج برنامجًا يستطيع فتح المنفذ الذي يكشفه الماسح.
- أكّد أن الماسح في وضع تسلسلي وأن نظام التشغيل يسرد منفذًا عند توصيله. افصله وتحقق من اختفاء المنفذ.
- دوّن اسم المنفذ. هو خاص بنظام التشغيل وقد يتغير عند التوصيل التالي.
- افتح المنفذ من تطبيق متوافق: طرفية تسلسلية، أو تطبيق سطح المكتب، أو مثال Web Serial أعلاه في متصفح Chromium على HTTPS أو localhost.
- اضبط معدل الباود وبتات البيانات والتكافؤ وبتات التوقف حين يحددها الدليل. تجاوز القيم المخترعة.
- امسح باركودًا معروفًا.
- قارن البايتات أو النص المفكوك بتلك الحمولة.
- تحقق من الإطار. ابحث عن بادئة، وعن CR أو LF أو CRLF بعد البيانات، فقط إذا كان ذلك ما هيّأه الدليل.
إذا فشل فتح المنفذ لأنه مشغول، أغلق البرنامج الآخر الذي يمسكه. إذا كان النص مشوّهًا، فإعدادات الخط لا تطابق الجهاز. إذا لم يظهر المنفذ أصلًا، فقد يبقى الماسح في وضع لوحة المفاتيح، أو قد يكون برنامج التشغيل ناقصًا، أو قد لا يُسمح لمستخدم نظام التشغيل بفتح الأجهزة التسلسلية.
مشكلات شائعة
يعمل الماسح في محرر نص ولا يعمل في التطبيق المستهدف. الجهاز يكتب. الهدف ليس له تركيز، أو مستمع keydown يتجاهل المفاتيح. ابدأ بـ الماسح يعمل في Notepad لكنه لا يعمل في POS.
الماسح لا يكتب في أي حقل نص. قد يكون في الوضع التسلسلي، أو مطفأ، أو لا يقرأ الرمز. ماسح الوضع التسلسلي لن يكتب. تحقق من وجود منفذ COM قبل أن تنقّح الحقل. يفصل ماسح الباركود لا يعمل الماسح المعطّل عن الواجهة الخاطئة.
المنفذ التسلسلي مفقود. وضع لوحة المفاتيح لا ينشئ منفذ COM. برنامج تشغيل ناقص، أو كابل شحن فقط، أو ماسح بلا وضع تسلسلي ينتج العرض نفسه. راقب قائمة أجهزة نظام التشغيل وأنت توصّل الماسح.
المنفذ التسلسلي مستخدم أصلًا. عملية واحدة فقط تستطيع قراءته. أغلق الطرفية أو النسخة الأخرى من التطبيق، ثم افتحه مرة أخرى.
إعدادات الاتصال خاطئة. عدم تطابق الباود أو التكافؤ أو بتات التوقف يبدو كأحرف عشوائية. اضبط القيم من دليل ذلك الطراز، ثم امسح رمزًا معروفًا مرة أخرى.
ENTER أو TAB لا يصل أبدًا. ذلك إعداد لاحقة الإسفين. يبلغ فاحص الإدخال عن لا شيء. انظر ماسح الباركود يفتقد ENTER ودليل اللاحقة المرتبط أعلاه. الماسح التسلسلي لا يرسل مفتاح Enter. قد يرسل بايتات CR أو LF بدل ذلك.
الأحرف خاطئة على ماسح إسفين. تخطيط لوحة مفاتيح الماسح وتخطيط نظام التشغيل قد يختلفان. البايتات التسلسلية لا يعاد تعيينها بذلك التخطيط. انظر تخطيط لوحة مفاتيح خاطئ في ماسح الباركود.
المتصفح لا يستطيع الوصول إلى الماسح. ماسح الإسفين لن يظهر في مطالبة Web Serial. Firefox وSafari ليس لديهما Web Serial API. الصفحة التي ليست HTTPS أو localhost لا تستطيع استخدامه. يستطيع المستخدم أيضًا رفض مطالبة المنفذ.
التطبيق يفقد الماسح بعد فصله. يعود ماسح الإسفين كلوحة مفاتيح، والمسح التالي ما زال يتطلب التركيز. المنفذ التسلسلي يختفي إلى أن يفتح التطبيق المنفذ الجديد. قد لا يطابق الاسم الاسم السابق.
سيناريوهات التكامل
تطبيقات الويب
يناسب إسفين لوحة المفاتيح إدخالًا مركّزًا وأحداث DOM العادية. الوصول التسلسلي داخل الصفحة يعني Web Serial في متصفح داعم، وسياقًا آمنًا، ومنفذًا يختاره المستخدم. الصفحة التي يجب أن تدعم Firefox وSafari والأكشاك غير المراقبة لا تستطيع الاعتماد على Web Serial وحده. يستطيع مساعد محلي أن يملك منفذ COM ويحوّل الباركودات المكتملة إلى الصفحة. ذلك المساعد برنامج منفصل. ينبغي ألا تتوقع الصفحة أن اختبار الإسفين يمرّنه.
أنظمة POS
نظام POS الذي يضع التركيز في حقل الصنف ويثبت عند Enter هو تكامل إسفين. نظام POS الذي يجب أن يمسح والحوار مفتوح، أو الذي يجب أن يتجاهل لوحة المفاتيح، هو تكامل تسلسلي. خلطهما ينتج مسوحًا في الحقل الخطأ أو مسوحًا لا تصل. طابق وضع الماسح مع الشاشة التي تعمل فعلًا.
تطبيقات سطح المكتب
يستطيع تطبيق سطح المكتب قبول إدخال الإسفين في أي عنصر تحكم مركّز، أو فتح منفذ COM الافتراضي وإبقاء جلسة طوال عمر العملية. ملكية المنفذ وإعادة الاتصال والتأطير جزء من تلك الجلسة. التركيز ليس كذلك.
أتمتة QA
يكتب Barcode Scanner Emulator قيمة تختارها في التطبيق المركّز ويستطيع إرسال ENTER أو TAB أو بلا لاحقة. ذلك يغطي تراجعات إسفين لوحة المفاتيح: التركيز والتحقق ومعالجة اللاحقة. هو لا ينشئ منفذ COM افتراضيًا، ولا يعدّد أجهزة USB، ولا يعيد إنتاج الباود والإطار. الاختبارات التسلسلية ما زالت تحتاج منفذًا تسلسليًا وقارئًا، أو بديل اختبار يكتب إطار البايتات نفسه الذي يحلّله تطبيقك.
تطبيقات الأكشاك
الكشك الذي يستخدم إدخال الإسفين عليه أن يبقي حقل المسح مركّزًا عبر الحوارات وشاشات التوقف ورسائل الخطأ. تركيز ضائع واحد والمسح التالي يصيب اختصارًا أو لا شيء. الكشك الذي يستخدم التسلسلي يستطيع قراءة المنفذ من دون ذلك التركيز، وعليه أن يحتفظ بالإذن للجهاز ويعيد فتح المنفذ بعد انقطاع الطاقة أو سحب الكابل.
أين يناسب Barcode Scanner Emulator
Barcode Scanner Emulator تطبيق سطح مكتب لـ Windows وmacOS وLinux. يعيد إنتاج مسار لوحة المفاتيح الذي يستخدمه ماسح الإسفين. تدخل النص، وتختار تأخير الكتابة، وتختار لاحقة هي لا شيء أو ENTER أو TAB. اختصار عام يكتب ذلك النص في التطبيق المركّز.
استخدمه لتطوير نماذج أسلوب HID وتراجعها حين لا يكون الماسح على المكتب. زاوجه مع فاحص إدخال الباركود لترى القيمة ومفاتيح البادئة واللاحقة التي استلمها المتصفح.
هو لا يحاكي جهاز USB تسلسليًا، ولا منفذ COM افتراضيًا، ولا تعداد USB، ولا فك ترميز بصري. تلك السلوكيات تظل من شأن العتاد، أو من شأن بديل اختبار تسلسلي تتحكم فيه.