ข้ามไปยังเนื้อหา

Barcode Scanner Emulator

เครื่องสแกนบาร์โค้ด USB HID กับแบบอนุกรม

เครื่องสแกน keyboard wedge แบบ USB HID พิมพ์บาร์โค้ดที่ถอดรหัสแล้วลงในแอปพลิเคชันที่มีโฟกัส เครื่องสแกนแบบอนุกรมผ่าน USB เปิดอินเทอร์เฟซอนุกรม ซึ่งมักเป็นพอร์ต COM เสมือน และแอปพลิเคชันต้องเปิดพอร์ตนั้นแล้วอ่านไบต์ USB คือสายเคเบิลและบัส HID กับแบบอนุกรมเป็นคนละวิธีในการนำเสนอข้อมูล

เลือกอินเทอร์เฟซที่แอปพลิเคชันอ่านได้จริง ช่องคิดเงินที่รับการพิมพ์อยู่แล้วเป็นปัญหาของ keyboard wedge บริการที่ต้องรับการสแกนทั้งที่ไม่มีช่องข้อความใดมีโฟกัส หรือต้องแยกไบต์ของเครื่องสแกนออกจากแป้นพิมพ์ เป็นปัญหาของแบบอนุกรม เครื่องสแกนจำนวนมากมีเพียงโหมดใดโหมดหนึ่ง บางเครื่องสลับได้ คู่มือของรุ่นนั้นคือรายการโหมดที่ทดสอบได้

คู่มือ คำอธิบาย HID keyboard wedge อธิบายเส้นทางของการกดแป้นโดยละเอียด เครื่องสแกนบาร์โค้ดทำงานอย่างไร? ครอบคลุมการจับภาพและการถอดรหัส หน้านี้เปรียบเทียบอินเทอร์เฟซฝั่งโฮสต์ทั้งสอง และการทดสอบที่อยู่กับแต่ละแบบ

โหมด keyboard wedge แบบ USB HID คืออะไร?

ในโหมดแป้นพิมพ์ USB HID เครื่องสแกนจะแจงตัวเป็นแป้นพิมพ์ ระบบปฏิบัติการโหลดไดรเวอร์แป้นพิมพ์ปกติ หลังถอดรหัส เครื่องสแกนส่งอักขระเป็นการกดแป้นไปยังตัวควบคุมที่มีโฟกัสของแป้นพิมพ์ ฟอร์มบนเว็บ ช่องสินค้าของ POS หรือกล่องข้อความบนเดสก์ท็อปรับอินพุตนั้นได้โดยไม่ต้องมีโค้ดเฉพาะเครื่องสแกน

โฟกัสเป็นตัวกำหนดปลายทาง ถ้าช่องที่ตั้งใจไว้ไม่มีโฟกัส อักขระจะลงในตัวควบคุมอื่นหรือหายไป เครื่องสแกนไม่คลิก และไม่เลื่อนตัวชี้

ส่วนต่อท้ายที่ตั้งค่าไว้อาจตามหลังเพย์โหลด Enter ส่งฟอร์มช่องเดียวจำนวนมาก Tab ย้ายโฟกัสไปตัวควบคุมถัดไป ไม่มีแป้นใดรับประกัน ทางเลือกของส่วนต่อท้ายอยู่ใน ส่วนต่อท้าย ENTER และ TAB ในเครื่องสแกนบาร์โค้ด

เหตุการณ์แป้นพิมพ์ธรรมดาไม่มีผู้ผลิตของเครื่องสแกน หมายเลขอนุกรม หรือธงที่บอกว่าแป้นมาจากเครื่องสแกน เบราว์เซอร์ที่ทำ WebHID ยังปฏิเสธอินเทอร์เฟซแป้นพิมพ์ ดังนั้นหน้าเว็บเปิดอุปกรณ์ wedge แล้วอ่านรายงาน 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 ที่เครื่องสแกน wedge ส่ง

