davi-nfc-agent

Installation

Pre-built Binaries

Download pre-built binaries from releases.

Building from Source

git clone https://github.com/dotside-studios/davi-nfc-agent.git
cd davi-nfc-agent
go build .

Requirements

The agent uses PC/SC for NFC reader communication. PC/SC is built into all major operating systems:

• macOS: Built-in (CCID framework)
• Windows: Built-in (WinSCard)
• Linux: Install pcsclite:

  # Debian/Ubuntu
  sudo apt install pcscd libpcsclite-dev
  
  # Fedora/RHEL
  sudo dnf install pcsc-lite pcsc-lite-devel
  
  # Arch Linux
  sudo pacman -S pcsclite
  

Supported Readers

Any PC/SC-compatible NFC reader works, including:

• ACR122U, ACR1252U, ACR1552
• HID Omnikey readers
• Identiv readers
• Most USB CCID readers

Troubleshooting

“No NFC devices found”

• Ensure your NFC reader is connected
• Check that PC/SC service is running:

  # Linux
  sudo systemctl status pcscd
  sudo systemctl start pcscd
  

• Verify the reader is detected:

  # Linux
  pcsc_scan
  

Permission Denied (Linux)

Add your user to the pcscd group or add udev rules:

# Create udev rule for common NFC readers
sudo tee /etc/udev/rules.d/99-nfc.rules << 'EOF'
SUBSYSTEM=="usb", ATTR{idVendor}=="072f", MODE="0666"
SUBSYSTEM=="usb", ATTR{idVendor}=="04e6", MODE="0666"
EOF

sudo udevadm control --reload-rules
sudo udevadm trigger

This site is open source. Improve this page.