abonneren

Extra Arduino-bibliotheken installeren doe je als volgt

Net als andere programmeeromgevingen kent Arduino het concept van libraries: externe code die je eenvoudig aan je eigen programma toevoegt. Arduino IDE maakt het heel eenvoudig om in je schetsen met bibliotheken te werken. Extra Arduino-bibliotheken installeren werkt zo.

Met de ingebouwde functies van de Arduino-taal kun je al leuke dingen doen, maar voor complexere schetsen heb je extra functionaliteit nodig. Arduino kent daarom net als andere programmeeromgevingen het concept van bibliotheken. Een bibliotheek (library) is een verzameling code met specifieke functionaliteit, die je eenvoudig in je eigen schetsen kunt gebruiken.

De Arduino IDE-ontwikkelomgeving heeft standaard al enkele bibliotheken geïnstalleerd. Bij deze standaardbibliotheken kun je er dus van uitgaan dat ze op elk systeem met Arduino IDE staan en je kunt ze dus zonder zorgen in je code gebruiken.

Zo gebruik je de standaardbibliotheek Wire als je met aangesloten elektronische componenten via het I²C-protocol wilt communiceren en SPI als die componenten het SPI-protocol gebruiken. Een servomotor stuur je dan weer aan met de bibliotheek Servo en met de bibliotheek SD lees je van en schrijf je naar een sd-kaart op een Arduino-shield met sd-kaartslot.

Als je een bibliotheek wilt gebruiken in je schets, moet je die bibliotheek eerst ‘importeren’. Dat kan eenvoudig door in het menu Schets op Bibliotheek gebruiken te klikken. Je krijgt dan in het menu alle beschikbare bibliotheken te zien. Klik gewoon op de bibliotheek die je nodig hebt, waarna Arduino IDE vooraan in je schets een opdracht toevoegt die de bibliotheek voor je code beschikbaar maakt. Voor de bibliotheek Servo is dat bijvoorbeeld:

#include <Servo.h>

Na een tijdje weet je wel hoe zo’n include-opdracht er uitziet: je hoeft dan niet meer de omweg via het menu te doen, maar kunt zelf de include-opdracht aan je code toevoegen. Let op: zet die altijd helemaal in het begin van je schets.

Van elke standaardbibliotheek vind je op de website van Arduino documentatie en voorbeeldcode. Die voorbeeldcode vind je ook in Arduino IDE in het menu Bestand / Voorbeelden. Lees de documentatie en probeer de voorbeelden eens uit voordat je de bibliotheek in je eigen schets gebruikt.

Extra bibliotheken toevoegen

Al vrij snel zul je extra bibliotheken willen installeren die niet in de standaardinstallatie van Arduino IDE aanwezig zijn. Ook dat is in Arduino IDE eigenlijk heel eenvoudig. Klik je in het menu Schets / Bibliotheek gebruiken op Bibliotheken beheren, dan open je het bibliotheekbeheer (Library Manager).

In het bibliotheekbeheer heb je toegang tot bijna 2000 Arduino-bibliotheken. In het zoekveld rechtsboven kun je filteren op een zoekterm en met de uitklapmenu’s ernaast toon je alleen de bibliotheken van een specifiek type of onderwerp.

Elke bibliotheek krijg een beknopte samenvatting. Met een klik op More info wordt een webpagina van de bibliotheek geopend. De bibliotheek installeren gaat eenvoudig door de bibliotheek te selecteren en rechts op Installeren te klikken. Dat installeert standaard de nieuwste versie. Wil je om een of andere reden een oudere versie, dan selecteer je die eerst in het uitklapmenu naast de installatieknop. Na de installatie verschijnt er naast de naam van de bibliotheek de aanduiding INSTALLED.

