This package provides a NIF binding to libnfc and some Elixir boilerplate for convenient & more idiomatic use.

Status

This library was designed to detect and track the presence of ISO/IEC 14443 Type A passive NFC targets from an Elixir application. Its original use-case was a Raspberry-based music box controlled by cheap passive NFC tags detectable by a PN532 NFC HAT. The adaptation of libnfc functions as well as design of the surrounding Elixir API is so far limited to support this use-case, yet extending the library for other NFC modulations should be relatively straightforward.

• ✅ Listing & opening NFC devices
• ✅ ISO 14333 Type A passive target selecting & tracking

Not implemented:

• Other modulations
• Initiator API: Polling, writing, transceiving
• Target API

Dependencies

• libnfc
• make
• working C11 compiler, e.g. gcc

Installing libnfc from source

On Debian and derived Linux systems:

sudo apt-get install build-essentials automake autoconf
sudo apt-get install libusb-devcopy

git clone https://github.com/nfc-tools/libnfc
cd libnfc
autoreconf -vis
./configure --prefix=/usr --sysconfdir=/etc
make -j4
sudo make installcopy

Visit libnfc for details.

Installation

def deps do
  [
    {:libnfc_ex, "~> 0.1.0"}
  ]
endcopy

Usage

{:ok, device} = LibNFC.open()

{:ok, target_info} =
  LibNFC.initiator_select_passive_target(device)

IO.puts("Target #{LibNFC.Utils.uid_hex(target_info["uid"])} in range")copy