InnerWeb
Skip to main content

USB-COM scanner with two ports: a plant gate case

The security post received a new code scanner in USB-COM serial port mode, and the gate panel showed no reads at all. The cause was that one device exposed two serial ports while the post had been set up for one. We describe the diagnosis and the settings that close this class of problem.

2
serial ports of one scanner, read together
Source: karta
5 s
window for rejecting a double scan on the server side
Source: karta
64
hexadecimal characters of the badge token
Source: karta

The situation: new scanner, panel shows no reads

A rolling stock maintenance company replaced the scanner at the security post by the gate. The previous one worked as a USB keyboard. The new one was configured by the integrator in USB-COM serial port mode, because that mode does not depend on the keyboard layout of the system. After the scanner was connected, the guards scanned QR badges, the device signalled a valid read, but the gate panel stayed silent: no verdict and no entry in the register.

From the security post the symptom looked like a faulty scanner. For IT it was more worrying: the operating system listed the device, the driver was installed, and yet no read reached the browser with the panel. Situations like this appear at the start of a shift, when the queue at the gate grows fastest.

Diagnosis: one device, two serial ports

A scanner in USB-COM mode can expose two serial ports of the same device. One carries the scanned data, the other carries configuration commands or serves as a backup channel. A post that assumes a single port and picks the first one on the list ends up on a channel where reads never appear.

The InnerWeb security panel handles this case: it opens both ports of the same device and reads them together, so a read is not lost whichever channel the scanner uses. On the system side this was therefore not a fault, but a condition that had to be checked on the device itself.

Two scanners of the same model at one post

A second trap is a post with two scanners of the same model, for example at two entry lanes. The system treats them as one device, because it identifies them by model and not by a separate serial number. In practice, with two scanners of one type, it is worth splitting the posts into separate computers or using different models, rather than hoping both will be handled independently.

Double-scan protection windows

Double-scan protection windowsBar chart: server window 5000 ms, browser window 2584 ms.010002000300040005000msServer: 5000 ms5000 msServerBrowser: 2584 ms2584 msBrowser
Source: Security panel function documentation (internal card)

Four things we checked, one by one

The diagnosis runs from the cheapest steps to the most expensive ones. The order matters, because three of the four causes need no service visit and no hardware replacement:

  • Scanner interface: whether the device really works as a serial port and not as a keyboard. After an interface change the scanner restores its default symbology, so the settings must be checked again after every mode change.
  • Reading QR codes with a URL: a 2D scanner with the option switched off by default emits nothing for a badge with an address, although barcodes work without any problem.
  • Number of ports: whether the device exposes two ports and whether the panel opened both.
  • Keyboard country: it matters in keyboard mode, but it is the first suspect when an address comes out garbled, so it is worth ruling out.

Fix and effect at the post

After the interface change the symbology was set again, and reading QR codes with a URL was switched on explicitly. The panel opened both ports of the device and showed a verdict from the first scan. What happens next matters: the scan itself is the act of control, there is no separate admit button, and every scan, including a rejected one, is written to the gate register. That is why the task of the security post after replacing a scanner is to run a test scan and check the entry in the register.

The panel also protects against the effects of a scan that is repeated too quickly: a double scan within a short interval is rejected on the server side within a 5-second window and on the browser side within a 2584 millisecond window. In this way a scanner that sends a code on two ports at once does not produce conflicting entry and exit records.

The scanner is an unauthenticated device, so the content of the code is treated as untrusted, it has a length limit, and it reveals nothing to a person who photographs the badge. The badge token has 64 hexadecimal characters from a random generator and is not derived from a number or a date.

Conclusions for IT and security

The most important conclusion concerns the split of responsibility. The scanner is a hardware element of the security post, and its settings are part of the acceptance procedure, not of the application configuration. A plant that writes the four points from the previous section into its scanner replacement instruction reduces the number of no-read reports after hardware changes.

The second conclusion: choosing USB-COM mode is justified when a plant has different keyboard layouts at its posts, but it costs an extra step of port testing. Keyboard mode is simpler to start up, serial mode is more resistant to the keyboard layout. The choice should be made deliberately and recorded together with the scanner model.

Checklist

Video

Frequently asked questions

Is USB-COM mode better than USB keyboard mode?

It depends on the plant. Serial mode does not depend on the keyboard layout but requires checking the ports. Keyboard mode is simpler, but it requires the keyboard country to be set on the scanner.

The scanner beeps, but the panel stays silent. Where should I look?

Start with the interface and the symbology, then check the option for reading codes with a URL. Check the ports only at the end.

Can a double read damage the register?

No. Reads within a short interval are rejected on the server and in the browser, so the register does not receive conflicting entries.

Does InnerWeb supply the scanners?

InnerWeb is a software vendor. The scanners are purchased and integrated by the plant, and their settings are described in the post instructions.

Let's set up the security post together with your IT team

Book a call about the gate post: we will prepare an acceptance checklist for the scanner model you use.

Let's talk