Manuelles Einbinden von Libraries

Um eigene Sensoren an die senseBox anschließen zu können, geben die Hersteller vieler Sensoren passende Libraries mit. Hier zeigen wir euch, wie ihr aus einem Github-Repository Libraries herunterladen und diese manuell einbinden könnt. Ihr könnt diese Anleitung für jegliche externe Libraries verwenden, die ihr in Arduino einbinden möchtet.


ACHTUNG: Die für die senseBox benötigten Libraries befinden sich bereits im Board-Support-Package, welches in Schritt 2 heruntergeladen wird. Ihr solltet diese nicht mehr manuell einbinden, so wie es in früheren Versionen dieses Buches angegeben wurde. Dadurch entstehen Doppelungen, die zu Fehlern führen können.

Libraries herunterladen und hinzufügen

'Library' - Was ist das eigentlich und wofür brauche ich das?

Eine Library ist wie der Name schon sagt eine Sammlung von etwas - eine Sammlung von Methoden um genauer zu sein. Methoden sind in der Programmierung kleinere Abschnitte von Code, die auf ein Objekt angewendet werden können. Bei der senseBox zum Beispiel kann eine Methode aufgerufen werden, um die LEDs auf dem MCU ein- und auszuschalten. Es gibt eine Menge solcher Standardmethoden, die von einer Vielzahl an Programmmen benutzt werden. Um diese Methoden nicht alle einzeln in den Programmcode übertragen zu müssen, können sie in Libraries abgelegt werden. Eine Library ist also eine Datei, in der viele Methoden gespeichert werden. Man kann Libraries in seinen Code einbinden. Dafür reicht es wenn sie im Arduino-Ordner für Libraries gespeichert sind und man sie dann mit einer einzigen Zeile zu Beginn des Programmcodes einbindet. Das sieht in Arduino für die Library mit dem Namen "senseBoxIO" wie folgt aus: 

#include <senseBoxMCU.h>;

Ist die Library eingebunden, können alle in ihr enthaltenen Methoden im Code benutzt werden.

Bei der manuellen Installation der Libraries können sehr schnell Fehler auftreten, daher sollte man hier besonders genau auf die einzelnen Schritte achten. Um dich bei der Installation möglichst gut zu unterstützen, haben wir für jedes Betriebssystem eine seperate Anleitung geschrieben. Wähle das zu deinem Computer passende System und folge den angegebenen Schritten.

Libraries einfügen Windows

  1. Die meisten externen Libraries findest du in Github-Repositories. Um sie herunterzuladen, musst du den grünen Button Clone or download und daraufhin im sich öffnenden Fenster Download ZIP klicken.

    Beispielhafter Download der \
    Beispielhafter Download der \

  2. Sollte der Download nicht von alleine starten, öffnet sich ein Fenster, in dem du das Feld Datei speichern auswählen musst und den Ordner an einen beliebigen Ort auf deinem Computer legst (standardmäßig ist das der Downloads-Ordner).

  3. Die heruntergeladene Datei ist ein .zip-Archiv, also eine komprimierte Version der Library. Es gilt daher als nächstes dieses .zip-Archiv zu entpacken. Dafür öffnest du den Speicherort des Archivs und klickst es mit Rechts-Klick an und wählst im erscheinenden Menü Alle extrahieren.... Wähle als Speicherort denselben Ordner wie beim Download (z.B. den Downloads-Ordner).

  4. Öffne nun die Arduino IDE. Gehe auf Datei -> Voreinstellungen:

    Klicke `Datei` und dann `Voreinstellungen`
    Klicke `Datei` und dann `Voreinstellungen`

    und schaue im Feld unter Sketchbook-Speicherort nach an welchem Ort der Sketchbook Ordner gespeichert ist.

    Schaue im rot-markierten Feld nach, wo dein Sketchbook-Speicherort ist
    Schaue im rot-markierten Feld nach, wo dein Sketchbook-Speicherort ist

    Merke dir den Pfad zu diesem Ordner, also den Ort wo dieser gespeichert ist.

    Du musst den Library-Ordner, den du bereits heruntergeladen und entpackt hast, im nächsten Schritt in den Sketchbook-Speicherort verschieben. Es ist daher sehr wichtig, dass du dir den entsprechenden Speicherort aus Punkt 4 genau merkst, um so später auftretende Fehler zu vermeiden.

  5. Nun navigierst du in deinem Datei-Explorer zum Sketchbook-Speicherort (siehe 4.). Beachte, dass der Zielordner im Datei-Explorer am Sketchbook-Speicherort den Namen Arduino trägt. Wähle den Ordner mit Doppelklick aus um seinen Inhalt zu sehen. Der Ordner enthält einen weiteren Ordner mit dem Namen "libraries".

    Was mache ich, wenn es keinen 'libaries'-Ordner gibt?

    Falls hier kein Ordner mit dem Namen "libraries" vorhanden ist, kannst du einfach einen neuen Ordner erstellen und diesen "libraries" nennen. Einen neuen Ordner erstellst du mit Rechtsklick in den Dateiexplorer -> Neu -> Ordner.

    Kopiere oder ziehe jetzt den heruntergeladenen und entpackten Ordner in den libraries-Ordner.

  6. Schließe jetzt das Programm Arduino vollständig und starte es erneut, um die Installation der entsprechenden Libraries abzuschließen.

Leider ist ein typischer Fehler, dass die senseBox Library nicht in den richtigen Ordner gelegt wird. Bitte überprüfe nochmal, ob du die Datei in den richtigen Ordner aus 4. gelegt hast.

