Situation: first day and the first report from reception
We describe a typical situation from the start-up of an access control point at a production plant. The post has a computer with a browser, a 2D code scanner connected by USB and badges printed from the system. In the morning the guard scans the first badges. Some pass without problems, and a few return a message that the code is unknown.
The report reaches the plant's IT administrator: the badge is genuine, it was printed an hour earlier, and the system says the code does not exist. The first reflex is to suspect a system error or a damaged print. In practice, in most such reports the code is correct and the problem lies between the scanner and the browser.
This is a description of a situation typical for start-ups of this kind, not the history of a specific plant. Its purpose is to show the administrator where to begin the diagnosis before replacing any hardware.
Why the scanner behaves like a keyboard
A scanner working in USB HID mode does not send ready text to the computer. It pretends to be a keyboard: for each character of the code it sends a key code, and the computer turns it into a letter according to the currently set keyboard layout. If the scanner was configured for a layout different from the one on the post's operating system, some characters change on the way.
The security panel recognises the scanner by its typing rhythm: a gap between characters below 34 ms means a machine rather than a human, and an unfinished read is cleared after 233 ms. This way a scan does not mix with manual typing on the same screen. The mechanism does not depend on the keyboard layout, so a scan is detected correctly even when its characters are distorted.
In practice the distortion affects special characters of the address: colons, slashes and dots, as well as letter case. An example is a scanner set to the French AZERTY layout on a computer with a Polish layout, or work with Caps Lock switched on. In that case the same code produces a different string than the one encoded in the badge.
What the panel parser does
The panel parser does not give up after the first failed recognition: it tries a second time with the reversed mapping, so a scan distorted by the wrong layout or by Caps Lock is still recognised. This reduces the number of false refusals, but it does not replace correct configuration, because not every distortion can be reversed with a single rule.
Why the code is not an address to open
The code from the badge is treated only as a string to match against a pattern, never as an address to open, HTML code or a command, and its length is limited. That is why even a very odd scan does not launch anything in the guard's browser: at most it ends with an unknown code message.
Timing thresholds for scanning in the security panel
Diagnosis in five steps
The IT administrator should separate two hypotheses: the code on the badge is wrong, or the code is correct and the scanner distorts it. The fastest way to decide is to scan the same badge into a plain text field that shows exactly what the scanner sent.
- Scan the badge into a plain text field (a notepad) and compare the result with the address printed on the badge. If the special characters differ, the cause is the scanner's keyboard layout.
- Check whether Caps Lock is on at the post. One scan in capital letters where the code has lower-case letters is enough to make the report repeat.
- Compare the keyboard layout in the operating system with the country code programmed into the scanner, and set the same one.
- For scanners that send nothing at all for codes containing a web address, enable the reading of such codes in the configuration. In some manufacturers' devices this option is disabled by default.
- Scan the same badge with a second scanner or with a second badge. If the problem occurs only on one device, the configuration of that unit is the cause, not the system.
Traps that return after a settings change
After fixing the keyboard layout, reports often come back after the scanner's operating mode is changed. Changing the scanner interface, for example from USB HID to USB-COM, restores the default symbol settings, so after every such change the reading of addresses and the keyboard country code must be checked again.
The second trap concerns programming the scanner with configuration codes. The whole sequence requires the USB cable to stay connected, and a loss of power during it discards the settings being changed. The scanner may look configured while in fact it has gone back to the previous values. After the sequence, always perform a test scan.
The third trap is confusing the causes: a double scan of the same code within 5 seconds is ignored on the server side with an informational message about a duplicate scan. A guard who sees such a message is not dealing with a reading error, but with protection against an accidental second entry.
Outcome and conclusions for the IT administrator
After setting one keyboard layout in the system and in the scanner, switching off Caps Lock and confirming the reading of addresses, subsequent scans pass without reports. The diagnosis time depends on whether the administrator starts from the text field or from suspecting the system: the first route takes a few minutes, the second can take a whole day.
The conclusions are practical. Treat the scanner at the gate as a device with its own configuration, not as a cable. Write down its settings (mode, layout, reading of addresses), keep them in the post's instructions and check them after every replacement or change of interface. Before the first day of operation, run a trial with several test badges, including one containing all the types of characters that appear in the address.
Checklist
Video
Frequently asked questions
Does an unknown code mean the badge is invalid?
No. The unknown code message means the string reached the panel in a form that cannot be matched. The most common cause is the keyboard layout or Caps Lock, not the validity of the badge.
Can the panel cope with a different keyboard layout?
Partly. The parser tries a second time with the reversed mapping, so typical distortions can be reversed. Correct scanner configuration is still recommended, because it reduces reports.
Why does the scanner send nothing for some codes?
On scanners from some manufacturers, reading of QR codes containing a web address is disabled by default. It must be explicitly enabled in the device configuration.
Can a scan open a foreign address in the guard's browser?
No. The code is treated only as a string to match against a pattern, and its length is limited.
Launching a gate with QR control?
We will show the security panel on a test post and go through the scanner configuration with your IT team before the guard scans the first badge.
Let's talk