✎ r502-api-manual [wiki]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
 
   R502 Spy Library is an operation API library of R502 SPY reader. Now it contains ISO14443 TypeA protocol debug API interface, Mifare Classic card command debug API interface. 
   For any question, please contact [[https:/mailto:javacardos@gmail.com|javacardos@gmail.com]] .


===== API introduction =====
==== 1. Constructor and initialization ====
=== Constructor ===


 * Parameter: scinterface
\\ 



 * Return: Smartcard debug object.
\\ 

=== init() ===


 * Function: Initialization.
\\ 



*Parameter: Null.
\\ 



*Return: Null.
\\ 

====2. Related contactless API====
=== rfOn() ===


*Function: Open smartcard reader electromagnetic field.
\\ 



*Parameter: Null.
\\ 



*Return:
        - True if the command is executed successfully. 
        - False if failed to execute the command.
\\ 

=== rfOff() ===


*Function: Close smartcard reader electromagnetic field.
\\ 



*Parameter: Null.
\\ 



*Return:
        - True if the command is executed successfully. 
        - False if failed to execute the command.
\\ 

=== rfAuto() ===


*Function: Set smartcard reader debug function to automatic status. In this status, anti-collision will be completed automatically.
\\ 



*Parameter: Null.
\\ 



*Return:
        - True if the command is executed successfully. 
        - False if failed to execute the command.
\\ 

=== rfManaul() ===


*Function: Set smartcard reader debug function to manual operation status. In this status, anti-collision program will be implemented by calling API interface.
\\ 



*Parameter: Null.
\\ 



*Return:
        - True if the command is executed successfully. 
        - False if failed to execute the command.
\\ 

====3. ISO14443 TypeA protocol API====
=== claREQA(commandValue) ===


*Function: Send REQA command of ISO14443 TypeA.
\\ 



*Parameter: commandValue: the value of command. It is 0x26 as defined in ISO14443 specification.
\\ 



*Return:
        - (True, command response value: ATQA) if the command is executed successfully. 
        - (False, error code) if failed to execute the command.
\\ 

=== claWUPA(commandValue) ===


*Function: Send WUPA command of ISO14443 TypeA.
\\ 



*Parameter: commandValue: the value of command. It is 0x52 as defined in ISO14443 specification.
\\ 



*Return:
        - (True, command response value: ATQA) if the command is executed successfully. 
        - (False, error code) if failed to execute the command.
\\ 

=== claAnticollision(commandValue) ===


*Function: Send ANTICOLLISION command of ISO14443 TypeA.
\\ 



*Parameter: commandValue: the value of command. e.g.: â€˜93 20â€™, â€˜95 20â€™, â€˜97 20â€™.
\\ 



*Return:
        - (True, command response value: UID CLn) if the command is executed successfully. 
        - (False, error code) if failed to execute the command.
\\ 

=== claSelect(commandValue) ===


*Function: Send SELECT command of ISO14443 TypeA.
\\ 



*Parameter: commandValue: the value of command. e.g.: â€˜93 70â€™ + UID, â€˜95 70â€™ + UID, â€˜97 70â€™ + UID.
\\ 



*Return:
        - (True, command response value: SAK) if the command is executed successfully. 
        - (False, error code) if failed to execute the command.
\\ 

=== claRATS(commandValue) ===


*Function: Send RATScommand of ISO14443 TypeA.
\\ 



*Parameter: commandValue: the value of command. The format defined in specification: â€˜E0â€™ + Parameter byte.
\\ 



*Return:
        - (True, command response value: ATS) if the command is executed successfully. 
        - (False, error code) if failed to execute the command.
\\ 

=== claHLTA(commandValue) ===


*Function:Send HLTA command of ISO14443 TypeA.
\\ 



*Parameter: commandValue: the value of command. The format defined in specification: â€˜50 00â€™.
\\ 



*Return:
        - (True, command response value) if the command is executed successfully. 
        - (False, error code) if failed to execute the command.
\\ 

=== claPPS(commandValue) ===


*Function:Send PPS command of ISO14443 TypeA.
\\ 



*Parameter: commandValue: the value of command. The format defined in specification: PPSS + PPS0 + PPS1.
\\ 



*Return:
        - (True, command response value) if the command is executed successfully. 
        - (False, error code) if failed to execute the command.
\\ 

====4. ISO14443 Block protocol API====
=== clTransmit(commandValue) ===


*Function: Send ISO14443 block.
\\ 



*Parameter: commandValue: the value of command. It can be I-Block, R-Block or S-Block.
\\ 



*Return:
        - (True, block response value) if the command is executed successfully. 
        - (False, error code) if failed to execute the command.
\\ 

====5. MIFARE Command API====
=== mifareAuthentication(commandValue) ===


*Function: Send MIFARE Authentication command.
\\ 



*Parameter: commandValue: the value of commandï¼ŽAuth type + Mifare Block Addr + (authentication key(6 bytes) + UID).
\\ 



*Return:
        - (True, â€˜â€™) if the command is executed successfully. 
        - (False, error code) if failed to execute the command.
\\ 

=== mifareBlockRead(commandValue) ===


*Function: Send MIFARE Read command.
\\ 



*Parameter: commandValue: the value of commandï¼ŽIt is 0x30 + Mifare Block Addr.
\\ 



*Return:
        - (True, block data) if the command is executed successfully. 
        - (False, error code) if failed to execute the command.
\\ 

=== mifareBlockWrite(commandValue) ===


*Function: Send MIFARE Write command.
\\ 



*Parameter: commandValue: the value of commandï¼ŽIt is 0xA0 + Mifare Block Addr + Data(16bytes).
\\ 



*Return:
        - (True, â€˜â€™) if the command is executed successfully. 
        - (False, error code) if failed to execute the command.
\\ 

=== mifareIncrement(commandValue) ===


*Function: Send MIFARE Increment command.
\\ 



*Parameter: commandValue: the value of commandï¼ŽIt is 0xC1 + Mifare Block Addr + Data(16 bytes).
\\ 



*Return:
        - (True, â€˜â€™) if the command is executed successfully. 
        - (False, error code) if failed to execute the command.
\\ 

=== mifareDecrement(commandValue) ===


*Function: Send MIFARE Decrement command.
\\ 



*Parameter: commandValue: the value of commandï¼ŽIt is 0xC0 + Mifare Block Addr + Data(16bytes).
\\ 



*Return:
        - (True, â€˜â€™) if the command is executed successfully. 
        - (False, error code) if failed to execute the command.
\\ 

=== mifareRestore (commandValue) ===


 * Function: Send MIFARE Restore command.
\\ 



*Parameter: commandValue: the value of commandï¼ŽIt is 0xC2 + Mifare Block Addr + Data(16bytes).
\\ 



*Return:
        - (True, â€˜â€™) if the command is executed successfully. 
        - (False, error code) if failed to execute the command.
\\ 

=== mifareTransfer(commandValue) ===


*Function: Send MIFARE Transfer command.
\\ 



*Parameter: commandValue: the value of commandï¼ŽIt is 0xB0.
\\ 



*Return:
        - (True, â€˜â€™) if the command is executed successfully. 
        - (False, error code) if failed to execute the command.
\\
User Tools

Site Tools

Page Tools
