libnfc工具库完整安装与使用教程

libnfc是一个跨平台的近场通信(NFC)用户空间库，为开发者提供了完整的NFC功能开发解决方案。本文将详细介绍libnfc的安装配置、核心功能和使用方法。

项目概述

libnfc是一个自由/开源的近场通信库，允许用户空间应用程序访问NFC设备。它支持多种NFC硬件设备，包括PN532、ACR122、PN71xx等，并提供丰富的API接口。

系统要求

在安装libnfc之前，请确保系统满足以下要求：

• POSIX系统（Linux、FreeBSD等）
• C编译器（gcc或clang）
• 相关依赖库：
  • libusb-0.1（用于pn53x_usb和acr122_usb驱动）
  • pcsc-lite（用于acr122_pcsc驱动）

安装步骤

1. 获取源代码

首先从代码仓库获取libnfc源代码：

git clone https://gitcode.com/gh_mirrors/li/libnfc
cd libnfc

2. 生成配置脚本

如果直接从git仓库获取代码，需要先生成配置文件：

autoreconf -vis

3. 编译安装

执行以下命令完成编译和安装：

./configure
make
sudo make install

4. 设备权限配置

为了让普通用户能够使用NFC设备，需要配置相应的权限规则：

在Linux系统上：

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

在FreeBSD系统上：

sudo cp contrib/devd/pn53x.conf /usr/local/etc/devd/

配置说明

libnfc支持通过配置文件和环境变量进行灵活配置。

配置文件

创建配置文件目录并复制示例配置：

sudo mkdir /etc/nfc
sudo cp libnfc.conf.sample /etc/nfc/libnfc.conf

配置文件示例内容：

# 允许设备自动检测（默认：true）
allow_autoscan = true

# 允许侵入式自动检测（默认：false）
allow_intrusive_scan = false

# 设置日志级别（默认：error）
log_level = 1

# 手动设置默认设备
device.name = "microBuilder.eu"
device.connstring = "pn532_uart:/dev/ttyUSB0"

环境变量

可以通过环境变量覆盖配置选项：

• LIBNFC_DEFAULT_DEVICE=<connstring>：设置默认设备
• LIBNFC_DEVICE=<connstring>：忽略配置文件中的所有设备，仅使用变量中定义的设备
• LIBNFC_AUTO_SCAN=<true|false>：覆盖配置文件中的allow_autoscan选项
• LIBNFC_LOG_LEVEL=<0|1|2|3>：设置日志级别

核心功能示例

设备轮询示例

libnfc提供了丰富的示例程序，其中nfc-poll是一个典型的设备轮询示例：

#include <nfc/nfc.h>

int main(void) {
    nfc_context *context;
    nfc_device *device;
    
    nfc_init(&context);
    device = nfc_open(context, NULL);
    
    if (device != NULL) {
        // 初始化设备
        nfc_initiator_init(device);
        
        // 设置调制参数
        const nfc_modulation modulations[] = {
            { .nmt = NMT_ISO14443A, .nbr = NBR_106 },
            { .nmt = NMT_ISO14443B, .nbr = NBR_106 },
            { .nmt = NMT_FELICA, .nbr = NBR_212 },
            { .nmt = NMT_FELICA, .nbr = NBR_424 },
            { .nmt = NMT_JEWEL, .nbr = NBR_106 },
            { .nmt = NMT_ISO14443BICLASS, .nbr = NBR_106 },
        };
        
        nfc_target target;
        // 轮询目标设备
        int res = nfc_initiator_poll_target(device, modulations, 6, 20, 2, &target);
        
        nfc_close(device);
    }
    
    nfc_exit(context);
    return 0;
}

工具程序

libnfc附带了一系列实用的命令行工具：

• nfc-list：列出可用的NFC设备
• nfc-poll：轮询NFC目标设备
• nfc-mfclassic：MIFARE Classic卡操作
• nfc-mfultralight：MIFARE Ultralight卡操作
• nfc-scan-device：扫描NFC设备

驱动程序支持

libnfc支持多种NFC设备驱动程序：

• pn53x_usb：支持PN53x系列USB设备
• acr122_usb：支持ACR122 USB设备
• acr122_pcsc：支持ACR122 PC/SC设备
• pn532_uart：支持PN532 UART设备
• pcsc：支持PC/SC兼容读卡器

故障排除

常见问题解决方案

Touchatag/ACR122设备检测失败： 确保PCSC-lite守护进程（pcscd）已安装并正在运行。

PN533 USB设备在Linux >= 3.1上的问题： 需要阻止内核自动加载相关模块：

sudo cp contrib/linux/blacklist-libnfc.conf /etc/modprobe.d/

调试技巧

启用调试模式获取详细信息：

LIBNFC_LOG_LEVEL=3 nfc-list -v

进阶使用

多设备配置

要配置多个设备，可以在/etc/nfc/devices.d/目录下为每个设备创建单独的配置文件：

sudo mkdir -p /etc/nfc/devices.d/

# 第一个设备
echo 'name = "My first device"
connstring = "pn532_uart:/dev/ttyACM0"' | sudo tee /etc/nfc/devices.d/first.conf

# 第二个设备  
echo 'name = "My second device"
connstring = "pn532_uart:/dev/ttyACM1"' | sudo tee /etc/nfc/devices.d/second.conf

总结

libnfc为NFC应用开发提供了强大而灵活的工具集。通过本文介绍的安装配置方法和使用示例，开发者可以快速上手并构建自己的NFC应用。建议在实际开发中多参考示例代码和官方文档，以获得最佳开发体验。