Meilhaus Electronic Handbuch ME-6000/ D. für PCI-Bus

Transkript

1 Meilhaus Electronic Handbuch ME-6000/ D für PCI-Bus ME Bit D/A-Wandlerkarte mit bis zu 16 Kanälen und galvanischer Trennung; optional: Insel-Kanäle

2 Impressum Handbuch ME-6000/6100 Revision 1.1D Ausgabedatum: 23. Oktober 2002 Meilhaus Electronic GmbH Fischerstraße 2 D Puchheim bei München Germany Copyright 2002 Meilhaus Electronic GmbH Alle Rechte vorbehalten. Kein Teil dieses Handbuches darf in irgendeiner Form (Fotokopie, Druck, Mikrofilm oder in einem anderen Verfahren) ohne ausdrückliche schriftliche Genehmigung der Meilhaus Electronic GmbH reproduziert oder unter Verwendung elektronischer Systeme verarbeitet, vervielfältigt oder verbreitet werden. Wichtiger Hinweis: Alle in diesem Handbuch enthaltenen Informationen wurden mit größter Sorgfalt und nach bestem Wissen zusammengestellt. Dennoch sind Fehler nicht ganz auszuschließen. Aus diesem Grund sieht sich die Firma Meilhaus Electronic GmbH dazu veranlaßt, darauf hinzuweisen, daß sie weder eine Garantie (abgesehen von den im Garantieschein vereinbarten Garantieansprüchen) noch die juristische Verantwortung oder irgendeine Haftung für Folgen, die auf fehlerhafte Angaben zurückgehen, übernehmen kann. Für die Mitteilung eventueller Fehler sind wir jederzeit dankbar. IBM und IBM PC/XT/AT sind Warenzeichen der International Business Machine Corporation. Delphi/Pascal ist ein Warenzeichen von Borland International, INC. Visual C++ und VisualBASIC sind Warenzeichen von Microsoft. VEE Pro und VEE OneLab sind Warenzeichen von Agilent Technologies. ME-VEC ist Warenzeichen von Meilhaus Electronic. Weitere der im Text erwähnten Firmen- und Produktnamen sind eingetragene Warenzeichen der jeweiligen Firmen.

3 Handbuch ME-6000/6100 Rev. 1.1D Inhalt 1 Einführung Lieferumfang Leistungsmerkmale Systemanforderungen Softwareunterstützung Installation Testprogramm Hardware Blockschaltbild Generelle Hinweise Hardware-Beschreibung Externer Trigger Galvanische Trennung Insel-Kanäle Option High Current Programmierung Betriebsarten Einzelwertausgabe Continuous-Mode WrapAround-Mode Hochsprachenprogrammierung Beispielprogramme Agilent VEE-Programmierung User Objects Demoprogramme Das "ME Board"-Menü LabVIEW -Programmierung Virtual Instruments Demoprogramme Meilhaus Electronic Seite 3 Inhalt

4 Rev. 1.1D Handbuch ME-6000/ Funktionsreferenz Überblick Nomenklatur Beschreibung der API-Funktionen Allgemeine Funktionen Analoge Ausgabe Fehler-Behandlung Anhang A Spezifikationen B Anschlußbelegungen B1 Anschlußbelegung Sub-D Buchse C Zubehör D Technische Fragen D1 Fax-Hotline D2 Serviceadresse D3 Treiber-Update E Index Inhalt Seite 4 Meilhaus Electronic

5 Handbuch ME-6000/6100 Rev. 1.1D 1 Einführung Sehr geehrte Kundin, sehr geehrter Kunde, Mit dem Kauf einer PC-Einsteckkarte von Meilhaus Electronic haben Sie sich für ein technologisch hochwertiges Produkt entschieden, das unser Haus in einwandfreiem Zustand verlassen hat. Überprüfen Sie trotzdem die Vollständigkeit und den Zustand Ihrer Lieferung. Sollten irgendwelche Mängel auftreten, bitten wir Sie, uns sofort in Kenntnis zu setzen. Bevor Sie die Karte in Ihren Rechner einbauen, lesen Sie bitte aufmerksam diese Bedienungsanleitung, insbesondere Kapitel 2 zur Installation durch. 1.1 Lieferumfang Wir sind selbstverständlich bemüht, Ihnen ein vollständiges Produktpaket auszuliefern. Um aber in jedem Fall sicherzustellen, daß Ihre Lieferung komplett ist, können Sie anhand nachfolgender Liste die Vollständigkeit Ihres Paketes überprüfen. Ihr Paket sollte folgende Teile enthalten: D/A-Wandlerkarte der ME-6000/6100 Familie für PCI-Bus Handbuch im PDF-Format auf CD-ROM (optional in gedruckter Form) Treiber-Software auf CD-ROM Spezial-Anschlußkabel von 78poligem Sub-D-Stecker auf 16 einzeln geschirmte Leitungen mit offenem Ende Meilhaus Electronic Seite 5 Einführung

6 Rev. 1.1D Handbuch ME-6000/ Leistungsmerkmale Modell-Übersicht Modell ME-6000/4 PCI ME-6000/8 PCI ME-6000/16 PCI ME-6100/4 PCI ME-6100/8 PCI ME-6100/16 PCI Optional für alle Modelle: Kurzbeschreibung 4 Spannungsausgänge mit galvanischer Trennung; 16 Bit, bis 500kHz je Kanal 8 Spannungsausgänge mit galvanischer Trennung; 16 Bit, bis 500kHz je Kanal 16 Spannungsausgänge mit galvanischer Trennung; 16 Bit, bis 500kHz je Kanal 4 Spannungsausgänge mit galvanischer Trennung; 16 Bit bis 500kHz je Kanal; alle 4 Kanäle timergesteuert verwendbar 8 Spannungsausgänge mit galvanischer Trennung; 16 Bit, bis 500kHz je Kanal; davon 4 Kanäle timergesteuert 16 Spannungsausgänge mit galvanischer Trennung; 16 Bit, bis 500kHz je Kanal; davon 4 Kanäle timergesteuert Insel-Kanäle (alle Kanäle voneinander entkoppelt) Tabelle 1: Modell-Übersicht ME-6000/6100 Familie Die Karten der ME-6000 Familie verfügen je nach Modell über 4-, 8- oder 16 D/A-Kanäle. Jeder Kanal hat seinen eigenen hochgenauen High Speed 16 Bit D/A-Wandler. Die Spannungsausgänge können im Ausgangsbereich ±10 V betrieben werden. Beim Spitzenmodell ME-6100 können 4 Kanäle zur Generierung von Kurvenformen verwendet werden. Jeder dieser 4 Kanäle verfügt über ein eigenes 8 kbyte großes Werte-FIFO. Damit sind Sample-Raten von bis zu 500 khz pro Kanal möglich. Sie kön- Einführung Seite 6 Meilhaus Electronic

7 Handbuch ME-6000/6100 Rev. 1.1D nen wählen zwischen der Betriebsart Continuous um kontinuierlich Werte auszugeben und der Betriebart Wraparound für periodische Signalverläufe. Bei den Modellen ME-6100/8 und ME-6100/16 sind zusätzlich 4 bzw. 12 normale D/A-Kanäle verfügbar. Für die ME-6100 erhalten Sie zusätzlich ein virtuelles Instrumenten-Panel mit einer graphischen Bedienoberfläche. Damit können Sie die Karte als Virtuellen Funktionsgenerator zur Ausgabe von periodischen Signalen verwenden. Abb. 1: Virtueller Funktionsgenerator Der D/A-Teil ist als Ganzes vom Rest der Karte galvanisch getrennt. Als Option können zusätzlich die einzelnen Kanäle voneinander entkoppelt werden (Insel-Kanäle). Damit können Genauigkeiten besser ±1% erreicht werden. Meilhaus Electronic Seite 7 Einführung

