Skip to content

installation.md

Latest commit

 

History

History
71 lines (53 loc) · 1.45 KB

installation.md

File metadata and controls

71 lines (53 loc) · 1.45 KB
Raw

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