Vhl_Write - Siemens SIMATIC RF1000 Operating Instructions Manual

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