8 Rev. 1.1D Handbuch ME-6000/ Systemanforderungen Die ME-6000/6100 setzt einen PC mit Intel Pentium Prozessor oder kompatiblen Rechner voraus, der über einen freien Standard-PCI Steckplatz verfügt. Die Karte wird von allen aktuellen Windows Versionen sowie Linux und VxWorks unterstützt. 1.4 Softwareunterstützung Den aktuellen Stand des Software-Lieferumfangs entnehmen Sie bitte den entsprechenden README-Dateien. Systemtreiber ME-Software-Developer-Kit (ME-SDK): Graphische Programmierumgebungen: Für alle gängigen Betriebssysteme (siehe README-Dateien) Beispiele für alle gängigen Programmiersprachen, sowie Tools und Testprogramme Meilhaus VEE-Treibersystem für HP VEE ab Version 4.0, HP VEE Lab, Agilent VEE Pro und Agilent VEE OneLab Treibersystem für LabView ab Version 4.0 Einführung Seite 8 Meilhaus Electronic

9 Handbuch ME-6000/6100 Rev. 1.1D 2 Installation Bitte lesen Sie vor Einbau der Karte das Handbuch Ihres Rechners bzgl. der Installation von zusätzlichen Hardwarekomponenten und das Kapitel Hardware-Installation in diesem Handbuch (sofern zutreffend, z. B. für ISA-Karten). Installation unter Windows (Plug&Play) Sie finden eine Anleitung in HTML-Form auf CD-ROM. Bitte vor Installation lesen und bei Bedarf ausdrucken! Grundsätzlich gilt folgende Vorgehensweise: Falls Sie die Treiber-Software in gepackter Form erhalten haben, entpacken Sie bitte vor Einbau der Karte die Software in ein Verzeichnis auf Ihrem Rechner (z. B. C:\temp). Bauen Sie die Karte in Ihren Rechner ein und installieren Sie anschließend die Treiber-Software. Diese Reihenfolge ist wichtig, um die Plug&Play-Funktionalität unter Windows 95*/98/Me/ 2000/XP zu gewährleisten. Für Windows 95* und NT 4.0 gilt dies analog, beachten Sie jedoch die etwas andere Vorgehensweise bei der Treiberinstallation. *Sofern Windows-Version von der betreffenden Karte unterstützt wird (siehe Readme-Dateien) Installation unter Linux Beachten Sie die Installationshinweise, die in der Archiv-Datei des jeweiligen Treibers enthalten sind. 2.1 Testprogramm Zum Test der Einsteckkarte wird ein Testprogramm mitgeliefert. Sie finden das Testprogramm im entsprechenden Unterverzeichnis von C:\MEILHAUS (Default). Voraussetzung: Systemtreiber korrekt installiert. Meilhaus Electronic Seite 9 Installation

10 Rev. 1.1D Handbuch ME-6000/6100 Installation Seite 10 Meilhaus Electronic

11 Handbuch ME-6000/6100 Rev. 1.1D 3 Hardware 3.1 Blockschaltbild +U_15* Steuerlogik Register Adreß-Bus FIFOs* Interner Datenbus M UX Galvanische Trennung D A D A PCI-Bus-Interface-Logik Insel_15* Insel_0* Uout_15* GND_15* -U_15* +U_0 Uout_0 GND_0 -U_0 Ext. Trigger DA0 3 ME-6000 ME pol. Sub-D Buchse Abb. 2: Blockschaltbild der ME-6000/ME-6100 * Je nach Modell sind nicht alle Funktionsgruppen verfügbar: ME-6000/4: ME-6000/8: ME-6000/16: ME-6100/4: ME-6100/8: ME-6100/16: Optional: 4 Spannungsausgänge (Uout_0 3). 8 Spannungsausgänge (Uout_0 7). 16 Spannungsausgänge (Uout_0 15). 4 Spannungsausgänge (Uout_0 3) mit Werte-FIFO zur Kurven-Generierung 8 Spannungsausgänge (Uout_0 7), davon 4 mit FIFO zur Kurven-Generierung (Uout_0 3) 16 Spannungsausgänge (Uout_0 15), davon 4 mit FIFO zur Kurven-Generierung (Uout_0 3) Galvanisch voneinander getrennte Kanäle Meilhaus Electronic Seite 11 Hardware

12 Rev. 1.1D Handbuch ME-6000/ Generelle Hinweise Achtung: Nach Einschalten des Rechners geben die D/A-Kanäle -10V aus. Nach dem Starten des Treibers gehen die Ausgänge nach 0V. Um ein definiertes Einschaltverhalten zu erreichen starten Sie zuerst den Host-Rechner. Schalten Sie Ihre ext. Beschaltung erst nach Start des Treibers ein. Wichtiger Hinweis! Beachten Sie, daß stets ein Bezug von der externen Beschaltung zur Masse der einzelnen Kanäle hergestellt werden muß. Die Pins +U_0 15 und -U_0 15 werden benötigt, falls eine der Optionen Insel-Kanäle oder High Current (HC) verwendet werden und dürfen ansonsten nicht beschaltet werden! Stellen Sie sicher, daß bei Berührung der Karte und beim Stecken des Anschlußkabels keine statische Entladung über die Steckkarte stattfinden kann. Sämtliche Steckverbindungen der Karte sollten grundsätzlich nur im spannungslosen Zustand hergestellt bzw. gelöst werden. Achten Sie auf sicheren Sitz des Anschlußkabels. Es muß vollständig auf die Sub-D Buchse aufgesteckt und mit den beiden Schrauben fixiert werden. Nur so ist eine einwandfreie Funktion der Karte gewährleistet ist! Die Belegung der 78poligen Sub-D Buchse finden Sie im Anhang (siehe Anschlußbelegungen auf Seite 57). Hardware Seite 12 Meilhaus Electronic

13 Handbuch ME-6000/6100 Rev. 1.1D 3.3 Hardware-Beschreibung Die Karten der ME-6000 Familie sind pro Kanal mit einem seriellen 16 Bit D/A-Wandler bestückt, der mit bis zu 500 khz wandeln kann. Die Ausgangsspannung kann einen Spannungsbereich von ±10 V überstreichen. U in [V] (7FFFHex) (FFFFHex) [digits] Externer Trigger Abb. 3: Übertragungskennlinie des D/A-Wandlers Auf der ME-6100 können die Kanäle 0 3 in den Betriebsarten Continuous und Wraparound durch ein externes Triggersignal gestartet werden. Per Software kann zwischen steigender und fallender Flanke gewählt werden. Das externe Triggersignal muß gegen Masse treiben (GND_x). Beachten Sie, daß die Triggereingänge mit einem Strom I F von min. 7,5 ma gespeist werden müssen. Kanal_x Vcc (+5V) R v ext. Trigger DA_x I F = min. 7,5 ma Optokoppler GND_x Abb. 4: Beschaltung der Triggereingänge Meilhaus Electronic Seite 13 Hardware

14 Rev. 1.1D Handbuch ME-6000/ Galvanische Trennung Alle D/A-Kanäle der Karte sind über Optokoppler von der PC-Masse galvanisch getrennt. D. h. GND_0 15 sind miteinander verbunden und beziehen sich auf eine gemeinsame Masse (ISO_GND). Bei der ME-6100 sind auch die externen Triggereingänge optoentkoppelt. Der Ausgangsstrom I max pro Kanal hängt von der Anzahl der bestückten bzw. genutzten Kanäle ab (siehe Tabelle). Kanäle I max Kanäle I max 4 ±15mA 12 ±10mA 8 ±15mA 16 ±3mA Tabelle 2: Max. Ausgangsstrom Beachten Sie, daß ±15 ma pro Kanal nicht überschritten werden dürfen! Die Pins für die ext. ±15V Spannungsversorgung (+U_x und -U_x) werden intern getrieben und dürfen nicht extern beschaltet werden! Galvanische Trennung Optokoppler Kanal_x D A +U_x Uout_x = ±10V -U_x GND_x I max ISO_GND Pins nicht beschalten! R L Abb. 5: Galvanische Trennung aller Kanäle Hardware Seite 14 Meilhaus Electronic

