CARD - History of Modifications (HISTORY)

     Author : D.MOURET
     Date :  2007/10/08
     Version :  V2R12b
     
    Copyright © SMARTWARE 2004-2007, All rights reserved





     1. CARD V2r12b


    1.1. Contact Interfaces Specific Modifications:

      • All Models : Fix wrong parity error results on T=0 commands.





     2. CARD V2r12a


    2.1. General Modifications:

      • Require at least MLOS version v2r23h.



    2.2. Contact Interfaces Specific Modifications:

      • All Models : card_PipeX takes ulong input and output lengthes.
      • Models Iso & IsoEh : card_Apdu manages sort case 4S APDU, according to ISO7816-3:2006 standard.
      • Models Iso & IsoEh : Add card_ParitySet and card_ParityGet methods.
      • All Models : card_C3Pulse process does not set IO line to HIZ (since CARD v2r11a). Also fix the process on US-ICC firmware V2R08 for both interfaces.
      • Model IsoEh : In card_OutX, fix process when ACK byte requests the reception of a single data byte followed by a procedure byte.



    2.3. Contactless Interfaces Specific Modifications:

      • All Models : card_PipeX takes ulong input and output lengthes.
      • Models ISO14443 & PayPass : Extended APDUs can fullfill the maximum amount of data defined in ISO7816 standard, in remote applications.
      • Models ISO14443A & B, & FeliCa : Fix random error 6 on communication methods.
      • Manage US-CLT product with firmware v3r01.






     3. CARD V2r11d


    3.1. Contact Interfaces Specific Modifications:

      • Model IsoEh : Fix simultaneous frequency programming process on multiple heads.
      • Model USB : Fix interface freezing on card_Off method.


    3.2. Contactless Interfaces Specific Modifications:

      • Model ISO14443A : Fix DSI update to 0 (baudrate = 106 kbd/s) with card_CardPCfg.





     4. CARD V2r11c



    4.1. Contact Interfaces Specific Modifications:

      • Model IsoEh : Fix character duration in transmission wheb ETU is updated through card_CardCfg.
      • Model USB : Fix a timeout error on card_Reset when station uses USCORE V4.


    4.2. Contactless Interfaces Specific Modifications:

      • Models ISO14443 & PayPass : Successfull card_Deselect configures automatically the reader to perform a level 3 WUP command sent by card_PipeX (baudrate is set to 106 kbd/s and FrameFlag field is set to a proper level 3 configuration).
      • Models ISO14443 & PayPass : Bit Frame field is set to default value after an invalid raw command sent by card_PipeX.
      • Models ISO14443A_RC : BPSK decoder is automatically selected if DSI > 0 (card_PFrame_RxCodingBPSK is also set).





     5. CARD V2r11b


    5.1. General Modifications:

      • Require at least MLOS version v2r23d.


    5.2. Contact Interfaces Specific Modifications:

      • All Models : Fix error 25552 on card_OSTest and card_IC1Get methods with US-ICC.
      • Model IsoEh : Fix character duration in transmission when ETU is modified by card_EtuX.





     6. CARD V2r11a


    6.1. Contact Interfaces Specific Modifications:

      • Add USB model of communication.
      • Manage communications on Contact Media Tester (US-CMT) product.
      • Manage communications on Integrated Media Card (US-IMC) product.
      • All Models : Add card_CnGet method to get current ISO contacts state.
      • All Models : Fix measurement waiting delays in card_IC1Get method, according to measurement scale.
      • All Models : Fix card_C3Pulse timeout error with US-ICC Firmware V2R08 on PERSO interface.
      • All Models : Fix station failure if 1st ATR byte duration is 12 etu (TS), with US-ICC Firmware V2R08.
      • All Models : In card_Reset, check C7 state before the activation of C2 contact.



    6.2. Contactless Interfaces Specific Modifications:

      • Manage communications on Contactless Tester (US-CLT) product.
      • Manage X-CORE Tester product embedding an FPGA Modem V2 design.
      • Models ISO14443-A : Manage split Byte oriented anticollision frames with FPGA Modem V2.





     7. CARD V2r10e



    7.1. Contact Interfaces Specific Modifications:

      • All models : Manage US-ICC FWI V2R08.



    7.2. Contactless Interfaces Specific Modifications:

      • All models : Manage US-PICC FWI V2R04.
      • Models ISO14443 & PayPass : Fix CID byte checking in card_Deselect answer.
      • Models ISO14443 & PayPass : Fix NAD and CID bytes checking in Level 4 frames according to standards.
      • Models ISO14443 : Don't add NAD byte in chained I_Blocks.





     8. CARD V2r10d


    8.1. Contactless Interfaces Specific Modifications:

      • Models PayPass : Disregard NAD & CID in level 4 exchanges





     9. CARD V2r10c


    9.1. Contactless Interfaces Specific Modifications:

      • Models ISO14443 & PayPass : Manage extended APDUS.
      • All models : Update test access to configuration structure.





     10. CARD V2r10b


    10.1. General Modifications:

      • Decrease Mutex timeout from 30 to 4 seconds in internal Model Take operation, to avoid to block temporarly an interface if a previous operation is not finished (Erno = 30004).



    10.2. Contact Interfaces Specific Modifications:

      • Model IsoEh : Fix invalid update of StructSize value on Protocol Structure Reading.



    10.3. Contactless Interfaces Specific Modifications:

      • All Models using RC : Reception automatically restarts on frame error.
      • Models ISO14443 & PayPass : Fix initialization of AFWT and ASFGT on card_Open().






     11. CARD V2r10a



    11.1. General Modifications:

      • Update defaut CARD timeout process to 6 seconds.
      • card_SysInfoGet output string includes CARDTM license information.
      • Data Acquisition mechanism handles firmware design version 2.



    11.2. Contact Interfaces Specific Modifications:

      • Model IsoEh : default 2 ms guardtime after PPS command can be modified in the configuration structure.



    11.3. Contactless Interfaces Specific Modifications:

      • Create PayPass-A and PayPass-B models of communication.
      • Models ISO14443 & PayPass : Add AFWT (additional Frame Waiting Time) and ASFGT (additional start-up frame guard time) in the configuration structure.
      • Models ISO14443-A, PayPass-A and Mifare : disable collision error process in Level 4 communications. Can be also configured through Frame_Flag fied of the configuration structure.






     12. CARD V2r09b


    12.1. Contact Interfaces Specific Modifications:

      • All Models : Fix invalid clock frequency generation when reader includes at least 4 contacts interfaces.



    12.2. Contactless Interfaces Specific Modifications:

      • Models ISO14443 B : Fix EGT setting.
      • Models ISO14443 B_RC : Manage EGT setting.
      • Models ISO14443 B : Fix maximum Sof to "0" duration to 63 etu instead of 31 etu.





     13. CARD V2r09a


    13.1. General Modifications:

      • Update CARD to work with new MLOS v2r22d system.
      • Fix update of CplStatus field of a card object in all methods.
      • DES Object shifted into MLOS system.


    13.2. Contact Interfaces Specific Modifications:

      • All Models : Update card models' names in documentation.
      • All Models : Add Methods to drive the contacts separately.
      • All Models : Add average current measurement method.
      • All Models : Add open/short test method.
      • All Models : Remove 150 ms delay when parity error generation mode is active.
      • Models Iso & IsoEh : Check NAD value in I_Block answers
      • Model IsoEh : Add T1ErrReemit in the configuration structure to set the maximum number of retries during error handling.
      • Model Iso : Fix Error 26 (Interface not opened) with previous PowerFACET applications (SDK v2r13 and below).
      • Fix DLL to access remotely to hwi methods with a PowerFACET reader.



    13.3. Contactless Interfaces Specific Modifications:

      • Define new names for ISO14443 models.
      • All Models : Add card_ModelSet and card_ModelGet methods to select a new model even if the interface is powered, or get the current model.
      • Models ISO14443 A & B : Add AFDT field in the configuration structure to set an additional frame delay time between the end of reception and the following transmission.
      • Models ISO14443 A & B :Add ErrReemit field in the configuration structure to set the number of retries during the Level 4 error recovery process.
      • Models ISO14443 A & B : FWI/FWT parameters are set to default value when card_Off is called.
      • Models ISO14443 A & B : card_Deselect puts back reader's configuration to Level 3 exchanges.
      • Models ISO14443 A & B : NAD value returned by the PICC in Level 4 frames is analysed according to ISO7816-3 description.
      • Models ISO14443 A : Add SFGI/SFGT fields in the configuration structure.
      • Models ISO14443 A & Mifare : Add card_Select method to perform immediately the Select commands without Anticol commands.
      • Models ISO14443 B : Add card_BaudRateSet method.
      • Models ISO14443 B : Add AFI and SlotNb fields in the configuration structure, used in REQB command.
      • Models ISO14443 B : Add card_AtbInfSet and card_AtbInfGet methods to handle Higher Layer commands in INF field of the ATTRIB command.




     14. CARD V2r08c


    14.1. Contact Interfaces Specific Modifications:

      • Model IsoEh : T=0 - Fix error 25013 when command send only 1 data byte to cards requesting an EGT above 3 etu.
      • Model IsoEh : Add flag to allow card_Reset to return a wrong ATR.
      • Models Iso & IsoEh : T=1 - Perform Block Repetition when BWT timeout occurs.
      • Models Iso & IsoEh : T=1 - Fix BWT value when the card performs a WTX request.


    14.2. Contactless Interfaces Specific Modifications:

      • Model TypeA : Fix communication error while previous selected model was Mifare.
      • Models TypeA & Ap, Type B : Fix DRI and DSI access and management (inc. card_CardPCfg; all Level 3 methods; Level 4 RATS and PPS methods).
      • Models TypeA & Ap, Type B : card_PipeX returns proper error code when interface is off.
      • Models TypeA & Ap, Type B : control FWI max value from ATS or ATQB.
      • Models TypeA & Ap : control SFGI max value from ATS.





     15. CARD V2r08b


    15.1. General Modifications:

      • Update CARD DLL and LIB for CARDTM v2r02a package.


    15.2. Contact Interfaces Specific Modifications:

      • Set back C1 voltage to its last defined value when OpenShort test has been performed.


    15.3. Contactless Interfaces Specific Modifications:

      • Model Mifare : Fix authentification error while presenting Key B only.






     16. CARD V2r08a



    16.1. General Modifications:

      • Add card_SysInfoGet method to return CARD application and Firmware interface versions.
      • Create errors card__Type (invalid Object or Model) and card__Open (interface not opened).
      • Add cardcfg.h header file including specific CARD DLL-Entry Points: cardcfg_Start and cardcfg_End.


    16.2. Contact Interfaces Specific Modifications:

      • Model Iso & IsoEh : WWT is calculated according to ISO 7816-3 standard.
      • Model IsoEh : Extra Guardtime value is properly set after ATR analysis.
      • Model IsoEh : Fix reception problems when an important Extra Guardtime value is set.
      • Model IsoEh : Fix Error 1 when parity error generation is enabled, and update error codes.
      • Model IsoEh : Improve parity errors simulation in reception for fast baudrate (ETU=8).
      • Model IsoEh : Improve ODMT accuracy when set in etu counts.


    16.3. Contactless Interfaces Specific Modifications:

      • All Models : Add card_IdGet method to get the smartcard Identifier or Serial Number.
      • Models Mifare, TypeA & Ap : Add card_REQA, card_WUPA, card_Anticol, and card_HaltA methods.
      • Model TypeB : Add card_REQB, card_WUPB, card_Attrib, and card_HaltB methods.
      • Models TypeA & Ap : Add card_RATS method.
      • Models TypeA & Ap, TypeB : Add card_Deselect method.
      • Models Mifare, TypeA : Handle anticollision if few cards are present in the field.
      • Models Mifare, TypeA & Ap, Type B : card_Reset method starts with a WUP command if field is already On.
      • Models TypeA, 15693, ICode : Frame size of the reader (FSD) is increased up to 256 bytes.
      • Models Mifare, TypeA, 15693, ICode : Communications are handled under interrupt process.
      • Model 15693 : Fix standard/fast mode.
      • Model TypeAp : Fix DRI and DSI setting with card_CardPCfg method.
      • Model TypeAp : FrameFlag "RxCodingBPSK" is in read only.
      • Models Mifare, FeliCa, 15693, ICode : Fix update of RFOnWait and RFOffWait parameters.
      • Model TypeB : Add a fixed delay of 150 us before any transmissions.






     17. CARD V2r07b



    17.1. Contact Interfaces Specific Modifications:

      • Fix errors 16 (CARD: No card) and 702 (RDC: Too long message) when card_close is called.
      • Fix replacement of error 19 (CARD: Card is mute) by error 21 (CARD: Communication error)


    17.2. Contactless Interfaces Specific Modifications:

      • Types A & B only : Review PCD rules and "Error detection and recovery" in Level 4 APDU exchanges.
      • Type A only : CID is supported and included in Level 4 frames if ATS don't mention it (TC1 byte absent).
      • Type A only : FSCI default value is fixed to 2.
      • Type A only (using card_ModelTypeA model ) : FSDI value is fixed to 5.
      • Type A only (using card_ModelTypeAp model ) : PPS method is managed.





     18. CARD V2r07a



    18.1. General Modifications:

      • Redo all C-Interface Documents
      • Set Card Method processing timeout value to 5 seconds (2 seconds before) - Cf. field timeout of the card object structure.
      • card_FreqXDef takes now an "ulong" parameter instead of an "ushort" parameter.
      • Shift in sysc.h and complement the card object codes used in card_Open Method.
      • Add a Card Hardware Interface Reference (Handle on Card Driver) in card_Type structure to access to lower level Methods.
      • Rename in card.h card_TuneSetCmd to card_TuneCmdSet
      • Rename in card.h Mifare Key Modes defines cdmifare_ModeKeyA/B is now card_ModeKeyA/B


    18.2. Contact Interfaces Specific Modifications:

      • Update the Baud Rate Adjustment Factor values: DI = 0x07 codes D = 64.
      • Interface can stay Powered On even on ATR errors during a Reset (RSTMode).
      • Card Detection can be enabled/disabled and consulted by software.
      • Fix Timeout management during receptions under card_ModelIsoEh Model.
      • Fix the send of Blocks of more than 257 bytes.
      • Correct card_Apdu function for Case 1 commands.
      • IFSD Parameter (T=1 protocol) can be modified.
      • WWT calculation suits EMV Standard: WWT = 960*WI*DI (DI is returned in TA1 byte of the card ATR).

      • Management of Parity Errors Generation in T=0 and T=1 protocols under card_ModelIsoEh Model.
      • Add a Data Acquisition mechanism on Byte Level (first version - size limited).



    18.3. Contactless Interfaces Specific Modifications:

      • Type B only : Correct DS and DR values in card_PCfgtype structure.
      • Type B only : DRI and DSI can be changed in Transparent Mode.
      • Type B only : ATTRIB is sent by card_Reset() even if card is not IS0 14443-4 compliant.
      • Type B only : Update FWI with REQB answer in card_Reset().
      • Type A only : PPS command is managed.
      • New timers RFOnWait et RFOffWait computed respectively after Power On and Power Off operations.
      • CID can be changed in Types A and B, and its default value is now 1 instead of 0.
      • FSDI default value is now 8 instead of 5.
      • Add NAD, CID, IFSC, RFOnWait and RFOffWait fields in card_PCfgType structure.
      • Types A & B only : Enable/disable CID and NAD bytes in Frames, through FrameFlag field in card_PCfgType structure.
      • Add card_TuneCmdGet method, and rename method card_TuneSetCmd card_TuneCmdSet.





     19. CARD V2r06c

      This new version corrects only a communication problem with the the contactless Type B cards.


    19.1. Contactless Interfaces Specific Modifications:

      • Type B: Fix a Buffer size problem in card_PipeX() method, avoiding permanent chaining commands.






     20. CARD V2r06a

      This version is the first one which uses efficiently the new architecture of Ultrasmart-ICC readers through a new model of communication: ISO Enhanced.


    20.1. Contact Interfaces Specific Modifications:

      • Add New Model to manage T=0 and T=1 Protocol : card_ModelIsoEh (ISO Enhanced)
      • Add Function to perform transparent exchanges under an ISO Model : card_Transceive
      • Add New Card Configuration Methods: card_cardCfgX and card_HwiCfg
      • Add card_CardDetect functions
      • Add card_FreqXGet function

      • Model Iso : FI = 0 is managed.
      • Model Iso - card_Reset: TCK byte is included in the ATR Buffer.
      • Model Iso - card_LastErrorGet: Returns a right value when an error occurs in card_PPSX().
      • Model Raw - card_ResetWarm : the ATR is properly returned in the ATR field of card_Type structure.
      • Model Raw - card_pipeX: Can indicate 0 data to send (Minimum System Required: US-ICC reader with V2R06 Firmware).






     SMARTWARE

    Smart Technology for Smart Industry


      COPYRIGHT

      All rights of translation, adaptation and reproduction by any mean reserved for all the countries.

      Any reproduction or any complete or partial representation of the pages published in this work, made without the written permission of SMARTWARE is illicit and constitutes an imitation, whatever mean is used. Only reproductions strictly reserved for the private use of the purchaser and not intended to be used collectively are authorized. So are the short quotations justified by the scientific or informative nature of the work which they are extracted from.(art L.122-4 L. 122-5 and L. 335-2 of the French Code ruling on intellectual property).


      © Smartware, Les ULIS, France, 1999-2006

      WARNING

      Information in this document is subject to change without notice and does not represent a commitment on the part of SMARTWARE.

      REGISTRED TRADEMARKS

      FACET, PowerFACET, UltraSmart, SmartTalk, ePassChecker are registered trademarks of SMARTWARE.
      MS-DOS, WINDOWS 95/NT/2K/XP are registered trademarks of Microsoft Corporation.

      ADDRESS

        SMARTWARE

        Le Carthagène
        11, Avenue des Andes
        91940 LES ULIS - FRANCE
        Phone : +33 1 6486 2525
        Fax : +33 1 6486 2526

        support@smartware.fr

        www.smartware.fr