Libraries einfügen Mac

  1. Die meisten externen Libraries findest du in Github-Repositories. Um sie herunterzuladen, musst du den grünen Button Clone or download und daraufhin im sich öffnenden Fenster Download ZIP klicken.

    Beispielhafter Download der \
    Beispielhafter Download der \

  2. Der Download sollte von alleine starten und die Datei automatisch entpackt und in deinem "Downloads"-Ordner abgelegt werden. Öffne den Downloads-Ordner und schaue ob der heruntergeladene Ordner dort vorhanden ist. Sollte dort anstelle eines Ordners nur eine .zip-Datei liegen, doppel-klicke diese, um sie zu entpacken.

  3. Öffne nun die Arduino IDE. Gehe oben auf Arduino -> Einstellungen ...:

    Klicke `Arduino` und dann `Einstellungen ...`
    Klicke `Arduino` und dann `Einstellungen ...`

    und schaue im Feld unter Sketchbook-Speicherort nach an welchem Ort der Sketchbook Ordner gespeichert ist.

    Schaue im rot-markierten Feld nach, wo dein Sketchbook-Speicherort ist
    Schaue im rot-markierten Feld nach, wo dein Sketchbook-Speicherort ist

    Merke dir den Pfad zu diesem Ordner, also den Ort wo dieser gespeichert ist.

    Du musst die Libraries, die du bereits heruntergeladen hast, im nächsten Schritt in den Sketchbook-Speicherort verschieben. Es ist daher sehr wichtig, dass du dir den entsprechenden Speicherort aus Punkt 3 genau merkst, um so später auftretende Fehler zu vermeiden.

  4. Nun navigierst du in deinem Finder zum Sketchbook-Speicherort. Beachte, dass der Zielordner im Finder am Sketchbook-Speicherort den Namen Arduino trägt. Wähle den Ordner mit Doppelklick aus um seinen Inhalt zu sehen. Der Ordner enthält einen weiteren Ordner mit dem Namen "libraries".

    Was mache ich, wenn es keinen 'libaries'-Ordner gibt?

    Falls hier kein Ordner mit dem Namen "libraries" vorhanden ist, kannst du einfach einen neuen Ordner erstellen und diesen "libraries" nennen.

    Kopiere oder ziehe jetzt den heruntergeladenen (entpackten) Ordner in den libraries-Ordner.

  5. Schließe jetzt das Programm Arduino vollständig und starte es erneut, um die Installation der entsprechenden Libraries abzuschließen.

Leider ist ein typischer Fehler, dass die senseBox Library nicht in den richtigen Ordner gelegt wird. Bitte überprüfe nochmal, ob du die Datei in den richtigen Ordner aus 3. gelegt hast.

Libraries einfügen Linux

  1. Die meisten externen Libraries findest du in Github-Repositories. Um sie herunterzuladen, musst du den grünen Button Clone or download und daraufhin im sich öffnenden Fenster Download ZIP klicken.

    Beispielhafter Download der \
    Beispielhafter Download der \

  2. Der Download startet von alleine und legt ein .zip-Archiv in deinem Downloads-Ordner ab. Öffne den Downloads-Ordner und entpacke die .zip Datei mit Rechts-Klick -> Extrahiere Hier(Extract Here).

  3. Öffne nun die Arduino IDE. Gehe auf Datei -> Voreinstellungen:

    Klicke `Datei` und dann `Voreinstellungen`
    Klicke `Datei` und dann `Voreinstellungen`

    und schaue im Feld unter Sketchbook-Speicherort nach an welchem Ort der Sketchbook Ordner gespeichert ist.

    Schaue im rot-markierten Feld nach, wo dein Sketchbook-Speicherort ist
    Schaue im rot-markierten Feld nach, wo dein Sketchbook-Speicherort ist

    Merke dir den Pfad zu diesem Ordner, also den Ort wo dieser gespeichert ist.

    Du musst die Libraries, die du bereits heruntergeladen und entpackt hast, im nächsten Schritt in den Sketchbook-Speicherort verschieben. Es ist daher sehr wichtig, dass du dir den entsprechenden Speicherort aus Punkt 3 genau merkst, um so später auftretende Fehler zu vermeiden.

  4. Nun navigierst du in deinem Datei-Explorer zum Sketchbook-Speicherort (siehe 3.). Beachte, dass der Zielordner im Datei-Explorer am Sketchbook-Speicherort den Namen Arduino trägt. Wähle den Ordner mit Doppelklick aus um seinen Inhalt zu sehen. Der Ordner enthält einen weiteren Ordner mit dem Namen "libraries".

    Was mache ich, wenn es keinen 'libaries'-Ordner gibt?

    Falls hier kein Ordner mit dem Namen "libraries" vorhanden ist, kannst du einfach einen neuen Ordner erstellen und diesen "libraries" nennen. Einen neuen Ordner erstellst du mit Rechtsklick in den Dateiexplorer -> Neuer Ordner (New Folder).

    Kopiere oder ziehe jetzt den heruntergeladenen (entpackten) Ordner in den libraries-Ordner.

  5. Schließe jetzt das Programm Arduino vollständig und starte es erneut, um die Installation der entsprechenden Libraries abzuschließen.

Leider ist ein typischer Fehler, dass die senseBox Library nicht in den richtigen Ordner gelegt wird. Bitte überprüfe nochmal, ob du die Datei in den richtigen Ordner aus 3. gelegt hast.

Made with ♥ by the senseBox team at ifgi, WWU Münster All content is published under CC BY-SA 4.0

results matching ""

    No results matching ""