NXP Semiconductors UG10068 User manual

UG10068
PN7220 - Quick start guide
Rev. 1.0 — 11 July 2023 User guide
Document information
Information Content
Keywords PN7220, Android, NFC Forum, EMVCo
Abstract This document describes the PN7220BP1 and how to use it.

NXP Semiconductors UG10068
PN7220 - Quick start guide
Revision history
Rev Date Description
v.1.0 20230711 Initial version
Revision history
UG10068 All information provided in this document is subject to legal disclaimers. © 2023 NXP B.V. All rights reserved.
User guide Rev. 1.0 — 11 July 2023
2 / 32

NXP Semiconductors UG10068
PN7220 - Quick start guide
1 Introduction
This document describes, how to work with PN7220. It leads to find relevant information about HW, antenna
and SW integration, as well as information related to PN7220 evaluation kit for reference implementation.
UG10068 All information provided in this document is subject to legal disclaimers. © 2023 NXP B.V. All rights reserved.
User guide Rev. 1.0 — 11 July 2023
3 / 32

NXP Semiconductors UG10068
PN7220 - Quick start guide
2 General description of PN7220
PN7220 is a complete NFC controller solution, with integrated FW and NCI interface, designed for contactless
communication at 13.56 MHz.
It is the ideal solution for quickly integrating NFC technology into any application, especially for applications
using Android OS.
PN7220 technical details are located in Data Sheet([8]).
UG10068 All information provided in this document is subject to legal disclaimers. © 2023 NXP B.V. All rights reserved.
User guide Rev. 1.0 — 11 July 2023
4 / 32

NXP Semiconductors UG10068
PN7220 - Quick start guide
3 PN7220 Integration steps
3.1 HW description
PN7220 (Figure 1) is close controller and needs DH to control it. At the moment the official DH supported by
PN7220 is Qualcom's DragonBoard 845c (Figure 2), but integration is possible with any other DH.
Figure 1. PN7220 Front
UG10068 All information provided in this document is subject to legal disclaimers. © 2023 NXP B.V. All rights reserved.
User guide Rev. 1.0 — 11 July 2023
5 / 32

NXP Semiconductors UG10068
PN7220 - Quick start guide
Figure 2. DragonBoard 845c Front
The PN7220 is designed to be easily connected to the Dragonboard. Pin header J43 (red square in Figure 2) is
one to one compatible with the Dragonboard LS1(red square in Figure 3).
UG10068 All information provided in this document is subject to legal disclaimers. © 2023 NXP B.V. All rights reserved.
User guide Rev. 1.0 — 11 July 2023
6 / 32

NXP Semiconductors UG10068
PN7220 - Quick start guide
Figure 3. PN7220 Back
On Figure 4, we can see how the boards look, when they are stacked on top of each other.
UG10068 All information provided in this document is subject to legal disclaimers. © 2023 NXP B.V. All rights reserved.
User guide Rev. 1.0 — 11 July 2023
7 / 32

NXP Semiconductors UG10068
PN7220 - Quick start guide
Figure 4. PN7220 on top of Dragonboard 845c
Note: For a proper operation it is required to supply the PNEV7220BP1 via the USB-C connector by 5V/1.5A.
The connected cable is required to provide a ferrite choke.
3.1.1 Dragonboard 845c
To power the board use DC_IN_12V (green square in Figure 2). The Dragonboard must be connected to
computer via the USB-C connector (blue square in Figure 2).
There are 6 switches on the back of the Dragonboard. The default values from 1-6 are ("OFF", "OFF", "OFF",
"OFF", "OFF", "ON").
3.1.2 PN7220
The PN7220 can be powered either via USB-C (red square in Figure 5) or directly from the Dragonboard.
To switch between power supply options, check J5 on the PN7220:
1. When 1-2 connected (external power supply - via USB-C)
2. When 3-4 connected (power supply via Dragonboard)
Refer to Table 1 and/or Figure 5 for the default settings of the PN7220.
Name Default setting
VBAT (J4) CONNECTED
VUP (J1) NOT CONNECTED
VBATPWR (J2) CONNECTED
AUX2AUX1 (J65) NOT CONNECTED
SW_ON (J47) NOT CONNECTED
VBAT_SEL (J3) NOT CONNECTED
EXT_PWR_SEL (J5) 1-2 CONNECTED
Table 1. PN7220 default jumper settings
UG10068 All information provided in this document is subject to legal disclaimers. © 2023 NXP B.V. All rights reserved.
User guide Rev. 1.0 — 11 July 2023
8 / 32

