NXP Semiconductors OM5579 User manual

AN11841
PN7150 Arduino SBC kit quick start guide
Rev. 1.6 — 14 June 2021 Application note
373016 COMPANY PUBLIC
Document information
Information Content
Keywords OM5579, PN7150, Arduino, MCUXpresso, UDOO, LPC, Kinetis, NFC, P2P,
card emulation, Linux, Android, NullOS, RTOS
Abstract This document gives a description on how to get started with the OM5579
PN7150 NFC controller SBC kit on boards featuring Arduino compatible
header.

NXP Semiconductors AN11841
PN7150 Arduino SBC kit quick start guide
1 Revision history
Rev Date Description
1.6 20210614 Moved to OM5579 because of OM5578 discontinuation
1.5 20181112 Updated with MCUXpresso project reference
1.4 20180725 Updated weblinks
1.3 20170222 Updated demo images weblinks
1.2 20160819 Added Android Marshmallow demo
1.1 20160620 Added Android NFC demo on UDOO Neo
1.0 20160518 First official release
Revision history
AN11841 All information provided in this document is subject to legal disclaimers. © NXP B.V. 2021. All rights reserved.
Application note Rev. 1.6 — 14 June 2021
COMPANY PUBLIC 373016 2 / 19

NXP Semiconductors AN11841
PN7150 Arduino SBC kit quick start guide
2 Introduction
This document gives a description on how to get started with the OM5579 PN7150 NFC-
Controller SBC kit on platform featuring Arduino compatible header. This document
provides a step by step guide to the installation procedure of the hardware and the
software. Finally, it shows PN7150 NFC controller functionalities through demonstration
application.
OM5579/PN7150 demonstration kit replaces previous OM5578/PN7150 demonstration
kit now discontinued.
2.1 OM5579/PN7150ARD demo kit
OM5579/PN7150ARD kit is a high performance fully NFC-compliant expansion
board compatible with Arduino Compatible Interface platforms (refer to [1] for more
details). It meets compliance with Reader mode, P2P mode and Card emulation mode
standards. The board features an integrated high-performance RF antenna to insure high
interoperability level with NFC devices.
The demo kit is comprised of a PN7150 NFC controller board, a dedicated interface
board, and an NFC sample card.
+ +
OM5579/PN7150
PN7150 NFC controller board
OM29110ARD-B
Arduino Interface Board
NTAG216
NFC Sample Card
Figure 1. OM5579/PN7150ARD kit overview
The demo kit is fully described in UM10935 document [7].
2.2 Linux driver support
PN7150 NFC controller is supported under GNU/Linux system using the NXP Linux
libnfc-nci software stack delivered through public GitHub repository https://github.com/
NXPNFCLinux/linux_libnfc-nci (for more details, refer to AN11697 [4]).
In Section 3.4, it is described how to run an image with the already integrated driver on
your kit.
2.3 Android driver support
PN7150 NFC controller is supported from the official Android Open Source Project (refer
to [6] for more details) with the addition of dedicated patches (refer to AN11690 [5]).
Section 3.5 describes how to run an image with the already integrated driver on your kit.
AN11841 All information provided in this document is subject to legal disclaimers. © NXP B.V. 2021. All rights reserved.
Application note Rev. 1.6 — 14 June 2021
COMPANY PUBLIC 373016 3 / 19

NXP Semiconductors AN11841
PN7150 Arduino SBC kit quick start guide
2.4 RTOS and Null OS support
Since implementing NFC Forum NCI standardized API, the PN7150 NFC Controller can
be easily integrated into system based on RTOS or even without OS.
Code example is given in the scope of MCUXpresso projects and can easily be ported to
any other system.
AN11841 All information provided in this document is subject to legal disclaimers. © NXP B.V. 2021. All rights reserved.
Application note Rev. 1.6 — 14 June 2021
COMPANY PUBLIC 373016 4 / 19

NXP Semiconductors AN11841
PN7150 Arduino SBC kit quick start guide
3 Quick Startup on UDOO Neo
3.1 Required items
• UDOO Neo [2]
• Compatible MicroSD card of at least 4 Gb memory size (8 Gb for Android demo image)
• Computer (running Windows, Linux or Mac OS X) for SD/MicroSD card installation and
remote access to UDOO Neo
• Micro USB cable to connect UDOO Neo to the computer
• UDOO Neo demo image file (see [8])
• For the Android NFC demo (see Section 3.5) the following items are additionally
required:
•USB mouse
•Micro HDMI cable to connect to Monitor / TV
•UDOO 12 V power supply (Note: the 5 V generated by UDOO Neo board from the
Micro USB is not stable on the Android image. Without the 12 V power supply,
the RF discovery may suddenly stop)
3.2 Hardware preparation
First of all, assemble the PN7150 NFC controller board with the Arduino interface board.
Figure 2. OM5579/PN7150ARD demo kit assembly
Then stacked together the boards with the UDOO Neo.
AN11841 All information provided in this document is subject to legal disclaimers. © NXP B.V. 2021. All rights reserved.
Application note Rev. 1.6 — 14 June 2021
COMPANY PUBLIC 373016 5 / 19

