18c574d66a
In some cases, a separate toolchain is necessary to build modules. E.g. the sim on macOS, where the native format is Mach-O. By default, just use CC/LD, which is appropriate for the most of platforms.
372 lines
11 KiB
Makefile
372 lines
11 KiB
Makefile
############################################################################
|
|
# tools/Config.mk
|
|
# Global build rules and macros.
|
|
#
|
|
# Copyright (C) 2011, 2013-2014, 2018-2019, 2020 Gregory Nutt. All rights
|
|
# reserved.
|
|
# Author: Richard Cochran
|
|
# Gregory Nutt <gnutt@nuttx.org>
|
|
#
|
|
# This file (along with $(TOPDIR)/.config) must be included by every
|
|
# configuration-specific Make.defs file.
|
|
#
|
|
# Redistribution and use in source and binary forms, with or without
|
|
# modification, are permitted provided that the following conditions
|
|
# are met:
|
|
#
|
|
# 1. Redistributions of source code must retain the above copyright
|
|
# notice, this list of conditions and the following disclaimer.
|
|
# 2. Redistributions in binary form must reproduce the above copyright
|
|
# notice, this list of conditions and the following disclaimer in
|
|
# the documentation and/or other materials provided with the
|
|
# distribution.
|
|
# 3. Neither the name NuttX nor the names of its contributors may be
|
|
# used to endorse or promote products derived from this software
|
|
# without specific prior written permission.
|
|
#
|
|
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
|
# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
|
# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
|
|
# FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
|
|
# COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
|
|
# INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
|
|
# BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
|
|
# OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
|
|
# AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
# LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
|
|
# ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
# POSSIBILITY OF SUCH DAMAGE.
|
|
#
|
|
############################################################################
|
|
|
|
# Disable all built-in rules
|
|
|
|
.SUFFIXES:
|
|
|
|
ifeq ($(CONFIG_WINDOWS_NATIVE),y)
|
|
export SHELL=cmd
|
|
endif
|
|
|
|
# These are configuration variables that are quoted by configuration tool
|
|
# but which must be unquoted when used in the build system.
|
|
|
|
CONFIG_ARCH := $(patsubst "%",%,$(strip $(CONFIG_ARCH)))
|
|
CONFIG_ARCH_CHIP := $(patsubst "%",%,$(strip $(CONFIG_ARCH_CHIP)))
|
|
CONFIG_ARCH_BOARD := $(patsubst "%",%,$(strip $(CONFIG_ARCH_BOARD)))
|
|
|
|
# Some defaults just to prohibit some bad behavior if for some reason they
|
|
# are not defined
|
|
|
|
OBJEXT ?= .o
|
|
LIBEXT ?= .a
|
|
|
|
# DELIM - Path segment delimiter character
|
|
#
|
|
# Depends on this settings defined in board-specific defconfig file installed
|
|
# at $(TOPDIR)/.config:
|
|
#
|
|
# CONFIG_WINDOWS_NATIVE - Defined for a Windows native build
|
|
|
|
ifeq ($(CONFIG_WINDOWS_NATIVE),y)
|
|
DELIM = $(strip \)
|
|
else
|
|
DELIM = $(strip /)
|
|
endif
|
|
|
|
# INCDIR - Convert a list of directory paths to a list of compiler include
|
|
# directories
|
|
# Example: CFFLAGS += ${shell $(INCDIR) [options] "compiler" "dir1" "dir2" "dir2" ...}
|
|
#
|
|
# Note that the compiler string and each directory path string must quoted if
|
|
# they contain spaces or any other characters that might get mangled by the
|
|
# shell
|
|
#
|
|
# Depends on this setting passed as a make command line definition from the
|
|
# toplevel Makefile:
|
|
#
|
|
# TOPDIR - The path to the top level NuttX directory in the form
|
|
# appropriate for the current build environment
|
|
#
|
|
# Depends on this settings defined in board-specific defconfig file installed
|
|
# at $(TOPDIR)/.config:
|
|
#
|
|
# CONFIG_WINDOWS_NATIVE - Defined for a Windows native build
|
|
|
|
ifeq ($(CONFIG_WINDOWS_NATIVE),y)
|
|
DEFINE = "$(TOPDIR)\tools\define.bat"
|
|
INCDIR = "$(TOPDIR)\tools\incdir.bat"
|
|
else
|
|
DEFINE = "$(TOPDIR)/tools/define.sh"
|
|
INCDIR = "$(TOPDIR)/tools/incdir.sh"
|
|
endif
|
|
|
|
# PREPROCESS - Default macro to run the C pre-processor
|
|
# Example: $(call PREPROCESS, in-file, out-file)
|
|
#
|
|
# Depends on these settings defined in board-specific Make.defs file
|
|
# installed at $(TOPDIR)/Make.defs:
|
|
#
|
|
# CPP - The command to invoke the C pre-processor
|
|
# CPPFLAGS - Options to pass to the C pre-processor
|
|
#
|
|
# '<filename>.c_CPPFLAGS += <options>' may also be used, as an example, to
|
|
# change the options used with the single file <filename>.c (or
|
|
# <filename>.S)
|
|
|
|
define PREPROCESS
|
|
@echo "CPP: $1->$2"
|
|
$(Q) $(CPP) $(CPPFLAGS) $($(strip $1)_CPPFLAGS) $1 -o $2
|
|
endef
|
|
|
|
# COMPILE - Default macro to compile one C file
|
|
# Example: $(call COMPILE, in-file, out-file)
|
|
#
|
|
# Depends on these settings defined in board-specific Make.defs file
|
|
# installed at $(TOPDIR)/Make.defs:
|
|
#
|
|
# CC - The command to invoke the C compiler
|
|
# CFLAGS - Options to pass to the C compiler
|
|
#
|
|
# '<filename>.c_CFLAGS += <options>' may also be used, as an example, to
|
|
# change the options used with the single file <filename>.c
|
|
|
|
define COMPILE
|
|
@echo "CC: $1"
|
|
$(Q) $(CC) -c $(CFLAGS) $($(strip $1)_CFLAGS) $1 -o $2
|
|
endef
|
|
|
|
# COMPILEXX - Default macro to compile one C++ file
|
|
# Example: $(call COMPILEXX, in-file, out-file)
|
|
#
|
|
# Depends on these settings defined in board-specific Make.defs file
|
|
# installed at $(TOPDIR)/Make.defs:
|
|
#
|
|
# CXX - The command to invoke the C++ compiler
|
|
# CXXFLAGS - Options to pass to the C++ compiler
|
|
#
|
|
# '<filename>.cxx_CXXFLAGS += <options>' may also be used, as an example, to
|
|
# change the options used with the single file <filename>.cxx. The
|
|
# extension .cpp could also be used. The same applies mutatis mutandis.
|
|
|
|
define COMPILEXX
|
|
@echo "CXX: $1"
|
|
$(Q) $(CXX) -c $(CXXFLAGS) $($(strip $1)_CXXFLAGS) $1 -o $2
|
|
endef
|
|
|
|
# ASSEMBLE - Default macro to assemble one assembly language file
|
|
# Example: $(call ASSEMBLE, in-file, out-file)
|
|
#
|
|
# NOTE that the most common toolchain, GCC, uses the compiler to assemble
|
|
# files because this has the advantage of running the C Pre-Processor against
|
|
# the assembly language files. This is not possible with other toolchains;
|
|
# platforms using those other tools should define AS and over-ride this
|
|
# definition in order to use the assembler directly.
|
|
#
|
|
# Depends on these settings defined in board-specific Make.defs file
|
|
# installed at $(TOPDIR)/Make.defs:
|
|
#
|
|
# CC - By default, the C compiler is used to compile assembly language
|
|
# files
|
|
# AFLAGS - Options to pass to the C+compiler
|
|
#
|
|
# '<filename>.s_AFLAGS += <options>' may also be used, as an example, to change
|
|
# the options used with the single file <filename>.s. The extension .asm
|
|
# is used by some toolchains. The same applies mutatis mutandis.
|
|
|
|
define ASSEMBLE
|
|
@echo "AS: $1"
|
|
$(Q) $(CC) -c $(AFLAGS) $1 $($(strip $1)_AFLAGS) -o $2
|
|
endef
|
|
|
|
# INSTALL_LIB - Install a library $1 into target $2
|
|
# Example: $(call INSTALL_LIB, libabc.a, $(TOPDIR)/staging/)
|
|
|
|
define INSTALL_LIB
|
|
@echo "IN: $1 -> $2"
|
|
$(Q) install -m 0644 $1 $2
|
|
endef
|
|
|
|
# ARCHIVE - Add a list of files to an archive
|
|
# Example: $(call ARCHIVE, archive-file, "file1 file2 file3 ...")
|
|
#
|
|
# Note: The fileN strings may not contain spaces or characters that may be
|
|
# interpreted strangely by the shell
|
|
#
|
|
# Depends on these settings defined in board-specific Make.defs file
|
|
# installed at $(TOPDIR)/Make.defs:
|
|
#
|
|
# AR - The command to invoke the archiver (includes any options)
|
|
#
|
|
# Depends on this settings defined in board-specific defconfig file installed
|
|
# at $(TOPDIR)/.config:
|
|
#
|
|
# CONFIG_WINDOWS_NATIVE - Defined for a Windows native build
|
|
|
|
define ARCHIVE
|
|
$(AR) $1 $(2)
|
|
endef
|
|
|
|
# PRELINK - Prelink a list of files
|
|
# This is useful when files were compiled with fvisibility=hidden.
|
|
# Any symbol which was not explicitly made global is invisible outside the
|
|
# prelinked file.
|
|
#
|
|
# Example: $(call PRELINK, prelink-file, "file1 file2 file3 ...")
|
|
#
|
|
# Note: The fileN strings may not contain spaces or characters that may be
|
|
# interpreted strangely by the shell
|
|
#
|
|
# Depends on these settings defined in board-specific Make.defs file
|
|
# installed at $(TOPDIR)/Make.defs:
|
|
#
|
|
# LD - The command to invoke the linker (includes any options)
|
|
# OBJCOPY - The command to invoke the object cop (includes any options)
|
|
#
|
|
# Depends on this settings defined in board-specific defconfig file installed
|
|
# at $(TOPDIR)/.config:
|
|
#
|
|
# CONFIG_WINDOWS_NATIVE - Defined for a Windows native build
|
|
|
|
ifeq ($(CONFIG_WINDOWS_NATIVE),y)
|
|
define PRELINK
|
|
@echo PRELINK: $1
|
|
$(Q) $(LD) -Ur -o $1 $2 && $(OBJCOPY) --localize-hidden $1
|
|
endef
|
|
else
|
|
define PRELINK
|
|
@echo "PRELINK: $1"
|
|
$(Q) $(LD) -Ur -o $1 $2 && $(OBJCOPY) --localize-hidden $1
|
|
endef
|
|
endif
|
|
|
|
# POSTBUILD -- Perform post build operations
|
|
# Some architectures require the use of special tools and special handling
|
|
# AFTER building the NuttX binary. Make.defs files for thos architectures
|
|
# should override the following define with the correct operations for
|
|
# that platform
|
|
|
|
define POSTBUILD
|
|
endef
|
|
|
|
# DELFILE - Delete one file
|
|
|
|
ifeq ($(CONFIG_WINDOWS_NATIVE),y)
|
|
define DELFILE
|
|
$(Q) if exist $1 (del /f /q $1)
|
|
endef
|
|
else
|
|
define DELFILE
|
|
$(Q) rm -f $1
|
|
endef
|
|
endif
|
|
|
|
# DELDIR - Delete one directory
|
|
|
|
ifeq ($(CONFIG_WINDOWS_NATIVE),y)
|
|
define DELDIR
|
|
$(Q) if exist $1 (rmdir /q /s $1)
|
|
endef
|
|
else
|
|
define DELDIR
|
|
$(Q) rm -rf $1
|
|
endef
|
|
endif
|
|
|
|
# MOVEFILE - Move one file
|
|
|
|
ifeq ($(CONFIG_WINDOWS_NATIVE),y)
|
|
define MOVEFILE
|
|
$(Q) if exist $1 (move /Y $1 $2)
|
|
endef
|
|
else
|
|
define MOVEFILE
|
|
$(Q) mv -f $1 $2
|
|
endef
|
|
endif
|
|
|
|
# COPYFILE - Copy one file
|
|
|
|
ifeq ($(CONFIG_WINDOWS_NATIVE),y)
|
|
define COPYFILE
|
|
$(Q) if exist $1 (copy /y /b $1 $2)
|
|
endef
|
|
else
|
|
define COPYFILE
|
|
$(Q) cp -f $1 $2
|
|
endef
|
|
endif
|
|
|
|
# CATFILE - Cat a list of files
|
|
#
|
|
# USAGE: $(call CATFILE,dest,src1,src2,src3,...)
|
|
|
|
ifeq ($(CONFIG_WINDOWS_NATIVE),y)
|
|
define CATFILE
|
|
$(Q) type $(2) > $1
|
|
endef
|
|
else
|
|
define CATFILE
|
|
$(Q) cat $(2) > $1
|
|
endef
|
|
endif
|
|
|
|
# RWILDCARD - Recursive wildcard used to get lists of files from directories
|
|
#
|
|
# USAGE: FILELIST = $(call RWILDCARD,<dir>,<wildcard-filename)
|
|
#
|
|
# This is functionally equivalent to the following, but has the advantage in
|
|
# that it is portable
|
|
#
|
|
# FILELIST = ${shell find <dir> -name <wildcard-file>}
|
|
|
|
define RWILDCARD
|
|
$(foreach d,$(wildcard $1/*),$(call RWILDCARD,$d,$2)$(filter $(subst *,%,$2),$d))
|
|
endef
|
|
|
|
# CLEAN - Default clean target
|
|
|
|
ifeq ($(CONFIG_WINDOWS_NATIVE),y)
|
|
define CLEAN
|
|
$(Q) if exist *$(OBJEXT) (del /f /q *$(OBJEXT))
|
|
$(Q) if exist *$(LIBEXT) (del /f /q *$(LIBEXT))
|
|
$(Q) if exist *~ (del /f /q *~)
|
|
$(Q) if exist (del /f /q .*.swp)
|
|
endef
|
|
else
|
|
define CLEAN
|
|
$(Q) rm -f *$(OBJEXT) *$(LIBEXT) *~ .*.swp
|
|
endef
|
|
endif
|
|
|
|
# TESTANDREPLACEFILE - Test if two files are different. If so replace the
|
|
# second with the first. Otherwise, delete the first.
|
|
#
|
|
# USAGE: $(call TESTANDREPLACEFILE, newfile, oldfile)
|
|
#
|
|
# args: $1 - newfile: Temporary file to test
|
|
# $2 - oldfile: File to replace
|
|
|
|
ifeq ($(CONFIG_WINDOWS_NATIVE),y)
|
|
define TESTANDREPLACEFILE
|
|
$(Q) move /Y $1 $2
|
|
endef
|
|
else
|
|
define TESTANDREPLACEFILE
|
|
if [ -f $2 ]; then \
|
|
if cmp $1 $2; then \
|
|
rm -f $1; \
|
|
else \
|
|
mv $1 $2; \
|
|
fi \
|
|
else \
|
|
mv $1 $2; \
|
|
fi
|
|
endef
|
|
endif
|
|
|
|
# Some defaults.
|
|
# $(TOPDIR)/Make.defs can override these appropriately.
|
|
|
|
MODULECC = $(CC)
|
|
MODULELD = $(LD)
|