Added ability to configure boards on project-level

Moved board-related modules under the `Hardware/Boards` directory.

Author: MrPointer

cmake/Platform/Arduino.cmake

@@ -1,6 +1,7 @@
-cmake_minimum_required(VERSION 3.8)
+cmake_minimum_required(VERSION 3.8.2)
 
 list(APPEND CMAKE_MODULE_PATH ${CMAKE_CURRENT_LIST_DIR}/Utilities)
+list(APPEND CMAKE_MODULE_PATH ${CMAKE_CURRENT_LIST_DIR}/Hardware/Boards)
 list(APPEND CMAKE_MODULE_PATH ${CMAKE_CURRENT_LIST_DIR}/System)
 list(APPEND CMAKE_MODULE_PATH ${CMAKE_CURRENT_LIST_DIR}/Other)
 list(APPEND CMAKE_MODULE_PATH ${CMAKE_CURRENT_LIST_DIR}/Properties)
@@ -11,7 +12,8 @@ list(APPEND CMAKE_MODULE_PATH ${CMAKE_CURRENT_LIST_DIR}/Targets)
 
 include(Utilities)
 
-include(BoardManager)
+include(Boards)
+
 include(RecipeParser)
 include(TargetFlagsManager)
 include(SourcesManager)

cmake/Platform/Hardware/Boards/BoardConfigurator.cmake

@@ -0,0 +1,29 @@
+include(CoreLibTarget)
+
+#========================================================================================================#
+# Internal function that actually configures project for use with a given hardware board.
+# Currently it only creates a Core-Library target based on the given board, which will be linked
+# to every Arduino-target created afterwards.
+#       _board_id - Complete ID of the board which will be used throughout the project.
+#========================================================================================================#
+function(_configure_arduino_board _board_id)
+
+    add_arduino_core_lib(${_board_id})
+
+endfunction()
+
+#========================================================================================================#
+# Configures CMake framework for use with the given Arduino hardware board.
+# Note that it doesn't do anything that's actually related to hardware, this is simply configuration!
+# This functio should be called at least once in each project, so targets created later could use the board.
+#       _board_name - Name of the board, e.g. nano, uno, etc...
+#       [] - Explicit board CPU if there are multiple versions of the board (such as atmega328p).
+#            This is an argument variable which has no name and can be passed as the last argument when required.
+#========================================================================================================#
+function(configure_arduino_board _board_name _board_cpu)
+
+    get_board_id(board_id ${_board_name} ${_board_cpu})
+
+    _configure_arduino_board(${board_id})
+
+endfunction()

cmake/Platform/Other/BoardManager.cmake …tform/Hardware/Boards/BoardManager.cmakecmake/Platform/Other/BoardManager.cmake renamed to cmake/Platform/Hardware/Boards/BoardManager.cmake cmake/Platform/Other/BoardManager.cmake renamed to cmake/Platform/Hardware/Boards/BoardManager.cmake

@@ -12,30 +12,43 @@
 function(get_board_id _return_var _board_name)
 
     set(extra_args ${ARGN})
+
     list(LENGTH extra_args num_of_extra_args)
+
     if (${num_of_extra_args} GREATER 0)
         list(GET extra_args 0 _board_cpu)
     endif ()
 
     list(FIND ARDUINO_CMAKE_BOARDS ${_board_name} board_name_index)
+
     if (${board_name_index} LESS 0) # Negative value = not found in list
-        message(FATAL_ERROR "Unknown given board name, not defined in 'boards.txt'. Check your\
-        spelling.")
+        message(FATAL_ERROR "Given board not defined in 'boards.txt' - Check your spelling.")
+
     else () # Board is valid and has been found
+
         if (DEFINED ${_board_name}_cpu_list) # Board cpu is to be expected
+
             if (NOT _board_cpu)
                 message(FATAL_ERROR "Expected board CPU to be provided for the ${_board_name} board")
+
             else ()
+
                 list(FIND ${_board_name}_cpu_list ${_board_cpu} board_cpu_index)
+
                 if (${board_cpu_index} LESS 0)
                     message(FATAL_ERROR "Unknown given board cpu")
                 endif ()
+
                 set(board_id "${_board_name}.${_board_cpu}")
+
                 set(${_return_var} "${board_id}" PARENT_SCOPE)
+
             endif ()
+
         else () # Board without explicit CPU
             set(${_return_var} ${_board_name} PARENT_SCOPE)
         endif ()
+
     endif ()
 
 endfunction()
@@ -58,19 +71,24 @@ function(get_board_property _board_id _property _return_var)
 
     # Get the length of the board to determine whether board CPU is to be expected
     list(LENGTH board_id num_of_board_elements)
+
     list(GET board_id 0 board_name) # Get the board name which is mandatory
 
     if (DEFINED ${board_name}_${property})
         set(retrieved_property ${${board_name}_${property}})
     elseif (${num_of_board_elements} EQUAL 1) # Only board name is supplied
         message(WARNING "Property ${_property} couldn't be found on board ${_board_id}")
+
     else ()
+
         list(GET board_id 1 board_cpu)
+
         if (NOT DEFINED ${board_name}_menu_cpu_${board_cpu}_${property})
             message(WARNING "Property ${_property} couldn't be found on board ${_board_id}")
         else ()
             set(retrieved_property ${${board_name}_menu_cpu_${board_cpu}_${property}})
         endif ()
+
     endif ()
 
     set(${_return_var} ${retrieved_property} PARENT_SCOPE)
@@ -100,13 +118,17 @@ function(try_get_board_property _board_id _property _return_var)
         set(${_return_var} ${${board_name}_${property}} PARENT_SCOPE)
     elseif (${num_of_board_elements} EQUAL 1) # Only board name is supplied
         return()
+
     else ()
+
         list(GET board_id 1 board_cpu)
+
         if (NOT DEFINED ${board_name}_menu_cpu_${board_cpu}_${property})
             return()
         else ()
             set(${_return_var} ${${board_name}_menu_cpu_${board_cpu}_${property}} PARENT_SCOPE)
         endif ()
+
     endif ()
 
 endfunction()

cmake/Platform/Hardware/Boards/Boards.cmake

@@ -0,0 +1,2 @@
+include(BoardManager)
+include(BoardConfigurator)