Perl - API Bindings¶

Voraussetzungen¶

• Perl 5.14 oder neuer mit Thread Unterstützung, Digest::HMAC_SHA1 Modul und Thread::Queue Modul 3.02 oder neuer

Installation¶

Die Perl Bindings können auf drei Weisen installiert werden: von unserem APT Repository für Debian basierte Linux Distributionen oder von CPAN oder vom Quelltext. Die Bindings können aber auch ohne Installation genutzt werden.

sudo apt install libtinkerforge-perl

cpanm Tinkerforge

perl Makefile.PL
make
make test
make install

Test eines Beispiels¶

Um ein Perl 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.

Als Beispiel wird im Folgenden das Konfigurationsbeispiel des Stepper Bricks getestet. Dafür muss zuerst die example_configuration.pl Datei aus dem examples/brick/stepper/ Ordner in einen neuen Ordner kopiert werden:

example_project/
 -> example_configuration.pl

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:

use constant HOST => 'localhost';
use constant PORT => 4223;
use constant UID => 'XXYYZZ'; # Change XXYYZZ to the UID of your Stepper Brick

Wenn die Bindings installiert wurden, dann kann das Beispiele jetzt direkt ausgeführt werden:

perl example_configuration.pl

Wenn die Bindings nicht installiert wurden, dann kann der Quelltext der Bindings auch direkt verwendet werden. Dafür muss der Tinkerforge/ Ordner vom source/lib/ Ordner in den example_project/ Ordner kopiert werden:

example_project/
 -> Tinkerforge/
 -> example_configuration.pl

Damit Perl den Tinkerforge/ Ordner auch findet muss am Anfang des Beispiels folgende Zeile eingefügt werden:

use lib './';

Dann ist auch schon alles bereit, um dieses Beispiel testen zu können:

perl example_configuration.pl

Bekannte Probleme¶

Es sind Deadlock-Probleme auf Windows mit Strawberry Perl und Active State Perl bekannt. Der empfohlene Workaround dafür ist Cygwin Perl zu verwenden, das von diesen Problemen nicht betroffen ist. Siehe diesen PerlMonks Thread für weitere Details.

API Referenz und Beispiele¶

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.