NFC Master Library

General Information

• libnfc: This is a Free/Libre library that provides userspace application access to NFC devices.
• Official sites:
• Website: nfc-tools.org
• Forum: libnfc Community
• Development: GitHub Repository

System Requirements

1. NFC Drivers
2. pn53x_usb & acr122_usb: Requires libusb-0.1
3. acr122_pcsc: Requires pcsc-lite
4. Regression Testing
5. Requires the Cutter Framework

Installation

For full details, refer to the INSTALL file:

1. Copy Udev Rules (GNU/Linux, Debian/Ubuntu):

bash

sudo cp contrib/udev/42-pn53x.rules /lib/udev/rules.d/

2. Copy Devd Rules (FreeBSD):

bash

contrib/devd/pn53x.conf

Configuration

• To customize default behavior, edit the libnfc.conf.sample file: bash sudo mkdir /etc/nfc sudo cp libnfc.conf.sample /etc/nfc/libnfc.conf
• Multiple Device Configurations: bash sudo mkdir -p /etc/nfc/devices.d printf 'name = "Device 1" connstring = "pn532_uart:/dev/ttyACM0"' | sudo tee /etc/nfc/devices.d/device1.conf

Bug Reporting

• Visit the libnfc GitHub Issues Page and include:
• libnfc Version
• System Information (e.g., OS version)
• Debug Trace (use $ LIBNFC_LOG_LEVEL=3 nfc-list -v)

Building the Library

Run the following commands:

./configure
make

Troubleshooting

• Touchatag/ACR122 Issues:
• Ensure PCSC-lite daemon is installed and running.

• If using libccid, modify ifdDriverOptions in /etc/libccid_Info.plist.

• ACR122 Configuration:

• Enable CCID Exchange Command by editing libccid_Info.plist and restarting pcscd.

• PN533 USB Devices on Linux 3.1+:

• Blacklist kernel modules nfc and pn533 to avoid conflicts: bash sudo cp contrib/linux/blacklist-libnfc.conf /etc/modprobe.d/blacklist-libnfc.conf

Proprietary Notes

• FeliCa is a registered trademark of Sony Corporation.
• MIFARE is a trademark of NXP Semiconductors.
• Jewel Topaz is a trademark of Innovision Research & Technology.