C API for BALTECH SDK

§ brp_I4CE_ExtendWaitingTime()

brp_errcode brp_I4CE_ExtendWaitingTime ( brp_protocol  protocol,
unsigned  WaitingTimeout,
unsigned  WTXM,
unsigned  RefreshTimeRatio 
)

This command enables to extend the waiting time for the response from the PCD. This command is required in case the host needs a longer time than FWT (see description of the I4CE.StartEmu command) to prepare a response APDU to the last request APDU from the PCD. After calling this command, the PICC repeatedly sends WTX requests to the PCD for WaitingTimeout ms.

This command should be run in BRP Continuous Mode , since it can explicitly be stopped by the host by executing the Break command. If this command is not run in BRP Continuous Mode, the reader has to wait for the WaitingTimeout duration before finalizing the execution of the command.

The WTX request refresh interval may be accommodated with the WTXM and RefreshRatio parameters according to the formula:

t(refresh) = FWT * WTXM * RefreshRatio / 100.

By default, the waiting time is renewed every (0.9 * FWT) ms (WTXM = 1, RefreshRatio = 90).

Please note that according to the ISO/IEC 14443-4:2008 specification, the maximum allowed value for FWT and for the extension FWT * WTXM is 4949 ms.

This command should only be used if the AutoWTX parameter in theI4CE.StartEmu command is set to 0. Otherwise, the card emulation automatically takes care of extending the frame waiting time.

Parameters
[in]protocolused to execute the command
[in]WaitingTimeoutTime (in ms) for which the emulated PICC should send WTX requests repeatedly. A value of 0xFFFF corresponds to an infinite value.
[in]WTXMWaiting Time Extension Multiplier (WTXM). This parameter extends the actual frame waiting time (FWT) by this multiplier (FWT_temp = FWT * WTXM). WTXM has to be comprised between 1 and 59.
[in]RefreshTimeRatioTogether with parameter WTXM , this value defines the WTX request refresh cycle time interval: t(refresh) = FWT * WTXM / RefreshTimeRatio. The value range of RefreshTimeRatio is 0..100. t(refresh) is expressed in ms.
Deprecated:
This command may be removed in future!