How to Write Arduino Library of Your Own

Normally, we write sketch on Arduino IDE, which essentially uses libraries. Library of Arduino is Set of Instructions to Avoid Repeated Huge Coding. As we discussed in how to learn Arduino programming, C++, C are important languages are important to learn for Arduino and embedded systems. Libraries add an abstraction from reality – which is practical for using things like a temperature humidity sensor. TM1637 7 segment LED display has lot of libraries, however we can avoid them and directly write code inside Arduino IDE. Basic is the construction of a working sketch. Here is Guide on How to Write Arduino Library of Your Own With Example. This is probably a helpful resource for knowing Arduino platform specific :

 

How to Write Arduino Library of Your Own

 

An Arduino library contains :

1. A directory with name of the thing, file name is the name of the thing (C++ language)
2. A .h header file (C++ langugage)
3. A .c or .cpp source code file, file name is the name of the thing (C or C++ language)
4. A optional file named keywords.txt

Example of name of the thing can be like TM1637, DHT11 etc. Usually unique names used to avoid confusion. It is practical to use Abhishek_TM1637 i.e. user named library for a custom user library. You can write those file using whatever editor you want, even plain text editors will work fine OR use Arduino IDE as code editor or use something like Visual Studio Code.

Arduino IDE places the libraries in specific directory within the operating system, like /usr/share/arduino/libraries for GNU/Linux systems. This is a normal sketch of LED Blink :

We can make that sketch like this :

Notice void on(), void off(), void blink(int time) – we made the sketch extended to implement those three functionalities.

Take that, our example library will be called LedBlinkLib. So, our directory structure of LedBlinkLib becoming :

We can easily drop that custom library directory to Arduino IDE’s library. Then restarting Arduino IDE will enable the library like other library.

Header File

The header is as if a summary of what the library contains. We can define some other libraries to load it. For our LedBlinkLib header file will go like this :

First two are referred to as an include guard to prevent the code from being included into the program binary multiple times. Third line includes the Arduino code to our library to enable to use the pinMode, digitalWrite, delay etc functions. Forth line is the beginning of the class LedBlinkLib. Next line uses public keyword.
Sixth, Seventh lines are constructor and destructor – set up library (construct), and delete it (deconstruct). Remaining lines are probably obvious.

Source File

Next, we need to write LedBlinkLib.cpp file :

Keywords File

keywords.txt is not mandatory, however this is example :

Example of Using the Library Created

To use this library, we will write a sketch like this, except the time we have nothing to write more :

 

Conclusion

 

This is a very primitive example, yet explains how libraries are written. You can publish the library, like this :

You can distribute zip as release :

Tagged With how to write arduino library , writing arduino library , writing an arduino library , writing arduino libraries , how to write arduino code on our own , writting librayys ardunio , how to write a library for Arduino , how to setup a library from source code arduino , create library arduino windows text , arduino writing your own library