Barcode Scanner Emulator
Máy quét mã vạch USB HID và nối tiếp
Máy quét keyboard wedge USB HID gõ mã vạch đã giải mã vào ứng dụng đang có tiêu điểm. Máy quét nối tiếp USB đưa ra giao diện nối tiếp, thường là cổng COM ảo, và ứng dụng phải mở cổng đó rồi đọc byte. USB là cáp và bus. HID và nối tiếp là hai cách trình bày dữ liệu khác nhau.
Chọn giao diện mà ứng dụng thực sự đọc được. Trường thanh toán vốn đã nhận việc gõ là bài toán keyboard wedge. Dịch vụ phải nhận lần quét khi không có trường văn bản nào đang có tiêu điểm, hoặc phải giữ byte của máy quét tách khỏi bàn phím, là bài toán nối tiếp. Nhiều máy quét chỉ có một trong hai chế độ. Một số đổi được. Sổ tay của đúng kiểu máy đó là danh sách chế độ bạn có thể kiểm thử.
Hướng dẫn Giải thích HID keyboard wedge trình bày đường đi của lần gõ phím. Máy quét mã vạch hoạt động như thế nào? nói về bắt hình và giải mã. Trang này so sánh hai giao diện máy chủ và những bài kiểm thử thuộc về từng giao diện.
Chế độ keyboard wedge USB HID là gì?
Ở chế độ bàn phím USB HID, máy quét liệt kê thành bàn phím. Hệ điều hành nạp trình điều khiển bàn phím thông thường của nó. Sau khi giải mã, máy quét gửi các ký tự thành lần gõ phím tới điều khiển đang có tiêu điểm bàn phím. Biểu mẫu web, trường mặt hàng POS hoặc hộp văn bản trên máy tính nhận đầu vào đó mà không cần mã riêng cho máy quét.
Tiêu điểm quyết định đích. Nếu trường định dùng không có tiêu điểm, ký tự rơi vào điều khiển khác hoặc bị mất. Máy quét không bấm chuột và không di chuyển con trỏ.
Một hậu tố đã cấu hình có thể đi sau phần tải. Enter gửi nhiều biểu mẫu một trường. Tab chuyển tiêu điểm sang điều khiển kế tiếp. Không khóa nào được bảo đảm. Cách chọn hậu tố nằm trong Hậu tố ENTER và TAB trên máy quét mã vạch.
Sự kiện bàn phím thông thường không gồm nhà sản xuất của máy quét, số seri, hay cờ nói rằng các phím đến từ máy quét. Trình duyệt có WebHID vẫn từ chối giao diện bàn phím, nên trang không mở được thiết bị wedge và không đọc được báo cáo HID thô.
Chế độ máy quét mã vạch nối tiếp USB là gì?
Ở chế độ nối tiếp USB, máy quét không gõ. Nó đưa ra giao diện nối tiếp qua USB. Hệ điều hành thường hiện giao diện đó thành cổng COM ảo: tên COM trên Windows, thiết bị cu hoặc tty trên macOS, hoặc thiết bị ttyACM hoặc ttyUSB trên Linux. Tên do trình điều khiển gán và có thể đổi sau khi rút máy quét.
Cổng COM ảo không phải cổng RS-232 vật lý. RS-232 là giao diện điện, có đầu nối và mức điện áp riêng, mà máy tính đọc qua UART. Nối tiếp USB dùng cáp USB. Ứng dụng vẫn mở cổng nối tiếp và đọc byte, nhưng tín hiệu trên dây là USB. Một số sản phẩm là máy quét RS-232 thật cộng bộ chuyển USB sang nối tiếp. Số khác thực hiện USB CDC và không nói RS-232. Hãy coi cổng mà hệ điều hành cho bạn thấy là điểm tích hợp, và đừng giả định chi tiết điện khớp nhau.
Ứng dụng mở cổng, đọc dòng byte, và quyết định thông điệp bắt đầu cũng như kết thúc ở đâu. Khung thường gặp là văn bản mã vạch theo sau bởi CR (0x0D), LF (0x0A), hoặc CR rồi LF. Việc đóng khung đó là cài đặt của thiết bị, không phải quy tắc của USB. Một byte tiền tố như STX cũng có thể có. Tiền tố và hậu tố trên máy quét mã vạch: hướng dẫn đầy đủ tách các byte đó khỏi phím Enter mà máy quét wedge gửi.
Tốc độ baud, bit dữ liệu, parity và bit dừng có ý nghĩa trên UART thật và trên nhiều bộ chuyển USB sang nối tiếp. Sai tốc độ cho ra ký tự rác chứ không phải một lỗi rõ ràng. Một số thiết bị COM ảo USB CDC bỏ qua tốc độ baud mà máy chủ yêu cầu và vẫn giao byte. Không có một bộ cài đặt nào hợp với mọi máy quét nối tiếp ảo. Dùng tốc độ và khung trong sổ tay của kiểu máy đó, rồi xác nhận bằng một mã vạch đã biết.
Tiến trình đang giữ cổng mở sẽ nhận dữ liệu. Tiêu điểm bàn phím không chọn đích. Chương trình khác đã mở cổng sẽ chặn lần mở thứ hai. Rút máy quét sẽ xóa cổng. Cắm lại có thể tạo tên mới, và ứng dụng phải mở cổng đó lần nữa.
HID và nối tiếp
| Đặc điểm | keyboard wedge HID | nối tiếp USB |
|---|---|---|
| Cách giao dữ liệu | Đầu vào kiểu bàn phím | Dòng byte nối tiếp |
| Cần tiêu điểm nhập | Có. Lần gõ theo điều khiển đang có tiêu điểm | Không. Byte đi tới tiến trình đã mở cổng |
| Tích hợp trình duyệt | Đầu vào và sự kiện bàn phím thông thường | Web Serial khi trình duyệt hỗ trợ, hoặc phần mềm ngoài trang |
| Quyền kiểm soát của ứng dụng | Giới hạn ở hành vi bàn phím, tiêu điểm và hậu tố | Ứng dụng đọc và đóng khung dòng dữ liệu |
| Nhận diện thiết bị | Không có từ sự kiện bàn phím thông thường | Hệ điều hành có thể hiện tên cổng. Danh tính ổn định vẫn phụ thuộc trình điều khiển |
| Cấu hình | Cài đặt máy quét, gồm hậu tố và bố cục bàn phím | Cài đặt máy quét cộng cài đặt cổng trên máy chủ mà thiết bị thực sự dùng |
| Cách dùng điển hình | Biểu mẫu và nhập mặt hàng POS | Tích hợp riêng sở hữu thiết bị |
Đó là các trường hợp thường gặp. Một kiểu máy, hệ điều hành và trình điều khiển cụ thể có thể khác. Máy quét Bluetooth ở chế độ bàn phím HID đi theo cột wedge ở tầng ứng dụng. Bluetooth SPP đi theo cột nối tiếp.
Máy quét HID hoạt động thế nào trong ứng dụng web
Một lần quét wedge cập nhật phần tử đang có tiêu điểm. Ký tự in được kích hoạt keydown rồi input. Enter và Tab kích hoạt keydown và không chèn ký tự vào ô nhập văn bản thông thường. Với các phím đó, event.key là "Enter" hoặc "Tab", còn với ký tự in được thì là một chuỗi một ký tự. event.code đặt tên phím vật lý và có thể giữ nguyên khi lệch bố cục bàn phím làm đổi event.key.
Trình lắng nghe dưới đây chỉ chốt trường khi Enter tới. Máy quét không có hậu tố Enter để văn bản nằm lại trong trường.
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 = ''
})
Đặt tiêu điểm vào #barcode trước lần quét. preventDefault() giữ biểu mẫu cha khỏi gửi lần thứ hai. Nếu máy quét gửi Tab, hãy đọc giá trị trong keydown đó và để trình duyệt chuyển tiêu điểm. Nếu không gửi phím nào trong hai phím, hãy gửi trường từ một nút hoặc một hành động rõ ràng khác. Một khoảng dừng khi gõ chỉ là cách phỏng đoán kết thúc lần quét.
Không có gì trong các sự kiện đó nhận diện thiết bị USB. Một người, một macro hoặc trình giả lập có thể tạo cùng chuỗi. Việc kiểm tra hợp lệ thuộc về phần tải. Quy trình trên trình duyệt, gồm Tab và ô nhập trống, nằm trong Cách kiểm thử máy quét mã vạch trong ứng dụng web.
Máy quét nối tiếp hoạt động thế nào trong ứng dụng
Một tích hợp nối tiếp mở cổng, đọc byte, tách thành thông điệp và xử lý lúc cổng biến mất. Trên máy tính để bàn, đó là API nối tiếp của hệ điều hành hoặc thư viện của nhà sản xuất. Trong trình duyệt, lựa chọn có sẵn duy nhất là Web Serial API, và chỉ ở những trình duyệt triển khai nó.
Web Serial có trên các trình duyệt dựa trên Chromium. Firefox và Safari không cung cấp. Trang phải là ngữ cảnh bảo mật, nghĩa là HTTPS hoặc localhost. requestPort() phải chạy từ một cử chỉ của người dùng, và người dùng phải chọn cổng trong hộp nhắc của trình duyệt. Máy quét keyboard wedge không xuất hiện trong danh sách đó, vì nó không phải thiết bị nối tiếp. Web Serial cũng không thấy cổng nối tiếp mà hệ điều hành chưa đưa ra.
Tốc độ baud trong ví dụ là điểm bắt đầu, bạn thay bằng giá trị trong sổ tay. Vòng lặp coi CR hoặc LF là hết một thông điệp và nuốt một cặp CRLF như một dấu kết thúc. Nếu máy quét dùng khung khác, cách tách này sai ngay cả khi cổng đã mở.
<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>
Vòng đọc chạy cho đến khi luồng kết thúc hoặc lần đọc thất bại. Rút máy quét thường làm lần đọc bị từ chối. releaseLock() và close() chạy trong finally. Các cổng đã được nguồn này chấp thuận trước đó có thể liệt kê bằng navigator.serial.getPorts() mà không hiện lại hộp nhắc. Lần chấp thuận đầu tiên vẫn cần người dùng.
Ứng dụng máy tính để bàn đi theo cùng ý tưởng với API nối tiếp của nền tảng: mở, đọc, đóng khung, và mở lại sau khi thiết bị trở về. Trang này không bịa lệnh của nhà sản xuất. Nếu máy quét chờ một giao thức riêng, giao thức đó nằm trong tài liệu của nhà sản xuất.
HID hay nối tiếp tốt hơn?
Không chế độ nào tốt hơn cho mọi sản phẩm. Dùng chế độ mà máy quét thực sự có và chế độ mà ứng dụng đọc được.
Chọn HID khi
- Ứng dụng đã nhận đầu vào bàn phím trong một trường đang có tiêu điểm.
- Bạn muốn biểu mẫu hoặc màn hình POS chạy mà không cần mã thiết bị.
- Quy trình có thể bảo đảm tiêu điểm trước mỗi lần quét.
- Enter hoặc Tab khớp cách biểu mẫu đó chốt hoặc chuyển tiếp.
Cân nhắc nối tiếp khi
- Lần quét phải tới khi tiêu điểm nằm trong hộp thoại, trên một nút, hoặc không ở đâu cả.
- Byte của máy quét phải tách khỏi việc gõ.
- Ứng dụng mở được cổng, đóng khung thông điệp, và phục hồi khi thiết bị bị rút.
- Máy chủ cấp được quyền cho cổng đó và không có tiến trình khác cần cổng cùng lúc.
Máy quét chỉ liệt kê thành bàn phím không thể chuyển sang nối tiếp bằng phần mềm trên máy chủ. Xác nhận các chế độ trong sổ tay trước khi thiết kế tích hợp.
Chuyển giữa HID và nối tiếp
Một số máy quét đổi chế độ khi bạn quét mã vạch cấu hình trong sổ tay của đúng nhà sản xuất đó, hoặc khi bạn ghi một hồ sơ bằng tiện ích của nhà cung cấp. Số khác được làm thành một giao diện và không có gì để chuyển.
Không có mã vạch cấu hình nào đổi được mọi hãng. Một chuỗi in cho kiểu máy khác có thể không làm gì, hoặc để máy quét ở một chế độ ngoài dự kiến. Sau mọi thay đổi, hãy xem hệ điều hành hiện gì: một bàn phím, một cổng COM, hoặc cả hai. Rồi kiểm thử đường mà ứng dụng dùng. Hướng dẫn cấu hình máy quét mã vạch mô tả các nhóm cài đặt thường gặp. Nó không thay sổ tay.
Kiểm thử máy quét HID
- Nối máy quét và xác nhận nó đang ở chế độ keyboard wedge. Trình soạn thảo văn bản phải nhận ký tự khi một trường trong trình soạn thảo đó đang có tiêu điểm.
- Mở trình kiểm thử đầu vào mã vạch.
- Bấm Start Test, hoặc bấm vùng quét. Vùng chuyển xanh khi sẵn sàng. Trang không tự lấy tiêu điểm.
- Quét một mã vạch mà bạn đã biết phần tải.
- So sánh giá trị đã ghi và số ký tự với phần tải đó.
- Đọc hậu tố: ENTER, TAB hoặc None. Enter và Tab không thuộc chuỗi mã vạch.
Trình kiểm thử ghi sự kiện bàn phím mà trình duyệt nhìn thấy. Nó không đọc cổng nối tiếp và không nhận diện thiết bị USB. Khi khoảng cách trung bình giữa các ký tự dưới 100 ms, nó báo thời gian đó. Thời gian không phải nhận diện phần cứng. Với mỗi keydown, gồm key và code, dùng trình kiểm thử sự kiện bàn phím. Một lượt QA rộng hơn nằm trong Cách kiểm thử đầu vào máy quét mã vạch.
Kiểm thử máy quét nối tiếp
Trình kiểm thử đầu vào mã vạch không mở cổng COM. Một bài kiểm thử nối tiếp cần chương trình mở được cổng mà máy quét đưa ra.
- Xác nhận máy quét đang ở chế độ nối tiếp và hệ điều hành liệt kê một cổng khi máy được nối. Rút máy và kiểm tra cổng biến mất.
- Ghi tên cổng. Tên phụ thuộc hệ điều hành và có thể đổi ở lần cắm sau.
- Mở cổng từ một ứng dụng tương thích: terminal nối tiếp, ứng dụng máy tính của bạn, hoặc ví dụ Web Serial ở trên trong trình duyệt Chromium trên HTTPS hoặc localhost.
- Đặt tốc độ baud, bit dữ liệu, parity và bit dừng khi sổ tay chỉ rõ. Bỏ qua các giá trị bịa.
- Quét một mã vạch đã biết.
- So sánh byte hoặc văn bản đã giải mã với phần tải đó.
- Kiểm tra khung. Tìm tiền tố, và CR, LF hoặc CRLF sau dữ liệu, chỉ khi sổ tay đã cấu hình như vậy.
Nếu mở cổng thất bại vì cổng bận, hãy đóng chương trình khác đang giữ cổng. Nếu văn bản là rác, cài đặt đường truyền không khớp thiết bị. Nếu cổng không bao giờ xuất hiện, máy quét có thể vẫn ở chế độ bàn phím, trình điều khiển có thể thiếu, hoặc người dùng hệ điều hành có thể không được phép mở thiết bị nối tiếp.
Sự cố thường gặp
Máy quét chạy trong trình soạn thảo văn bản nhưng không chạy trong ứng dụng đích. Thiết bị đang gõ. Đích không có tiêu điểm, hoặc một trình lắng nghe keydown đang bỏ các phím. Bắt đầu từ Máy quét chạy trong Notepad nhưng không chạy trong POS.
Máy quét không gõ vào trường văn bản nào. Nó có thể đang ở chế độ nối tiếp, đã tắt nguồn, hoặc không đọc được ký hiệu. Máy quét ở chế độ nối tiếp sẽ không gõ. Kiểm tra cổng COM trước khi gỡ lỗi trường. Máy quét mã vạch không hoạt động tách máy quét hỏng khỏi giao diện sai.
Thiếu cổng nối tiếp. Chế độ bàn phím không tạo cổng COM. Thiếu trình điều khiển, cáp chỉ sạc, hoặc máy quét không có chế độ nối tiếp cũng cho cùng triệu chứng. Theo dõi danh sách thiết bị của hệ điều hành trong lúc cắm máy quét.
Cổng nối tiếp đang được dùng. Chỉ một tiến trình đọc được cổng. Đóng terminal hoặc bản sao khác của ứng dụng, rồi mở lại.
Cài đặt truyền thông sai. Lệch baud, parity hoặc bit dừng trông như ký tự ngẫu nhiên. Đặt các giá trị từ sổ tay của kiểu máy đó, rồi quét lại một mã đã biết.
ENTER hoặc TAB không bao giờ tới. Đó là cài đặt hậu tố wedge. Trình kiểm thử đầu vào báo None. Xem Máy quét mã vạch thiếu ENTER và hướng dẫn hậu tố đã liên kết ở trên. Máy quét nối tiếp không gửi phím Enter. Nó có thể gửi byte CR hoặc LF thay vào đó.
Ký tự sai trên máy quét wedge. Bố cục bàn phím của máy quét và bố cục của hệ điều hành có thể không khớp. Byte nối tiếp không bị bố cục đó ánh xạ lại. Xem Máy quét mã vạch sai bố cục bàn phím.
Trình duyệt không truy cập được máy quét. Máy quét wedge sẽ không xuất hiện trong hộp nhắc Web Serial. Firefox và Safari không có Web Serial API. Trang không phải HTTPS hoặc localhost không dùng được. Người dùng cũng có thể đóng hộp nhắc chọn cổng.
Ứng dụng mất máy quét sau khi rút. Máy quét wedge trở lại thành bàn phím, và lần quét sau vẫn cần tiêu điểm. Cổng nối tiếp biến mất cho đến khi ứng dụng mở cổng mới. Tên có thể không khớp tên trước.
Tình huống tích hợp
Ứng dụng web
Keyboard wedge hợp với ô nhập đang có tiêu điểm và sự kiện DOM thông thường. Truy cập nối tiếp bên trong trang nghĩa là Web Serial trên trình duyệt hỗ trợ, một ngữ cảnh bảo mật, và một cổng do người dùng chọn. Trang phải hỗ trợ Firefox, Safari và kiosk không người trực không thể chỉ dựa vào Web Serial. Một trình trợ giúp cục bộ có thể sở hữu cổng COM và chuyển mã vạch hoàn chỉnh tới trang. Trình trợ giúp đó là phần mềm riêng. Trang vẫn không nên kỳ vọng một bài kiểm thử wedge sẽ thử được nó.
Hệ thống POS
POS đặt tiêu điểm vào trường mặt hàng và chốt bằng Enter là tích hợp wedge. POS phải quét khi modal đang mở, hoặc phải bỏ qua bàn phím, là tích hợp nối tiếp. Trộn hai cách sẽ cho lần quét vào sai trường hoặc lần quét không bao giờ tới. Khớp chế độ máy quét với màn hình đang thực sự trực.
Ứng dụng máy tính để bàn
Ứng dụng máy tính có thể nhận đầu vào wedge ở điều khiển đang có tiêu điểm, hoặc mở cổng COM ảo và giữ một phiên trong suốt đời tiến trình. Quyền sở hữu cổng, kết nối lại và đóng khung là một phần của phiên đó. Tiêu điểm thì không.
Tự động hóa QA
Barcode Scanner Emulator gõ một giá trị bạn chọn vào ứng dụng đang có tiêu điểm và có thể gửi ENTER, TAB hoặc không hậu tố. Việc đó phủ các hồi quy keyboard wedge: tiêu điểm, kiểm tra hợp lệ và xử lý hậu tố. Nó không tạo cổng COM ảo, không liệt kê thiết bị USB, và không tái hiện baud cùng khung. Kiểm thử nối tiếp vẫn cần một cổng nối tiếp và chương trình đọc, hoặc một đối tượng thử nghiệm ghi đúng khung byte mà ứng dụng phân tích.
Ứng dụng kiosk
Kiosk dùng đầu vào wedge phải giữ tiêu điểm của trường quét qua hộp thoại, trình bảo vệ màn hình và thông báo lỗi. Mất tiêu điểm một lần, lần quét sau sẽ trúng phím tắt hoặc không trúng gì. Kiosk dùng nối tiếp đọc được cổng mà không cần tiêu điểm đó, và phải giữ quyền với thiết bị rồi mở lại cổng sau mất điện hoặc bị rút cáp.
Barcode Scanner Emulator nằm ở đâu
Barcode Scanner Emulator là ứng dụng máy tính cho Windows, macOS và Linux. Nó tái hiện đường bàn phím mà máy quét wedge dùng. Bạn nhập văn bản, chọn độ trễ gõ, và chọn hậu tố là không có, ENTER hoặc TAB. Một phím tắt toàn cục gõ văn bản đó vào ứng dụng đang có tiêu điểm.
Dùng nó để phát triển và hồi quy các biểu mẫu kiểu HID khi máy quét không có trên bàn. Ghép với trình kiểm thử đầu vào mã vạch để thấy giá trị, phím tiền tố và hậu tố mà trình duyệt nhận.
Nó không giả lập thiết bị nối tiếp USB, cổng COM ảo, việc liệt kê USB hay giải mã quang học. Những hành vi đó vẫn thuộc về phần cứng, hoặc về một đối tượng thử nghiệm nối tiếp mà bạn kiểm soát.