Advertisement

Quick Links

UG10068
PN7220 – Quick start guide
Rev. 2.0 — 4 April 2024
Document information
Information
Keywords
Abstract
Content
PN7220, Android, NFC Forum, EMVCo
This document describes the PNEV7220BP1 and PNEV7220BP2 and how to use it.
User guide

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the PN7220 and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Summary of Contents for NXP Semiconductors PN7220

  • Page 1 UG10068 PN7220 – Quick start guide Rev. 2.0 — 4 April 2024 User guide Document information Information Content Keywords PN7220, Android, NFC Forum, EMVCo Abstract This document describes the PNEV7220BP1 and PNEV7220BP2 and how to use it.
  • Page 2: Introduction

    PN722x evaluation kit for reference implementation. Note: Throughout this document, PN7220 and PN7221 may be referred to as "PN722x". Both NFC controllers posses a similar set of features, while PN7221 also includes the Enhanced Contactless Polling (ECP) protocol by Apple.
  • Page 3: General Description Of Pn722X

    UG10068 NXP Semiconductors PN7220 – Quick start guide 2 General description of PN722x PN722x is a complete NFC controller solution with an integrated FW and NCI interface, designed for contactless communication at 13.56 MHz and contact interface via TDA. It is a solution for quickly integrating NFC technology into other applications, especially using Android OS.
  • Page 4: Pnev722Xbpx Integration Steps

    UG10068 NXP Semiconductors PN7220 – Quick start guide 3 PNEV722xBPx integration steps This chapter explains how to combine i.MX M8 (Nano, Mini, ULP) boards and PNEV722xBPx. The first section Section 3.1 "Hardware description" describes the hardware on all three variants of i.MX 8M, PNEV722XBP1, and PNEV722XBP2.
  • Page 5: I.mx 8M Nano And Mini

    UG10068 NXP Semiconductors PN7220 – Quick start guide 3.1.1 i.MX 8M Nano and Mini An i.MX 8M Nano and Mini can be connected to PNEV722xBPx via J1003 (highlighted in red in Figure 1 Figure Table 1 describes the connections between PNEV722xBPx and both variants of i.MX 8M.
  • Page 6 UG10068 NXP Semiconductors PN7220 – Quick start guide To power up the i.MX 8M Nano and Mini, use USB-C (highlighted in green in Figure 1 Figure 2). For connecting the board to the PC, use USB-C (highlighted in blue in...
  • Page 7: I.mx 8M Ulp

    UG10068 NXP Semiconductors PN7220 – Quick start guide 3.1.2 i.MX 8M ULP The board can be connected to PNEV722xBPx via an Arduino Interface J20 (highlighted in red in Figure 4). To power the ULP board, use P1 (highlighted in blue in Figure 3).
  • Page 8 UG10068 NXP Semiconductors PN7220 – Quick start guide To switch between flashing Android and running Android, hardware changes are necessary. SW5 (highlighted in red in Figure 3) is used for switching. Note: When changing switches, the board must be powered off.
  • Page 9: Pnev722Xbp1

    UG10068 NXP Semiconductors PN7220 – Quick start guide 3.1.3 PNEV722xBP1 Figure 5 shows PNEV722xBP1 board. To power up a board either via USB-C (J7) or directly from DH. The NXP recommendation is to connect the power supply via USB-C. To switch between power supply options, J5 must be changed as follows: 1.
  • Page 10 UG10068 NXP Semiconductors PN7220 – Quick start guide Figure 6 shows J43 (highlighted in red), which can be used to connect board with i.MX 8M boards. Figure 6. PNEV722xBP1 back To switch between 1.8V and 3.3V for VDDIO_SEL, change the solder jumper to 1-3 (3.3V) or 1-2 (1.8V).
  • Page 11: Pnev722Xbp2

    1-2 CONNECTED HOST_SEL0 (J63) 1-2 CONNECTED CONNECTED CONNECTED PN7220 IC can be found on the module board (yellow square in Figure 7). Red square on Figure 7 shows K82, which exists only on the PNEV722xBP2 board. To flash it, use a debugger like J-Link and connect it to J35...
  • Page 12 UG10068 NXP Semiconductors PN7220 – Quick start guide Figure 7. PNEV722xBP2 Front Red square on Figure 8 shows J43, which can be used to connect board with i.MX 8M boards. Figure 8. PNEV722xBP2 Back To switch between 1.8V and 3.3V for VDDIO_SEL, change the solder jumper to 1-3 (3.3V) or 1-2 (1.8V).
  • Page 13: Software Description

    UG10068 NXP Semiconductors PN7220 – Quick start guide 3.2 Software description PN722x supports the NCI 2.2 interface, which is suitable for use with the Android OS. NXP provides changes in AOSP source code and patches. In general NXP provides changes in AOSP code, so that the code is compliant with PN722x features.
  • Page 14: Environment Setup

    UG10068 NXP Semiconductors PN7220 – Quick start guide 4 Environment setup The following subsections provide instructions on how to prepare an environment on Windows and Linux. 4.1 Windows environment setup To enable ADB ([3]) on a Windows computer, additional tools must be installed.
  • Page 15 UG10068 NXP Semiconductors PN7220 – Quick start guide 3. After downloading, extract the folder and add "adb.exe" and "fastboot.exe" to the path (see Figure 11 Figure 12). Figure 11. Unzip platform-tools Figure 12. Add adb.exe and fastboot.exe UG10068 All information provided in this document is subject to legal disclaimers.
  • Page 16 UG10068 NXP Semiconductors PN7220 – Quick start guide Instructions for adding tools to the path can be found under this link: [5]. After install the win-usb driver, follow the instructions below: 1. Choose the driver from the webpage (see Figure 13).
  • Page 17 UG10068 NXP Semiconductors PN7220 – Quick start guide After the steps are completed, an i.MX 8M Nano/Mini/ULP can be connected to the computer. In the Device Manager, check if the device appears in the list. The goal is to have the device listed as an Android device (Figure 16).
  • Page 18 UG10068 NXP Semiconductors PN7220 – Quick start guide 3. Click: "Let me pick from a list of available drivers on my computer" (see Figure 19). Figure 19. Let me pick from a list of available drivers on my computer 4. Select "Android device" (see Figure 20).
  • Page 19 UG10068 NXP Semiconductors PN7220 – Quick start guide 5. Select "Android Composite ADB Interface" (see Figure 21). Figure 21. Android Composite ADB Interface 6. Click "Yes" (Figure 22). Figure 22. Click Yes The next step is flashing the i.MX 8M with Android images.
  • Page 20: Linux Environment Setup

    UG10068 NXP Semiconductors PN7220 – Quick start guide 4.2 Linux environment setup Reference Linux version: Ubuntu 22.04.2 LTS. On Linux, preparing the environment can be achieved with the following the steps to add adb and fastboot support: 1. Download zip from 2.
  • Page 21: Installing Prebuild Images

    UG10068 NXP Semiconductors PN7220 – Quick start guide 5 Installing prebuild images Prebuild images can be downloaded from [16]. On the webpage, click "Design Resources" (Figure Figure 23. Design resources After clicking this button, the page automatically scroll to the "Design Resources" section. In this section, look for the "Software"...
  • Page 22 Section 3.1.2 4. Run the following command: ./uuu_imx_android_flash.bat -f imx8mX -a -e -d pn7220 Note: Depend on the I.MX8 board that is used, imx8mX is different (imx8mn = i.MX 8M Nano, imx8mm = i.MX 8M Mini, imx8ulp = I.MX8 ULP) Boards need to be connected shows the expected output.
  • Page 23: Adb Commands Explanation

    UG10068 NXP Semiconductors PN7220 – Quick start guide 6 ADB commands explanation After the images are flashed to the i.MX 8M, and the PNEV722xBPx is connected, adb logs can be used to monitor the communication. To check the communication, a terminal (command prompt on Windows) must be open.
  • Page 24: Test Applications

    UG10068 NXP Semiconductors PN7220 – Quick start guide 7 Test applications At this point, communication between PNEV722xBPx and i.MX 8M should be established. Communication with the card should be working, this can be verified with a adb logcat command. The last step is to use the test applications provided by NXP.
  • Page 25: Test Applications Only For Pnev722Xbp1

    UG10068 NXP Semiconductors PN7220 – Quick start guide 7.1 Test applications only for PNEV722xBP1 This section describes the test applications for the PNEV722xBP1 board, and gives instructions on installation and how to use them. 7.1.1 EMVCo Compliance Execution This application is running an EMVCo loopback application and is part of the release packet:...
  • Page 26: Emvco Mode Switch

    UG10068 NXP Semiconductors PN7220 – Quick start guide 7.1.2 EMVCo Mode Switch This application shows the usage of the Mode Switch API. It does not run any EMVCo loopback application in the background. To test communication when PN722x works in EMVCo mode, use other applications.
  • Page 27 UG10068 NXP Semiconductors PN7220 – Quick start guide Select different technologies and enable the "Use EMVCo" switch. If valid technologies are selected and EMVCo mode is selected, the EMVCo indicator glows with green color, and the NFC indicator glows with red color.
  • Page 28 UG10068 NXP Semiconductors PN7220 – Quick start guide If an error occurs, invalid technologies are selected and EMVCo mode is not activated, the EMVCo indicator is shown in red and the NFC indicator in green. Try again with a different technology combination. See Figure 32 for reference.
  • Page 29: Emvco Ct Test Application

    UG10068 NXP Semiconductors PN7220 – Quick start guide 7.1.3 EMVCo CT test application The application is part of the following release packet [16]: To install it, run: $adb root $adb remount $adb push EMVCoAidlHalTDATest /system/etc/ $adb shell $cd system/etc/ $chmod 0777 EMVCoAidlHalTDATest...
  • Page 30: Emvco Transac Test

    UG10068 NXP Semiconductors PN7220 – Quick start guide 7.1.4 EMVCo Transac test The application is part of the following release package [16]: To install, run: $adb root $adb remount $adb push EMVCoAidlHalTransacTest /system/etc/ $adb shell $cd system/etc/ $chmod 0777 EMVCoAidlHalTransacTest...
  • Page 31: Test Applications Only For Pnev722Xbp2

    UG10068 NXP Semiconductors PN7220 – Quick start guide 7.2 Test applications only for PNEV722xBP2 This section describes the test applications for the PNEV722xBP2 board. It provides instructions for installation and usage. As the BP2 board uses a secure MCU, all EMVCo related applications are executed on this secure MCU.
  • Page 32: Combined Test Applications

    PN7220 – Quick start guide 7.3 Combined test applications Applications in this section can be used with both variants of the boards, PN7220 and PN7221. 7.3.1 DTA application This application is responsible for runningning the NFC Forum compliance test. It can be found under [16].
  • Page 33: Nfctdatest

    UG10068 NXP Semiconductors PN7220 – Quick start guide • The RF technology tabs allow selecting individually each technology for each possible mode. • The "LLCP" field allows enabling specific "Pattern Number" for dedicated test execution. • The "SNEP" field allows running dedicated tests, requiring also the "Android Beam" feature been enabled in the Android device settings.
  • Page 34 UG10068 NXP Semiconductors PN7220 – Quick start guide In the pop-up, click "next" until the application is not open. Check Figure Figure 40. Follow the instructions UG10068 All information provided in this document is subject to legal disclaimers. © 2024 NXP B.V. All rights reserved.
  • Page 35 UG10068 NXP Semiconductors PN7220 – Quick start guide Click "DISCOVER TDA" to find the smart card connected over TDA. The button changes the color to green and the text to "TDA_DISCOVER_DONE". Check Figure Figure 41. Discover connected smart cards over TDA UG10068 All information provided in this document is subject to legal disclaimers.
  • Page 36 UG10068 NXP Semiconductors PN7220 – Quick start guide Select the SAM slot and click "OPEN TDA". See Figure Figure 42. Open a specific SAM slot UG10068 All information provided in this document is subject to legal disclaimers. © 2024 NXP B.V. All rights reserved.
  • Page 37 UG10068 NXP Semiconductors PN7220 – Quick start guide Send the APDU to Contact card using send "SEND APDU". See Figure Figure 43. Send APDU to contact card UG10068 All information provided in this document is subject to legal disclaimers. © 2024 NXP B.V. All rights reserved.
  • Page 38 UG10068 NXP Semiconductors PN7220 – Quick start guide The TDA can be closed with the "CLOSE TDA" button. See Figure Figure 44. Close TDA UG10068 All information provided in this document is subject to legal disclaimers. © 2024 NXP B.V. All rights reserved.
  • Page 39: Other Useful Applications

    UG10068 NXP Semiconductors PN7220 – Quick start guide 7.3.3 Other useful applications Other NXP applications can also be used, for example: • TagInfo Application • TagWriter Application • CTS Verifier Application The TagInfo and TagWriter application can be installed through the Android Play Store.
  • Page 40: Nfc Cockpit

    UG10068 NXP Semiconductors PN7220 – Quick start guide 7.3.4 NFC Cockpit PN722x is the first NXP NCI-based controller that supports the NFC Cockpit tool. It can be downloaded from [15]. Install the NFC Cockpit and follow the instructions below to run the NFC Cockpit with PN722x: Note: Support started from NFC Cockpit version 8.0.0...
  • Page 41 UG10068 NXP Semiconductors PN7220 – Quick start guide 3. Enter: cd system/bin 4. Enter the command below (see Figure 47 for expected output): pnscr true Figure 47. Run pnscr 5. Open the NFC Cockpit application on the PC and start using it.
  • Page 42: Firmware Update

    UG10068 NXP Semiconductors PN7220 – Quick start guide 8 Firmware update The firmware (FW) update procedure is different between both use cases of PN722x. On a single host (PNEV722xBP1), the firmware update is done via the Android host. In dual host (PNEV722xBP2), the firmware update must be performed via a secure MCU.
  • Page 43 UG10068 NXP Semiconductors PN7220 – Quick start guide Checking if FW has been successfully update: Save the adb logs, as described in Section 6, then open the log file and search for "FW". Figure 48 shows the relevant parts and the current version of FW.
  • Page 44 UG10068 NXP Semiconductors PN7220 – Quick start guide By default in libnfc-nxp.conf , the FW update is blocked with the flag. To enable the FW update, the following steps must be performed: 1. Open the command prompt 2. Run the following command: adb pull /vendor/etc/libnfc-nxp.conf...
  • Page 45: Dual Host

    UG10068 NXP Semiconductors PN7220 – Quick start guide 8.2 Dual host FW update is executed via a secure MCU. NXP provides the NciLib ([17]) and "Secure MCU mode switch" application to show how to perform FW update on a dual host with PNEV722xBP2 board. For more information on how to run the applications, refer to [13].
  • Page 46: Configuration Files

    UG10068 NXP Semiconductors PN7220 – Quick start guide 9 Configuration files Using configuration files, settings can be changed on PN722x. Five configuration files can be stored to a specific location on DH. Table 8. Configuration file and location Configuration filename Location on DH libemvco-nxp.conf...
  • Page 47: Abbreviations And Acronyms

    UG10068 NXP Semiconductors PN7220 – Quick start guide 10 Abbreviations and acronyms Table 9. Abbreviations Acronym Description hardware Software Operating System Mega Hertz Near Field Communication Near Field Communication Controller Interface Firmware MiddleWare Device Host Volt AOSP Android Open Source Project...
  • Page 48: References

    PN7220 – Quick start guide 11 References Web page – PN7220 – EMV L1 Compliant NFC Controller with NCI Interface Supporting EMV and NFC Forum Applications (link) Datasheet – PN7220 – EMV L1 Compliant NFC Controller with NCI Interface Supporting EMV and NFC Forum Applications (link) Resources –...
  • Page 49: Radio Equipment Directive (Red)

    UG10068 NXP Semiconductors PN7220 – Quick start guide 12 Radio Equipment Directive (RED) The following information is provided per Article 10.8 of the Radio Equipment Directive 2014/53/EU: (a) Frequency bands in which the equipment operates. (b) The maximum RF power transmitted.
  • Page 50: Note About The Source Code In The Document

    UG10068 NXP Semiconductors PN7220 – Quick start guide 13 Note about the source code in the document Example code shown in this document has the following copyright and BSD-3-Clause license: Copyright 2023-2024 NXP Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1.
  • Page 51: Revision History

    UG10068 NXP Semiconductors PN7220 – Quick start guide 14 Revision history Table 11. Revision history Document ID Release date Description UG10068 v.2.0 04 April 2024 • Section 3 "PNEV722xBPx integration steps" updated. • Section 5 "Installing prebuild images" updated. • Section 7 "Test applications "...
  • Page 52: Legal Information

    NXP Semiconductors. In the event that customer uses the product for design-in and use in In no event shall NXP Semiconductors be liable for any indirect, incidental, automotive applications to automotive specifications and standards, punitive, special or consequential damages (including - without limitation - customer (a) shall use the product without NXP Semiconductors’...
  • Page 53 NXP accepts no liability for any vulnerability. Customer should those standards. Purchase of NXP Semiconductors IC does not include a regularly check security updates from NXP and follow up appropriately.
  • Page 54 UG10068 NXP Semiconductors PN7220 – Quick start guide Tables Tab. 1. i.MX 8M Nano and Mini connections to Tab. 5. PNEV722xBP1 default jumper settings ..... 9 PNEV722xBPx ..........5 Tab. 6. PNEV722xBP2 default jumper settings ... 11 Tab. 2. i.MX 8M Nano and Mini extended Tab.
  • Page 55: Table Of Contents

    UG10068 NXP Semiconductors PN7220 – Quick start guide Contents Introduction ............2 General description of PN722x .......3 PNEV722xBPx integration steps ....4 Hardware description .........4 3.1.1 i.MX 8M Nano and Mini ........5 3.1.2 i.MX 8M ULP ............. 7 3.1.3 PNEV722xBP1 ...........9 3.1.4...

Table of Contents