Vhl_Select - Siemens SIMATIC RF1000 Operating Instructions Manual

Programming
6.2 Programming via USB/RS232 interface (using DLL functions)
6.2.1.10

vhl_select

With the help of 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".
With the "vhl_select" function you can select the card located in the antenna field of the
reader. When "VHLSelect" is called again, the currently selected card is changed to the
"Hold mode" and "vhl_select" 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". If there are several cards in the antenna field
of the reader and you want to select all cards, set the parameter "Reselect = false". Then call
the "vhl_select" function until all cards in the antenna field are recognized. If no new card is
detected, "CARD_NOT_SELECTED_ERR" is returned.
Function call
int
vhl_select(
int Handle,
word CardTypeMask,
bool Reselect,
bool AllowConfig,
byte * CardType,
int * Status
);
Table 6- 11
Parameter
vhl_select
32
Description of the parameters
Description
You can use this function to select a card located in the antenna field.
Handle The session key returned by the "brp_open_usb_session" or
"brp_open_serial_session" function.
CardTypeMask Use this parameter to specify the card family to be recognized. If all card
families should be detected, set the parameter to the value "0xFFFF" (see
following table).
Reselect Select "Reselct = true" if there is only one card in the antenna field which
should be detected. Select "Reselct = false" if there are several cards in the
antenna field which should be detected.
AllowConfig This value is "true" when a configuration card is to be read. In normal oper-
ation, the value must be set to "false" to prevent unintentional acceptance
of the reader configuration.
CardType The returned value indicates the card type (see following table).
Status
OK
•
NOTAG_ERR
•
HF_ERR
•
HW_ERR
•
CONFCARD_READ
•
You can find more information on the reader status in the section "Status
codes (Page 55)".
Operating Instructions, 02/2020, C79000-G8976-C432-07
SIMATIC RF1000