Programming
6.2 Programming via USB/RS232 interface (using DLL functions)
6.2.1.13
vhl_read
This function reads the memory area which is stored in a VHL function previously stored in
the reader. The "VHLFile" parameter is used to reference the VHL function stored in the
reader. With the configuration stored in the reader ex works, you can read out an ISO 15693
transponder from address 0 via "VHLFile = 255".
When a card is located in the antenna field and the function was completed, the status "OK"
is returned.
Note that this function always returns the return value "CARD_NOT_SELECTED_ERR"
when a card is displayed to the reader without the "vhl_select" function being executed first.
Function call
int
vhl_read(
int Handle,
byte VHLFile,
word Address,
word Length,
byte * Data,
int * Status
);
Table 6- 15
Parameter
vhl_read
Return value
36
Description of the parameters
Description
This function call reads a previously defined memory area from the card.
Handle
The session key returned by the "brp_open_usb_session" or
"brp_open_serial_session" function.
VHLFile
Number of the VHL function that is to be used.
Address
Start address of the data that is going to be read.
Length
Length of the data that is going to be read as of the start address.
Data
Area in which the received data is stored (max. 65535 bytes).
Status
OK
•
CARD_NOT_SELECTED_ERR
•
HF_ERR
•
HW_ERR
•
CONFIG_ERR
•
AUTH_ERR
•
READ_ERR
•
You will find more information on the reader status in the section "Status
codes (Page 55)".
BRP_OK
•
You will find more information on return values in the section "Return val-
ues (Page 40)".
Operating Instructions, 02/2020, C79000-G8976-C432-07
SIMATIC RF1000