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

## SYNOPSIS

1. rdrhandle:chipRead(address, length)
2. rdrhandle:chipReadEx(clains, address, length)

## DESCRIPTION

Read length bytes of data from the chip card at address address.

The chip card must have been enabled by calling v4kf:chipEnable 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 processing result is provided with the v4kf.processingComplete() callback.

The second form, chipReadEx() supports an extra parameter that allows access to special memory on the chip card.

clains | SLE4418
--- | ---
0x330E | Read 8 bits, data without protect bit (default)
0x330C | Read 9 bits, data with protect bit

clains | SLE4428
--- | ---
0x320E | Read 8 bits, data without protect bit (default)
0x320C | Read 9 bits, data with protect bit

clains | SLE4432
--- | ---
0x3130 | Read main memory (default)
0x3134 | Read protection memory (length must be 4, address must be 0xFFFF)

clains | SLE4442
--- | ---
0x3030 | Read main memory (default)
0x3034 | Read protection memory (length must be 4, address must be 0xFFFF)
0x3031 | Read security memory (length must be 4, address must be 0xFFFF)

## RETURN VALUE

Returns true if the command was accepted, false if not.

## SEE ALSO

v4kf:chipDisable, v4kf:chipEnable, v4kf:chipWrite, v4kf:chipActivate, v4kf:state