Velleman K8055 Experimentier Board C# Programmieranleitung Seite 1 von 14
Inhaltsverzeichnis Einführung...3 Vorbereitung...3 Compiler...3 K8055 SDK...3 Erster Schritt : Erstellen der DLL...4 Compilieren der Datei K8055_Net.cs...6 Zweiter Schritt : Erstellen der Anwendung...8 Projekt erstellen...8 Laden der DLL K8055_Net.dll...9 Erstellen der Grafischen Komponenten...10 Dritter Schritt : Der Test...13 Vorbereitung...13 Ausführen...13 Seite 2 von 14
Einführung Dieses Dokument soll dazu dienen eine kleine Anwendung für die USB Schnittstelle zu erstellen. Vorbereitung Compiler Für dieses Beispiel wird die Anwendung Limnor Studio 5 verwendet, diese kann Kostenfrei (Stand 18.10.2011) unter folgendem Link bezogen werden : http://www.limnor.com. K8055 SDK Des Weiteren wird die K8055 SDK von Velleman benötigt welche unter folgendem Link zu beziehen ist : http://www.velleman.eu/support/downloads/?code=k8055&type Nachdem die Dateien heruntergeladen wurden und die Anwendung Limnor 5 Studio erfolgreich installiert wurde kann mit dem Entwickeln begonnen werden. Seite 3 von 14
Erster Schritt : Erstellen der DLL Es wird für die DLL eine leere Textdatei benötigt welche die Bezeichnung K8055_Net.cs bekommt. Es muss eventuell der Haken in den Ordneroptionen/Ansicht Erweiterungen bei bekannten Dateitypen ausblenden entfernt werden. Abbildung 1: Ordneroptionen/Ansicht Für die DLL wird die Visual C# 2008 Express Textpassage aus dem Dokument in eine Textdatei kopiert. Abbildung 2: Inhalt für die DLL Seite 4 von 14
Es wird folgender Header für die Klasse benötigt : Abbildung 3: Klasse mit Header Die Vollständige Klasse kann unter folgendem Link bezogen werden : http://www.stefan-draeger-software.de/itdokumente/sonstiges/k8055/sources/k8055_net.cs Seite 5 von 14
Compilieren der Datei K8055_Net.cs Nun muss diese Klasse Compiliert werden dazu starten Sie die Anwendung Limnor 5 Studio. Abbildung 4: Anwendung Limno 5 Studio Unter dem Menüpunkt Tools/Source Compiler öffnet sich folgendes Fenster. Abbildung 5: Limnor 5 Studio Tools/Source Compiler Fenster In diesem geben Sie nun den Pfad für die *.cs Datei ein und klicken auf Compile. Die Datei befindet sich bei erfolgreichem Compilieren im Verzeichnis C:\Program Files (x86)\longflow Enterprises\Limnor Studio 5\tmp\K8055_Net.dll. Die nun Compilierte Datei und die Datei K8055D.dll werden für die weitere Verwendung in das Systemverzeichnis des Betriebssystems kopiert. Beachten Sie bitte dabei das dazu ggf. Administratorrechte erforderlich sein können. Seite 6 von 14
Bei 32Bit Systemen sind diese Dateien in das Verzeichnis C:\Windows\System32 zu kopieren bei 64Bit Systemen ist dieses Verzeichnis C:\Windows\SysWOW64. Seite 7 von 14
Zweiter Schritt : Erstellen der Anwendung Projekt erstellen Für die Anwendung benötigen Sie als erstes ein Projekt dieses wird im Menüpunkt File/New Projekt erstellt aus dem folgenden Fenster wählen Sie nun Windows Application aus. Abbildung 6: Limnor 5 Studio File/New Projekt Nach vergabe eines Namens und dem ggf. anpassen der Location bestätigen Sie dieses Fenster mit der Schaltfläche OK. Nun nachdem das Projekt generiert wurde öffnen Sie im Menübaum Solution 'K8055_TestApp' den Menüpunkt K8055_TestApp und tätigen einen Doppelklick auf den Unterpunkt WinFormApp1. Das Fenster sollte nach dem Ladevorgang wie folgt aussehen : Abbildung 7: Limnor 5 Studio Projekt Oberfläche Seite 8 von 14
Laden der DLL K8055_Net.dll Nun wird die Compilierte DLL K8055_Net.dll dem Projekt hinzugefügt dieses geschieht indem Sie im Menübaum WinFormApp1 from LimnoWinApp ein rechtsklick tätigen und im PopupMenü den Eintrag Add Utility wählen. Abbildung 8: Limno 5 Studio DLL dem Projekt hinzufügen Im nun sich öffnenden Fenster wählen Sie die Schaltfläche Load File und öffnen die DLL K8055_Net.dll wählen Sie danach aus der Liste die hinzugefügte Datei und wählen den sich darunter befindlichen Menüpunkt (siehe Bild). Abbildung 9: Limnor 5 Studio DLL dem Projekt hinzufügen 2 Seite 9 von 14
Erstellen der Grafischen Komponenten Die Grafischen Komponenten werden auf die Form1 erstellt welche man mit einem doppelklick auf den Menüpunkt im folgenden Menübaum öffnet (siehe Bild). Abbildung 10: Limnor 5 Studio Form1 wählen Nach dem Ladevorgang sollte das Programm wie folgt aussehen. Abbildung 11: Limnor 5 Studio Grafischer Editor Seite 10 von 14
Für diese einfache Anwendung benötigen Sie eine Button und Label Komponente. Diese finden Sie in der Toolbox im Menüpunkt Common Controls Abbildung 12: ToolBox Nach dem einfügen und anordnen der Grafischen Komponenten werden diesen die Actions hinzugefügt. Dazu wird im Menübaum der DLL mit einem rechtsklick Create action die Action erstellt. Abbildung 13: Limnor 5 Studio "Create action" Für die Anwendung wird die Action SearchDevices()Int32 benötigt. Seite 11 von 14
Nachdem Sie diese Action erstellt haben, weisen Sie dieser dem Label hinzu. Abbildung 14: Limnor 5 Studio AssignTo Wählen Sie aus dem unten dargestellten Menübaum den Eintrag Text:String und wählen die Schaltfläche Next. Abbildung 15: Action dem Label zuweisen Um die Action auszulösen benötigt der Button die Action. Diese fügen Sie hinzu indem, Sie einen rechtsklick auf den Button tätigen und dort Assign Action / Click wählen. Abbildung 16: Assing Action Seite 12 von 14
Im nun geöffneten Fenster wählen Sie die im Menübaum Actions die Action K8055DClassSearchDevices und bestätigen das Fenster mit einem klick auf Next. Dritter Schritt : Der Test Vorbereitung Damit getestet werden kann muss ggf. das Zielsystem eingestellt werden sollte die Anwendung für X86 Systeme dienen so kann man im Menüpunk Projekt/Properties die TargetPlatform wählen, für dieses Beispiel wählen Sie X86. Ausführen Wählen Sie im Fenster die Schaltfläche Run ( ). Abbildung 17: Limnor 5 Studio "Fertiges Projekt" Nach dem erfolgreichen Compilieren sollte sich die Anwendung öffnen. Abbildung 18: K8055_TestApp Bei einem Klick auf die Schaltfläche Suche wird eine eventuell angeschlossene USB Karte erkannt und die Zahl 1 zurückgegeben. Seite 13 von 14
Abbildungsverzeichnis Abbildung 1: Ordneroptionen/Ansicht...4 Abbildung 2: Inhalt für die DLL...4 Abbildung 3: Klasse mit Header...5 Abbildung 4: Anwendung Limno 5 Studio...6 Abbildung 5: Limnor 5 Studio Tools/Source Compiler Fenster...6 Abbildung 6: Limnor 5 Studio File/New Projekt...8 Abbildung 7: Limnor 5 Studio Projekt Oberfläche...8 Abbildung 8: Limno 5 Studio DLL dem Projekt hinzufügen...9 Abbildung 9: Limnor 5 Studio DLL dem Projekt hinzufügen 2...9 Abbildung 10: Limnor 5 Studio Form1 wählen...10 Abbildung 11: Limnor 5 Studio Grafischer Editor...10 Abbildung 12: ToolBox...11 Abbildung 13: Limnor 5 Studio "Create action"...11 Abbildung 14: Limnor 5 Studio AssignTo...12 Abbildung 15: Action dem Label zuweisen...12 Abbildung 16: Assing Action...12 Abbildung 17: Limnor 5 Studio "Fertiges Projekt"...13 Abbildung 18: K8055_TestApp...13 Seite 14 von 14