Instruction

This is a Raspberry Pi NFC HAT based on PN532 operating in the 13.56MHz frequency range. It supports three communication interfaces: I2C, SPI, and UART.

NFC (Near Field Communication) is a wireless technology allows contactless point-to-point data communication between devices within a short distance of 10 cm. It is widely used in applications such as access control system, smart tickets, meal card, etc.

Based on the popular NFC controller PN532 with multi interface options, this HAT will easily enable NFC function for your Raspberry Pi.

Features

  • Standard Raspberry Pi 40PIN GPIO extension header, supports Raspberry Pi series boards
  • Onboard PN532 chip, supports various NFC/RFID cards like MIFARE/NTAG2xx, etc.
  • Three interface options: I2C, SPI, and UART, configured via jumpers and switches
  • Breakout control pins, for easily connecting with host boards like STM32/Arduino
  • Comes with development resources and manual (examples for Raspberry Python/C, STM32, Arduino)

Note

  • This module can only be used to write/read NFC card whose password is known, it cannot be used for decrypting encrypted NFC card. For example, the default password of all blocks of Mifare Classic card is 0xFFFFFFFFFFFF. the Mifare card can be written/read only when the default password isn't changed
  • This module cannot be used to copy card, unless that the card use default password.
  • This module cannot be used to simulate NFC card. Because ID of NFC card are 4 bytes, because of security policy of PN532, it will set the first byte of simulate card to 0x08. For more details, please refer to http://www.nfc-tools.org/index.php?title=PN53x%E3%80%82

Quick testing

You can quick test the module by connecting it to PC with USB to TTL module instead of Raspberry Pi

1. Hardware connection
PN532 NFC HATUSB to TTL Module
3V33.3V
GNDGND
TXRX
RXTX
2. Set L0 to L and L1 to L by jumpers
3. Connect USB to TTL Module to PC by USB cable
4. Open Serial assistant software, set it
  • 波特率(Baud rate):115200
  • 数据位(Data bits):8
  • 停止位(Stop bits):1
  • 校验位(Parity):None
  • 流控制(Flow control):None
5. Check "HEX发送” and “HEX显示”
PN532 NFC HAT.jpg
6. Select correct serial port and open
7. Send data below to wake up FN532 module:
55 55 00 00 00 00 00 00 00 00 00 00 00 00 00 00 FF 03 FD D4 14 01 17 00

(Please refer to PN532 User Manual HSU wake up condition Chapter)

The response from PN532 module should be:

00 00 FF 00 FF 00 00 00 FF 02 FE D5 15 16 00
8. Send data below to scan Mifare Classic card(The blue card provided, hereafter called as "card")
00 00 FF 04 FC D4 4A 01 00 E1 00

Closing card to coil part of module, module scan it and response:

00 00 FF 0C F4 D5 4B 01 01 00 04 08 04 XXXXXXXXXX 00

XXXXXXXXXX in response data is ID (3 bytes) and checksum (1 byte) of card.(Please refer to PN532 User Manual InListPassiveTarget Chapter)

Using demo codes

PN532 NFC HAT supports UART, I2C and SPI interface. You can use them according to your situation.After connecting PN532 NFC HAT (hereafter called as PN532) to Raspberry PI, then set the L1, L0 jumpers and DIP switch for different interfaces.

Choose the interface:

  • UART:By default, UART interface of Raspberry Pi is used for Sheell debugging. If you use serial port for degbugging, you need to add an USB to TTL module for communicating just like what we do on #Quick testing. In this case, the serial port is mapped as ttyUSB0 instead of ttyS0
  • I2C: Raspberry Pi doesn't supports I2C Clock Stretching. However, PN532 may use Clock Stretching (slaver pull-down SCL pin of I2C interface). Clock Stretching cause that Raspberry Pi cannot control all I2C devices, therefore, if you need to connect other i2C device, we do not recommend you to use I2C interface.
  • SPI:We use D4 (BCM) pin as Chip select pin of SPI interface. Take care about GPIO conflict.

Raspberry Pi examples

Download demo code from #Resources, unzip and copy raspberrypi folder to /home/pi of Raspberry Pi. You can firstly copy it to /boot of SD card, then copy it to /home/pi.

SPI Interface

1. Set L0 toL and L1 to H by jumpers

2. Connect RSTPDN->D20 by jumper

3. Set DIP switch to

