Skip to content

Convert NFC card taps on CCID compatible NFC readers to quicktill user tokens

License

Notifications You must be signed in to change notification settings

sde1000/quicktill-nfc-bridge

Repository files navigation

quicktill-nfc-bridge

This is a quick and dirty interface between pyscard / pcsc and quicktill, to convert NFC card taps on an NFC reader into user tokens delivered as UDP packets to localhost:8455.

Any CCID compatible NFC reader should work: there's a standard way to retrieve contactless UIDs. This package has additional code to deal with ACR122, ACR1252 and ACR1255 readers (with suitably recent firmware), to turn off the "beep on card insert/remove" options when the reader is discovered.

The reader configuration code can only work when CCID escape is enabled in the pcsc driver. To do this, edit the driver config file (/etc/libccid_Info.plist on Linux) and set key ifdDriverOptions to 0x0001. On ACR1252 and ACR1255 the configuration is stored in non-volatile memory on the reader, so once all your readers have been configured you can change the driver config file back to the default setting of 0x0000. You may need to restart pcscd to pick up the configuration file change. ACR122 doesn't have any non-volatile memory so the beeps need turning off every time it's plugged in.

In order to wake up the screen when a NFC card tap occurs, quicktill-nfc-bridge creates a virtual keyboard and taps the left Ctrl key.

Copying

quicktill-nfc-bridge is Copyright (C) 2014–2024 Stephen Early [email protected]

It is distributed under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see this link.

Building

To build quicktill-nfc-bridge, start with this repository as the current working directory:

make

To build the Debian package:

dpkg-buildpackage

About

Convert NFC card taps on CCID compatible NFC readers to quicktill user tokens

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published