Je kunt nu het bibliotheekbeheer sluiten en de geïnstalleerde bibliotheek op exact dezelfde manier als een standaardbibliotheek gebruiken. De meeste bibliotheken voegen ook voorbeeldschetsen toe in het menu Bestand / Voorbeelden. Overigens vind je alle bibliotheken die via het bibliotheekbeheer te installeren zijn ook op de website Arduino Library List, met uitgebreide zoekmogelijkheden.

Een zip-bestand toevoegen

Het bibliotheekbeheer geeft toegang tot enorm veel bibliotheken, maar soms heb je toch een bibliotheek nodig die er (nog) niet in te vinden is, bijvoorbeeld omdat die nog vrij nieuw is. De ontwikkelaar verspreidt zijn bibliotheek normaal gesproken dan als een zip-bestand.

Pak dit zip-bestand niet zelf uit, maar open in Arduino IDE het menu Schets / Bibliotheek gebruiken en klik dan op .ZIP Bibliotheek toevoegen. Selecteer dan het zip-bestand dat je gedownload hebt. Arduino IDE pakt het zip-bestand uit en plaatst de inhoud ervan op de juiste locatie.

De geïnstalleerde bibliotheek kun je nu op dezelfde manier als een standaardbibliotheek gebruiken en als de ontwikkelaar voorbeeldschetsen heeft toegevoegd, zijn die ook in het menu Bestand / Voorbeelden beschikbaar.

Handmatig bibliotheken toevoegen

Als de ontwikkelaar van een bibliotheek zelfs geen zip-bestand beschikbaar maakt, is er nog een derde manier om de bibliotheek te installeren: door zelf de bestanden op de juiste locatie te plaatsen waar de Arduino IDE ze vindt. Dat klinkt moeilijker dan het is, maar het is iets omslachtiger, dus we raden dit alleen aan als de vorige twee manieren niet beschikbaar zijn.

Daarvoor dien je eerst de schetsboeklocatie van je Arduino IDE te weten. Klik in het menu Bestand op Voorkeuren en kijk bovenaan in het tekstveld bij Schetsboeklocatie. In Windows is dat bijvoorbeeld C:\Users\Gebruikersnaam\Documents\Arduino, in Linux is dit /home/gebruikersnaam/Arduino en in macOS /Users/gebruikersnaam/Documents/Arduino.

Onder de schetsboeklocatie vind je een map met de naam libraries. Hierin staat voor elke bibliotheek een map. Maak hier dus een map voor je bibliotheek aan (de naam van de bibliotheek is een goede naam voor de map). Kopieer de bestanden van de bibliotheek in deze map. Je hebt minstens een bestand met de extensie .c of .cpp en een bestand met de extensie .h nodig. Als je daarna Arduino IDE herstart, is de bibliotheek beschikbaar in het menu Schets / Bibliotheek gebruiken.

Arduino-bibliotheken updaten

Eén keer een bibliotheek installeren is niet voldoende. De ontwikkelaars brengen immers waarschijnlijk regelmatig een nieuwe versie uit om fouten op te lossen en functionaliteit toe te voegen. Gebruik je het bibliotheekbeheer, dan krijg je normaal gesproken onderaan Arduino IDE regelmatig een melding dat er nieuwe versies beschikbaar zijn. Je kunt ook zelf in het bibliotheekbeheer bij type Bij te werken kiezen om te zien welke van je geïnstalleerde bibliotheken een nieuwe versie hebben. Selecteer één voor één de bibliotheken en klik rechts op Updaten.

Voor bibliotheken die je via een zip-bestand of manueel hebt geïnstalleerd, dien je zelf regelmatig naar updates te zoeken. Let op: het volstaat niet om enkel een bibliotheek te updaten. Je dient ook je schetsen die van die bibliotheek gebruikmaken opnieuw te compileren en naar je Arduino te uploaden om van de nieuwe versie van de bibliotheek gebruik te maken in je code.

Geschreven door: Koen Vervloesem op

Category: Workshop, Programmeren

Tags: arduino

Laatste Vacatures