SCKMISOMOSINSSSCLSDARXTX
ONONONONOFFOFFOFFOFF


4. Connect PN532 NFC HAT to Raspberry Pi

Connect PN532 NFC HAT to Raspberry Pi via SPI interface
PN532 NFC HATRaspberry Pi (BCM)
SCKSCK
MISOMISO
MOSIMOSI
NSSP4 (D4)

5. Enable SPI interface

Open Terminal of Raspberry Pi,use command: sudo raspi-config

Choose Interfacing Options -> SPI -> Yes

6. Run demo codes(Use example_get_uid.py and rpi_get_uid.c as example)

Open Terminal, navigate to directory of demo codes

cd ~/raspberrypi/

1) python code:

Enter directory of python codes: cd ~/raspberrypi/python/

Modify example_get_uid.py file,set the initialize code as :

pn532 = PN532_SPI(debug=False, reset=20, cs=4)
#pn532 = PN532_I2C(debug=False, reset=20, req=16)
#pn532 = PN532_UART(debug=False, reset=20)

Save after modifying, then run the codes with command:

python3 example_get_uid.py

2) C codes:

Enter directory of c code: cd ~/raspberrypi/c/example/

Modify rpi_get_uid.c file, set initialize code as:

PN532_SPI_Init(&pn532);
//PN532_I2C_Init(&pn532);
//PN532_UART_Init(&pn532);

Save and compile:sudo make

Run the code:

./rpi_get_uid.exe

7. Expected result:Close card to coil part of PN532, the UID of card is read

UART interface

1. Set L0 to L and L1 to L by jumpers

2. Connecting RSTPDN ->D20 by jumper

3. Set DIP switch to

SCKMISOMOSINSSSCLSDARXTX
OFFOFFOFFOFFOFFOFFONON


4. Connect PN532 to Raspberry Pi

Connect PN532 NFC HAT to Raspberry Pi via UART interface
PN532 NFC HATRaspberry Pi
RXTX
TXRX

5. Enable Serial port. By default, the serial port is used for Shell debugging.

Open Terminal of Raspberry PI and run command: sudo raspi-config

Choose Interfacing Options-> Serial -> No -> Yes

【Note】You need to restart Raspberry Pi after enabling serial port

6. Run demo codes(Use example_get_uid.py and rpi_get_uid.c as examples)

Open Terminal and navigate to directory of demo codes:

cd ~/raspberrypi/

1) python code:

Enter directory of python code: cd ~/raspberrypi/python/

Modify example_get_uid.py file, set initialize code to:

#pn532 = PN532_SPI(debug=False, reset=20, cs=4)
#pn532 = PN532_I2C(debug=False, reset=20, req=16)
pn532 = PN532_UART(debug=False, reset=20)

Save.Then run code by command:

python3 example_get_uid.py

2) C code:

Enter directory of c code:cd ~/raspberrypi/c/example/

Modify rpi_get_uid.c file, set initialize code to:

//PN532_SPI_Init(&pn532);
//PN532_I2C_Init(&pn532);
PN532_UART_Init(&pn532);

Save then compile code: sudo make

Run code:

./rpi_get_uid.exe

7. Expected result:Close card to coil part of PN532, the UID of card is read

If demo code of UART run failed, you can test serial port by this example
cd ~/raspberrypi/python/
python3 example_uart_hex.py

Enter data and sent, data sent and received should be printed on terminal as expected. e.g. sent data below to wake up PN532:

55 55 00 00 00 00 00 00 00 00 00 00 00 00 00 00 FF 03 FD D4 14 01 17 00

The response data should be:

00 00 FF 00 FF 00 00 00 FF 02 FE D5 15 16 00
I2C interface

1. Set L0 as H, L1 as L by jumpers

2. Connect RSTPDN ->D20 and INT0 -> D16(avoid from Clock Stretching) by jumpers

3. Set DIP switch to

SCKMISOMOSINSSSCLSDARXTX
OFFOFFOFFOFFONONOFFOFF


4. Connect PN532 to Raspberry Pi

Connect PN532 NFC HAT to Raspberry Pi via I2C interface
PN532 NFC HATRaspberry Pi
SCLSCL
SDASDA

5. Enable I2C interface

Open Terminal of Raspberry Pi and run command: sudo raspi-config

Choose Interfacing Options-> I2C -> Yes


6. Run code(Use example_get_uid.py and rpi_get_uid.c as examples)

