Siemens SIMATIC RF1000 Operating Instructions Manual page 44

Programming
7.2 Programming via USB/RS232 interface (using DLL functions)
Function call
int
vhl_select(
int Handle,
word CardTypeMask,
bool Reselect,
bool AllowConfig,
byte * CardType,
int * Status
);
Table 7-11
Parameter
vhl_select
Return value
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 of the "CardType" parameter specifies the card family
(1-6) while the less significant half byte (X) refers to the recognized card type.
Table 7-12
CardTypeMask
0x0001 (bit 1)
0x0002 (bit 2)
0x0004 (bit 3)
44
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_seri‐
al_session" function.
CardTypeMask Use this parameter to specify the card family to be recognized. When 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 opera‐
tion, 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 detailed information on the reader status in the section
"Status codes (Page 66)".
• BRP_OK
You can find more information on return values in the section "Return values
(Page 52)".
Assigning the card types
CardType
0x1X
0x2X
0x3X
Protocols/card types
ISO 14443 A / MIFARE
LEGIC Legacy (only for RF1070R)
ISO 15693
Operating Instructions, 05/2023, C79000-G8976-C432-10
SIMATIC RF1000