Vhl_Select - Siemens SIMATIC RF1060R Operating Instructions Manual

Programming interface
4.1 The functions of the DLL
4.1.7

vhl_select

With this function you select a card located in the antenna field. If successful, the status "OK"
is returned.
The type of the selected card is returned in the parameter "CardType". Note that
specification of the card type is achieved with the serial number, the length of the serial
number and other information specified at the time of the selection phase. Since there is no
guarantee that the serial number is unique, the card type is also not necessarily correct.
With the "VHLSelect" function you can select the card located in the antenna field of the
reader. Whenever "VHLSelect" is called again, the currently selected card is changed to the
"Hold mode" and "VHLSelect" returns the value "NOTAG_ERR". If you want to select a card
again without removing it physically from the antenna field, you need to set the "Reselect"
parameter to "TRUE".
The "CardTypeMask" parameter allows only specific card families to be selected. If you want
to select all cards supported by the hardware of the reader, you need to set the parameter to
"0xFFFF". The more significant half byte specifies the card family (1-6) while the less
significant half byte (X) refers to the recognized card type.
Table 4- 2
CardTypeMask
0x0001 (bit 1)
0x0002 (bit 2)
0x0004 (bit 3)
0x0008 (bit 4)
0x0010 (bit 5)
0x0020 (bit 6)
Function call
int
vhl_select(
int Handle,
word CardTypeMask,
bool Reselect,
bool AllowConfig,
byte * CardType,
int * Status
);
16
The different card types and their representation
CardType
0x1X
0x2X
0x3X
0x4X
0x5X
0x6X
Card family
ISO 14443 A / mifare
Reserved
ISO 15693
ISO 14443 B
Reserved
Reserved
Operating Instructions, 05/2017, C79000-G8976-C432-02
SIMATIC RF1060R