Open ternimal and navigate to directory of demo codes:

cd ~/raspberrypi/

1) python code:

Enter directory of python code: cd ~/raspberrypi/python/

Modify example_get_uid.py file, set initialize code to:

#pn532 = PN532_SPI(debug=False, reset=20, cs=4)
pn532 = PN532_I2C(debug=False, reset=20, req=16)
#pn532 = PN532_UART(debug=False, reset=20)

Save, then run code

python3 example_get_uid.py

2) C code:

Enter directory of c code:cd ~/raspberrypi/c/example/

Modify rpi_get_uid.c file, set initialize code to:

//PN532_SPI_Init(&pn532);
PN532_I2C_Init(&pn532);
//PN532_UART_Init(&pn532);

Save then compile codes:sudo make

Run code:

./rpi_get_uid.exe

7. Expected result:Close card to coil part of PN532, the UID of card is read

Arduino examples

1. Make sure that you have installed Arduino IDE in your PC

2. Create a new folder in ...\Arduino\libraries (Installation directory of Arduino IDE) and named it as pn532

3. Copy files pn532.c, pn532.h, pn532_uno.cpp and pn532_uno.h to ...\Arduino\libraries\pn532 from Arduino demo codes

4. Demo codes is under examples\arduino (demo codes you download) directory

5. Herein we take Arduino UNO board as example

SPI interface

1. Set L0 to L and L1 to H by hy jumpers

2. Set DIP switch to:

SCKMISOMOSINSSSCLSDARXTX
ONONONONOFFOFFOFFOFF

3. Connect PN532 NFC HAT to Arduino UNO:

Connect PN532 NFC HAT to Arduino UNO via SPI interface
PN532 NFC HATArduino UNO
SCKD13
MISOD12
MOSID11
NSSD4


4. Run codes(Use examples\arduino\uno_get_uid\ uno_get_uid.ino as examples):

Open uno_get_uid.ino file, set initialize code to:

PN532_SPI_Init(&pn532);
//PN532_I2C_Init(&pn532);

Compile and upload codes to Arduino UNO

Open Serial monitor, press Reset button of Arduino Uno to reset

5. Expected result: close card to coil part of PN532, the UID of card is read and printed.

I2C interface

1. Set L0 to L and L1 to H by jumpers

2. Set DIP switch to

SCKMISOMOSINSSSCLSDARXTX
OFFOFFOFFOFFONONOFFOFF

3. Connect PN532 NFC HAT to Arduino UNO

Connect PN532 NFC HAT to Arduino UNO via I2C interface
PN532 NFC HATArduino UNO
SCLA5
SDAA4


4. Run code(Use examples\arduino\uno_get_uid\ uno_get_uid.ino as example):

Open uno_get_uid.ino file, set initialize code to:

//PN532_SPI_Init(&pn532);
PN532_I2C_Init(&pn532);

Compile and upload codes to Arduino UNO board

Open Serial monitor, press Reset button of Arduino UNO board to reset.

5. Expected result: close card to coil part of PN532, the UID of card is read and printed.

STM32 example

The development board used here is Open103C which is based on STM32F103CBT6.

Download project

1. Open project by keil software(...\MDK-ARM\pn532_stm32.uvprojx),Click Rebuild to compile project.

2. Choose programmer:Options for Target -> Debug-> Use,default: ST-Link Debugger。

3. Choose download method:Options for Target -> Debug选项卡 -> Settings -> Debug -> Port,Default: JTAG.

4. Connect Open board to PC by programmer. Note that you should power Open board separately.

5. Click Download to download project.

Hardware connection

SPI connection

1. Set L0 to L and L1 to H by jumpers

2. Set DIP switch to

SCKMISOMOSINSSSCLSDARXTX
ONONONONOFFOFFOFFOFF

3. Connect PN632 to Open103C board

Connect PN532 NFC HAT to STM32F via SPI interface
PN532 NFC HATSTM32F103CBT6
SCKPA5
MISOPA6
MOSIPA7
NSSPA4


I2C connection

1. Set L0 to H and L1 to L by jumpers

2. Set DIP switch to

SCKMISOMOSINSSSCLSDARXTX
OFFOFFOFFOFFONONOFFOFF

3. Connect PN632 to Open103C board

Connect PN532 NFC HAT to STM32F via I2C interface
PN532 NFC HATSTM32F103CBT6
SCLPB6
SDAPB7
Software setting

