Introduction

The libfreefare project provides a convenient API for MIFARE card manipulations.

It is part of the nfc-tools, you can find more info on them on the nfc-tools wiki.

If you are new to libfreefare or the nfc-tools, you should collect useful information on the project website and the dedicated forums.

Feature matrix

Tags

| Tag | Status | |:--------------------|:--------------| | FeliCa Lite | Supported | | MIFARE Classic 1k | Supported | | MIFARE Classic 4k | Supported | | MIFARE DESFire 2k | Supported | | MIFARE DESFire 4k | Supported | | MIFARE DESFire 8k | Supported | | MIFARE DESFire EV1 | Supported | | MIFARE Mini | Supported | | MIFARE Plus S 2k | Not supported | | MIFARE Plus S 4k | Not supported | | MIFARE Plus X 2k | Not supported | | MIFARE Plus X 4k | Not supported | | MIFARE Ultralight | Supported | | MIFARE Ultralight C | Supported | | NTAG21x | Supported |

Specifications

| Specification | Status | |:--------------------------------------|:----------| | Mifare Application Directory (MAD) v1 | Supported | | Mifare Application Directory (MAD) v2 | Supported | | Mifare Application Directory (MAD) v3 | Supported (part of Mifare DESFire support) |

Installation

For *NIX systems

You can use released version (see Download section) or development version:

First, ensure all dependencies are installed:

• libnfc;
• git;
• Autotools (autoconf, automake, libtool);
• OpenSSL development package.

apt-get install autoconf automake git libtool libssl-dev pkg-config

Clone this repository:

git clone https://github.com/nfc-tools/libfreefare.git
cd libfreefare

Before compiling, remember to run:

autoreconf -vis

You can now compile libfreefare the usual autotools way:

./configure --prefix=/usr
make
sudo make install

For Windows Systems

Requirements

• cmake
• make
• mingw{32,64}-gcc

Building

mingw64-cmake -DLIBNFC_INCLUDE_DIRS=/path/to/libnfc-source/include  -DLIBNFC_LIBRARIES=/path/to/libnfc.dll
mingw64-make

Debug

In order to debug using gdb, you should tune the CFLAGS:

CFLAGS="-O0 -ggdb" ./configure --prefix=/usr
make clean all

It is then possible to debug examples using this kind of command from the root of the repository:

./libtool --mode=execute gdb examples/mifare-classic-write-ndef

If you are only interested in viewing transfert traces between the PCD and the PICC, simply use the --enable-debug configure flag:

./configure --enable-debug
make clean all