15 Handbuch ME-6000/6100 Rev. 1.1D Insel-Kanäle Mit der Option Insel-Kanäle haben alle D/A-Kanäle voneinander unabhängige Masse-Potentiale und Versorgungs-Pins. D. h. Sie müssen die Bezugsmasse des jeweiligen Kanals (GND_0 15) einzeln mit der entsprechenden Masse Ihres externen Schaltungsteils verbinden. Außerdem benötigen Sie für jeden Insel-Kanal eine eigenständige, symmetrische Versorgungsspannung von ±15 V (±22mA pro Kanal für I max = ±15mA). Bei Verwendung einer hochwertigen, rauscharmen Spannungsquelle können Sie damit hervorragende Genauigkeiten besser ±1% erreichen. Bei der ME-6100 sind auch die ext. Triggereingänge in die Inseln miteinbezogen. Sie können pro D/A-Kanal max. ±15mA treiben. Galvanische Trennung Optokoppler Insel_x D A +U_x = +15V Uout_x = ±10V I max = ±15 ma -U_x = -15V GND_x Insel-Masse R L Abb. 6: Insel-Kanäle Meilhaus Electronic Seite 15 Hardware

16 Rev. 1.1D Handbuch ME-6000/ Option High Current Die Option High Current (HC) können Sie mit den Kartenvarianten ohne Insel-Kanäle kombinieren. Dadurch haben Sie die Möglichkeit den Ausgangsstrom pro Kanal auf I max = ±15mA zu erhöhen. Dies erfordert eine externe, rauscharme Spannungsversorgung von ±15V (±22mA pro Kanal für I max = ±15mA) und eine Änderung der Hardware bitte kontaktieren Sie dazu unsere Service-Abteilung (siehe Seite 59). Galvanische Trennung Optokoppler Kanal_x D A +U_x = +15V Uout_x = ±10V I max = ±15 ma -U_x = -15V GND_x ISO_GND R L Abb. 7: Schematische Beschaltung der Ausgänge in der Option High Current (mit galvanischer Trennung) Hardware Seite 16 Meilhaus Electronic

17 Handbuch ME-6000/6100 Rev. 1.1D 4 Programmierung Bevor Sie mit der Karte arbeiten können, muß sie für die entsprechende Betriebsart konfiguriert werden. Dies geschieht durch geeignete Programmierung mit der mitgelieferten Treibersoftware, siehe Kap. 5.3 Beschreibung der API-Funktionen auf Seite 33. Grundsätzlich sollte nach jedem Funktionsaufruf eine Fehlerabfrage mit Hilfe der Funktion me6x00getdrverrmess gemacht werden. Für die ME-6100 erhalten Sie zusätzlich ein virtuelles Instrumenten-Panel mit einer graphischen Bedienoberfläche. Damit können Sie die Karte sofort als virtuellen Funktionsgenerator zur Ausgabe von periodischen Signalen verwenden. 4.1 Betriebsarten Einzelwertausgabe Diese Betriebsart ist für alle Modelle der ME-6000 Familie verfügbar. Der auszugebende Spannungswert wird in den entsprechenden D/A-Wandler geladen und sofort ausgegeben (transparent). Verwenden Sie folgende Funktionen für Konfiguration und Start der hier beschriebenen Betriebsart: me6x00aosingle (Lädt einzelnen Wert in den D/A-Wandler und gibt diesen sofort aus) Das folgende Beispiel soll die grundsätzliche Vorgehensweise erläutern, es erhebt jedoch keinen Anspruch auf syntaktische Richtigkeit (siehe auch Funktionsbeschreibung auf Seite 45 sowie Beispielprogramme im ME-SDK). //Im folgenden Beispiel sprechen alle Funktionen die Karte mit der //logischen <BoardNumber> 0 an iboardnumber = 0; //Transparente Ausgabe von +10V return = me6x00aosingle(iboardnumber, AO_CH05, 0xFFFF); if (return == 0) then me6x00getdrverrmess("me6000-test"); endif; Meilhaus Electronic Seite 17 Programmierung

18 Rev. 1.1D Handbuch ME-6000/ Continuous-Mode Diese Betriebsart ist nur für das Modell ME-6100 verfügbar. Damit können Sie auf den Kanälen 0 3 voneinander unabhängige, beliebige, sich kontinuierlich ändernde Signalverläufe ausgeben. Diese sind in der Regel nicht periodisch im Gegensatz zur Betriebsart WrapAround. Die D/A-FIFOs der einzelnen Kanäle müssen kontinuierlich nachgeladen werden. Erzeugen Sie für jeden Kanal ein Wertefeld mit den gewünschten Werten. Die Ausgabe erfolgt timergesteuert; dazu müssen Sie vorher den Zeitgeber (Timer) konfigurieren, der ein festes Zeitraster (Sample-Rate) für die Wandlung der einzelnen Werte vorgibt (me6x00aosettimer). Wenn Ihr Programm parallel dazu weitere Aufgaben abarbeiten soll (hängt auch von der Rechenleistung Ihres Systems ab), verwenden Sie die Funktion me6x00aocontinuousex (Hintergrundbetrieb). Das Nachladen der FIFOs muß in diesem Fall mit einer anwenderdefinierten Callback-Funktion erfolgen (siehe Bespiel im ME-SDK). Gestartet wird die Ausgabe durch Aufruf der Funktion me6x00aostart oder durch eine Flanke am externen Triggereingang (siehe me6x00aosettrigger). Mit den Funktionen me6x00aostop(ex) und me6x00aoreset wird die Ausgabe sofort und vollständig beendet. Beachten Sie, daß die Ausgabe nach Aufruf der Funktion me6x00aocontinuous(ex) unbedingt gestartet werden muß, bevor Sie die Ausgabe wieder beenden können. (Diagramm siehe nächste Seite) Programmierung Seite 18 Meilhaus Electronic

19 Handbuch ME-6000/6100 Rev. 1.1D Das folgende Diagramm soll die grundsätzliche Vorgehensweise im Continuous-Mode veranschaulichen. Beginn Sample-Rate me6000frequencytotimer Umrechnung der Abtastrate zur Übergabe an die Funktion me6000aosettimer Ticks me6000aosettimer Konfigurieren des Timers Triggermode me6000aosettrigger Start per me6000aostart oder ext. Trigger? Wertefeld me6000aocontinuous Vorbereiten der kontinuierlichen Ausgabe Warten me6000aostart Ausgabe per Software starten Ausgabe durch ext. Trigger starten Ausgabe läuft me6000aocontinuous Interruptgesteuertes Nachladen des FIFOs nein Beenden? ja me6000aostop oder me6000aoreset Ausgabe beenden Ende Abb. 8: Programmierung des Continuous-Mode Meilhaus Electronic Seite 19 Programmierung

20 Rev. 1.1D Handbuch ME-6000/6100 Beispiel Continuous-Mode: Das folgende Beispiel soll die grundsätzliche Vorgehensweise erläutern, erhebt jedoch keinen Anspruch auf syntaktische Richtigkeit (siehe auch Funktionsbeschreibung auf Seite 38 sowie Beispielprogramme im ME-SDK). //Im folgenden Beispiel sprechen alle Funktionen Kanal 0 der Karte //mit der logischen <BoardNumber> 0 an. Die Sample-Rate soll //300kHz betragen. iboardnumber = 0; ichannel = AO_CH00; dfreq = ; //Umrechnung der Sample rate ( Hz) in Ticks iticks = me6x00frequencytotimer(dfreq); //Übergabe der Ticks (110 Ticks) an die Funktion me6x00aosettimer //zur Konfigurierung des Timers me6x00aosettimer(iboardnumber, ichannel, iticks); //Die Ausgabe soll per Software gestartet werden. me6x00aosettrigger(iboardnumber, ichannel, AO6000_TRIGGER_TIMER); //Wertefeld mit der Größe BUFFER_SIZE ein erstes Mal erzeugen... //Continuous-Mode vorbereiten mit Zeiger auf Wertefeld //(max.64k Werte) me6x00aocontinuous(iboardnumber, ichannel, BUFFER_SIZE, psbuffer); //Starten der kontinuierlichen Ausgabe me6x00aostart(iboardnumber, AO_CH00); while (TRUE) { //Wertefeld mit der Größe BUFFER_SIZE erneut beschreiben... me6x00aocontinuous(iboardnumber, ichannel, BUFFER_SIZE, psbuffer); } //Continuous-Mode vollständig beenden me6x00aostop(iboardnumber, ichannel); Programmierung Seite 20 Meilhaus Electronic

