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

## SYNOPSIS

#include <v4kf.lh>
rdrhandle:insert([flags])

## DESCRIPTION

This command can only be used if the reader is ready.

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

### Insertion readers

Sets up the reader for card insertion. The shutter opens and allows a card to be inserted. The optional flags, when 1, will cause the card to be locked inside the reader after insertion.

When this state completes successfully, it will enter the Inserted or Locked state, respectively, as requested by flags.

### Motor readers

Sets up the reader for card insertion. The shutter is enabled and allows a card to be inserted. The optional flags value is a bit-wise or of zero or more options:

V4KF_INSERT_AUTOLOCK | Automatically engage chip contact after insertion.
V4KF_INSERT_CHECK_FOR_MAGSTRIPE | (V2XF only) Only accept cards with a proper magstripe.
V4KF_INSERT_WIGGLE | (V2XF only) Wiggle card back and forth during insertion.

When this state completes successfully, it will enter the Inserted or Locked state, respectively, as requested by flags. The Locked state indicates that the chip contact is engaged.

## SEE ALSO

v4kf:eject, v4kf:capture, v4kf:init, v4kf:lock, v4kf:reset, v4kf:state