https://github.com/omaraflak/apdu-library
Library built on top of libNfc to easily send APDU commands.
https://github.com/omaraflak/apdu-library
android android-hce hce libnfc nfc pn532
Last synced: 11 months ago
JSON representation
Library built on top of libNfc to easily send APDU commands.
- Host: GitHub
- URL: https://github.com/omaraflak/apdu-library
- Owner: omaraflak
- Created: 2018-06-08T10:10:35.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2019-09-30T09:21:24.000Z (almost 7 years ago)
- Last Synced: 2025-04-12T14:22:57.311Z (over 1 year ago)
- Topics: android, android-hce, hce, libnfc, nfc, pn532
- Language: C++
- Homepage:
- Size: 14.6 KB
- Stars: 20
- Watchers: 2
- Forks: 9
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# APDU Library
Library built on top of libNfc, that allows to easily send APDU commands through a terminal.
# Compile
Enter the repo directory then simply :
```
make
```
# Dependency : Libnfc
This code uses [libnfc](https://github.com/nfc-tools/libnfc)
If you're on Linux, you can install libnfc simply by doing :
```
git clone https://github.com/nfc-tools/libnfc.git
autoreconf -vis
./configure --enable-doc
make
sudo make install
```
# Notice
The code contains an implementation of the APDU protocol according to [Wikipedia](https://fr.wikipedia.org/wiki/Application_Protocol_Data_Unit).
However, I'm not entierly sure if I implemented correctly the **extended apdu** protocol. The `PN532` doesn't support it anyway...
# How to use
Use the `NfcManager` to simplify the process of detecting, opening and transceiving data.
```c++
NfcManager manager;
if(manager.open()){
if(manager.isTargetPresent()){
// do things ...
}
manager.close();
}
```
Once the device opened, use the `APDU` class to send and receive APDUs commands.
If you want to perform a **select** command, you would do :
```c++
APDU apdu;
apdu.setClass(0x00);
apdu.setInstruction(0xA4);
apdu.setParams(0x04, 0x00);
apdu.setCmd(hexStringToByteArray(appId));
apdu.buildAPDU();
manager.transceive(apdu);
```
To know more about APDUs instruction codes etc, read the beautiful [ISO standard](http://cardwerk.com/smart-card-standard-iso7816-4-section-5-basic-organizations)
When `manager.transceive()` ends, the `APDU` object will contain the response, if any. You can get it like this :
```c++
std::vector responseBytes = apdu.getRespBytes();
std::string responseString = apdu.getRespString();
```
That said, `NfcManager` already implements the `select` command, you just need to do this :
```c++
manager.selectApplication(appId, apdu);
```
# Examples
You can find a full examples **[here](https://github.com/OmarAflak/APDU-Library/blob/master/examples)**.