21 Handbuch ME-6000/6100 Rev. 1.1D WrapAround-Mode Diese Betriebsart ist nur für das Modell ME-6100 verfügbar. Im WrapAround -Modus können Sie auf den Kanälen 0 3 voneinander unabhängige, periodische Signale generieren. Vor Beginn der Ausgabe werden die D/A-FIFOs der einzelnen Kanäle einmalig geladen. Erzeugen Sie für jeden Kanal ein Wertefeld mit den gewünschten Werten, das später periodisch ausgegeben wird. Die Ausgabe erfolgt timergesteuert auf Firmware-Ebene. Dazu müssen Sie vorher den Zeitgeber (Timer) konfigurieren, der ein festes Zeitraster (Sample-Rate) für die Wandlung der einzelnen Werte vorgibt (me6x00aosettimer). Gestartet wird die Ausgabe durch Aufruf der Funktion me6x00aostart oder durch eine Flanke am externen Triggereingang (siehe me6x00aosettrigger). Mit der Funktion me6x00aostop können Sie die Ausgabe vorübergehend stoppen, d. h. am entsprechenden D/A-Kanal wird nach Anhalten der Ausgabe der letzte Wert im D/A-FIFO und damit ein definierter Spannungswert ausgegeben. Sofern zwischenzeitlich die Betriebsart für diesen Kanal nicht gewechselt wurde, kann die Ausgabe mit der Funktion me6x00aostart jederzeit neu gestartet werden. Durch Aufruf der Funktion me6x00aoreset wird die Ausgabe nach Abarbeitung des Werte-FIFOs vollständig beendet. Beachten Sie, daß die Ausgabe nach Aufruf der Funktion me6x00aowraparound mindestens einmal gestartet werden muß, bevor Sie die Ausgabe wieder beenden können. (Diagramm siehe nächste Seite) Meilhaus Electronic Seite 21 Programmierung

22 Rev. 1.1D Handbuch ME-6000/6100 Das folgende Diagramm soll die grundsätzliche Vorgehensweise im WrapAround-Mode veranschaulichen. Beginn Sample-Rate me6000frequencytotimer Umrechnung der Abtastrate zur Übergabe an die Funktion me6000aosettimer Ticks me6000aosettimer Konfigurieren des Timers Triggermode me6000aosettrigger Start per me6000aostart oder ext. Trigger? Wertefeld me6000aowraparound Vorbereiten der periodischen Ausgabe Warten me6000aostart Ausgabe per Software starten Ausgabe durch ext. Trigger starten Ausgabe läuft auf Firmware-Ebene me6000aostop Ausgabe anhalten me6000aoreset Ausgabe beenden Ende Abb. 9: Programmierung WrapAround-Mode Programmierung Seite 22 Meilhaus Electronic

23 Handbuch ME-6000/6100 Rev. 1.1D Beispiel WrapAround-Mode: Das folgende Beispiel soll die grundsätzliche Vorgehensweise erläutern, erhebt jedoch keinen Anspruch auf syntaktische Richtigkeit (siehe auch Funktionsbeschreibung auf Seite 52 sowie Beispielprogramme im ME-SDK). //Im folgenden Beispiel sprechen alle Funktionen Kanal 0 der Karte //mit der logischen <BoardNumber> 0 an iboardnumber = 0; ichannel = AO_CH00; dfreq = ; //Umrechnung der Sample-Rate (320000Hz) in Ticks iticks = me6x00frequencytocounter(dfreq); //Übergabe der Ticks (1650 ticks) an die Funktion me6x00aosettimer //zur Konfigurierung des Timers me6x00aosettimer(iboardnumber, ichannel, iticks); //Die Ausgabe soll durch eine steigende Flanke des ext. Triggers //gestartet werden. me6x00aosettrigger(iboardnumber, ichannel, AO6000_TRIGGER_EXT_HIGH); //Ausgabe einer Sinusschwingung die mit 16 Stufen angenähert //werden soll. => Frequenz des Sinus: 20kHz bei 320kHz Sample-Rate //Es muß ein Wertefeld der Größe BUFFER_SIZE = 16 erzeugt werden.... //WrapAround-Mode vorbereiten me6x00aowraparound(iboardnumber, ichannel, BUFFER_SIZE, psbuffer); //Starten der periodischen Ausgabe me6x00aostart(iboardnumber, ichannel);... //WrapAround-Mode vorübergehend stoppen me6x00aostop(iboardnumber, ichannel); //Neustart der periodischen Ausgabe möglich, sofern zwischenzeitlich keine andere Betriebsart gewählt wurde me6x00aostart(iboardnumber, ichannel); //WrapAround-Mode vollständig beenden me6x00aoreset(iboardnumber, ichannel); Meilhaus Electronic Seite 23 Programmierung

24 Rev. 1.1D Handbuch ME-6000/ Hochsprachenprogrammierung Folgende Hochsprachen werden standardmäßig unterstützt: Visual C++ ab Version 4.0. Delphi ab Version 2.0. VisualBASIC ab Version 4.0. Für weitere Infos beachten Sie bitte die entsprechenden README-Dateien auf der ME-Power-CD. Es ist darauf zu achten, daß für den Compiler und Linker die Pfade auf diese Dateien richtig gesetzt sind. Durch Einbinden der hochsprachenspezifischen Definitionsdatei in Ihr Projekt können Sie viele Parameter in Form vordefinierter Konstanten und Makros übergeben. Alternativ ist die direkte Übergabe des entsprechenden Hex-Wertes jederzeit möglich. Programmierung Seite 24 Meilhaus Electronic

25 Handbuch ME-6000/6100 Rev. 1.1D Beispielprogramme Zum leichteren Verständnis der Programmierung werden einfache Beispiele und kleine Projekte im Source-Code mitgeliefert. Die Beispielprogramme finden Sie im ME Software Developer Kit (ME-SDK), das standardmäßig ins Verzeichnis C:\Meilhaus\ me-sdk installiert wird. Bitte beachten Sie die Hinweise in den entsprechenden README-Dateien. 4.3 Agilent VEE-Programmierung Die Agilent VEE-Komponenten für Ihre Karte finden Sie auf der ME-Power-CD oder zum Download unter Das Meilhaus VEE Treibersystem unterstützt die HP VEE Vollversionen 4.x und 5.x, HP VEE Lab, Agilent VEE Pro und Agilent VEE OneLab. Zur Installation der VEE-Komponenten und für weitere Infos beachten Sie bitte die Dokumentation, die Sie mit dem VEE Treibersystem erhalten. Zu den Grundlagen der VEE- Programmierung benutzen Sie bitte Ihre VEE Dokumentation und die VEE Online-Hilfe. Meilhaus Electronic Seite 25 Programmierung

26 Rev. 1.1D Handbuch ME-6000/ User Objects Zur komfortableren Handhabung des Treibers wurden vordefinierte User Objects erstellt, welche intern API-Funktionen aufrufen. Diese sind über den zusätzlichen Menüpunkt ME Board in der VEE-Entwicklungsumgebung aufrufbar und können wie andere Standard-Funktionen von VEE auch in der Entwicklungsumgebung plaziert und in einer Applikation verdrahtet werden. Die User Objects sind weitgehend selbsterklärend und basieren auf den im Kap. Funktionsreferenz dokumentierten API-Funktionen. Zusätzlich gibt es noch sog. Expanded User Objects, um Ihnen das Programmieren so bequem wie möglich zu machen. Eine Kurzbeschreibung zum jeweiligen User Object finden Sie auch unter Description indem Sie den Mauszeiger über das entsprechende UO bewegen und die rechte Maustaste drücken. Die User Objects können für eigene Bedürfnisse jederzeit geändert, angepaßt und bei Bedarf als kundenspezifisches Objekt abgespeichert werden. Programmierung Seite 26 Meilhaus Electronic

