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