Open project and choose the interface according to interface used. recompile and download

// PN532_SPI_Init(&pn532);
PN532_I2C_Init(&pn532);

4. Connect USB to TTL module to UART1 interface (PA9->RX, PA10->TX) of STM32 and PC.

5. Open serial assistant software, and reset Open103C

6. Expected result: close card to coil part of PN532, the UID of card is read and printed.

Description of examples

Examples above are used to read UID of Mifare Classic card (example_get_uid.py / rpi_get_uid.exe / uno_get_uid.ino / stm32_get_uid), here we describe other examples.

【Note】

Before run the examples, you should set the L0/L1 pins and DIp switch according to interfaces used. You cannot set all the pins to ON,it will cause that data received are wrong. Here we take 0 is OFF and 1 is ON

  • UART interface:Set jumpers [L1..L0] as LL,set DIP switch to 00000011
  • I2C interface: Set jumpers [L1..L0] as LH, set DIP switch to 00001100.
  • SPI interface: Set jumpers [L1..L0] as HL, set DIP switch to 11110000.

Read Mifare Classic card

ExamplesHardware platform
example_dump_mifare.pyRaspberry Pi
rpi_dump_mifare.cRaspberry Pi
uno_dump_mifare.inoArduino UNO
stm32_dump_mifare/MDK-ARM/pn532_stm32.uvprojxSTM32F103CBT6


Expected result:Close the Mifare Classic card to PN532 NFC HAT, the data in card are printed:

0 : 37 F9 20 69 87 08 04 00 62 63 64 65 66 67 68 69
1 : 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
2 : 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
3 : 00 00 00 00 00 00 FF 07 80 69 FF FF FF FF FF FF
4 : 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
5 : 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
6 : 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
7 : 00 00 00 00 00 00 FF 07 80 69 FF FF FF FF FF FF
8 : 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
9 : 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
10 : 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
11 : 00 00 00 00 00 00 FF 07 80 69 FF FF FF FF FF FF
… …
63 : 00 00 00 00 00 00 FF 07 80 69 FF FF FF FF FF FF

Note:

  • Data of every row are related to every block of card
  • First 4 bytes of block 0 are UID of Mifare Classic card, fifth byte is parity bit. It is checksum of the first 4 bytes.
  • Block 0 (UID) of classic card cannot be modified.
  • Every sector have four blocks, these four blocks use same password. For example, blocks 4N~4N+3 belong to same sector.
  • Block 4N+3 is cipher block, that is if you want to read the data of blocks 4N~4N+2, you must use cipher of block 4N+3.
  • The car has 64 blocks in total, which is 1K.

e.g. To read block 6, we need to use cipher of the related sector, that is the data of block 7.

7 : 00 00 00 00 00 00 FF 07 80 69 FF FF FF FF FF FF

The first six bytes are KEY A, it is default FF FF FF FF FF FF, if you read it, the data response would be 00 00 00 00 00 00. The last six bytes are KEY B saved in plaintext. KEY A and KEY B of Mifare Classic card are default FF FF FF FF FF FF.

Four bytes in the middle are Access Bits, default FF 07 80 69. Access Bits are used for controlling access permission, it will be locked if user write wrong data to them.

PN532 NFC HAT-6.png

For example, if you write 0xFF to byte 6, high four bits of byte 7 should be 0b0000,low four bits of byte 8 should be 0b0000. For more details, please refer to Access conditions for data blocks section of MF1S50YYX_V1.pdf

The card provided can be unlock by "back door" leaved, however, if you use common Mifare card, once you write wrong data to Access Bits, the card will be locked and unable to restore. Be careful when you writing card

Read/Write Mifare Classic

ExamplesHardware Platform
example_rw_mifare.pyRaspberry Pi
rpi_rw_mifare.cRaspberry Pi
uno_rw_mifare.inoArduino UNO
stm32_rw_mifare/MDK-ARM/pn532_stm32.uvprojxSTM32F103CBT6


Expected result: Close Mifare Classic card to PN532 NFC HAT, block 6 will be written with data 00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F.

Note:

  • Before you write the block 6, you should make sure that the cipher of block 6 is 0xFF FF FF FF FF FF, which are the first six bytes of block 7.
  • If you want to modify examples and try to write block N+3, you much be careful and remember the cipher. Because that N+3 is cipher block, once you forget the cipher, you should not access block N~N+2 any more.