27 Handbuch ME-6000/6100 Rev. 1.1D Demoprogramme Zur Demonstration und zum leichteren Verständnis wurden kleine Demoprogramme erstellt, die alle wichtigen User Objects enthalten. Die Demoprogramme sind über den Menüpunkt ME Board Demos aufrufbar. Die VEE-Demoprogramme enthalten teilweise auch Ergänzungen der normalen User Objects und tragen zur leichteren Unterscheidung von diesen das Präfix "x " im Dateinamen. Meilhaus Electronic Seite 27 Programmierung

28 Rev. 1.1D Handbuch ME-6000/ Das "ME Board"-Menü Das Installationsprogramm erweitert die Menüleiste von VEE automatisch um den Eintrag ME Board. Dadurch ist eine komfortable Nutzung aller unter VEE zur Verfügung stehenden Treiberfunktionen möglich. Über das ME Board -Menü können Sie nach Kartenfamilien geordnet, die ent-sprechenden Treiberund Demo-User Objects aufrufen. Hinweis: Der Installationsumfang der User Objects (UOs) richtet sich nach der von Ihnen gewählten Kartenfamilie(n) zu Beginn der VEE Treiber-Installation. Sollten Sie UOs im ME Board -Menü aufrufen, die jedoch nicht installiert wurden, so führt dies zur Fehlermeldung: File filename was not found. Error number: 700 Bei Bedarf können Sie die benötigten VEE Komponenten jederzeit nachinstallieren (siehe ME-Power-CD ). 4.4 LabVIEW -Programmierung Die LabVIEW -Komponenten für Ihre Karte finden Sie auf der ME-Power-CD oder zum Download unter Die Meilhaus LabVIEW -Treiber unterstützen die LabVIEW Vollversionen 4.x oder höher. Zur Installation der LabVIEW - Komponenten und für weitere Infos beachten Sie bitte die Dokumentation, die Sie mit dem jeweiligen LabVIEW-Treiber erhalten. Zu den Grundlagen der LabVIEW -Programmierung benutzen Sie bitte Ihre LabVIEW Dokumentation und die LabVIEW Online-Hilfe. Programmierung Seite 28 Meilhaus Electronic

29 Handbuch ME-6000/6100 Rev. 1.1D Virtual Instruments Zur komfortableren Handhabung des Treibers wurden vordefinierte Virtual Instruments (VIs) erstellt. Diese sind über das Menü Datei - Öffnen in LabVIEW aufrufbar und können wie andere Standard-VIs von LabVIEW auch in der Entwicklungsumgebung plaziert und in einer Applikation verdrahtet werden. Die Source VIs sind weitgehend selbsterklärend und basieren auf den im Kap. Funktionsreferenz dokumentierten API-Funktionen. Zusätzlich gibt es noch sog. Expanded Virtual Instruments, um Ihnen das Programmieren so bequem wie möglich zu machen. Eine Kurzbeschreibung zum jeweiligen VI finden Sie auch im VI Function Tree. Dieses VI dient nur der Dokumentation und kann über das Menü Datei - Öffnen aufgerufen werden. Unter Description finden Sie eine Kurzbeschreibung zum jeweiligen VI. Die VIs können für eigene Bedürfnisse jederzeit geändert, angepaßt und bei Bedarf als kundenspezifisches VI abgespeichert werden. Meilhaus Electronic Seite 29 Programmierung

30 Rev. 1.1D Handbuch ME-6000/ Demoprogramme Zur Demonstration und zum leichteren Verständnis wurden kleine Demoprogramme erstellt, die alle wichtigen Virtual Instruments (VIs) enthalten. Die Demoprogramme sind über das Menü Datei Öffnen aufrufbar. Programmierung Seite 30 Meilhaus Electronic

31 Handbuch ME-6000/6100 Rev. 1.1D 5 Funktionsreferenz 5.1 Überblick Der 32 Bit-Treiber für die ME-6000/6100 wurde für die neue Windows Treiberarchitektur Windows Driver Model (WDM) entwickelt. Zur Unterstützung der Karte unter Windows NT4.0 steht zusätzlich ein herkömmlicher Kernel-Treiber zur Verfügung. Ein VxD-Treiber wie er noch von Windows 95 verwendet wird ist nicht vorgesehen. Der Systemtreiber besteht aus folgenden Komponenten: WDM-Treiber (ME6000.SYS) für Windows 98/Me/2000/XP. Kernel-Treiber (ME6000.SYS) für Windows NT4.0. API-DLL (ME6000.DLL) mit den Treiber-Funktionen für den Kartentyp ME Nachdem der Treiber erfolgreich geladen wurde, ermöglichen die API-Funktionen einen komfortablen Zugriff auf die Hardware. Jede Funktion, die auf eine Karte vom Typ ME-6000/6100 zugreifen soll, benötigt zur Identifizierung der Karte einen Integerwert. In der nun folgenden Beschreibung der Funktionen ist dieser Parameter mit <BoardNumber> bezeichnet. Er spezifiziert die anzusprechende Karte, wobei folgendes gilt: 5.2 Nomenklatur Die API-Funktionen sind kartenspezifisch gehalten. Jede API- Funktion für die Karten des Typs ME-6000/6100 beginnt mit dem Präfix me6x00. Für die Funktionsnamen wurden weitgehend selbstredende Bezeichner verwendet. Jeder Funktionsname besteht aus aus einem kartentypspezifischen Präfix und mehreren Bestandteilen für die entsprechende Funktionsgruppe (z. B. AO für analoge Ausgabe). Meilhaus Electronic Seite 31 Funktionsreferenz

32 Rev. 1.1D Handbuch ME-6000/6100 Für die Funktionsbeschreibung gelten folgende Vereinbarungen: Funktionsnamen werden im Fließtext kursiv geschrieben z. B. me6x00getboardversion <Parameter> werden in spitzen Klammern in der Schriftart Courier geschrieben <Variablen> als Platzhalter für vordefinierte Konstanten werden kursiv geschrieben und in spitze Klammern gesetzt [eckige Klammern] werden für optional verwendbare Variablen verwendet DATEINAMEN oder PFADE werden in Großbuchstaben in der Schriftart Courier geschrieben me6x00 () Programmausschnitte sind in der Schriftart Courier geschrieben Zur Kennzeichnung des Datentyps werden folgende Kennbuchstaben verwendet: i oder dw s oder w c oder b 32-Bit Integer-Wert 16-Bit Short-Wert 8-Bit Character-Wert p Zeiger auf Datentyp (i, s oder c) Funktionsreferenz Seite 32 Meilhaus Electronic

33 Handbuch ME-6000/6100 Rev. 1.1D 5.3 Beschreibung der API-Funktionen Die Funktionsbeschreibung ist nach den folgenden Funktionsgruppen geordnet; innerhalb einer Funktionsgruppe gilt alphabetische Reihenfolge: Allgemeine Funktionen auf Seite Analoge Ausgabe auf Seite Fehler-Behandlung auf Seite 54 Funktion Kurzbeschreibung Seite Allgemeine Funktionen me6x00frequencytotimer Konvertiert Frequenz zur Übergabe an me6x00aosettimer me6x00getboardversion Kartenversion ermitteln 35 me6x00getdllversion DLL-Versionsnummer ermitteln 36 me6x00getdriverversion Treiber-Versionsnummer ermitteln 36 Analoge Ausgabe me6x00aocontinuous/ex Kontinuierliche Ausgabe vorbereiten 38 me6x00aoreset Ausgabe wird beendet und Ausgangskanal 41 auf 0 V gesetzt me6x00aoresetall Gesamte Karte wird in den Grundzustand 42 gesetzt me6x00aosettimer D/A-Timer konfigurieren 43 me6x00aosettrigger Triggermodi konfigurieren 44 me6x00aosingle Einzelwert ausgeben (transparent) 45 me6x00aostart Wraparound- oder Continuous-Mode 46 starten me6x00aostop/ex WrapAround- und Continuous-Mode 47 stoppen bzw. beenden me6x00aowavegen Einfacher Funktionsgenerator 50 me6x00aowraparound Periodische Ausgabe vorbereiten 52 Fehler-Behandlung me6x00getdrverrmess Fehlerstring gemäß Fehlercode 54 Tabelle 3: Übersicht der Bibliotheksfunktionen 34 Meilhaus Electronic Seite 33 Funktionsreferenz