อัตราบอด บิตข้อมูล พาริตี และบิตหยุดมีความหมายบน UART จริงและบนอะแดปเตอร์ USB เป็นอนุกรมจำนวนมาก อัตราที่ผิดให้ตัวอักษรขยะ ไม่ใช่ข้อผิดพลาดที่ชัดเจน อุปกรณ์ COM เสมือนแบบ USB CDC บางเครื่องไม่สนใจอัตราบอดที่โฮสต์ขอ และยังส่งไบต์อยู่ ไม่มีการตั้งค่าเดียวที่ใช้กับเครื่องสแกนอนุกรมเสมือนทุกเครื่อง ใช้อัตราและกรอบในคู่มือของรุ่นนั้น แล้วยืนยันด้วยบาร์โค้ดที่รู้ค่า

โปรเซสที่เปิดพอร์ตค้างไว้เป็นผู้รับข้อมูล โฟกัสของแป้นพิมพ์ไม่เลือกปลายทาง โปรแกรมอื่นที่เปิดพอร์ตอยู่แล้วจะขัดขวางการเปิดครั้งที่สอง การถอดเครื่องสแกนทำให้พอร์ตหาย การเสียบกลับอาจสร้างชื่อใหม่ และแอปพลิเคชันต้องเปิดพอร์ตนั้นอีกครั้ง

HID กับแบบอนุกรม

คุณลักษณะ keyboard wedge แบบ HID USB แบบอนุกรม
การส่งข้อมูล อินพุตแบบแป้นพิมพ์ สายไบต์อนุกรม
ต้องมีโฟกัสของอินพุต ใช่ การกดแป้นตามตัวควบคุมที่มีโฟกัส ไม่ ไบต์ไปที่โปรเซสที่เปิดพอร์ต
การเชื่อมกับเบราว์เซอร์ อินพุตและเหตุการณ์แป้นพิมพ์ธรรมดา Web Serial เมื่อเบราว์เซอร์รองรับ หรือซอฟต์แวร์นอกหน้า
การควบคุมของแอปพลิเคชัน จำกัดที่พฤติกรรมแป้นพิมพ์ โฟกัส และส่วนต่อท้าย แอปพลิเคชันอ่านและกำหนดกรอบของสตรีม
การระบุอุปกรณ์ ไม่มีจากเหตุการณ์แป้นพิมพ์ธรรมดา ระบบปฏิบัติการแสดงชื่อพอร์ตได้ ตัวตนที่เสถียรยังขึ้นกับไดรเวอร์
การกำหนดค่า การตั้งค่าเครื่องสแกน รวมส่วนต่อท้ายและผังแป้นพิมพ์ การตั้งค่าเครื่องสแกนบวกการตั้งค่าพอร์ตฝั่งโฮสต์ที่อุปกรณ์ใช้จริง
การใช้งานทั่วไป ฟอร์มและการป้อนสินค้า POS การเชื่อมต่อเฉพาะทางที่ถือครองอุปกรณ์

นี่เป็นกรณีที่พบบ่อย รุ่น ระบบปฏิบัติการ และไดรเวอร์หนึ่งชุดอาจต่างออกไป เครื่องสแกน Bluetooth ในโหมดแป้นพิมพ์ HID เดินตามคอลัมน์ wedge ที่ชั้นแอปพลิเคชัน Bluetooth SPP เดินตามคอลัมน์อนุกรม

เครื่องสแกน HID ทำงานในเว็บแอปพลิเคชันอย่างไร

การสแกนแบบ wedge อัปเดตองค์ประกอบที่มีโฟกัส อักขระที่พิมพ์ได้ยิง 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() ต้องทำงานจากท่าทางของผู้ใช้ และผู้ใช้ต้องเลือกพอร์ตในข้อความของเบราว์เซอร์ เครื่องสแกน keyboard wedge ไม่ปรากฏในรายการนั้น เพราะไม่ใช่อุปกรณ์อนุกรม 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

  1. ต่อเครื่องสแกนและยืนยันว่าอยู่ในโหมด keyboard wedge โปรแกรมแก้ไขข้อความควรรับอักขระเมื่อช่องในโปรแกรมนั้นมีโฟกัส
  2. เปิด ตัวทดสอบอินพุตบาร์โค้ด
  3. คลิก Start Test หรือคลิกพื้นที่สแกน พื้นที่จะเป็นสีน้ำเงินเมื่อพร้อม หน้าไม่ดึงโฟกัสเอง
  4. สแกนบาร์โค้ดที่คุณรู้เพย์โหลดอยู่แล้ว
  5. เปรียบเทียบค่าที่จับได้และจำนวนอักขระกับเพย์โหลดนั้น
  6. อ่านส่วนต่อท้าย ได้แก่ ENTER, TAB หรือ None Enter และ Tab ไม่เป็นส่วนหนึ่งของสตริงบาร์โค้ด

