# Manual Integration of Libraries

To be able to connect own sensors to the senseBox, the manufacturers of many sensors provide suitable libraries. Here we show you how to download libraries from a Github repository and integrate them manually. You can use this guide for any external libraries you want to include in Arduino.

ATTENTION: The libraries required for the senseBox are already in the board support package, which is downloaded in Step 2. You should not longer integrate them manually like it was suggested in the previous books. This creates duplications that can lead to errors.

'Library' - What is it and why do I need it?

As the name suggests, a library is a collection of something - a collection of methods to be more specific. Methods are programming smaller sections of code that can be applied to an object. For example, with the senseBox, a method can be invoked to turn the LEDs on and off on the MCU. There are a lot of such standard methods that are used by a variety of programs. In order not to have to transfer these methods individually into the program code, they can be stored in libraries. So a library is a file that stores many methods. You can include libraries in your code. For this it is enough if they are stored in the Arduino folder for libraries and then they are integrated with a single line at the beginning of the program code. This is how it looks like in Arduino for the library named "senseBoxIO":

#include <senseBoxMCU.h>;


If the library is included, all methods contained in it can be used in the code.

The manual installation of the libraries can cause errors very quickly, so be sure to pay close attention to each step. To help you with the installation as well as possible, we have written a separate manual for each operating system. Choose the right system for your computer and follow the steps given.

# Insert Libraries Windows

1. Most external libraries can be found in Github repositories. To download them, you have to click the green button Clone or download and click Download ZIP afterwards.

2. If the download does not start on its own, a window opens in which you have to select the field Save file and place the folder anywhere on your computer (this is the Downloads folder by default).

3. The downloaded file is a .zip archive, which is a compressed version of the library. The next step is to unpack this .zip archive. To do this, open the archive location and right-click it and select 'Extract All ...' in the menu that appears. Select the same folder as the download location (for example, the Downloads folder).

4. Now open the Arduino IDE. Go to File ->Preferences:

and look in the box under Sketchbook location 'for the location of the Sketchbook folder.

Remember the path to this folder, ie the location where it is stored.

You need to move the library folder you have already downloaded and unpacked to the sketchbook location in the next step. It is therefore very important that you remember exactly the corresponding location from point 4, to avoid errors that could occur later.

5.Now navigate to the sketchbook location in your file explorer (see 4.). Note that the destination folder is named 'Arduino' in the File Explorer at the sketchbook location. Double-click on the folder to see its contents. The folder contains another folder named "libraries".

What do I do if there is no 'libraries' folder?

If there is no folder with the name "libraries", you can simply create a new folder and call it "libraries". Create a new folder by right-clicking in the file explorer -> New -> folder.

Now copy or drag the downloaded and unzipped folder into the libraries-folder.

1. Close the Arduino program completely and start it again to complete the installation of the respective libraries.
Unfortunately, a typical error is that the senseBox library is not placed in the correct folder. Please check again if you put the file in the right folder from 4..

# Insert Libraries Mac

1. Most external libraries can be found in Github repositories. To download them, you have to click the green button Clone or download and then in the windowDownload ZIP which opens.

3. Now open the Arduino IDE. Go to the top of Arduino ->Settings ...:

and look in the box under Sketchbook location 'for the location of the Sketchbook folder.

Remember the path to this folder, ie the location where it is stored.

You need to move the libraries you have already downloaded to the sketchbook location in the next step. It is therefore very important that you remember exactly the corresponding location from point 3, to avoid errors that could occur later.
4. Now you navigate to the sketchbook location in your Finder. Note that the destination folder in the Finder is named 'Arduino' at the sketchbook location. Double-click on the folder to see its contents. The folder contains another folder named "libraries".

What do I do if there is no 'libraries' folder?

If there is no folder with the name "libraries", you can simply create a new folder and name it "libraries".

Copy or drag now the downloaded (unzipped) folder into the libraries-folder.

5. Close the Arduino program completely and start it again to complete the installation of the respective libraries.

Unfortunately, a typical error is that the senseBox library is not placed in the correct folder. Please check again if you have placed the file in the correct folder from 3.

# Insert Libraries Linux

1. Most external libraries can be found in Github repositories. To download them, you have to click the green button Clone or download and then in the windowDownload ZIP which opens.

2.The download starts automatically and saves a .zip archive in your Downloads folder. Open the Downloads folder and unpack the .zip file with right-click ->Extract Here ( Extract Here ).

1. Now open the Arduino IDE. Go to File ->Preferences:

and look in the box under Sketchbook location 'for the location of the Sketchbook folder.

Remember the path to this folder, ie the location where it is stored.

You need to move the libraries you have already downloaded and unzipped to the sketchbook location in the next step. It is therefore very important that you remember exactly the corresponding location from point 3, to avoid errors that could occur later.
2. Now navigate to the sketchbook location in your file explorer (see 3.). Note that the destination folder is named 'Arduino' in the File Explorer at the sketchbook location. Double-click on the folder to see its contents. The folder contains another folder named "libraries".

What do I do if there is no 'libraries' folder?

If there is no folder with the name "libraries", you can simply create a new folder and call it "libraries". Create a new folder by right-clicking in the File Explorer - & gt;  New folder (New Folder).

Copy or drag now the downloaded (unzipped) folder into the libraries`-folder.

3. Close the Arduino program completely and start it again to complete the installation of the respective libraries.

Unfortunately, a typical error is that the senseBox library is not placed in the correct folder. Please check again if you have placed the file in the correct folder from 3..