34 Rev. 1.1D Handbuch ME-6000/ Allgemeine Funktionen me6x00frequencytotimer Beschreibung Konvertiert die Sample-Rate (max. 500 khz) in die Anzahl der Ticks zur Übergabe an die Funktion me6x00aosettimer. Minimal 66 Ticks entsprechen 500 khz; max. (2 32-1) Ticks entsprechen einer Periodendauer von ca. 130s (siehe auch Beschreibung der Funktion me6x00aosettimer). Hinweis: Die Sample-Rate ist nicht die Frequenz einer periodisch auszugebenden Kurvenform! Definitionen C: int me6x00frequencytotimer(double dfreq); Delphi: Function me6x00frequencytotimer (dfreq: double): integer; Basic: Declare Function me6x00frequencytotimer Lib me6x00 Alias (ByVal dfreq As Double) As Long Parameter Modell: ME-6000 ME-6100 verfügbar: Kanal 0 3 <Freq> Rückgabewert Gewünschte Sample-Rate in [Hz]; Wertebereich: 0, Rückgabe der errechneten Ticks als Integerwert (best mögliche Annäherung). Funktionsreferenz Seite 34 Meilhaus Electronic

35 Handbuch ME-6000/6100 Rev. 1.1D me6x00getboardversion Beschreibung Modell: ME-6000 ME-6100 verfügbar: Es wird die Kartenversion für eine installierte Karte der Kartenfamilie ME-6000 ermittelt. Definitionen C: int me6x00getboardversion (int iboardnumber, int *piversion) Delphi: Function me6x00getboardversion (iboardnumber: integer; Var iversion: integer): integer; Basic: Declare Function me6x00getboardversion Lib "me6x00" Alias (ByVal iboardnumber As Long, iversion As Long) As Long Parameter <BoardNumber>Nummer der anzusprechenden Karte vom Typ ME-6000/6100 (0 31) <Version> Zeiger auf Integer-Variable, in der die Device-ID zurückgegeben wird. Mögliche Werte sind: 6004Hex: ME-6000/4 Standard 6008Hex: ME-6000/8 Standard 600FHex: ME-6000/16 Standard 6014Hex: ME-6000/4 Opto 6018Hex: ME-6000/8 Opto 601FHex: ME-6000/16 Opto 6034Hex: ME-6000/4 Insel 6038Hex: ME-6000/8 Insel 603FHex: ME-6000/16 Insel 6104Hex: ME-6100/4 Standard 6108Hex: ME-6100/8 Standard 610FHex: ME-6100/16 Standard 6114Hex: ME-6100/4 Opto 6118Hex: ME-6100/8 Opto 611FHex: ME-6100/16 Opto 6134Hex: ME-6100/4 Insel 6138Hex: ME-6100/8 Insel 613FHex: ME-6100/16 Insel Meilhaus Electronic Seite 35 Funktionsreferenz

36 Rev. 1.1D Handbuch ME-6000/6100 Rückgabewert Wurde die Funktion erfolgreich ausgeführt, so wird 1 zurückgege-- ben. Im Fehlerfall wird 0 zurückgegeben. Die genaue Fehlerursache kann dann über me6x00getdrverrmess ermittelt werden.) me6x00getdllversion Beschreibung Modell: ME-6000 ME-6100 verfügbar: Ermittelt die Versionsnummer der Treiber-DLL. Definitionen C: int me6x00getdllversion(); Delphi: Function me6x00getdllversion: integer; Basic: Declare Function me6x00getdllversion Lib "me6x00_32" Alias "_VBme6x00GetDLLVersion@0" () As Long Parameter keine Rückgabewert Versionsnummer. Der 32-Bit-Wert enthält in den höherwertigen 16 Bit die Hauptversion und in den niederwertigen 16 Bit die Unterversion. Beispiel: 0x ergibt die Version 2.01 me6x00getdriverversion Beschreibung Modell: ME-6000 ME-6100 verfügbar: Ermittelt die Versionsnummer des Treibers für die ME-6000/6100. Funktionsreferenz Seite 36 Meilhaus Electronic

37 Handbuch ME-6000/6100 Rev. 1.1D Definitionen C: int me6x00getdriverversion(char *pbuffer); Delphi: Function me6x00getdriverversion (Var pbuffer: string): integer; Basic: Declare Function me6x00getdriverversion Lib me6x00 Alias (ByVal pbuffer As String) As Long Parameter <Buffer> Rückgabewert Zeiger auf den String der Treiberversion. Wurde die Funktion erfolgreich ausgeführt, so wird 1 zurückgegeben. Im Fehlerfall wird 0 zurückgegeben. Die genaue Fehlerursache kann über me6x00getdrverrmess ermittelt werden. Analoge Ausgabe Meilhaus Electronic Seite 37 Funktionsreferenz

38 Rev. 1.1D Handbuch ME-6000/ Analoge Ausgabe me6x00aocontinuous Beschreibung Modell: ME-6000 ME-6100 verfügbar: Kanal 0 3 Funktion gilt nur für das Modell ME-6100, Kanal 0 3. Diese Funktion dient der Vorbereitung der Betriebsart Continuous. Sie können damit beliebige Signalverläufe ausgeben, die in der Regel nicht periodisch sind (im Gegensatz zur Betriebsart WrapAround ). Die D/A-FIFOs der einzelnen Kanäle müssen kontinuierlich nachgeladen werden. Erzeugen sie für jeden Kanal einen Ausgabepuffer definierter Größe (max. 64k Werte) mit den auszugebenden Werten. Die Ausgabe erfolgt timergesteuert; dazu müssen Sie vorher den Zeitgeber (Timer) konfigurieren, der ein festes Zeitraster (Sample-Rate) für die Wandlung der einzelnen Werte vorgibt (me6x00aosettimer). Bei erstmaligem Aufruf der Funktion me6x00aocontinuous wird eine möglicherweise noch aktive Betriebsart auf dem betreffenden Kanal beendet, der Kanal auf 0V gesetzt, das D/A-FIFO gelöscht und anschließend erstmalig geladen. Gestartet wird die Ausgabe durch Aufruf der Funktion me6x00aostart oder durch eine Flanke am externen Triggereingang (siehe me6x00aosettrigger). Mit den Funktionen me6x00aostop oder me6x00aoreset wird die Ausgabe sofort und vollständig beendet. Siehe auch Kap. Betriebsarten auf Seite 18 und Programmierbeispiele im ME-Software-Developer-Kit. Hinweis! Beachten Sie, daß Sie nach Aufruf der Funktion me6x00aocontinuous die Ausgabe unbedingt starten müssen, bevor Sie mit me6x00aostop oder me6x00aoreset die Ausgabe beenden können. Ansonsten kann es zu Fehlfunktionen kommen! Definitionen C: int me6x00aocontinuous (int iboardnumber, int ichannel, int isize, short *psbuffer); Funktionsreferenz Seite 38 Meilhaus Electronic

