matrix-hal-nfc is a simple, easy to use wrapper for using NXP's NFC Reader Library with the PN512 chip on the MATRIX Creator.
- Reading Info (All tags)
- Reading Page (MIFARE Ultralight & NTAG)
- Writing Page (MIFARE Ultralight & NTAG)
- Reading NDEF (MIFARE Ultralight & NTAG)
- Writing NDEF (MIFARE Ultralight & NTAG)
Before moving on, be sure to have setup a MATRIX Creator with MATRIX HAL installed (HAL is needed for LEDs & matrix-creator-init).
Download the following packages to your Raspberry Pi.
sudo apt install cmake git
Due to NXP's terms & conditions, we cannot directly distribute the library to our users.
You can download the NFC Reader Library for PN512 by creating an account on the NXP website and downloading the zip file here.
Click the download button.
Click the 4.04.05 NFC Reader Library for PN512.
Then click SW297940.zip to download NFC Reader Library v4.040.05 R2 for PNEV512B including all software examples.
To start installing the NXP library, clone this repository.
git clone https://github.com/matrix-io/matrix-hal-nfc.git
cd matrix-hal-nfc
Now move the SW297940.zip file you downloaded into the matrix-hal-nfc folder. If you don't know how to transfer files into your Raspberry Pi, follow this simple guide on using an FTP client.
Once complete, you can install the NXP library into /usr/local/include/matrix_nfc/nxp_nfc with the following command. Please ensure that you have have placed SW297940.zip inside matrix-hal-nfc.
./install_nxp.sh
Inside matrix-hal-nxp, you need to run the build script to finish the library installation. This will install the header files in /usr/local/include/matrix_nfc/ and the libmatrix_hal_nfc.so library file in /usr/local/lib/.
./build.sh
After building is complete, a few compiled examples will be in the build/examples folder.
You can compile your own programs by using:
g++ -o YOUR_OUTPUT YOUR_INPUT -std=c++11 -DNXPBUILD__PH_RASPBERRY_PI -I/usr/local/include/matrix_nfc/nxp_nfc/NxpNfcRdLib/types -I/usr/local/include/matrix_nfc/nxp_nfc/NxpNfcRdLib/intfs -lmatrix_hal_nfc -lmatrix_creator_hal
The NDEF parsing library in src/ndef/ndef_parse is Don's NDEF Library for Arduino; it has been modified for this wrapper.
The NXP NFC Library is provided by NXP, and can not be redistributed without permission of NXP.