Skip to content
Basket
Menu
Hardware setup5 min readUpdated 2026-11-15

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.

Important: Do not use USB-OEM, Virtual COM / Serial, or Bluetooth SPP mode.
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. 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. 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. 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. 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. 1.Scan the Add Enter / CR Suffix programming barcode from the scanner’s manual.
  2. 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. 1.Scan the USB HID Keyboard (or Bluetooth HID) programming barcode.
  2. 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. 1.Verify the scanner is a 2D imager and that QR Code and PDF417 are enabled.
  2. 2.Confirm keyboard layout is set to US English (QWERTY).
  3. 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. 1.Open Android Settings → System → Languages & input → Physical keyboard.
  2. 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. 1.Use the handheld HID scanner for receipt and online order QR codes.