Skip to main content

Smartcard Interoperability Issues for the Transit Industry (2006) / Chapter Skim
Currently Skimming:

Appendix A - Set of Functionality for a Standard API
Pages 92-99

The Chapter Skim interface presents what we've algorithmically identified as the most significant single chunk of text within every page in the chapter.
Select key terms on the right to highlight them within pages of the chapter.


From page 92...
... This would include information about the API version supported and any support for optional API instructions. Table A-3 describes the API-provided GetPCDProp function used to retrieve a list of properties associated with the actual hardware reader defined by a particular reader ID.
Read the entire page →
From page 93...
... xPCD Pointer to the PCD structure 0 Successful execution Return Value 2008 Failed execution Precondition None Return Code(s) The function returns 0 if successful.
Read the entire page →
From page 94...
... xFirm Pointer to Firmware structure int nID Interface ID of the communication target. 0 Successful execution Return Value 2008 Failed execution Precondition None Return Code(s)
Read the entire page →
From page 95...
... xResponseFrame Pointer to the Response_Frame structure for the incoming response frame from the card. BYTE nPICCType Type of card PCD xPCD PCD structure 0 Successful execution 2008 Failed execution 2002 Timeout Return Value 2088 No precise diagnosis Precondition OpendReader and Poll functions should be executed successfully prior to TransmitToCard function.
Read the entire page →
From page 96...
... Parameters List of members Data Type Field Name Description BYTE nVersion Supported TCRP API version char* cOptional Supported optional API instructions
Read the entire page →
From page 97...
... cUsbName USB device name Parameters List of members Data Type Field Name Description BYTE nDevice Target reader identification number int nAntennaStrength Options to set the reader's antenna strength char* cProtocol Options to set the reader's protocol mode BYTE nSAM Number of SAM slots in the reader char*
Read the entire page →
From page 98...
... bool bISOPart4 ISO 7816 part-4 compliant Parameters List of members Data Type Field Name Description bool ISOA TYPE A card bool ISOB TYPE B card bool MifareClassic Phillips Mifare Classic 1K card bool MifareUltralight Phillips Mifare Ultralight card bool Jewel Jewel card bool MV4000 MV 4K card Parameters List of members Data Type Field Name Description short nExpectedLength Expected length of the response frame short nActualLength Actual length of the response frame BYTE baReceiveFrame[256] Incoming response data frame int nPCDStatus Outgoing command status short nNumIterations Number of iteration to check the response frame from the card short nIterationTimeout Timeout delay of each iteration
Read the entire page →
From page 99...
... ; Set of Functionality for a Standard API 99
Read the entire page →

Key Terms

  • pcd structure
  • outgoing command
  • response frame
  • target reader
  • picc structure

  • field name
  • name description
  • data type
  • type field
  • int nid

  • command status
  • reader identification
  • api instructions
  • api version
  • incoming response

  • timeout delay
  • optional api
  • pcd xpcd
  • xfirm int
  • firmware structure

  • command data
  • response data
  • actual hardware
  • revision level
  • hardware reader

  • xpcd pointer
  • particular contactless
  • return value
  • byte npicctype
  • firmware content


    • This material may be derived from roughly machine-read images, and so is provided only to facilitate research.
    More information on Chapter Skim is available.