==============================================================================
Release Notes - NxpRdLib V2.1.1.0 Beta
==============================================================================

1. Document purpose

This document describes the content of the source package of the NXP
Reader Library as well as known problems and restrictions.
The application programming interface itself is
described in the Programmers Reference Manual.

2. Known problems and restrictions

* Restrictions


  - !!! Due to cryptographic algorithms this package is EXPORT CONTROLLED!
  - Supported contactless Readers: NXP Pegoda RD70x (firmware V2.12 or above),
                                   NXP Pegoda RD710,
                                   NXP CLRC663,
                                   NXP MFRC523
  - Supported SAMs: NXP MIFARE SAM AV2 (P5DF081)
  - Supported contact Readers: OMNIKEY CardMan 3x21,
                               OMNIKEY CardMan 5321

This library is written in ANSI C and it is therefore possible to be compiled on any ANSI C compiler.
For customer convenience, we attach a project release, so that the user can easily load the project and 
start compilation/development. This project file has the following restriction:

This product includes software developed by the OpenSSL Project * for use in the OpenSSL Toolkit. (http://www.openssl.org/)" 
This product includes cryptographic software written by Eric Young (Eay@cryptsoft.com).
The signature verification example application(Rd710_MF0EV1_ECDSA) for MFULEV1 uses cryptographic functionality of the "OpenSSL" library. (http://openssl.org). Refer to the license.txt for the OpenSSL license terms and conditions.

  - Supported Operating Systems: Microsoft Windows 7 64-bit OS
  - Supported Compiler: Microsoft Visual C++ 2008

For the NXP Pegoda RD710 a project is prepared, which can be compiled within the embedded environement of the Pegoda.
Together with a LPCXPresso environment, one can therefore program/compile/debug this project as an examplary implementation.
This package is part of the public software and documentation of Pegoda RD710.

When compiling with logging disabled i.e., removing NXPBUILD__PH_LOG from ph_NxpBuild.h file, please
take care to comment out exports for logging under GENERIC LOG EXPORTS section in NxpRdLib.def file.

* Known Problems

  - MIFARE DesFire ISO Reader Binary and ISO Read Records command cannot read
    more than Tx buffer size of data due to SAM error in the second call
    to this command with option PH_EXCHANGE_RXCHAINING. This occurs only
    in SAM X mode. Read data in smaller chunks instead to avoid this error.
	
3. Material list

|----BAL
|--------PcscWin
|--------Rd70xusbWin
|--------Rd710Sam
|--------SerialWin
|--------Stub
|--------PipeLin
|--------SocketWin
|
|----HAL
|--------Callback
|--------Rc523
|--------Rc663
|--------Rc632
|--------Rd70x
|--------Rd710
|--------SamAV2
|--------RdCardSim
|--------LicenseeHAL
|
|----PAL
|--------I14443p3a
|------------Sw
|------------Rd70x
|------------Rd710
|------------SamAV2_X
|
|--------I14443p3b
|------------Sw
|
|--------I14443p4
|------------Sw
|------------Rd710
|------------SamAV2_X
|
|--------I14443p4a
|------------Sw
|------------Rd710
|------------SamAv2_X
|
|--------Mifare
|------------Sw
|------------Rd710
|------------SamAV2_X
|------------Stub
|
|--------EpcUid
|------------Sw
|
|--------Sli15693
|------------Sw
|
|--------Felica
|------------Sw
|
|--------I18092mPI
|------------Sw
|
|--------18000-3m3
|------------Sw
|
|----AL
|--------Mfc
|------------Sw
|------------SamAV2_X
|
|--------Mfp
|------------Sw
|------------SamAV2
|------------SamAV2_X
|
|--------MfpEv1
|------------Sw
|
|--------Mful
|------------Sw
|------------SamAV2
|------------SamAV2_X
|
|--------Mfdf
|------------Sw
|------------SamAV2
|------------SamAV2_X
|
|--------MfdfEv2
|------------Sw
|
|--------Felica
|------------Sw
|
|--------I15693
|------------Sw
|
|--------ICODE ILT
|------------Sw
|
|--------Sli
|------------Sw
|
|--------Vca
|------------Sw
|------------SamAV2
|------------SamAV2_X
|
|----Common
|--------CidManager
|------------Sw
|------------Rd710
|
|--------CryptoRng
|------------Sw
|
|--------CryptoSym
|------------Sw
|
|--------KeyStore
|------------Sw
|------------Rc632
|------------Rc663
|------------Rd710
|------------SamAV2
|
|--------Log
|--------Tools
|
|----docs
|--------14_user_doc
|------------NXP_SLDA.pdf
|------------Nxp Reader Library.chm
|
|--------22_rel_doc
|------------ReleaseNotes.txt
|
|----ex
|--------CryptoLibFootprint
|--------Rc663_Felica
|--------Rc663_ICodeEpcUid
|--------Rc663_ICodeSLI
|--------Rc663_ISO14443B
|--------Rc663_ISO18000p3m3
|--------Rc663_Mfc
|--------Rc663_Mfp
|--------Rc663_Mful
|--------Rc663_Mfulc
|--------Rd70x_Mfdf
|--------Rd70x_MfdfEv2
|--------Rd70x_MfPlus
|--------Rd70x_Mful_Mfulc
|--------Rd70xBasic
|--------Rd710
|--------Rd710_MF0EV1
|--------Rd710_MF0EV1_ECDSA
|--------Rd710_NDEF_Demo
|--------Rd710_NoSam_MfPlus
|--------Rd710_Rd852_SamX_MfPlus
|--------Rd710_Rd852_SamX_Pcsc
|--------Rd710_SamNonX_KeyStore
|--------Rd710_SamNonX_TwoCards


4. Mandatory material (for Example), not included

* PCSC compatible contact (T=1) reader
* RD701 contactless reader
* CLRC663 Eval Board
* MFRC523 Eval Board
* Sample cards

5. Revision History
V2.1.1.0 (Build 25062013) Beta
+ Mifare Plus EV1 component added in AL
+ Two warnings related to unused variables wSSKeyNr wSSKeyVer in MFP EV1 SSAUTH implementation are suppressed due to 
  lack of documentation support in RefArch or Design document 
+ LicenseeHAL integrated and added as separate package
* Various bugfixes and cleanup throughout the components

V2.1.0.0 (Build 04122012)
+ Mifare Ultralight EV1 commands part of Mifare Ultralight AL component.
+ ICODE ILT component included in AL
+ 18000 part 3 mode 3 protocol included in PAL
+ RdCardSim component included in the HAL. This component is required to connect to simulation environments.
+ SocketWin component included in the BAL. This component is required to connect to simulation environments.
+ PipeLinux component included in the BAL. This component is required to connect to Linux simulation environments.
+ Some critical bugs resolved.

V2.0.1.0 (Build 04082011)
+ Fixed 0x0A authentication bug in MIFARE Desfire Application Layer component.

V2.0.0.0 (Build 04072011):
+ Added various PAL and AL blocks (refer to 3. Material list)
+ Added lots of example code (refer to 3. Material list)
+ Added wOption parameter to phbalReg_Exchange function
+ Added support for SCardControl through Exchange for PcscWin BAL
+ Added support for P5DF081 SAM with CLRC663 in X-Mode configuration
+ Added (experimental) ISO14443B support to RD70x HAL
+ Added (experimental) PN512 support to MFRC523 HAL
+ Added support to use LoadReg instead of internal constants for CLRC663 register configuration
* Updated pphLog_Callback_t, now also includes pointers to pDataParams and pEntries
* Various bugfixes and cleanup throughout the components

V1.1.0.0 (Build 13092010):
* Updated release

V1.0.0.0 (Build 26022010):
* First packaged version.
