Die Visual Basic .NET Bindings ermöglichen es Bricks und Bricklets aus selbst erstellen Visual Basic .NET Programmen heraus zu steuern. Die ZIP Datei für die Bindings beinhaltet:
Tinkerforge.dll
, eine vorkompilierte .NET BibliothekTinkerforge.xml
, die API Dokumentation für Visual Studio, MonoDevelop, usw.source/
den Quelltext für Tinkerforge.dll
examples/
die Beispiele für alle Bricks und BrickletsDie Visual Basic .NET Bindings basieren auf den C# Bindings. Seit Version 2.0.0 sind die C# Bindings CLS-konform. Dies erlaubt es die Bindings mit allen .NET kompatiblen Sprachen zu verwenden, wie z.B. Visual Basic .NET.
Ob und wie die Visual Basic .NET Bindings installiert werden müssen hängt stark
davon ab wie sie benutzt werden sollen. Wenn der Visual Basic .NET Compiler
direkt von der Kommandozeile aufgerufen wird genügt es die Tinkerforge.dll
Datei im gleichen Verzeichnis wie den Visual Basic .NET Quelltext des Programms
abzulegen.
Um die Bindings in einer IDE zu verwenden muss die Tinkerforge.dll
Datei
wahrscheinlich zuerst dem Assembly-Katalog der IDE hinzugefügt werden. Wie dies
gemacht wird hängt von der IDE ab und wird in der Dokumentation der jeweiligen
IDE erklärt.
Um ein Visual Basic .NET Beispiel testen zu können, müssen zuerst Brick Daemon und Brick Viewer installiert werden. Brick Daemon arbeitet als Proxy zwischen der USB Schnittstelle der Bricks und den API Bindings. Brick Viewer kann sich mit Brick Daemon verbinden und gibt Informationen über die angeschlossenen Bricks und Bricklets aus.
Am Beispiel werden wir das Stepper Brick Konfigurationsbeispiel mit dem Visual Basic .NET Compiler (VBNC) kompilieren, der Teil von Mono ist. Dazu muss als erstes ein neues Visual Basic .NET Projekt in MonoDevelop erstellt werden, klicke:
MonoDevelop sollte jetzt einen Application.vb
Datei in seinem Editor
anzeigen. Ersetze deren Inhalt durch dem Inhalt der ExampleConfiguration.vb
Datei im examples/Brick/Stepper/
Ordner.
Am Anfang des Beispiels ist mit HOST
und PORT
angegeben unter welcher
Netzwerkadresse der Stepper Brick zu erreichen ist. Ist er lokal per USB
angeschlossen dann ist localhost
und 4223 richtig. Als UID
muss die
UID des angeschlossen Stepper Bricks angegeben werden, diese kann über den
Brick Viewer ermittelt werden:
Const HOST As String = "localhost"
Const PORT As Integer = 4223
Const UID As String = "XXYYZZ" ' Change XXYYZZ to the UID of your Stepper Brick
Jetzt muss noch Tinkerforge.dll
dem Projekt als Verweis hinzugefügt werden:
Tinkerforge.dll
ausDas Projekt ist jetzt bereit für einen Test, klicke:
Der Visual Basic .NET Compiler kann auch von der Kommandozeile aus verwendet werden:
vbnc /target:exe /out:Example.exe /reference:Tinkerforge.dll ExampleConfiguration.vb
Am Beispiel werden wir das Stepper Brick Konfigurationsbeispiel in Microsoft Visual Basic 2010 kompilieren. Dazu muss als erstes ein neues Visual Basic erstellt werden, klicke:
Visual Studio sollte jetzt einen Module1.vb
Datei in seinem Editor
anzeigen. Ersetze deren Inhalt durch dem Inhalt der ExampleConfiguration.vb
Datei im examples/Brick/Stepper/
Ordner.
Am Anfang des Beispiels ist mit HOST
und PORT
angegeben unter welcher
Netzwerkadresse der Stepper Brick zu erreichen ist. Ist er lokal per USB
angeschlossen dann ist localhost
und 4223 richtig. Als UID
muss die
UID des angeschlossen Stepper Bricks angegeben werden, diese kann über den
Brick Viewer ermittelt werden:
Const HOST As String = "localhost"
Const PORT As Integer = 4223
Const UID As String = "XXYYZZ" ' Change XXYYZZ to the UID of your Stepper Brick
Jetzt muss noch Tinkerforge.dll
dem Projekt als Verweis hinzugefügt werden:
Tinkerforge.dll
ausBevor das Projekt getestet werden kann muss Visual Studio wissen was das richtige Startobjekt ist:
Das Projekt ist jetzt bereit für einen Test, klicke:
Links zur API Referenz der IP Connection, Bricks und Bricklets sowie die Beispiele aus der ZIP Datei der Bindings sind in der folgenden Tabelle aufgelistet. Anleitungen für weiterführende Projekte finden sich im Abschnitt über Kits.