NXP Semiconductors UG10068
PN7220 - Quick start guide
Figure 5. PN7220 default jumper settings
To switch between 1.8 V and 3.3 V for VDDIO_SEL (green square in Figure 5), change the solder jumper to 1-3
(for 3.3 V) or 1-2 (for 1.8 V).
For more details, check Data sheet ([8]).
3.2 Software description
PN7220 supports NCI 2.2 interface, which is perfect for use with Android OS.
NXP provides patches on top of AOSP code. If we want to build AOSP with patches provided by NXP, check [9].
In this quick start guide, we focus on preparing the Windows and Linux environment, using it together with
prebuild Android images, and starting work with PN7220.
UG10068 All information provided in this document is subject to legal disclaimers. © 2023 NXP B.V. All rights reserved.
User guide Rev. 1.0 — 11 July 2023
9 / 32

NXP Semiconductors UG10068
PN7220 - Quick start guide
4 Environment setup
This section, describes how to prepare the environment on Windows or Linux. This is necessary to flash
Android OS to the Dragonboard and to start work with the PN7220.
4.1 Windows environment setup
To enable ADB ([1]) on a Windows computer, we need to install a few things.
For ADB and Fastboot, we need to install the SDK Platform Tools. Follow the next steps:
1. Download platform-tools from [2]
Figure 6. Platform-Tools webpage
2. Accept the terms and conditions and click Download button
Figure 7. Accept&Download
3. After downloading, extract folder and add "adb.exe" and "fastboot.exe" to path
UG10068 All information provided in this document is subject to legal disclaimers. © 2023 NXP B.V. All rights reserved.
User guide Rev. 1.0 — 11 July 2023
10 / 32

NXP Semiconductors UG10068
PN7220 - Quick start guide
Figure 8. Unzip platform-tools
Figure 9. Add adb.exe and fastboot.exe
Instructions for adding tools to path [3].
Now we need to install the win-usb driver. Follow the next steps.
1. Get driver from webpage [4]
Figure 10. win-usb driver webpage
2. Accept the terms and conditions and click Download button
UG10068 All information provided in this document is subject to legal disclaimers. © 2023 NXP B.V. All rights reserved.
User guide Rev. 1.0 — 11 July 2023
11 / 32

NXP Semiconductors UG10068
PN7220 - Quick start guide
Figure 11. Accept terms&conditions and download
3. Extract all and right-click to "android_winusb.inf" and press "Install"
Figure 12. Install driver
After all the steps are completed, we can connect the Dragonboard to the computer. In the Device Manager,
check if the device appers in the list. It could be that the computer does not recognize the Dragonboard as an
Android device when it first starts, but list it under "Other devices" as "Unknown device" or "Android". Check
Figure 13.
Figure 13. Device manager
Install correct driver for device:
1. Right-click to "Unknown device" or "Android" and click "Update driver"
2. "Browse my computer for drivers"
UG10068 All information provided in this document is subject to legal disclaimers. © 2023 NXP B.V. All rights reserved.
User guide Rev. 1.0 — 11 July 2023
12 / 32

