TABLE OF CONTENTS

 

[Modules] S10

NAME

   SpringCardS10API :: S10 Card entry functions

COPYRIGHT

DESCRIPTION

   Implementation of S10 entry functions to read or write the card

[Functions] SCardS10PSCVerification

NAME

   SCardS10PSCVerification

DESCRIPTION

   S10 verification function of the Programmable Security Code (PSC) 

INPUTS

   SCARDHANDLE hCard  : handle of the card
   BYTE code3         : byte 3 of Programmable Security Code
   BYTE code2         : byte 2 of Programmable Security Code
   BYTE code1         : byte 1 of Programmable Security Code
   BYTE status[2]     : 2-byte buffer to receive status code

RETURNS

   SCARD_S_SUCCESS     : PSC verification succeeded
   Other code if internal or communication error has occured.  

NOTES

   This function must be used with a S10 card containing a Programmable Security Code.
   For more information, read the datasheet of the S10 card.

[Functions] SCardS10ReadDataArea

NAME

   SCardS10ReadDataArea

DESCRIPTION

   S10 read main memory function

INPUTS

   SCARDHANDLE hCard : handle of the card
   BYTE *recv_data   : data received
   BYTE addr         : first address to read
   BYTE recv_len     : length of data to read in byte
   BYTE status[2]    : 2-byte buffer to receive status code

RETURNS

   SCARD_S_SUCCESS   : success, card read
   Other code if internal or communication error has occured.  

NOTES

   Maximun length of data to read is 128 bytes

SEE ALSO

   SCardS10ReadProtectionArea
   SCardS10ReadSecurityArea

[Functions] SCardS10ReadProtectionArea

NAME

   SCardS10ReadProtectionArea

DESCRIPTION

   S10 read protection memory function

INPUTS

   SCARDHANDLE hCard : handle of the card
   BYTE recv_data[4] : 4-byte buffer to receive protection data
   BYTE status[2]    : 2-byte buffer to receive status code

RETURNS

   SCARD_S_SUCCESS    : success, protection memory read
   Other code if internal or communication error has occured.  

NOTES

   This function must be used with a S10 card containing a protection memory.
   For more information, read the datasheet of the S10 card.

SEE ALSO

   SCardS10ReadDataArea
   SCardS10ReadSecurityArea

[Functions] SCardS10ReadSecurityArea

NAME

   SCardS10ReadSecurityArea

DESCRIPTION

   S10 read security memory function

INPUTS

   SCARDHANDLE hCard : handle of the card
   BYTE recv_data[4] : 4-byte buffer to receive security data
   BYTE status[2]    : 2-byte buffer to receive status code

RETURNS

   SCARD_S_SUCCESS    : success, security memory read
   Other code if internal or communication error has occured.  

NOTES

   This function must be used with a S10 card containing a security memory.
   For more information, read the datasheet of the S10 card.

SEE ALSO

   SCardS10ReadDataArea
   SCardS10ReadProtectionArea

[Functions] SCardS10UpdateSecurityArea

NAME

   SCardS10UpdateSecurityArea

DESCRIPTION

   S10 update security memory function

INPUTS

   SCARDHANDLE hCard : handle of the card
   BYTE *update_data : data to update
   BYTE addr         : first address to update
   BYTE update_len   : length of data to update
   BYTE status[2]    : 2-byte buffer to receive status code

RETURNS

   SCARD_S_SUCCESS   : success, data updated
   Other code if internal or communication error has occured.  

NOTES

   This function must be used with a S10 card containing a security memory.
   This function will only be executed if a PSC has been successfully verified before.
   Maximum length of data to write is 4 bytes.
   Address lies between 0 and 3.
   For more information, read the datasheet of the S10 card.

SEE ALSO

   SCardS10WriteDataArea
   SCardS10WriteProtectionArea

[Functions] SCardS10WriteDataArea

NAME

   SCardS10WriteDataArea

DESCRIPTION

   S10 write data memory function

INPUTS

   SCARDHANDLE hCard : handle of the card
   BYTE *write_data  : data to write
   BYTE addr         : first address to write
   BYTE write_len    : length of data to write
   BYTE status[2]    : 2-byte buffer to receive status code

RETURNS

   SCARD_S_SUCCESS   : success, data written
   Other code if internal or communication error has occured.  

NOTES

   Maximun length of data to write is 128 bytes.
   If the S10 card has a PSC, this function will only be executed if a PSC has been successfully verified before.
   For more information, read the datasheet of the S10 card.

SEE ALSO

   SCardS10WriteProtectionArea
   SCardS10UpdateSecurityArea

[Functions] SCardS10WriteProtectionArea

NAME

   SCardS10WriteProtectionArea

DESCRIPTION

   S10 write protection memory function

WARNING

   The protection bytes are irreversible byte-wise.

INPUTS

   SCARDHANDLE hCard : handle of the card
   BYTE *write_data  : data to write
   BYTE addr         : first address to write
   BYTE write_len    : length of data to write
   BYTE status[2]    : 2-byte buffer to receive status code

RETURNS

   SCARD_S_SUCCESS   : success, data written
   Other code if internal or communication error has occured.  

NOTES

   This function must be used with a S10 card containing a protection memory.
   This function will only be executed if a PSC has been successfully verified before.
   Maximum length of data to write is 32 bytes.
   Address lies between 0 and 31.
   For more information, read the datasheet of the S10 card.

SEE ALSO

   SCardS10WriteDataArea
   SCardS10UpdateSecurityArea

Generated from scard_s10_entry.c on Tue Mar 31 12:16:31 2009