ตัวทดสอบบันทึกเหตุการณ์แป้นพิมพ์ที่เบราว์เซอร์มองเห็น อ่านพอร์ตอนุกรมไม่ได้ และระบุอุปกรณ์ USB ไม่ได้ เมื่อช่องว่างเฉลี่ยระหว่างอักขระต่ำกว่า 100 ms มันรายงานจังหวะนั้น จังหวะไม่ใช่การระบุฮาร์ดแวร์ สำหรับ keydown แต่ละครั้ง รวม key และ code ให้ใช้ ตัวทดสอบเหตุการณ์แป้นพิมพ์ รอบ QA ที่กว้างกว่าอยู่ใน วิธีทดสอบอินพุตจากเครื่องสแกนบาร์โค้ด

การทดสอบเครื่องสแกนแบบอนุกรม

ตัวทดสอบอินพุตบาร์โค้ดไม่เปิดพอร์ต COM การทดสอบแบบอนุกรมต้องมีโปรแกรมที่เปิดพอร์ตที่เครื่องสแกนเปิดเผยได้

  1. ยืนยันว่าเครื่องสแกนอยู่ในโหมดอนุกรม และระบบปฏิบัติการแสดงพอร์ตเมื่อเชื่อมต่ออยู่ ถอดออกแล้วตรวจว่าพอร์ตหายไป
  2. จดชื่อพอร์ต ชื่อขึ้นกับระบบปฏิบัติการ และอาจเปลี่ยนในการเสียบครั้งถัดไป
  3. เปิดพอร์ตจากแอปพลิเคชันที่เข้ากันได้ ได้แก่ เทอร์มินัลอนุกรม แอปเดสก์ท็อปของคุณ หรือตัวอย่าง Web Serial ด้านบนในเบราว์เซอร์ Chromium บน HTTPS หรือ localhost
  4. ตั้งอัตราบอด บิตข้อมูล พาริตี และบิตหยุดเมื่อคู่มือระบุ ข้ามค่าที่แต่งขึ้น
  5. สแกนบาร์โค้ดที่รู้ค่า
  6. เปรียบเทียบไบต์หรือข้อความที่ถอดรหัสกับเพย์โหลดนั้น
  7. ตรวจกรอบ มองหาคำนำหน้า และ CR, LF หรือ CRLF หลังข้อมูล เฉพาะเมื่อคู่มือตั้งค่าไว้เช่นนั้น

ถ้าเปิดพอร์ตไม่สำเร็จเพราะพอร์ตไม่ว่าง ให้ปิดโปรแกรมอื่นที่ถือพอร์ตไว้ ถ้าข้อความเป็นขยะ การตั้งค่าสายไม่ตรงกับอุปกรณ์ ถ้าพอร์ตไม่ปรากฏเลย เครื่องสแกนอาจยังอยู่ในโหมดแป้นพิมพ์ ไดรเวอร์อาจขาด หรือผู้ใช้ของ OS อาจไม่ได้รับอนุญาตให้เปิดอุปกรณ์อนุกรม

ปัญหาที่พบบ่อย

เครื่องสแกนใช้ได้ในโปรแกรมแก้ไขข้อความ แต่ใช้ไม่ได้ในแอปพลิเคชันเป้าหมาย อุปกรณ์กำลังพิมพ์ เป้าหมายไม่มีโฟกัส หรือตัวฟัง keydown ทิ้งแป้น เริ่มจาก เครื่องสแกนใช้ได้ใน Notepad แต่ใช้ไม่ได้ใน POS

