Programming
6.2 Programming via USB/RS232 interface (using DLL functions)
SIMATIC RF1000
Operating Instructions, 02/2020, C79000-G8976-C432-07
37
6.2.1.14
vhl_write
This function writes data to a memory area that is stored in a VHL function previously stored
in the reader. The VHL configuration stored in the reader is configured via the "VHLFile"
parameter. With the configuration stored in the reader ex works, you can use "VHLFile =
255" to write to an ISO 15693 transponder from address 0.
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_write(
int Handle,
byte VHLFile,
word Address,
word Length,
byte * Data,
int * Status
);
Table 6- 16 Description of the parameters
Parameter
Description
vhl_write
This function call writes data into a previously defined memory area of 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 written.
Length
Length of the data that is going to be written as of the start address.
Data
Area in which the written 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-