39 Handbuch ME-6000/6100 Rev. 1.1D Delphi: Basic: Parameter Function me6x00aocontinuous (iboardnumber, ichannel, isize: integer; psbuffer: tmeaobuffer): integer; Declare Function me6x00aocontinuous Lib me6x00 Alias (ByVal lboardnumber As Long, ByVal lchannel As Long, ByVal lsize As Long, ByVal pibuffer As Integer) As Long <BoardNumber>Nummer der anzusprechenden Karte vom Typ ME-6000/6100 (0 31) <Channel> Kanal-Nummer; mögliche Werte: <Kanal> Beschreibung AO_CH00 AO_CH03 Kanal 0 3 (00Hex 03Hex) <Size> Größe des Ausgabepuffers (max. 64k Werte) <Buffer> Zeiger auf Puffer mit den auszugebenden Werten Rückgabewert Wurde die Funktion erfolgreich ausgeführt, so wird 1 zurückgegeben. Im Fehlerfall wird 0 zurückgegeben. Die genaue Fehlerursache kann dann über me6x00getdrverrmess ermittelt werden. me6x00aocontinuousex Beschreibung Modell: ME-6000 ME-6100 verfügbar: Kanal 0 3 Variante von me6x00aocontinuous (siehe oben) für den Hintergrundbetrieb. Diese Funktion erlaubt Ihnen parallel weitere Aufgaben abzuarbeiten (hängt jedoch von der Rechenleistung Ihres Systems ab). Das Nachladen der FIFOs muß in diesem Fall mit einer anwenderdefinierten Callback-Funktion erfolgen (siehe Beispiel im ME-SDK). Gestartet wird die Ausgabe durch Aufruf der Funktion me6x00aostart oder durch eine Flanke am externen Triggereingang (siehe me6x00aosettrigger). Beenden Sie die Ausgabe mit der Funktion me6x00aostopex, falls Sie im Parameter <Loops> die Konstante AO6000_INFINITE (unendlich) übergeben haben. Siehe auch Kap. Betriebsarten auf Seite 18 und Programmierbeispiele im ME-Software-Developer-Kit. Meilhaus Electronic Seite 39 Funktionsreferenz

40 Rev. 1.1D Handbuch ME-6000/6100 Hinweis! Beachten Sie, daß Sie nach Aufruf der Funktion me6x00aocontinuousex die Ausgabe unbedingt starten müssen, bevor Sie die Ausgabe (in Abhängigkeit vom Parameter <Loops>) beenden können. Bei Verwendung von AO6000_INFINITE beenden Sie die Ausgabe mit der Funktion me6x00aostopex. Ansonsten kann es zu Fehlfunktionen kommen! Definitionen C: int me6x00aocontinuousex (int iboardnumber, int ichannel, int isize, short *psbuffer, int iloops, PVOID_PROC pcallback, PVOID_PROC pargs); Delphi: Function me6x00aocontinuousex (iboardnumber, ichannel, isize: integer; psbuffer: tmeaobuffer; iloops: integer; pcallback, pargs: PVOID_PROC): integer; Basic: Declare Function me6x00aocontinuousex Lib me6x00 Alias (ByVal lboardnumber As Long, ByVal lchannel As Long, ByVal lsize As Long, ByVal pibuffer As Integer, ByVal lloops As Long, ByVal pcallback As Long, ByVal pargs As Long) As Long Parameter <BoardNumber>Nummer der anzusprechenden Karte vom Typ ME-6000/6100 (0 31) <Channel> Kanal-Nummer; mögliche Werte: <Kanal> Beschreibung AO_CH00 AO_CH03 Kanal 0 3 (00Hex 03Hex) <Size> Größe des Ausgabepuffers (max. 64k Werte) <Buffer> Zeiger auf Ausgabepuffer mit den auszugebenden Spannungswerten <Loops> Anzahl der Wiederholungen; für unendlich können Sie die Konstante AO6000_INFINITE verwenden <Callback> Zeiger auf anwenderdefinierte Callback-Funktion <Args> Optional kann der Callback-Funktion hier ein Parameter übergeben werden (ansonsten NULL- Pointer übergeben) Funktionsreferenz Seite 40 Meilhaus Electronic

41 Handbuch ME-6000/6100 Rev. 1.1D Rückgabewert Wurde die Funktion erfolgreich ausgeführt, so wird 1 zurückgegeben. Im Fehlerfall wird 0 zurückgegeben. Die genaue Fehlerursache kann dann über me6x00getdrverrmess ermittelt werden. me6x00aoreset Beschreibung Modell: ME-6000 ME-6100 verfügbar: Diese Funktion beendet eine laufende Ausgabe des betreffenden Kanals in den Betriebsarten Continuous oder WrapAround. In der Betriebsart Continuous wird die Ausgabe sofort und vollständig beendet. Dagegen wird in der Betriebsart WrapAround die Ausgabe mit dem letzten FIFO-Wert gestoppt. Danach wird das korrespondierende FIFO gelöscht und der Kanal auf 0V gesetzt. Hinweis! Bevor Sie diese Funktion aufrufen, müssen Sie sicherstellen, daß nach Aufruf der Funktion me6x00aocontinuous bzw. me6x00aowraparound die Ausgabe mit me6x00aostart oder durch ein externes Triggersignal tatsächlich gestartet wurde. Ansonsten kann es zu Fehlfunktionen kommen! Definitionen C: int me6x00aoreset (int iboardnumber, int ichannel); Delphi: Function me6x00aoreset (iboardnumber, ichannel: integer): integer; Basic: Declare Function meao6000reset Lib "me6x00" Alias "_VBme6x00AOReset@8" (ByVal iboardnumber As Long, ByVal lchannel As Long) As Long Parameter <BoardNumber>Nummer der anzusprechenden Karte vom Typ ME-6000/6100 (0 31) <Channel> Kanal-Nummer; mögliche Werte: <Kanal> Beschreibung AO_CH00 AO_CH15 Kanal 0 15 (00Hex 15Hex) Meilhaus Electronic Seite 41 Funktionsreferenz

42 Rev. 1.1D Handbuch ME-6000/6100 Rückgabewert Wurde die Funktion erfolgreich ausgeführt, so wird 1 zurückgegeben. Im Fehlerfall wird 0 zurückgegeben. Die genaue Fehlerursache kann dann über me6x00getdrverrmess ermittelt werden. me6x00aoresetall Beschreibung Diese Funktion beendet jegliche Aktion auf der betreffenden Karte. Es wird ein genereller Reset der Karte durchgeführt. Danach geben alle Ausgänge 0V aus. Definitionen C: int me6x00aoresetall (int iboardnumber); Delphi: Function me6x00aoresetall (iboardnumber: integer): integer; Basic: Declare Function meao6000resetall Lib "me6x00" Alias "_VBme6x00AOResetAll@4" (ByVal iboardnumber As Long) As Long Parameter Modell: ME-6000 ME-6100 verfügbar: <BoardNumber>Nummer der anzusprechenden Karte vom Typ ME-6000/6100 (0 31) Rückgabewert Wurde die Funktion erfolgreich ausgeführt, so wird 1 zurückgegeben. Im Fehlerfall wird 0 zurückgegeben. Die genaue Fehlerursache kann dann über me6x00getdrverrmess ermittelt werden. Funktionsreferenz Seite 42 Meilhaus Electronic

43 Handbuch ME-6000/6100 Rev. 1.1D me6x00aosettimer Beschreibung Modell: ME-6000 ME-6100 verfügbar: Kanal 0 3 Mit dieser Funktion wird für die Betriebsarten Continuous und WrapAround der als 32 Bit Zähler verwendete Timer konfiguriert. Als Zeitbasis dient ein 33MHz Takt. Daraus ergibt sich eine Periodendauer von 30,30ns, die als kleinste Zeiteinheit definiert wird und im Folgenden 1 Tick genannt wird. Die gewünschte Sample-Rate muß nun als Vielfaches eines Ticks im Parameter <Ticks> übergeben werden. Die Anzahl der Ticks bei vorgegebener Sample-Rate f Sample errechnet sich folgendermaßen: 1 Allgemein: = Ticks f Sample 30, 30ns Anzahl der Ticks für max. Sample-Rate: = 66Ticks (42Hex) 500kHz 30, 30ns Min. Sample-Rate (d. h. max. Anzahl der Ticks = (2 32-1)): 1 f Sample = = Hz T Sample 130s ( )Ticks 30, 30ns D. h. die. Sample-Rate läßt sich in Schritten von 30,30ns zwischen minimaler und maximaler Sample-Rate einstellen. Zur Übergabe der Sample-Rate an die Funktion me6x00aosettimer bietet Ihnen die Funktion me6x00frequencytotimer eine bequeme Umrechnungsmöglichkeit. Ein Beispiel zur Vorgehensweise finden Sie im Abschnitt Programmierung auf Seite 17, sowie in den Beispielprogrammen, die im ME- SDK enthalten sind. Definitionen C: int me6x00aosettimer (int iboardnumber, int ichannel, int iticks); Delphi: Function me6x00aosettimer (iboardnumber, ichannel, iticks: integer): integer; Basic: Declare Function me6x00aosettimer Lib me6x00 Alias "_VBme6x00AOSetTimer@8" (ByVal lboardnumber As Long, ByVal lchannel As Long, ByVal lticks As Long) As Long Meilhaus Electronic Seite 43 Funktionsreferenz