NXP Semiconductors UG10068
PN7220 - Quick start guide
Figure 14. Browse my computer for driver
3. Click: "Let me pick from a list of available drivers on my computer"
Figure 15. Let me pick from a list of available drivers on my computer
4. Select "Android device"
UG10068 All information provided in this document is subject to legal disclaimers. © 2023 NXP B.V. All rights reserved.
User guide Rev. 1.0 — 11 July 2023
13 / 32

NXP Semiconductors UG10068
PN7220 - Quick start guide
Figure 16. Android Device
5. Select "Android Composite ADB Interface"
Figure 17. Android Composite ADB Interface
6. Click "Yes"
UG10068 All information provided in this document is subject to legal disclaimers. © 2023 NXP B.V. All rights reserved.
User guide Rev. 1.0 — 11 July 2023
14 / 32

NXP Semiconductors UG10068
PN7220 - Quick start guide
Figure 18. Click Yes
The next step is flashing the Dragonboard with Android images.
4.2 Linux environment setup
Reference Linux version: Ubuntu 22.04.2 LTS.
On Linux, preparing the environment is a bit easier. Follow the steps to add adb and fastboot support:
1. Download zip from [2]
2. Unzip
3. Open terminal and type "sudo nano .bashrc"
4. Add "export PATH=${PATH}:/path/to/adb_fastboot" for example
export PATH=${PATH}:/home/nxp/Downloads/platform-tools
The next step is flashing the Dragonboard with Android images.
UG10068 All information provided in this document is subject to legal disclaimers. © 2023 NXP B.V. All rights reserved.
User guide Rev. 1.0 — 11 July 2023
15 / 32

NXP Semiconductors UG10068
PN7220 - Quick start guide
5 Installing prebuild images
NXP provides prebuild images so that users can work with PN7220 immediately.
The steps we must follow, to install images on Dragonboard:
1. Download zip from [9]
2. Unzip
3. Inside the folder, we can see the following structure
Figure 19. Structure of prebuild images folder
4. In the image folder we can find MW along with the test applications. In the system_image folder, we find the
precompiled Android OS images
5. Connect the Dragonboard to the computer and turn on the board
6. Run system_img_flash.bat (Windows) or system_img_flash.sh (Linux)
After the script is finished, we have a working environment. One of the emulators, that can be used to emulate
Android devices on the computer is Vysor [5].
UG10068 All information provided in this document is subject to legal disclaimers. © 2023 NXP B.V. All rights reserved.
User guide Rev. 1.0 — 11 July 2023
16 / 32

NXP Semiconductors UG10068
PN7220 - Quick start guide
6 ADB commands explanation
After the images are flashed to the Dragonboard, and the PN7220 is connected to it, we can use the adb logs
to monitor the communication. To check the communication, we must open the terminal (command prompt on
Windows).
There is a number of commands, we can use to check if PN7220 and Dragonboard are communicating with
each other. Let us explain the basic adb commands:
• adb devices: this command lists all available devices currently connected to the computer
• fastboot devices: this command lists all available devices in bootloader mode that are connected to the
computer (not required if we use prebuilt images)
• adb logcat: this command prints all logs from Android
• adb shell: this command enter Android device terminal
• adb push: this command pushes files to Android devices. To do this we must root the device and remount it.
This can be done with:
– adb root: to root the device as root user
– adb remount: to remount the device
• adb install: this command will installs any *.apk (for example: TagInfo)
With the commands listed above, we can accomplish numerous things when debugging the setup. One of the
most important commands is adb logcat, but unfortunately it is very hard to get the interesting part. For that we
can combine a few commands:
adb shell
logcat | grep "NxpNci" #his command prints only lines where NxpNci is mentioned.
Check Figure 20.
Instead of NxpNci, the following words can also be used:
• NxpNciX: to get only NFC Forum NCI commands send from DH
• NxpNciR: to get only NFC Forum NCI commands received to DH
• EMVCoNciX: to get only EMVCo profile commands send from DH
• EMVCoNciR: to get only EMVCo profile commands received to DH
•"nfc" or "emvco": with one of these two words, we can get most of interesting parts of logcat.
A words can also be combined like: logcat | grep -i -e emvco -e nxpnci.
Figure 20. Logcat example
UG10068 All information provided in this document is subject to legal disclaimers. © 2023 NXP B.V. All rights reserved.
User guide Rev. 1.0 — 11 July 2023
17 / 32