NXP Semiconductors AN11841
PN7150 Arduino SBC kit quick start guide
Figure 3. OM5579/PN7150ARD and UDOO Neo stacked together
Note: The UDOO Neo feature a “two rows” connectors, the demo kit must be plugged in
the inner ones as show in below picture:
Figure 4. OM5579/PN7150ARD and UDOO Neo stacked together - zoom
3.3 Software preparation
The MicroSD needs to store an image specific for the OM5579 Linux or Android NFC
demo. This demo image can be downloaded from [8] and loaded to the MicroSD card,
following the installation guidelines provided here: http://www.udoo.org/docs-neo/
Getting_Started/Create_a_bootable_MicroSD_card_for_UDOO_Neo.html
AN11841 All information provided in this document is subject to legal disclaimers. © NXP B.V. 2021. All rights reserved.
Application note Rev. 1.6 — 14 June 2021
COMPANY PUBLIC 373016 6 / 19

NXP Semiconductors AN11841
PN7150 Arduino SBC kit quick start guide
3.4 Linux NFC demo application
3.4.1 Application details
The demo application uses a part of the Linux libnfc-nci stack available on public GitHub
repository https://github.com/NXPNFCLinux/linux_libnfc-nci. The related source code can
then be found there (more details in document AN11697 [4]).
3.4.2 Starting the application
Start the UDOO Neo board as “USB Headless IoT Device”, by just inserting the Micro-
SD card in the related slot and connect the micro-USB cable to your PC. Be sure to have
installed the right driver specific for the USB connection, refer to http://www.udoo.org/
docs-neo/Basic_Setup/Usb_Direct_Connection.html.
Open a remote session through “Web Control Panel” by browsing to “192.168.7.2” in a
web browser, it should display the UDOO Neo platform dashboard:
Figure 5. UDOO dashboard
Then open a terminal session by clicking on “>_ REMOTE TERMINAL” button.
Note: there is other way to open a remote terminal allowing to run the demo application.
Refer to http://www.udoo.org/docs-neo/Getting_Started/Use_as_a_Computer.html and
http://www.udoo.org/docs-neo/Getting_Started/Use_as_a_headless_IoT_Device.html for
more details.
Log in the terminal using the default credentials:
•Login: udooer
•Password: udooer
AN11841 All information provided in this document is subject to legal disclaimers. © NXP B.V. 2021. All rights reserved.
Application note Rev. 1.6 — 14 June 2021
COMPANY PUBLIC 373016 7 / 19

NXP Semiconductors AN11841
PN7150 Arduino SBC kit quick start guide
Figure 6. UDOO Remote Terminal
Then browse to the Linux libnfc-nci stack directory (refer to Section 2.2 for more details
about the Linux NFC software stack).
$ cd ~/linux_libnfc-nci
The application requires parameters to run:
$ ./nfcDemoApp <OPTIONS>
You can get the parameters details by launching the application help menu:
$ ./nfcDemoApp –-help
Figure 7. Linux demo application parameters
The demo application offers 3 modes of operation:
• Polling: continuously waiting for a remote NFC device (tag or peer device) and
displays related information
• Tag writing: allows writing NDEF content to an NFC tag
• Tag emulation: allows sharing NDEF content to an NFC reader device
AN11841 All information provided in this document is subject to legal disclaimers. © NXP B.V. 2021. All rights reserved.
Application note Rev. 1.6 — 14 June 2021
COMPANY PUBLIC 373016 8 / 19

NXP Semiconductors AN11841
PN7150 Arduino SBC kit quick start guide
• Device push: allows pushing NDEF content to a remote NFC peer device
3.4.2.1 Polling mode
When in this mode, the application displays information of any discovered NFC tags or
remote NFC device. It is reached starting the application with “poll” parameter:
$ ./nfcDemoApp poll
Figure 8. Linux demo application polling mode
3.4.2.2 Device push mode
This mode allows pushing data to a remote NFC device (e.g. an NFC phone). It is
reached using “push” parameter:
$ ./nfcDemoApp push <OPTIONS>
Linux demo application device push mode
You can get more information about the message format using “-h” or “--help” parameter:
$ ./nfcDemoApp push –-help
AN11841 All information provided in this document is subject to legal disclaimers. © NXP B.V. 2021. All rights reserved.
Application note Rev. 1.6 — 14 June 2021
COMPANY PUBLIC 373016 9 / 19

NXP Semiconductors AN11841
PN7150 Arduino SBC kit quick start guide
3.4.2.3 Tag emulation mode
This mode allows emulating an NFC tag (NFC Forum T4T) to share data to a remote
NFC reader (e.g. an NFC phone). It is reached using “share” parameter:
$ ./nfcDemoApp share <OPTIONS>
Figure 9. Linux demo application Tag emulation mode
You can get more information about the message format using “-h” or “--help” parameter:
$ ./nfcDemoApp share –-help
3.4.2.4 Tag writing mode
This mode allows writing data to an NFC tag. It is reached using “write” parameter:
$ ./nfcDemoApp write <OPTIONS>
AN11841 All information provided in this document is subject to legal disclaimers. © NXP B.V. 2021. All rights reserved.
Application note Rev. 1.6 — 14 June 2021
COMPANY PUBLIC 373016 10 / 19