44 Rev. 1.1D Handbuch ME-6000/6100 Parameter <BoardNumber>Nummer der anzusprechenden Karte vom Typ ME-6000/6100 (0 31) <Channel> Kanal-Nummer; mögliche Werte: <Kanal> Beschreibung AO_CH00 AO_CH03 Kanal 0 3 (00Hex 03Hex) <Ticks> Anzahl der Ticks für den 32 Bit Timer, der die Sample-Rate für die Betriebsarten Continuous und WrapAround bestimmt. Der Wertebereich liegt zwischen 66 und (2 32-1) Ticks ( FFFFFFFFHex) (siehe oben). Rückgabewert Wurde die Funktion erfolgreich ausgeführt, so wird 1 zurückgegeben. Im Fehlerfall wird 0 zurückgegeben. Die genaue Fehlerursache kann dann über me6x00getdrverrmess ermittelt werden. me6x00aosettrigger Beschreibung Modell: ME-6000 ME-6100 verfügbar: Kanal 0 3 Diese Funktion legt fest, auf welche Weise die Ausgabe in den Betriebsarten Continuous und WrapAround gestartet werden soll. Sie können zwischen Start per Software (siehe me6x00aostart) und externem Triggersignal (positive/negative Flanke) wählen. Definitionen C: int me6x00aosettrigger (int iboardnumber, int ichannel, int imodepolarity); Delphi: Function me6x00aosettrigger (iboardnumber, ichannel, imodepolarity: integer): integer; Basic: Declare Function me6x00aosettrigger Lib me6x00 Alias "_VBme6x00AOSetTrigger@8" (ByVal lboardnumber As Long, ByVal lchannel As Long, ByVal lmodepolarity As Long) As Long Funktionsreferenz Seite 44 Meilhaus Electronic

45 Handbuch ME-6000/6100 Rev. 1.1D Parameter <BoardNumber>Nummer der anzusprechenden Karte vom Typ ME-6000/6100 (0 31) <Channel> Kanal-Nummer; mögliche Werte: <Kanal> Beschreibung AO_CH00 AO_CH03 Kanal 0 3 (00Hex 03Hex) <ModePolarity>Bedingung für Wandlungsstart durch Einstellung von Triggerquelle und Triggerflanke. <ModePolarity> Beschreibung AO6X00_TRIGGER_TIMER (00Hex) per Software (me6x00aostart) AO6X00_TRIGGER_EXT_HIGH (10Hex) Ext. Trigger, steigende Flanke AO6X00_TRIGGER_EXT_LOW (30Hex) Ext. Trigger, fallende Flanke Rückgabewert Wurde die Funktion erfolgreich ausgeführt, so wird 1 zurückgegeben. Im Fehlerfall wird 0 zurückgegeben. Die genaue Fehlerursache kann dann über me6x00getdrverrmess ermittelt werden.. me6x00aosingle Beschreibung Modell: ME-6000 ME-6100 verfügbar: Diese Funktion dient der transparenten Ausgabe einer Spannung auf dem gewünschten Kanal. Jede vorhergehende Ausgabe (Single, Continuous oder WrapAround) wird sofort beendet. Das korrespondiernde D/A-FIFO wird gelöscht und der gewünschte Wert unmittelbar ausgegeben. Es ist keine Vorbereitung mit anderen Funktionen nötig. Definitionen C: int me6x00aosingle (int iboardnumber, int ichannel, int ivalue); Delphi: Function me6x00aosingle (iboardnumber, ichannel, ivalue: integer): integer; Meilhaus Electronic Seite 45 Funktionsreferenz

46 Rev. 1.1D Handbuch ME-6000/6100 Basic: Parameter Declare Function me6x00aosingle Lib me6x00 Alias (ByVal lboardnumber As Long, ByVal lchannel As Long, ByVal lvalue As Long) As Long <BoardNumber>Nummer der anzusprechenden Karte vom Typ ME-6000/6100 (0 31) <Channel> Kanal-Nummer; mögliche Werte: <Kanal> Beschreibung AO_CH00 AO_CH15 Kanal 0 15 (00Hex 15Hex) <Value> 16 Bit Ausgabewert; der Wertebereich liegt zwischen: 0000Hex (-10 V) FFFFHex (+10 V) Rückgabewert Wurde die Funktion erfolgreich ausgeführt, so wird 1 zurückgegeben. Im Fehlerfall wird 0 zurückgegeben. Die genaue Fehlerursache kann dann über me6x00getdrverrmess ermittelt werden. me6x00aostart Beschreibung Modell: ME-6000 ME-6100 verfügbar: Kanal 0 3 Funktion zum Starten der analogen Ausgabe des jeweiligen Kanals in den Betriebsarten Continuous und WrapAround. Falls Sie in der Funktion me6x00aosettrigger die Option Externer Trigger gewählt haben, wird die Ausgabe durch eine entsprechende Flanke am ext. Triggereingang gestartet. In diesem Fall muß me6x00aostart nicht aufgerufen werden. Ein Beispiel zur Vorgehensweise finden Sie im Abschnitt Programmierung auf Seite 17, sowie in den Beispielprogrammen, die im ME- SDK enthalten sind. Definitionen C: int me6x00aostart (int iboardnumber, int ichannel); Delphi: Function me6x00aostart (iboardnumber, ichannel: integer): integer; Funktionsreferenz Seite 46 Meilhaus Electronic

47 Handbuch ME-6000/6100 Rev. 1.1D Basic: Parameter Declare Function me6x00aostart Lib me6x00 Alias (ByVal lboardnumber As Long, ByVal lchannel As Long) As Long <BoardNumber>Nummer der anzusprechenden Karte vom Typ ME-6000/6100 (0 31) <Channel> Kanal-Nummer; mögliche Werte: <Kanal> Beschreibung AO_CH00 AO_CH03 Kanal 0 3 (00Hex 03Hex) Rückgabewert Wurde die Funktion erfolgreich ausgeführt, so wird 1 zurückgegeben. Im Fehlerfall wird 0 zurückgegeben. Die genaue Fehlerursache kann dann über me6x00getdrverrmess ermittelt werden. me6x00aostop Beschreibung Modell: ME-6000 ME-6100 verfügbar: Kanal 0 3 Funktion zum Beenden der analogen Ausgabe des jeweiligen Kanals in den Betriebsarten Continuous und WrapAround. In der Betriebsart Continuous wird die Ausgabe sofort und vollständig beendet, d. h. am entsprechenden D/A-Kanal liegt nach Beendigung der Ausgabe ein zufälliger Spannungswert an und das D/A-FIFO wird gelöscht. Dagegen wird in der Betriebsart WrapAround die Ausgabe mit dem letzten FIFO-Wert gestoppt, d. h. am entsprechenden D/A-Kanal liegt nach Beendigung der Ausgabe ein definierter Spannungswert an. Sofern die Betriebsart für diesen Kanal nicht gewechselt wurde kann die Ausgabe mit der Funktion me6x00aostart jederzeit neu gestartet werden. Ein Beispiel zur Vorgehensweise finden Sie im Abschnitt Programmierung auf Seite 17, sowie in den Beispielprogrammen, die im ME- SDK enthalten sind. Meilhaus Electronic Seite 47 Funktionsreferenz