เครื่องสแกนไม่พิมพ์ลงช่องข้อความใดเลย อาจอยู่ในโหมดอนุกรม ปิดเครื่อง หรืออ่านสัญลักษณ์ไม่ได้ เครื่องสแกนโหมดอนุกรมจะไม่พิมพ์ ตรวจพอร์ต COM ก่อนดีบักช่อง เครื่องสแกนบาร์โค้ดไม่ทำงาน แยกเครื่องสแกนที่เสียออกจากอินเทอร์เฟซที่ผิด

พอร์ตอนุกรมหาย โหมดแป้นพิมพ์ไม่สร้างพอร์ต COM ไดรเวอร์ที่ขาด สายที่ชาร์จได้อย่างเดียว หรือเครื่องสแกนที่ไม่มีโหมดอนุกรม ให้อาการเดียวกัน ดูรายการอุปกรณ์ของ OS ขณะเสียบเครื่องสแกน

พอร์ตอนุกรมถูกใช้อยู่แล้ว มีโปรเซสเดียวที่อ่านได้ ปิดเทอร์มินัลหรือสำเนาอื่นของแอปพลิเคชัน แล้วเปิดใหม่

การตั้งค่าการสื่อสารผิด บอด พาริตี หรือบิตหยุดที่ไม่ตรงดูเหมือนอักขระสุ่ม ตั้งค่าจากคู่มือของรุ่นนั้น แล้วสแกนรหัสที่รู้ค่าอีกครั้ง

ENTER หรือ TAB ไม่มาถึงเลย นั่นเป็นการตั้งค่าส่วนต่อท้ายของ wedge ตัวทดสอบอินพุตรายงาน None ดู เครื่องสแกนบาร์โค้ดไม่มี ENTER และคู่มือส่วนต่อท้ายที่ลิงก์ไว้ด้านบน เครื่องสแกนแบบอนุกรมไม่ส่งแป้น Enter อาจส่งไบต์ CR หรือ LF แทน

อักขระผิดบนเครื่องสแกน wedge ผังแป้นพิมพ์ของเครื่องสแกนกับผังของระบบปฏิบัติการขัดกันได้ ไบต์อนุกรมไม่ถูกแมปใหม่โดยผังนั้น ดู ผังแป้นพิมพ์ของเครื่องสแกนบาร์โค้ดไม่ถูกต้อง

เบราว์เซอร์เข้าถึงเครื่องสแกนไม่ได้ เครื่องสแกน wedge จะไม่ปรากฏในข้อความ Web Serial Firefox และ Safari ไม่มี Web Serial API หน้าที่ไม่ใช่ HTTPS หรือ localhost ใช้ไม่ได้ ผู้ใช้ปิดข้อความเลือกพอร์ตได้เช่นกัน

แอปพลิเคชันสูญเสียเครื่องสแกนหลังจากถอด เครื่องสแกน wedge กลับมาเป็นแป้นพิมพ์ และการสแกนครั้งถัดไปยังต้องมีโฟกัส พอร์ตอนุกรมหายไปจนกว่าแอปพลิเคชันจะเปิดพอร์ตใหม่ ชื่ออาจไม่ตรงกับครั้งก่อน

สถานการณ์การเชื่อมต่อ

เว็บแอปพลิเคชัน

keyboard wedge เหมาะกับอินพุตที่มีโฟกัสและเหตุการณ์ DOM ธรรมดา การเข้าถึงแบบอนุกรมในหน้าหมายถึง Web Serial ในเบราว์เซอร์ที่รองรับ บริบทที่ปลอดภัย และพอร์ตที่ผู้ใช้เลือก หน้าที่ต้องรองรับ Firefox, Safari และคีออสก์ที่ไม่มีคนเฝ้า พึ่ง Web Serial อย่างเดียวไม่ได้ ตัวช่วยในเครื่องถือพอร์ต COM แล้วส่งบาร์โค้ดที่สมบูรณ์ไปยังหน้าได้ ตัวช่วยนั้นเป็นซอฟต์แวร์แยก หน้าไม่ควรคาดว่าการทดสอบ wedge จะทดมัน