Read NTAG2XX card

ExamplesHardware plaftform
example_dump_ntag2.pyRaspberry Pi
rpi_dump_ntag2.cRaspberry Pi
uno_dump_ntag2.inoArduino UNO
stm32_dump_ntag2/MDK-ARM/pn532_stm32.uvprojxSTM32F103CBT6

Expected result: Close Ntag215 card to PN532 NFC HAT, data of the card will be printed

0: 04 85 32 3b
1: 92 a8 64 80
2: de 48 00 00
3: e1 10 3e 00
4: 03 00 fe 00
5: 00 00 00 00
6: 00 00 00 00
7: 00 00 00 00
… …
134: 00 00 00 00

Note:

  • Ntag215 card should be purchase separately.
  • Page of Ntag215 card just like blocks of Mifare card.
  • The first three bytes of page 0 is UID0~UID2 of Ntag215 card, the fourth byte is parity bits, it is checksum of the first three bytes and 0x88 (Cascade Tag).
  • Page 1 are UID3 ~ UID6 of card.
  • The first byte of Page 2 is parity bit, it is checksum (Xor) of UID3 ~ UOD6.

Read/Write NTAG2XX Card

ExamplesHardware platform
example_rw_ntag2.pyRaspberry Pi
rpi_rw_ntag2.cRaspberry Pi
uno_rw_ntag2.inoArduino UNO
stm32_rw_ntag2/MDK-ARM/pn532_stm32.uvprojxSTM32F103CBT6

Expected result: Close Ntag215 card to PN532 NFC HAT, data 00 01 02 03 are written to Page 6.

Note:

  • The last two bytes of Page 2 are used for flag and lock page from 03h to 0Fh, set them to read-only mode. This operation is not reversible. Please take care about it when you try to write the page. For more details, please refer to Static lock bytes (NTAG21x) Section of NTAG213/215/216 file.
PN532 NFC HAT-7.png
  • If you want to lock data of pages after Page 10h, you should write corresponding addresses to first three bytes of Page 28h (Ntag213), Page 82h (Ntag215) or Page E2h(Ntag216).For details, please refer to Dynamic Lock Bytes Section of NTAG213/215/216 file.
PN532 NFC HAT-8.png
  • About more functions of Ntag2xx car please refer to NTAG213/215/216 manual.

Write GPIO of PN532

ExamplesHardware platform
example_write_gpio.pyRaspberry Pi
rpi_write_gpio.cRaspberry Pi
uno_write_gpio.inoArduino UNO
stm32_write_gpio/MDK-ARM/pn532_stm32.uvprojxSTM32F103CBT6

Expected result: Print status of PN532's GPIO

Pin P30: 1
Pin P31: 0
Pin P32: 1
Pin P33: 0
Pin P34: 1
Pin P35: 0
Pin P71: 0
Pin P72: 1
Pin I0: 1
Pin I1: 0

Note:

Examples will set GPIO:P30 -> HIHG,P31 -> LOW,P33 -> LOW,P35 -> LOW,P71 -> LOW,P72 -> HIGH

Note:

  • P32 is int0, once it is set to LOW, PN532 is reset.
  • P34 is SIC_CLK, it is always High when you read it
  • P71 is MISO, it is High when you set PN532 to SPI mode.
  • P72 is SCK,it is High when you set PN532 to SPI Mode.
  • When powering, PN532 will set communication mode according to L0/L1. After setting, you can remove jumpers and use them as GPIO.

The states of PIN P30 -- P35 will be set to Hihg after hardware reset (RSTPDN is set to Low for 2s and then set to High)

Read GPIO of PN532

ExamplesHardware platform
example_read_gpio.pyRaspberry Pi
rpi_read_gpio.cRaspberry Pi
uno_read_gpio.inoArduino UNO
stm32_read_gpio/MDK-ARM/pn532_stm32.uvprojxSTM32F103CBT6

Expected result: Print states of PN532's GPIO

Port P3: 0x3f
Port P7: 0x07
Port I: 0x07
Pin P30: 1
Pin P31: 1
Pin P32: 1
Pin P33: 1
Pin P34: 1
Pin P35: 1
Pin I0: 1
Pin I1: 0

Note:

The states of PIN P30 -- P35 will be set to Hihg after hardware reset (RSTPDN is set to Low for 2s and then set to High)

Resources

Documents

Demo codes