Tera barcode scanner - HID not recognized by QZ

[thbl]

@windows
By default the barcode reader show as a USB HID Keyboard, tho in device maneger you can change driver to "HID-compatible device"

In QZ it dosen't show on the HID list for some reason ?
Is there a tool to check if its a QZ issue or win/driver one ?
This is the device info with default windows driver

It shows in the USB tab list, but trying to claim it here gives this error
Error: javax.usb.UsbPlatformException: USB error 4: Can't open device Bus 003 Device 016: ID 0145:0012: No such device (it may have been disconnected)
But if you change driver to WinUSB (using this tool https://zadig.akeo.ie/) you can claim and get raw stream in USB tab.

@tresf open for suggestions and ready to help what i can :)

[tresf]

@tresf open for suggestions and ready to help what i can :)

Will check out a bit later this week.

[thbl]

Thanks @tresf let me know if you need me to test something

[tresf]

Windows strictly prohibits stealing keystrokes for security reasons, so devices which only offer keyboard emulation suffer as a result. My experience with the Tera scanner is the following:

1. 🚫 Using USB charging/data cable, the device emulates a keyboard and sends (very slow) keystrokes to the Desktop. QZ Tray is unable to read from device in this mode.
2. 🚫 Using USB wireless dongle, the device sends (faster) keystrokes to the Desktop. QZ Tray is unable to read from device in this mode.
3. 🚫 This behavior is identical between Windows and macOS. Neither OS are able to read from this device.

We'll need to switch this into POS Scanner mode... quoting Microsoft's scanner page:

Please refer to your barcode scanner documentation or contact your barcode scanner manufacturer for instructions to enable the HID POS Scanner mode.

I tried and failed. I've attempted to manipulate the device into raw HID mode and serial mode using both USB methods, but the manual doesn't offer a QR code for this function and attempting to scan other Tera model barcodes don't seem to have an effect either. It always stays in keyboard emulation (we've been able to read from other HID scanners as identified in #288, but the Keyboard support breaks this as explained here: nyholku/purejavahidapi#50 (comment)).

So what's next? The manual does mention "POS" on page 4, but also says the following on page 18:

Q&A
...
5. Other [connection methods] require special testing tools. If you have such needs, please contact the seller.
...
9. [Modifying other scanner settings] please contact the seller.

Per the manual, I've emailed Tera directly for assistance.

[tresf]

I'd like to add that although "POS" (Point Of Sale) is used quite liberally in documentation, its usage applies equally to non-POS systems such as shipping, inventory, etc. POS can be considered generic for all applicable industries.

[thbl]

Thanks for your test @tresf what Tera barcode scanner do you use ?
For most of them it seams possible to convert it to COM mode, i have some contacts from Tera will forward you mail with info on this... :)
atm i have their "new" 1 mega pixel one this only supports hid two.
But as i understand it it supports 2 hid modes depinding on what driver you set in device maneger.
1: HID keyboard ....
2: (normal?) HID - dosen't output like a keyboard

[thbl]

@tresf do you know of any simple software to test if a HID device should be compatible ?
(for testing my reader in mode 2)

[tresf]

@tresf do you know of any simple software to test if a HID device should be compatible ?

I've always relied on vendor-provided demos when Java failed. Note, there is an open bug report to add BarcodeScanner class support to the library we use: nyholku/purejavahidapi#70. If you find it listing as such, we can expedite a downstream patch to include this in QZ Tray.

[tresf]

But as i understand it it supports 2 hid modes depinding on what driver you set in device maneger.
1: HID keyboard ....
2: (normal?) HID - dosen't output like a keyboard

This may be true, but in my experience with other scanners, the scanner itself controls this.

[tresf]

what Tera barcode scanner do you use

This one: https://www.amazon.com/gp/product/B07T5KG5JC/ref=ask_ql_qh_dp_hza

[tresf]

I forgot to mention, that I did receive feedback from the seller, it just didn't work with my scanner. Leaving this here incase it's useful to someone in the future... this is quoted directly from an email from tera-digital.com.

Closing, marking as wontfix, since the hardware just doesn't seem to behave properly with the instructions provided. Note, #624 could ultimately fix this, if QZ Tray offered Bluetooth support, so that may be a better avenue for the aforementioned scanner.

Please see the following steps for USB Virtual COM interface.

Firstly, let's make sure everything is normal by the following 5 steps.

1. Plug in the USB cable, press the trigger button to start up the scanner
2. Scan the setup code “Restore Factory Default”

3. Scan the setup code "Instant Upload Mode"

4. Scan the setup code "USB_HID-default" (user manual page)

   

5. Open a file, scan a barcode on the package of an item to see if it uploads normally, if everything works as normal, please go on the next 3 steps

These are the correct steps to use Virtual Com:

1. Plug in the USB cable, press the trigger button to start up the scanner
2. Scan the configuration code "USB Virtual COM"

   

3. Download and install the attached driver.