Home Contents | # v4kf:chipExecute | V4kf | Core4 Lua Event System

## SYNOPSIS

#include <v4kf.lh>
rdrhandle:chipExecute(apdu)

## DESCRIPTION

Sends an APDU block to a smartcard for processing.

The card must have been activated by calling v4kf:chipActivate before it can be read.

This command can only be used if the reader is in the Locked state, which ensures that the chip contact is engaged and stays so for the whole operation.

While this state processes, the reader is in the Processing state and v4kf:isProcessing() returns true. The reader returns to the Locked state on completion.

The command returns immediately. Actual execution of any reader operation is done within the event loop.

The RAPDU returned by the chip is provided with the v4kf.processingComplete() callback.

## NOTES

APDU and RAPDU are terms from the ISO/IEC 7816-4 chip card specification. The driver sends and receives the APDU data verbatim and does not modify it in any way. There is a Wikipedia article about the APDU.

The EMV standard for Credit Cards is based on ISO/IEC 7816-4. Specifications for EMV are available for free download from EMVCo.

A short introduction is available from Wikipedia.

## SEE ALSO

v4kf:chipDisable, v4kf:chipEnable, v4kf:chipRead, v4kf:chipWrite, v4kf:state, v4kf.emvDecode(), v4kf.emvLookup()