Programming
6.2 Programming via USB/RS232 interface (using DLL functions)
SIMATIC RF1000
36
Operating Instructions, 02/2020, C79000-G8976-C432-07
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 Description of the parameters
Parameter
Description
vhl_read
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
Return value
•
BRP_OK
You will find more information on return values in the section "Return val-
