Vhl_Read - Siemens SIMATIC RF1000 Betriebsanleitung

Programmierung
6.2 Programmierung über die USB-/RS232-Schnittstelle (über DLL-Funktionen)
6.2.1.13

vhl_read

Diese Funktion liest den Speicherbereich aus, der in einer vorher im Reader hinterlegten
VHL-Funktion hinterlegt ist. Über den Parameter "VHLFile" wird die im Reader hinterlegte
VHL-Funktion referenziert. Mit der ab Werk im Reader hinterlegten Konfiguration können Sie
über "VHLFile = 255" einen ISO 15693-Transponder ab der Adresse 0 auslesen.
Wenn sich eine Karte im Antennenfeld befindet und die Funktion abgeschlossen wurde, wird
der Status "OK" zurückgegeben.
Beachten Sie, dass diese Funktion immer den Rückgabewert
"CARD_NOT_SELECTED_ERR" zurückgibt, wenn dem Reader eine Karte angezeigt wird,
ohne dass zuvor die Funktion "vhl_select" ausgeführt worden ist.
Funktionsaufruf
int
vhl_read(
int Handle,
byte VHLFile,
word Address,
word Length,
byte * Data,
int * Status
);
Tabelle 6- 15 Beschreibung der Parameter
Parameter
vhl_read
Rückgabewert
38
Beschreibung
Dieser Funktionsaufruf liest einen vorher festgelegten Speicherbereich von
der Karte aus.
Handle Der von der Funktion "brp_open_usb_session" oder
"brp_open_serial_session" zurückgelieferte Sitzungsschlüssel.
VHLFile Nummer der VHL-Funktion welche verwendet werden soll.
Address Startadresse der Daten welche gelesen werden sollen.
Length Länge der Daten welche ab der Startadresse gelesen werden sollen.
Data Bereich in dem die empfangenen Daten abgelegt werden (max. 65535
Byte).
Status
OK
•
CARD_NOT_SELECTED_ERR
•
HF_ERR
•
HW_ERR
•
CONFIG_ERR
•
AUTH_ERR
•
READ_ERR
•
Weitere Informationen zu dem Reader-Status, finden Sie im Kapitel
"Status-Codes (Seite 57)".
BRP_OK
•
Weitere Informationen zu den Rückgabewerten, finden Sie im Kapitel
"Rückgabewerte (Seite 43)".
Betriebsanleitung, 02/2020, C79000-G8900-C432-07
SIMATIC RF1000