Programming
6.2 Programming via USB interface
SIMATIC RF1000
Operating Instructions, 02/2019, C79000-G8976-C432-04
27
Function call
int
vhl_read(
int Handle,
byte VHLFile,
word Address,
word Length,
byte * Data,
int * Status
);
Table 6- 13 Description of the parameters
Parameter
Description
vhl_read
The parameter reads a previously specified memory area from the card.
Handle
The session key returned by the function "brp_open_usb_session".
VHLFile
Number of the VHL file 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-
6.2.1.12
vhl_write
This function writes data to a memory area that is stored in a VHL file previously stored in
the reader. The VHL configuration stored in the reader is configured with the "VHLFile ID".
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.