Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nfc-tools/libfreefare
A convenience API for NFC cards manipulations on top of libnfc.
https://github.com/nfc-tools/libfreefare
c libfreefare libnfc mifare mifare-desfire mifare-ultralight mifare1k nfc
Last synced: 4 days ago
JSON representation
A convenience API for NFC cards manipulations on top of libnfc.
- Host: GitHub
- URL: https://github.com/nfc-tools/libfreefare
- Owner: nfc-tools
- License: other
- Created: 2015-03-14T12:18:01.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2024-07-25T07:13:30.000Z (6 months ago)
- Last Synced: 2025-01-10T21:04:58.842Z (11 days ago)
- Topics: c, libfreefare, libnfc, mifare, mifare-desfire, mifare-ultralight, mifare1k, nfc
- Language: C
- Homepage:
- Size: 788 KB
- Stars: 411
- Watchers: 32
- Forks: 106
- Open Issues: 47
-
Metadata Files:
- Readme: README.md
- Changelog: ChangeLog
- License: COPYING
- Authors: AUTHORS
Awesome Lists containing this project
README
# Introduction
[](https://travis-ci.org/nfc-tools/libfreefare)
[](https://gitter.im/nfc-tools/libfreefare?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
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](http://nfc-tools.org/).
If you are new to _libfreefare_ or the _nfc-tools_, you should collect useful information on the [project website](http://nfc-tools.org/) and the [dedicated forums](http://www.libnfc.org/community).
# 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](https://github.com/nfc-tools/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
```