USB-WATCHDOG-STICK Hardware-Beschreibung 2011 Februar
INDEX 1. Einleitung 5 1.1. Vorwort 5 1.2. Kundenzufriedenheit 5 1.3. Kundenresonanz 5 2. Hardware Beschreibung 7 2.1. Übersichtsbild 8 2.2. Technische Daten 9 2.3. Pinbelegung DSUB-9 Buchse 10 2.4. Kontroll LED 10 3. Software 12 3.1. Benutzung unserer Produkte 12 3.1.1. Ansteuerung über grafische Anwendungen 3.1.2. Ansteuerung über unsere DELIB Treiberbibliothek 3.1.3. Ansteuerung auf Protokollebene 3.1.4. Ansteuerung über mitgelieferte Testprogramme 3.2.
INDEX 4. DELIB API Referenz 4.1. Verwaltungsfunktionen 4.1.1. DapiOpenModule 4.1.2. DapiCloseModule 4.2. Fehlerbehandlung 4.2.1. DapiGetLastError 4.2.2. DapiGetLastErrorText 4.3. Watchdog Funktionen 4.3.1. DapiWatchdogEnable 4.3.2. DapiWatchdogDisable 4.3.3. DapiWatchdogRetrigger 4.4. Programmier-Beispiel 5. Anhang 22 22 22 23 24 24 25 26 26 27 28 29 32 5.1. Revisionen 32 5.2.
Einleitung I Einleitung | Seite 4
1. Einleitung 1.1. Vorwort Wir beglückwünschen Sie zum Kauf eines hochwertigen DEDITEC Produktes! Unsere Produkte werden von unseren Ingenieuren nach den heutigen geforderten Qualitätsanforderungen entwickelt. Wir achten bereits bei der Entwicklung auf flexible Erweiterbarkeit und lange Verfügbarkeit.
Hardware Beschreibung II Hardware Beschreibung | Seite 6
2. Hardware Beschreibung Die in einem USB-Stick Gehäuse untergebrachte Elektronik sorgt für eine Überwachung mit Watchdogfunktion. Der eingesetzte Microcontroller wird in regelmäßigen Intervallen vom PC über den USB-BUS abgefragt. Bei einer Zeitüberschreitung schaltet der Watchdog-Stick dann selbständig die beiden Relais mit einem vom Benutzer vorzugebenem Ablauf. So können durch die Relais, mit entsprechender Verkabelung, bei einem Timeout z.B.
2.1.
2.2. Technische Daten USB-Stick-Ausgabemodul mit USB 2.0 / USB 1.
2.3. Pinbelegung DSUB-9 Buchse Pin 3&7 2&6 1, 4, 5, 8, 9 Beschreibung Relais 1 Relais 2 NC 2.4.
Software III Software | Seite 11
3. Software 3.1. Benutzung unserer Produkte 3.1.1. Ansteuerung über grafische Anwendungen Wir stellen Treiberinterfaces z.B. für LabVIEW und ProfiLab zur Verfügung. Als Basis dient die DELIB Treiberbibliothek, die von ProfiLab direkt angesteuert werden kann. Für LabVIEW bieten wir eine einfache Treiberanbindung mit Beispielen an! 3.1.2. Ansteuerung über unsere DELIB Treiberbibliothek Im Anhang befindet sich die komplette Funktionsreferenz für das Integrieren unserer API-Funktionen in Ihre Software.
3.1.4. Ansteuerung über mitgelieferte Testprogramme Für die wichtigsten Funktionen unserer Produkte stellen wir einfach zu bedienende Testprogramme zur Verfügung,. Diese werden bei der Installation der DELIB Treiberbibliothek direkt mit installiert. So können z.B. Relais direkt getestet werden oder Spannungen am A/D Wandler direkt überprüft werden.
3.2. DELIB Treiberbibliothek 3.2.1. Übersicht Die folgende Abbildung erläutert den Aufbau der DELIB Treiberbibliothek Die DELIB Treiberbibliothek ermöglicht ein einheitliches Ansprechen von DEDITEC Hardware, mit der besonderen Berücksichtigung folgender Gesichtspunkte: Betriebssystem unabhängig Programmiersprachen unabhängig Produkt unabhängig 3.2.1.1.
3.2.1.2. Programmieren mit diversen Programmiersprachen Für das Erstellen eigener Anwendungen stellen wir Ihnen einheitliche Befehle zur Verfügung. Dies wird über die DELIB Treiberbibliothek gelöst. Sie wählen die Programmiersprache ! So können leicht Anwendung unter C++, C, Visual Basic, Delphi oder LabVIEW® entwickelt werden. 3.2.1.3. Schnittstellenunabhängiges programmieren Schreiben Sie Ihre Anwendung schnittstellenunabhängig ! Programmieren Sie eine Anwendung für ein USB-Produkt von uns.
3.2.2. Unterstützte Betriebssysteme Unsere Produkte unterstützen folgende Betriebssysteme: Windows 7 Windows Vista Windows XP Windows 2000 Linux 3.2.3. Unterstützte Programmiersprachen Unsere Produkte sind über folgende Programmiersprachen ansprechbar: C C++ C# Delphi VisualBasic VB.
3.2.4. Installation DELIB-Treiberbibliothek Legen Sie die DEDITEC driver CD in das Laufwerk und starten Sie “delib_install.exe”. Die DELIB-Treiberbibliothek ist auch unter http://www. deditec.de/delib erhältlich. Drücken Sie auf “Install”.
Die Treiber werden nun installiert. Die DELIB Treiberbibliothek wurde nun Installiert. Drücken sie auf “Close” um die Installation zu beenden. Mit dem “DELIB Configuration Utility” (nächstes Kapitel) können Sie Ihr Modul konfigurieren (dies ist nur nötig, wenn Sie mehr als ein Modul ansprechen möchten).
3.2.5. DELIB Configuration Utility “DELIB Configuration Utility” wird auf dem folgendem Weg gestartet: Start Programme DEDITEC DELIB DELIB Configuration Utility. Das “DELIB Configuration Utility” ist ein Programm zur Konfiguration und Unterteilung Identischer USB-Module im System. Dies ist aber nicht nötig falls nur ein Modul vorhanden ist.
3.3. Testprogramme 3.3.1. Watchdog Demo "Watchdog Demo" wird auf folgendem Weg gestartet: Start -> Programme -> DEDITEC -> DELIB -> Watchdog Demo. Diese Grafik zeigt einen Test des Watchdog-Sticks. Oben links kann man die Konfiguration des Moduls ablesen.
DELIB API Referenz IV DELIB API Referenz | Seite 21
4. DELIB API Referenz 4.1. Verwaltungsfunktionen 4.1.1. DapiOpenModule Beschreibung Diese Funktion öffnet ein bestimmtes Modul. Definition ULONG DapiOpenModule(ULONG moduleID, ULONG nr); Parameter moduleID=Gibt das Modul an, welches geöffnet werden soll (siehe delib.h) nr=Gibt an, welches (bei mehreren Modulen) geöffnet werden soll. nr=0 -> 1. Modul nr=1 -> 2.
4.1.2. DapiCloseModule Beschreibung Dieser Befehl schliesst ein geöffnetes Modul.
4.2. Fehlerbehandlung 4.2.1. DapiGetLastError Beschreibung Diese Funktion liefert den letzten erfassten Fehler. Definition ULONG DapiGetLastError(); Parameter Keine Return-Wert Fehler Code 0=kein Fehler. (siehe delib.
4.2.2. DapiGetLastErrorText Beschreibung Diese Funktion liest den Text des letzten erfassten Fehlers.
4.3. Watchdog Funktionen 4.3.1. DapiWatchdogEnable Beschreibung Diese Funktion aktiviert den Watchdog.
4.3.2. DapiWatchdogDisable Beschreibung Diese Funktion deaktiviert den Watchdog.
4.3.3. DapiWatchdogRetrigger Beschreibung Diese Funktion retriggert den Watchdog-Timer.
4.4.
} // ---------------------------------------------------// activate watchdog DapiWatchdogEnable(handle); printf("watchdog is activated\n"); printf("Taste für weiter\n"); getch(); // ---------------------------------------------------// activate watchdog DapiWatchdogDisable(handle); printf("watchdog is deactivated\n"); printf("Taste für weiter\n"); getch(); // ---------------------------------------------------// activate watchdog + retrigger DapiWatchdogEnable(handle); DapiWatchdogRetrigger(handle); printf
Anhang V Anhang | Seite 31
5. Anhang 5.1. Revisionen Rev 2.
5.2. Urheberrechte und Marken Linux ist eine registrierte Marke von Linus Torvalds. Windows CE ist eine registrierte Marke von Microsoft Corporation. USB ist eine registrierte Marke von USB Implementers Forum Inc. LabVIEW ist eine registrierte Marke von National Instruments. Intel ist eine registrierte Marke von Intel Corporation AMD ist eine registrierte Marke von Advanced Micro Devices, Inc.