InnerWeb
Skip to main content

QR scanner setup: keyboard country and URL codes

A 2D scanner at the workshop gate works correctly only when its keyboard country is set, reading of QR codes with a URL is switched on and the symbology has been checked after every interface change. This guide for IT walks through these settings one by one, so that a single set of settings serves the gate.

4
steps of the scanner setup
2
serial ports of one scanner in USB-COM mode

Why the scanner must be configured before the first badge

The scanner is an unauthenticated device: the content of the code is treated as untrusted, has a length limit and reveals nothing to a person who photographs the badge. For this reason the system does not guess what the scanner meant to send, so the device settings must be right from the start.

Wrong settings give two typical symptoms: the scanner stays silent or sends a distorted address. Both can be avoided with a few steps during installation, before the first badge reaches an employee's hands.

Step 1: keyboard country

A scanner delivered with a foreign keyboard layout, for example French AZERTY, sent a distorted address. The parser recognises such a code thanks to reverse mapping, but the lasting fix is to set the keyboard country on the scanner. Choose the layout that matches the computer at the gate.

Check this with a test scan: open a text editor and scan a badge. The address should appear legibly, with correct colons and slashes. If characters are swapped, the keyboard layout in the scanner does not match the computer's layout.

Steps of the scanner setup

Steps of the scanner setupChart: four consecutive setup steps, from the interface to the test scan.01234stepInterfaceInterface: 1 step1Keyboard countryKeyboard country: 2 step2QR reading with URLQR reading with URL: 3 step3Test scanTest scan: 4 step4
Source: to

Step 2: reading QR codes with a URL

A 2D scanner with the option of reading QR codes containing a URL switched off at the factory emits nothing for a badge with an address. The option has to be explicitly enabled in the symbology settings. The symptom looks like a scanner failure, although the scanner works and simply does not pass on this code.

If the test scan gives no text at all, check this option first, before replacing the device.

Step 3: choosing the interface and checking the symbology again

Changing the scanner's interface, that is a USB keyboard or a USB-COM serial port, restores the default symbology settings. After every such change the settings must be checked again: keyboard country, reading of QR codes with an address and code length.

A practical rule: first choose the interface, and only then set the rest. The reverse order ends with the settings disappearing after an interface change.

Step 4: USB-COM mode and two ports

A scanner in USB-COM mode can expose two serial ports of the same device. The system opens both and reads them together, and two scanners of the same model at one workstation are treated as a single device.

For IT this means two things: two ports in Device Manager are not a fault, and two identical scanners at one workstation will not give two independent readings. If a workstation serves two directions of traffic, separate workstations are needed.

Common faults and quick diagnosis

No reading for a badge with an address: check the QR with URL reading. Distorted characters: check the keyboard country. Settings gone after replacement: after an interface change the symbology returned to default. Two ports in Device Manager: the normal USB-COM mode. A table like this in three sentences shortens the report to IT from an hour to a few minutes, because most scanner problems have one of these four causes.

A test scan in a text editor settles whether the problem lies in the device or in the system: if the address reads correctly in the editor but the gate does not accept it, check the settings on the panel side, not the scanner. If the editor shows a distorted address or nothing, stay with the device settings.

Documenting the settings and replacing the device

Record the scanner settings in one protocol: model, interface, keyboard country, enabled symbologies, configuration date and the person who made it. At a workshop running three shifts, a scanner replacement at night happens more often than expected, and the night shift usually has no IT staff. The protocol lets security or the duty technician restore the settings on their own.

A good practice is to keep one spare scanner, configured according to the protocol and described. After a replacement you run the same test scan you did at installation, and add an entry to the protocol.

Final test before go-live

Scan a test badge and check three things: the address is legible, the record appears in the gate log, and a second scan within less than 5 seconds is rejected. Record the scanner settings in the protocol, so that the same set can be repeated at a device replacement.

Video

Frequently asked questions

Why does the scanner send nothing for a badge?

Most often the reading of QR codes with a URL is switched off from the factory. Turn this option on in the symbology settings.

Why are the characters in the address swapped in the editor?

The scanner has a foreign keyboard layout set. The parser recognises it, but the lasting fix is to set the correct keyboard country.

Do I need to set anything after changing the interface?

Yes. Changing to a USB keyboard or USB-COM restores the default symbology, so the settings must be checked again.

Let's talk about the gate in your workshop

We will show the security panel on the example of a rolling stock maintenance depot and discuss how to connect it to your existing access control system.

Let's talk