PHP - API Bindings¶

Voraussetzungen¶

• PHP 5.3 oder neuer mit bcmath und sockets Erweiterung

Installation¶

Die PHP Bindings können auf zwei Weisen installiert werden: von unserem APT Repository für Debian basierte Linux Distributionen oder vom PEAR Package. Die Bindings können aber auch ohne Installation genutzt werden.

sudo apt install php-tinkerforge

pear install Tinkerforge.tgz

Test eines Beispiels¶

Um ein PHP 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 ExampleConfiguration.php Datei aus dem examples/Brick/Stepper/ Ordner in einen neuen Ordner kopiert werden:

example_project/
 -> ExampleConfiguration.php

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:

<?php

const HOST = 'localhost';
const PORT = 4223;
const 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:

php ExampleConfiguration.php

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

example_project/
 -> Tinkerforge/
 -> ExampleConfiguration.php

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

php ExampleConfiguration.php

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.