AMiRo-OS

################################################################################

# AMiRo-Apps is a collection of applications and configurations for the        #

# Autonomous Mini Robot (AMiRo).                                               #

# Copyright (C) 2018..2020  Thomas Schöpping et al.                            #

#                                                                              #

# This program is free software: you can redistribute it and/or modify         #

# it under the terms of the GNU General Public License as published by         #

# the Free Software Foundation, either version 3 of the License, or            #

# (at your option) any later version.                                          #

#                                                                              #

# This program is distributed in the hope that it will be useful,              #

# but WITHOUT ANY WARRANTY; without even the implied warranty of               #

# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the                #

# GNU General Public License for more details.                                 #

#                                                                              #

# You should have received a copy of the GNU General Public License            #

# along with this program.  If not, see <http://www.gnu.org/licenses/>.        #

#                                                                              #

# This research/work was supported by the Cluster of Excellence Cognitive      #

# Interaction Technology 'CITEC' (EXC 277) at Bielefeld University, which is   #

# funded by the German Research Foundation (DFG).                              #

################################################################################

#!/bin/bash

# load library

source "$(dirname ${BASH_SOURCE[0]})/../../bash/setuplib.sh"

### print welcome text #########################################################

# Prints a welcome message to standard out.

#

# usage:      printWelcomeText

# arguments:  n/a

# return:     n/a

#

function printWelcomeText {

  printf "######################################################################\n"

  printf "#                                                                    #\n"

  printf "#                  Welcome to the QtCreator setup!                   #\n"

  printf "#                                                                    #\n"

  printf "######################################################################\n"

  printf "#                                                                    #\n"

  printf "# Copyright (c) 2018..2020  Thomas Schöpping                         #\n"

  printf "#                                                                    #\n"

  printf "# This is free software; see the source for copying conditions.      #\n"

  printf "# There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR  #\n"

  printf "# A PARTICULAR PURPOSE. The development of this software was         #\n"

  printf "# supported by the Excellence Cluster EXC 227 Cognitive Interaction  #\n"

  printf "# Technology. The Excellence Cluster EXC 227 is a grant of the       #\n"

  printf "# Deutsche Forschungsgemeinschaft (DFG) in the context of the German #\n"

  printf "# Excellence Initiative.                                             #\n"

  printf "#                                                                    #\n"

  printf "######################################################################\n"

}

### print help #################################################################

# Prints a help text to standard out.

#

# usage:      printHelp

# arguments:  n/a

# return:     n/a

#

function printHelp {

  printInfo "printing help text\n"

  printf "usage:    $(basename ${BASH_SOURCE[0]}) [-h|--help] [-c|--create=<configuration>] [-d|--delete=<configuration>] [-q|--quit] [--log=<file>]\n"

  printf "\n"

  printf "options:  -h, --help\n"

  printf "              Print this help text.\n"

  printf "          -c, --create <configuration>\n"

  printf "              Create projects for a single configuration or for all configurations (<configuration>='*').\n"

  printf "          -d, --delete <configuration>\n"

  printf "              Delete projet files of a single configuration or of all configurations (<configuration>='*').\n"

  printf "          -q, --quit\n"

  printf "              Quit the script.\n"

  printf "          --log=<file>\n"

  printf "              Specify a log file.\n"

}

### read directory where to create/delete projects #############################

# Read the directory where to create/delete project files from user.

#

# usage:      getProjectsDir <pathvar>

# arguments:  <pathvar>

#                 Variable to store the selected path to.

# return:     n/a

#

function getProjectsDir {

  local amiroappsdir=$(realpath $(dirname $(realpath ${BASH_SOURCE[0]}))/../../../)

  local input=""

  printLog "reading path for project files from user...\n"

  read -p "Path where to create/delete project files: " -i $amiroappsdir -e input

  printLog "user selected path $(realpath $input)\n"

  eval $1="$(realpath $input)"

}

### retrieves the ARM-NONE-EABI-GCC include directory ##########################

# Retrieves the include directory of the currently set arm-none-eabi-gcc.

