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 וקלט ריק, נמצא באיך לבדוק סורקי ברקוד ביישומי אינטרנט.
איך סורקים טוריים עובדים ביישומים
חיבור טורי פותח יציאה, קורא בתים, מפצל אותם להודעות ומטפל בהיעלמות היציאה. בשולחן העבודה זה ה-API הטורי של מערכת ההפעלה או ספריית היצרן. בדפדפן האפשרות המובנית היחידה היא 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() בלי להציג את ההנחיה שוב. האישור הראשון עדיין דורש את המשתמש.
יישום שולחן עבודה הולך באותו רעיון עם ה-API הטורי של הפלטפורמה: פתיחה, קריאה, מסגור ופתיחה מחדש אחרי שהמכשיר חוזר. העמוד הזה לא ממציא פקודות יצרן. אם הסורק מצפה לפרוטוקול קנייני, הפרוטוקול נמצא בתיעוד היצרן.
מה עדיף: 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 או פענוח אופטי. ההתנהגויות האלה עדיין שייכות לחומרה, או לכפיל בדיקה טורי שבשליטתכם.