Programming interface
4.1 The functions of the DLL
SIMATIC RF1060R
16
Operating Instructions, 05/2017, C79000-G8976-C432-02
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
The different card types and their representation
CardTypeMask
CardType
Card family
0x0001 (bit 1)
0x1X
ISO 14443 A / mifare
0x0002 (bit 2)
0x2X
Reserved
0x0004 (bit 3)
0x3X
ISO 15693
0x0008 (bit 4)
0x4X
ISO 14443 B
0x0010 (bit 5)
0x5X
Reserved
0x0020 (bit 6)
0x6X
Reserved
Function call
int
vhl_select(
int Handle,
word CardTypeMask,
bool Reselect,
bool AllowConfig,
byte * CardType,
int * Status
);
