Adding a Hand Scanner (HID Mode)
Configure a wired or cordless handheld scanner in HID Keyboard Wedge mode with an Enter suffix so it works across Register, ID checks, Price Check, Transactions, and Online Orders.
- Required mode
- HID Keyboard (USB HID Keyboard / Bluetooth HID) + Enter (CR) Suffix
- Where in Basket POS
- Automatic across Register, ID Check, Price Check, Transactions, Online Orders & Product Maintenance
- Applies to
- USB Wired Hand Scanners · USB Cradle Wireless Scanners · Bluetooth HID Scanners · Basket POS
Before you start
- A USB or Bluetooth handheld barcode scanner (a 2D imager is strongly recommended for QR codes and driver’s license ID checks).
- The manufacturer’s quick-start or programming barcode sheet (Zebra, Datalogic, Honeywell, Socket, etc.).
- If using a cordless cradle scanner, ensure the scanner is paired to its USB cradle and the cradle is plugged into the POS terminal.
Required hand scanner mode: HID Keyboard + Enter Suffix
In HID Keyboard mode, the hand scanner acts as an ultra-fast hardware keyboard. Unlike the counter scanner scale, you do not select a hand scanner in Settings → Hardware—Basket POS automatically recognizes rapid HID keystroke bursts on every supported screen.
- Interface mode
USB HID Keyboard (or Bluetooth HID Keyboard)
Standard keyboard-wedge mode. Do not use USB-OEM or Serial/COM emulation.
- Terminator / Suffix
Enter / Carriage Return (CR)
Required so Basket POS immediately submits the scanned UPC, QR code, or search term.
- Keyboard layout
US English (QWERTY)
Prevents punctuation errors inside URLs, discount QRs, and wallet passes.
- Recommended 2D symbologies
QR Code & PDF417 enabled
QR Code is needed for receipt lookup, online orders, and gift card/wallet passes; PDF417 is required for scanning driver’s licenses during ID checks.
- Settings → Hardware selection
Not required
Only the counter scanner scale and receipt printer are selected in Settings → Hardware.
Step-by-step setup
- 1
Reset to factory defaults (recommended for used scanners)
If the hand scanner was previously configured for another POS system, reset it first so old prefixes or serial modes do not interfere.
- Scan the Factory Defaults / Restore Defaults barcode in the scanner’s quick-start guide.
- Wait for the scanner to beep and reboot.
- 2
Set the scanner to HID Keyboard mode and add an Enter suffix
Program the scanner to output standard keyboard characters followed by an Enter key.
- For wired USB or USB-cradle scanners: scan the USB HID Keyboard (sometimes labeled USB Keyboard Wedge or PC/AT Keyboard) barcode.
- For cordless Bluetooth scanners: scan the Bluetooth HID Keyboard mode barcode.
- Scan the Add CR Suffix / Enter Suffix barcode (many scanners enable CR suffix by default—confirm by checking your manual).
- Make sure Keyboard Country / Language is set to US English.
- If scanning 2D barcodes (receipt QRs, wallet QRs, or driver’s licenses), verify QR Code and PDF417 symbologies are enabled.
Keep Android’s on-screen keyboard enabled
Because Android sees an HID scanner as a physical keyboard, some tablets hide the touch keyboard automatically. On the POS tablet, open Android Settings → System → Languages & input → Physical keyboard and turn ON "Use on-screen keyboard" (Show virtual keyboard).
- 3
Connect the scanner to the POS terminal
Attach the USB cable/cradle or complete Bluetooth pairing on Android.
- Wired / USB Cradle: Plug the USB cable into an open USB port on the Basket POS terminal. No Android USB permission popup is needed for HID keyboards.
- Bluetooth: Open Android Settings → Connected devices → Pair new device, select your scanner, and confirm pairing.
- Note: You do not need to select the hand scanner under Basket POS Settings → Hardware.
- 4
Where the HID hand scanner works in Basket POS
Once connected in HID mode, the hand scanner works automatically across these screens:
- Register: Rings up product UPCs, discount QRs (DISCOUNT:...), wallet passes, gift card QRs, online order QRs, and receipt lookup QRs.
- Age Verification (ID Check): Scans the PDF417 barcode on the back of customer driver’s licenses and state IDs.
- Transactions & Online Orders: Scans any receipt or order QR to jump directly to that transaction or pickup order.
- Price Check & Product Maintenance: Scans a UPC to check price/stock or open/create an item.
Verify your setup
- On the Register screen, scan a standard product barcode and verify it adds to the basket immediately without tapping Search.
- Scan a printed Basket receipt QR code and verify it opens the transaction or order lookup (remember: receipt QRs require the HID hand scanner, not the counter scanner).
- If age-restricted items are sold, test scanning the PDF417 barcode on the back of an ID in the ID Check prompt.
Troubleshooting
If the hardware does not behave as expected, match what you are seeing below:
Scanner beeps and types the barcode into the field, but does not add the item
Likely cause
- The scanner is missing its Enter / Carriage Return (CR) suffix.
How to fix
- 1.Scan the Add Enter / CR Suffix programming barcode from the scanner’s manual.
- 2.Re-test on the Register screen—the item should submit immediately after the final digit.
Scanner beeps, but no characters appear anywhere in Basket POS
Likely cause
- The scanner is in USB-OEM, Virtual COM (CDC), or Bluetooth SPP mode instead of HID Keyboard mode.
- A Bluetooth scanner is paired to a different nearby tablet or phone, or went to sleep.
How to fix
- 1.Scan the USB HID Keyboard (or Bluetooth HID) programming barcode.
- 2.For Bluetooth scanners, unpair from any other device, confirm it shows as Connected under Android Bluetooth settings, and wake it by pulling the trigger.
QR codes, URLs, or driver’s license IDs miss characters or fail to read
Likely cause
- The scanner’s USB keystroke transmission speed is faster than the tablet WebView can process long bursts.
- The scanner is set to a non-US keyboard layout, or newlines inside PDF417 ID barcodes are being stripped.
- The hand scanner is a 1D-only laser scanner (cannot read 2D QR or PDF417 codes).
How to fix
- 1.Verify the scanner is a 2D imager and that QR Code and PDF417 are enabled.
- 2.Confirm keyboard layout is set to US English (QWERTY).
- 3.In the scanner’s manual, increase USB Keystroke Delay / Inter-character Delay slightly (e.g., 2–5 ms) so long multi-line barcodes arrive cleanly.
The on-screen touch keyboard disappeared after plugging in the hand scanner
Likely cause
- Android automatically hides the virtual keyboard when a physical HID keyboard is attached.
How to fix
- 1.Open Android Settings → System → Languages & input → Physical keyboard.
- 2.Toggle Use on-screen keyboard (Show virtual keyboard) to ON.
Scanning a receipt QR gives "Scan order and receipt codes with the hand scanner."
Likely cause
- You scanned the receipt/order QR with the counter scanner scale instead of the HID hand scanner.
How to fix
- 1.Use the handheld HID scanner for receipt and online order QR codes.
Related hardware guides
Hardware setup
Adding a Scanner Scale (Datalogic & Zebra)
Connect Datalogic Magellan or Zebra MP-series combo scanner scales using USB-OEM mode, configure lb/kg units and Type 2 pricing in Basket POS, and resolve weight or scan issues.
Hardware setup
Adding a Receipt Printer & Cash Drawer
Connect a USB ESC/POS receipt printer and RJ11/RJ12 cash drawer, configure receipt width and printing rules in Basket POS, and troubleshoot common printer and drawer issues.