Inhaltsverzeichnis
Werbung
®
10.2 RTC
5 Befehlssatz
Die Befehle sind alphabetisch geordnet.
Kontrollbefehl acquire_rtc
Funktion
Reserviert die gewünschte RTC
Aufruf
NoOfAcquiredCard = acquire_rtc( CardNo )
Parameter
CardNo
Rückgabe
Der Rückgabewert (32-Bit-Wert ohne Vorzeichen) ist CardNo, sofern die Reservierung
erfolgreich war und 0, wenn die Karte bereits für ein anderes Anwenderprogramm
reserviert ist oder die Versionsprüfung einen Fehler feststellt.
Hinweise
• Der Befehl acquire_rtc ist auch in einem Single-Board-System hilfreich, wenn die
Verwendung der Karte durch unterschiedliche Anwenderprogramme koordiniert
werden muss.
• Der Befehl acquire_rtc bleibt wirkungslos, wenn CardNo die Zahl der bei der Initialisie-
rung gefundenen RTC
= 0 ist (reale Karten zählen ab 1) (Rückgabewert 0, get_last_error-Returncode
RTC5_PARAM_ERROR).
• Zugriffsberechtigungen auf die vorhandenen Karten werden exklusiv (gleichzeitig
jeweils immer nur an ein Anwenderprogramm) vergeben. Der Befehl acquire_rtc bleibt
deshalb auch wirkungslos, wenn die angeforderte Karte bereits durch eine anderes
Anwenderprogramm reserviert ist (Rückgabewert 0, get_last_error-Returncode
RTC5_ACCESS_DENIED). Bevor eine bereits reservierte Karte mit acquire_rtc bean-
sprucht werden kann, muss die Karte vom zugriffsberechtigten Anwenderprogramm
mit
release_rtc
Wenn die Karte andererseits bereits vor der Initialisierung eines Anwenderprogramms
freigegeben wurde, so wird das Anwenderprogramm bei der Initialisierung mit
init_rtc5_dll
nommen. Ein explizites acquire_rtc ist in diesem Fall nicht erforderlich und bleibt dann
auch wirkungslos. Rückgabewert ist dann aber trotzdem CardNo.
• Die Treiber-DLL und die Programmdateien RTC5OUT.out, RTC5RBF.rbf und
RTC5DAT.dat können nicht in beliebigen Programmversionen miteinander kombiniert
werden. Der Befehl acquire_rtc führt eine entsprechende Versionsprüfung durch. Sind
noch keine Programmdateien geladen, kann die Versionsprüfung zwar nicht explizit
durchgeführt werden (get_last_error-Returncode RTC5_TIMEOUT), gilt aber dennoch
als bestanden und verhindert damit die Übernahme nicht. Sind Programmdateien
geladen und bei der Versionsprüfung wird ein Fehler festgestellt, dann wird der Zugriff
verweigert (Rückgabewert 0, get_last_error-Returncode
RTC5_ACCESS_DENIED|RTC5_VERSION_MISMATCH).
• Eine mit acquire_rtc erfolgreich angeforderte Karte wird nicht automatisch zur aktiven
Karte. Die Aktivierung geschieht nur mit den Befehlen
• Laufende Karten werden durch acquire_rtc nicht angehalten und insbesondere auch
nicht initialisiert.
• Der Befehl acquire_rtc ist auch ohne explizite Zugriffsberechtigung für irgendeine
®
RTC
• Der Befehl acquire_rtc ist nicht als Multi-Board-Befehl verfügbar.
• Siehe auch
gramm", Seite
®
®
RTC
5 PCI-Karte, RTC
5 PCI-Express-Karte, RTC
Rev. 1.10 d
10 Befehle und Funktionen
®
5-Karte für ein Anwenderprogramm.
(DLL-interne) Nummer der gewünschten Karte als 32-Bit-Wert ohne Vorzeichen.
®
5-Karten (siehe rtc5_count_cards) übersteigt oder wenn CardNo
oder
free_rtc5_dll
als für die Karte zugriffsberechtigt in die Kartenverwaltung aufge-
5-Karte verfügbar.
Kapitel 6.7.1 "Hinweise zur Übernahme einer Karte durch ein Anwenderpro-
93.
®
5 PC/104-Plus-Karte, RTC
explizit freigegeben werden.
select_rtc
®
5 PCIe/104-Karte
oder init_rtc5_dll.
251
Werbung
Inhaltsverzeichnis