NXP Semiconductors UG10068
PN7220 - Quick start guide
7 Test applications
At this point, communication between PN7220 and Dragonboard should be established. Communication with
the card should be working, and we can verify this with adb logcat. The last step is to use the test applications
provided by NXP. The test applications can be found in the package located [9] inside image folder. Script
"system_img_flash.bat" (Windows) or "system_img_flash.sh" (Linux) will install test applications by default with
the following commands:
•adb root
•adb remount
•adb push test_app_name /location/location
•adb shell chmod 0777 /location/location => is giving executable access to pushed application
adb root
adb remount
adb push image/EMVCoAidlHalComplianceTest/EMVCoAidlHalComplianceTest system/etc
adb shell chmod 0777 /system/etc/EMVCoAidlHalComplianceTest
If we want to try the application, we have to go to the place where the application is installed. For example, to
run EMVCoAidlHalComplianceTest we need to use the following commands in the terminal:
adb shell
cd system/etc
./EMVCoAidlHalComplianceTest Type AB
The following subsections,describe all test applications provided by NXP. DTA and EMVCo compliance
execution applications are prvided by NXP to enable customer to run NFC Forum compliance or EMVCo
compliance, and are not required for basic functionality testing.
7.1 EMVCo Mode Switch
This application demonstrate, how to switch between NFC Forum and EMVCo modes. Application is already
part of image. To run Android emulation use Vysor [5] or any similar tool. There we can access EMVCo Mode
Switch application. Figure 21 shows deault view of application. By default, NFC mode is active on boot so the
NFC indicate will glow with green color and the EMVCo indicator will glow with red color.
UG10068 All information provided in this document is subject to legal disclaimers. © 2023 NXP B.V. All rights reserved.
User guide Rev. 1.0 — 11 July 2023
18 / 32

NXP Semiconductors UG10068
PN7220 - Quick start guide
Figure 21. EMVCo mode switch application: default view
Select different technologies and enable the "Use EMVCo" switch. If valid technologies are selected and
EMVCo mode is selected, the EMVCo indicator will glow with green color, and NFC indicator will glow with red
color. See Figure 22 for reference.
Figure 22. EMVCo mode switch: EMVCo mode is selected
UG10068 All information provided in this document is subject to legal disclaimers. © 2023 NXP B.V. All rights reserved.
User guide Rev. 1.0 — 11 July 2023
19 / 32

NXP Semiconductors UG10068
PN7220 - Quick start guide
If in-valid technologies are selected and EMVCo mode is not activated, the EMVCo indicator will glow with
red color, and NFC indicator will glow with green color. Try again with different technology combination. See
Figure 23 for reference.
Figure 23. EMVCo mode switch: failure
Steps to disable the EMVCo poll:
•Disable the "Use EMVCo" switch. It will enable NFC.
•EMVCo indicator will glow with red color and the NFC indicator will glow with green color.
7.2 EMVCo compliance execution
This application is also already part of the image. If we want to run it, we must follow next steps:
Open terminal (command prompt on Windows) and run:
adb shell
cd system/etc
./EMVCo AidlHalComplianceTest type AB
Figure 24 shows successful run of test application.
Figure 24. EMVCo compliance execution: Working
If there are invalid parameters passed to the EMVCoAidlHalCompliance application fails. See Figure 25.
UG10068 All information provided in this document is subject to legal disclaimers. © 2023 NXP B.V. All rights reserved.
User guide Rev. 1.0 — 11 July 2023
20 / 32