Refactored '3rd-party-library' example to be more organized.

Also added some more doc-comments to the example's 'CMakeLists.txt' file.

Author: MrPointer

examples/3rd-party-library/3rd_party.cpp

@@ -0,0 +1,15 @@
+#include <Arduino.h>
+#include "NeoPixelTest.hpp"
+#include "GFXTest.h"
+#include "InterruptTest.hpp"
+
+void setup()
+{
+    testNeoPixel();
+    testGFX();
+}
+
+void loop()
+{
+
+}

examples/3rd-party-library/CMakeLists.txt

@@ -3,17 +3,27 @@ cmake_minimum_required(VERSION 3.8.2)
 project(3rd_Party_Arduino_Library)
 get_board_id(board_id nano atmega328)
 
-add_arduino_executable(3rd_Party_Arduino_Library ${board_id} NeoPixelTest.cpp GFXTest.cpp)
+# First, declare and create our executable - It'll use 4 sources
+add_arduino_executable(3rd_Party_Arduino_Library ${board_id} 3rd_party.cpp
+        NeoPixelTest.cpp GFXTest.cpp InterruptTest.cpp)
 target_include_directories(3rd_Party_Arduino_Library PRIVATE include)
 
+# Add the "NeoPixel" library manually using the library addition API
 add_arduino_library(Adafruit_NeoPixel ${board_id} libraries/Adafruit_NeoPixel/Adafruit_NeoPixel.cpp)
 target_include_directories(Adafruit_NeoPixel PUBLIC libraries/Adafruit_NeoPixel)
 
-# 'Trick' the framework to use current directory as Sketchbook, allowing us to use the 'find' API
+# Find the "GFX" library by 'tricking' the framework to use current directory as the Sketchbook path,
+# allowing us to use the 'find' API
 set(ARDUINO_CMAKE_SKETCHBOOK_PATH "${CMAKE_CURRENT_LIST_DIR}")
 find_arduino_library(Adafruit_GFX Adafruit-GFX-Library ${board_id} 3RD_PARTY)
-target_source_directories(Adafruit_GFX
-        DIRS libraries/Adafruit-GFX-Library/Fonts)
+# We can also explicitly add additional directories to the target,
+# as only root dir and 'src' sub-dir are added by default
+target_source_directories(Adafruit_GFX DIRS libraries/Adafruit-GFX-Library/Fonts)
 
+# Find the "EnableInterrupt" a header-only library
+#find_arduino_library(enableInterrupt EnableInterrupt ${board_id} 3RD_PARTY)
+
+# Link all libraries to our previously created target
 link_arduino_library(3rd_Party_Arduino_Library Adafruit_NeoPixel ${board_id})
 link_arduino_library(3rd_Party_Arduino_Library Adafruit_GFX ${board_id})
+#link_arduino_library(3rd_Party_Arduino_Library enableInterrupt ${board_id})

examples/3rd-party-library/GFXTest.cpp

@@ -2,7 +2,7 @@
 
 static Adafruit_GFX_Button gfxButton;
 
-void doSomething()
+void testGFX()
 {
     gfxButton.isPressed();
 }

examples/3rd-party-library/InterruptTest.cpp

@@ -0,0 +1 @@
+#include "include/InterruptTest.hpp"

examples/3rd-party-library/NeoPixelTest.cpp

@@ -1,15 +1,11 @@
-#include <Adafruit_NeoPixel.h>
-#include "GFXTest.h"
+
+#include <NeoPixelTest.hpp>
+
+#include "include/NeoPixelTest.hpp"
 
 Adafruit_NeoPixel neoPixel;
 
-void setup()
+void testNeoPixel()
 {
     neoPixel.clear();
-    doSomething();
-}
-
-void loop()
-{
-
 }

examples/3rd-party-library/include/GFXTest.h

@@ -3,6 +3,6 @@
 
 #include <Adafruit_GFX.h>
 
-void doSomething();
+void testGFX();
 
 #endif //EXAMPLES_GFXTEST_HPP

examples/3rd-party-library/include/InterruptTest.hpp

@@ -0,0 +1,4 @@
+#ifndef EXAMPLES_INTERRUPTTEST_HPP
+#define EXAMPLES_INTERRUPTTEST_HPP
+
+#endif //EXAMPLES_INTERRUPTTEST_HPP

examples/3rd-party-library/include/NeoPixelTest.hpp

@@ -0,0 +1,8 @@
+#ifndef EXAMPLES_NEOPIXELTEST_HPP
+#define EXAMPLES_NEOPIXELTEST_HPP
+
+#include <Adafruit_NeoPixel.h>
+
+void testNeoPixel();
+
+#endif //EXAMPLES_NEOPIXELTEST_HPP