#

# usage:      retrieveGccIncludeDir <path>

# arguments:  <path>

#                 Variable to store the path to.

# return:    0

#                 No error or warning occurred.

#            -1

#                 Error: Command 'arm-none-eabi-gcc' not found.

#            -2

#                 Error: include directory could not be resolved.

#

function retrieveGccIncludeDir {

  local binpath=$(which arm-none-eabi-gcc)

  local gccincpath=""

  # retrieve binary path or link

  if [ -z "$binpath" ]; then

    printError "command 'arm-none-eabi-gcc' not found\n"

    return -1

  else 

    # traverse any links

    while [ -L "$binpath" ]; do

      binpath=$(realpath $(dirname $binpath)/$(readlink $binpath))

    done

    printInfo "gcc-arm-none-eabi detected: $binpath\n"

    # return include path

    gccincpath=$(realpath $(dirname ${binpath})/../arm-none-eabi/include/)

    if [ ! -d "$gccincpath" ]; then

      printWarning "$gccincpath does not exist\n"

      return -2

    else

      eval $1="$gccincpath"

      return 0

    fi

  fi

}

### detect available configurations ############################################

# Detect all avalable configurations.

#

# usage:      detectConfigurations <configurationsarray>

# arguments:  <configurationsarray>

#                 Array variable to store all detected configurations to.

# return:     n/a

#

function detectConfigurations {

  local configs_detected=()

  local configsdir=$(realpath $(dirname $(realpath ${BASH_SOURCE[0]}))/../../../configurations)

  # detect all available modules (via directories)

  for dir in $(ls -d ${configsdir}/*/); do

    configs_detected[${#configs_detected[@]}]=$(basename $dir)

  done

  # set the output variable

  eval "$1=(${configs_detected[*]})"

}

### create project files for a single or for all configurations ################

# Create project files for all modules of a single or of all configurations.

#

# usage:      createProject <configurations> [-c|--configuration=<configuration>] [-p|--path=<path>] [--gcc=<path>] [-o|--out=<var>] [--gccout=<var>]

# arguments:  <configurations>

#                 Array containing all configurations available.

#             -c, --configuration <configuration>

#                 Name (folder name) of the configuration for which project files shall be generated.

#                 Set <configuration> to '*' in order to generate projects for all available configurations.

#             -p, --path <path>

#                 Path where to create the project files.

#             --gcc=<path>

#                 Path to the GCC include directory.

#             -o, --out <var>

#                 Variable to store the path to.

#             --gccout=<var>

#                 Variable to store the path to the GCC include directory to.

#                 If this optional arguments is absent, ths function will ask for user input.

# return:     0

#                 No error or warning occurred.

#             1

#                 Aborted by user.

#             2

#                 The selected configuration does not contain any modules.

#             -1

#                 No configurations available.

#             -2

#                 The specified <configuration> could not be found.

#             -3

#                 Parsing the project for the specified configuration failed.

#             -4

#                 Missing dependencies.

#

function createProject {

  local config=""

  local configs=("${!1}")

  local configs2generate=()

  local configsdir=$(realpath $(dirname $(realpath ${BASH_SOURCE[0]}))/../../../configurations)

  local gccincludedir=""

  local gccoutvar=""

  local includes=()

  local makedir=""

  local makedirs=()

  local modules=()

  local otherargs=()

  local outvar=""

  local parse_state=""

  local projectfiles=()

  local projects=()

  local projectsdir=""

  local quotes="\'\"\´\`\„\“"

  local rawout=""

  local sourcefile=""

  local sourcefiles=()

  local userdir=$(pwd)

  local userinput=""

  # check dependencies

  checkCommands make

  if [ $? -ne 0 ]; then

    printError "Missing dependencies detected.\n"

    return -4

  fi

  # parse arguments

  while [ $# -gt 0 ]; do

    if ( parseIsOption $1 ); then

      case "$1" in

        -c=*|--configuration=*)

          config="${1#*=}"; shift 1;;

        -c|--configuration)