ระบบ POS

POS ที่วางโฟกัสในช่องสินค้าและยืนยันด้วย Enter เป็นการเชื่อมต่อแบบ wedge POS ที่ต้องสแกนขณะโมดัลเปิดอยู่ หรือต้องไม่สนใจแป้นพิมพ์ เป็นการเชื่อมต่อแบบอนุกรม การปนกันทำให้การสแกนลงช่องผิดหรือไม่มาถึงเลย จับคู่โหมดเครื่องสแกนกับหน้าจอที่ปฏิบัติงานจริง

แอปพลิเคชันเดสก์ท็อป

แอปเดสก์ท็อปรับอินพุต wedge ในตัวควบคุมที่มีโฟกัส หรือเปิดพอร์ต COM เสมือนแล้วคงเซสชันไว้ตลอดอายุของโปรเซส ความเป็นเจ้าของพอร์ต การเชื่อมใหม่ และการกำหนดกรอบเป็นส่วนของเซสชันนั้น โฟกัสไม่ใช่

การทำงานอัตโนมัติของ QA

Barcode Scanner Emulator พิมพ์ค่าที่คุณเลือกเข้าแอปพลิเคชันที่มีโฟกัส และส่ง ENTER, TAB หรือไม่มีส่วนต่อท้ายได้ สิ่งนี้ครอบคลุมการถดถอยของ keyboard wedge ได้แก่ โฟกัส การตรวจสอบ และการจัดการส่วนต่อท้าย มันไม่สร้างพอร์ต COM เสมือน ไม่แจงอุปกรณ์ USB และไม่จำลองอัตราบอดกับกรอบ การทดสอบแบบอนุกรมยังต้องการพอร์ตอนุกรมกับตัวอ่าน หรือตัวแทนทดสอบที่เขียนกรอบไบต์แบบเดียวกับที่แอปพลิเคชันแยกวิเคราะห์

แอปพลิเคชันคีออสก์

คีออสก์ที่ใช้อินพุต wedge ต้องคงโฟกัสของช่องสแกนข้ามกล่องโต้ตอบ โปรแกรมรักษาหน้าจอ และข้อความผิดพลาด โฟกัสหายครั้งเดียว การสแกนถัดไปจะโดนทางลัดหรือไม่โดนอะไรเลย คีออสก์ที่ใช้แบบอนุกรมอ่านพอร์ตโดยไม่ต้องมีโฟกัสนั้น และต้องถือสิทธิ์ของอุปกรณ์ไว้ แล้วเปิดพอร์ตใหม่หลังไฟดับหรือสายถูกดึง

Barcode Scanner Emulator อยู่ตรงไหน

Barcode Scanner Emulator เป็นแอปเดสก์ท็อปสำหรับ Windows, macOS และ Linux มันจำลองเส้นทางแป้นพิมพ์ที่เครื่องสแกน wedge ใช้ คุณป้อนข้อความ เลือกความหน่วงของการพิมพ์ และเลือกส่วนต่อท้ายเป็นไม่มี ENTER หรือ TAB ทางลัดส่วนกลางพิมพ์ข้อความนั้นเข้าแอปพลิเคชันที่มีโฟกัส

ใช้มันพัฒนาและทดสอบถดถอยฟอร์มแบบ HID เมื่อเครื่องสแกนไม่อยู่บนโต๊ะ จับคู่กับตัวทดสอบอินพุตบาร์โค้ดเพื่อดูค่า แป้นคำนำหน้า และส่วนต่อท้ายที่เบราว์เซอร์ได้รับ

มันไม่จำลองอุปกรณ์อนุกรม USB พอร์ต COM เสมือน การแจง USB หรือการถอดรหัสเชิงแสง พฤติกรรมเหล่านั้นยังเป็นของฮาร์ดแวร์ หรือของตัวแทนทดสอบแบบอนุกรมที่คุณควบคุม