__________________________________________________
NXPNFCRDLIB EXAMPLE : NFCRDLIBEX8_HCE_T4T
(V07.10.00)
__________________________________________________
Table of Contents
_________________
1 Document Purpose
2 Description of the NfcrdlibEx8_HCE_T4T
3 Restrictions on NfcrdlibEx8_HCE_T4T
4 Configurations of NfcrdlibEx8_HCE_T4T
5 Package Contents
6 Mandatory materials (not included)
7 Hardware Configuration
8 Software Configuration
9 Steps to build NfcrdlibEx8_HCE_T4T for LPC1769 with PN5190 using MCUXpresso
10 Steps to build NfcrdlibEx8_HCE_T4T for LPC1769 with PN5180 using MCUXpresso
11 Steps to build NfcrdlibEx8_HCE_T4T for PN7462AU using MCUXpresso
12 Steps to build NfcrdlibEx8_HCE_T4T for FRDM-K82F using MCUXpresso
13 Selection of Board / OSAL / Frontend (MCUXpresso)
14 Steps to follow for PI / Linux / CMake
15 Running NfcrdlibEx8_HCE_T4T
16 List of supported NFC Reader Boards/ICs
17 Reference Documents
1 Document Purpose
==================
This document describes the steps to be followed to execute
NfcrdlibEx8_HCE_T4T example as well as it's known problems and
restrictions.
2 Description of the NfcrdlibEx8_HCE_T4T
========================================
- NfcrdlibEx8_HCE_T4T can be run with PN5180, PN5190 and PN7462AU.
(See Section-16 for supported versions).
- This example will demonstrate card emulation of type 4A tag (T4AT).
- If any reader device is brought in proximity then this example will
go into card emulation mode.
- In card emulation mode this allows both reading and writing of NDEF
message by reader.
- By default the configured NDEF message is "www.nxp.com".
- The maximum NDEF length the reader can write is limited by NDEF file
size used in example (default configured as 1024 bytes).
- By default CET4T NDEF message mapping version configured to 2.0.
User need to update this macro to PHCE_T4T_NDEF_SUPPORTED_VNO to
configure NDEF message mapping version to 3.0.
3 Restrictions on NfcrdlibEx8_HCE_T4T
=====================================
- NfcrdlibEx8_HCE_T4T is restricted to be run on NFC Reader Boards/ICs
mentioned in Section-16.
- The APIs are intended for NXP contact-less reader ICs only, as such
the APIs are not to be ported to any technology from any other
vendor.
- NXP will not support porting to any other vendor platform.
- This software project requires NxpNfcRdLib v07.10.00 or later.
- **IMPORTANT** The default used MCU Type is K82. When executing
example on LPC1769 or PN7462AU, the MCU Type has to be changed in
the MCUXpresso IDE.
- For switching to MCU Type to PN7462AU, see Section-11
- For switching to MCU Type to LPC1769, see Section-9, Section-10 and
Section-.
4 Configurations of NfcrdlibEx8_HCE_T4T
=======================================
- This example is written to demonstrate Host Card Emulation feature
in Passive Type 4A.
5 Package Contents
==================
- Readme.txt
+ This readme file
- NfcrdlibEx8_HCE_T4T.c
+ Main example file.
- intfs/NfcrdlibEx8_HCE_T4T.h
+ Interfaces/Defines specific to the example
- intfs/ph_NxpBuild_App.h
+ Reader library build configuration file
- src/phApp_Helper.c
- src/phApp_PN5180_Init.c
- src/phApp_PN5190_Init.c
- src/phApp_PN7462AU_Init.c
- src/phApp_RC663_Init.c
- src/phApp_Init.c and intfs/phApp_Init.h
+ Common utility functions (common across all examples)
- mcux/.cproject and mcux/.project
+ MCUXpresso project configuration file
- cr_startup_lpc175x_6x.c
+ Startup required to compile example for LPC1769 Micro Controller.
6 Mandatory materials (not included)
====================================
- MCUXpresso IDE. It can be downloaded from
[http://www.nxp.com/products/:MCUXpresso-IDE]
- SDK for Freedom K82 Board
([http://www.nxp.com/products/:FRDM-K82F]). The pre-build SDK can
be downloaded from
[https://mcuxpresso.nxp.com/en/license?hash=9897a8c19a6bc569c3fade7141f0f405&hash_download=true&to_vault=true]
See MCUXpresso User Manual for steps needed to install an SDK.
- Plugin to extend MCUXpresso to support PN7462AU. (Required for
MCUXpresso versions before MCUXpressoIDE_10.0.2)
- LPCXpresso LPC1769 / Freedom K82 development boards For NFC ICs
listed in Section-16 (Note: PN7462AU (Section-16 Bullet-2) does not
need any other other microcontroller).
7 Hardware Configuration
========================
Before starting this application, HW Changes may be required for the
used board. Refer to the following User Manuals / Application notes
before starting with this example.
- AN11744: PN5180 Evaluation board quick start guide
- AN11802: NFC Reader Library for Linux Installation Guidelines
- AN12550: PNEV5190B Evaluation board quick start guide
8 Software Configuration
========================
- The Software can be compiled for Cortex M3 LPC1769 micro-controller,
Cortex M4 Freedom K82 and Cortex M0 based PN7462AU from NXP.
- Since this example can be configured to run on various MCU ICs and
various NFC ICs, appropriate changes are required as mentioned in
Section-9, Section-10, Section-11 and Section-12.
- Listen Mode: In discovery loop listen mode, active listen is
disabled and only passive listen is enabled to support Type 4A card
emulation. Poll mode is not used.
9 Steps to build NfcrdlibEx8_HCE_T4T for LPC1769 with PN5190 using MCUXpresso
=============================================================================
See "PNEV5190B Evaluation board quick start guide" in AN12550 (See
Section-17, Bullet-5 below)
10 Steps to build NfcrdlibEx8_HCE_T4T for LPC1769 with PN5180 using MCUXpresso
==============================================================================
See "Importing provided SW example projects" in AN11908 (See
Section-17, Bullet-2 below)
11 Steps to build NfcrdlibEx8_HCE_T4T for PN7462AU using MCUXpresso
===================================================================
- For MCUXpresso versions before MCUXpressoIDE_10.0.2, See "Adding
PN7462AU Plugin" in UM10883. (See Section-17, Bullet-3 below)
- See "Importing provided SW example projects" in UM10883.
12 Steps to build NfcrdlibEx8_HCE_T4T for FRDM-K82F using MCUXpresso
====================================================================
See "Import projects to the MCUXpresso" in AN11908. (See Section-17,
Bullet-2 below)
13 Selection of Board / OSAL / Frontend (MCUXpresso)
====================================================
For MCUXpresso, the selection of Board / OSAL / Frontend has to be
done via -D (Preprocessor defines).
1) To select the board go to "Project Properties" --> "C/C++ Build"
--> "Settings" --> "Preprocessor" --> "Defined symbols (-D)", and
define the relevant PHDRIVER_<BoardNFCCombination>_BOARD macro.
e.g. For using LPC1769 with Pn5180 use
PHDRIVER_LPC1769PN5180_BOARD. For list of supported boards refer
to Platform\DAL\cfg\BoardSelection.h.
2) To select the osal/os type, go to "Project Properties" --> "C/C++
Build" --> "Settings" --> "Preprocessor" --> "Defined symbols
(-D)".
e.g. For using FreeRTOS use PH_OSAL_FREERTOS. For other options
refer to RTOS\phOsal\inc\phOsal_Config.h.
14 Steps to follow for PI / Linux / CMake
=========================================
The steps are described in AN11802. (See Section-17, Bullet-4 below)
15 Running NfcrdlibEx8_HCE_T4T
==============================
1) When the application is running, if any reader device is brought in
proximity then this example will behave like a Type 4A tag (in card
emulation mode).
2) In card emulation mode this allows both reading and writing of NDEF
message by reader.
16 List of supported NFC Reader Boards/ICs
==========================================
1) PNEV5180B v2.0 Customer Evaluation Board
2) PN7462AU v2.1 Customer Evaluation Board
3) PNEV5190B v1.0 Customer Evaluation Board
17 Reference Documents
======================
1) UM10954 : PN5180 SW Quick start guide
[http://www.nxp.com/docs/en/user-guide/UM10954.pdf]
2) AN11908 : NFC Reader Library for FRDM-K82F Board Installation
guidelines
[http://www.nxp.com/docs/en/application-note/AN11908.pdf]
3) UM10883 : PN7462AU Quick Start Guide - Development Kit
[http://www.nxp.com/docs/en/user-guide/UM10883.pdf]
4) AN11802 : NFC Reader Library for Linux Installation Guidelines
[http://www.nxp.com/docs/en/application-note/AN11802.pdf]
5) AN12550 : PNEV5190B Evaluation board quick start guide
----------------------------------------------------------------------
For updates of this example, see
[http://www.nxp.com/products/:NFC-READER-LIBRARY]
