[clinton/Smoothieware.git] / build / build.mk

# Copyright 2012 Adam Green (http://mbed.org/users/AdamGreen/)
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
###############################################################################
# USAGE:
# Variables that must be defined in including makefile.
#   PROJECT: Name to be given to the output binary for this project.
#   BUILD_DIR: The directory containing this build.mk file.
#
# Variables that may be optionally set in makefile.
#   SRC: The root directory for the sources of your project.  Defaults to '.'.
#   LIBS_PREFIX: List of library/object files to prepend to mbed.ar capi.ar libs.
#   LIBS_SUFFIX: List of library/object files to append to mbed.ar capi.ar libs.
#   BUILD_TYPE: Type of build to produce.  Allowed values are:
#                  Debug - Build for debugging.  Disables optimizations and
#                          links in debug MRI runtime.  Best debugging 
#                          experience.
#                  Release - Build for release with no debug support.
#                  Checked - Release build with debug support.  Due to
#                            optimizations, debug experience won't be as good
#                            as Debug but might be needed when bugs don't
#                            reproduce in Debug builds.
#                  default: Release
#   DEVICES: List of devices for which to build.  This list be space delimited
#            and can include the following devices:
#            LPC1768, LPC11U24
#            default: LPC1768
#   GPFLAGS: Additional compiler flags used when building C++ sources.
#   GCFLAGS: Additional compiler flags used when building C sources.
#   AS_GCFLAGS: Additional compiler flags used by GCC when building
#               preprocessed assembly language sources.
#   AS_FLAGS: Additional assembler flags used when building assembly language
#             sources.
#   NO_FLOAT_SCANF: When set to 1, scanf() will not support %f specifier to
#                   input floating point values.  Reduces code size.
#   NO_FLOAT_PRINTF: When set to 1, scanf() will not support %f specifier to
#                    output floating point values.  Reduces code size.
#   VERBOSE: When set to 1, all build commands will be displayed to console.
#            It defaults to 0 which suppresses the output of the build tool
#            command lines themselves.
#   MRI_BREAK_ON_INIT: Should the program halt before calling into main(),
#                      allowing the developer time to set breakpoints in main()
#                      or in code run from within global constructors.
#                      default: 1 - break on init.
#   MRI_SEMIHOST_STDIO: Set to non-zero value to allow debug monitor to use
#                       semi-host calls to redirect stdin/stdout/stderr to the
#                       gdb console.
#                       default: 1 for Debug/Checked builds and 0 for Release.
#   MRI_UART: Select the UART to be used by the debugger.  See mri.h for
#             allowed values.
#             default: MRI_UART_MBED_USB - Use USB based UART on the mbed.
# Example makefile:
#       PROJECT=HelloWorld
#       BUILD_DIR=../..
#
#       include $(BUILD_DIR)/build.mk
#      
###############################################################################

# Check for undefined variables.
ifndef PROJECT
$(error makefile must set PROJECT variable.)
endif

ifndef BUILD_DIR
$(error makefile must set BUILD_DIR.)
endif


# Default DEVICES to LPC1768 if nothing else has been specified.
DEVICES?=lpc1768


# Use DEVICES variable to determine which builds to perform.
CLEAN_DEVICES=$(addsuffix .clean,$(DEVICES))
.PHONY: all clean $(DEVICES) $(CLEAN_DEVICES) deploy deploy-lpc1768 deploy-lpc11u24

all: $(DEVICES)

clean: $(CLEAN_DEVICES)

export
$(DEVICES):
	@echo Building for device $@
	@$(MAKE) -f $(BUILD_DIR)/$@.mk all

$(CLEAN_DEVICES): %.clean:
	@echo Cleaning up for device $*
	@$(MAKE) -f $(BUILD_DIR)/$*.mk clean

ifdef LPC_DEPLOY
deploy deploy-lpc1768:
	@echo Deploying to target.
	$(subst PROJECT,LPC1768/$(PROJECT),$(LPC_DEPLOY))

deploy-lpc11u24:
	@echo Deploying to target.
	$(subst PROJECT,LPC11U24/$(PROJECT),$(LPC_DEPLOY))
endif
Commit	Line	Data
172d42d9 AG	1	# Copyright 2012 Adam Green (http://mbed.org/users/AdamGreen/)
	2	#
	3	# Licensed under the Apache License, Version 2.0 (the "License");
	4	# you may not use this file except in compliance with the License.
	5	# You may obtain a copy of the License at
	6	#
	7	# http://www.apache.org/licenses/LICENSE-2.0
	8	#
	9	# Unless required by applicable law or agreed to in writing, software
	10	# distributed under the License is distributed on an "AS IS" BASIS,
	11	# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
	12	# See the License for the specific language governing permissions and
	13	# limitations under the License.
	14	###############################################################################
	15	# USAGE:
	16	# Variables that must be defined in including makefile.
	17	# PROJECT: Name to be given to the output binary for this project.
	18	# BUILD_DIR: The directory containing this build.mk file.
	19	#
	20	# Variables that may be optionally set in makefile.
	21	# SRC: The root directory for the sources of your project. Defaults to '.'.
	22	# LIBS_PREFIX: List of library/object files to prepend to mbed.ar capi.ar libs.
	23	# LIBS_SUFFIX: List of library/object files to append to mbed.ar capi.ar libs.
	24	# BUILD_TYPE: Type of build to produce. Allowed values are:
	25	# Debug - Build for debugging. Disables optimizations and
	26	# links in debug MRI runtime. Best debugging
	27	# experience.
	28	# Release - Build for release with no debug support.
	29	# Checked - Release build with debug support. Due to
	30	# optimizations, debug experience won't be as good
	31	# as Debug but might be needed when bugs don't
	32	# reproduce in Debug builds.
	33	# default: Release
	34	# DEVICES: List of devices for which to build. This list be space delimited
	35	# and can include the following devices:
	36	# LPC1768, LPC11U24
	37	# default: LPC1768
	38	# GPFLAGS: Additional compiler flags used when building C++ sources.
	39	# GCFLAGS: Additional compiler flags used when building C sources.
	40	# AS_GCFLAGS: Additional compiler flags used by GCC when building
	41	# preprocessed assembly language sources.
	42	# AS_FLAGS: Additional assembler flags used when building assembly language
	43	# sources.
	44	# NO_FLOAT_SCANF: When set to 1, scanf() will not support %f specifier to
	45	# input floating point values. Reduces code size.
	46	# NO_FLOAT_PRINTF: When set to 1, scanf() will not support %f specifier to
	47	# output floating point values. Reduces code size.
	48	# VERBOSE: When set to 1, all build commands will be displayed to console.
	49	# It defaults to 0 which suppresses the output of the build tool
	50	# command lines themselves.
	51	# MRI_BREAK_ON_INIT: Should the program halt before calling into main(),
	52	# allowing the developer time to set breakpoints in main()
	53	# or in code run from within global constructors.
	54	# default: 1 - break on init.
	55	# MRI_SEMIHOST_STDIO: Set to non-zero value to allow debug monitor to use
	56	# semi-host calls to redirect stdin/stdout/stderr to the
	57	# gdb console.
	58	# default: 1 for Debug/Checked builds and 0 for Release.
	59	# MRI_UART: Select the UART to be used by the debugger. See mri.h for
	60	# allowed values.
	61	# default: MRI_UART_MBED_USB - Use USB based UART on the mbed.
	62	# Example makefile:
	63	# PROJECT=HelloWorld
	64	# BUILD_DIR=../..
65	#
66	# include $(BUILD_DIR)/build.mk
67	#
68	###############################################################################
69
70	# Check for undefined variables.
71	ifndef PROJECT
72	$(error makefile must set PROJECT variable.)
73	endif
74
75	ifndef BUILD_DIR
76	$(error makefile must set BUILD_DIR.)
77	endif
78
79
80	# Default DEVICES to LPC1768 if nothing else has been specified.
81	DEVICES?=lpc1768
82
83
84	# Use DEVICES variable to determine which builds to perform.
85	CLEAN_DEVICES=$(addsuffix .clean,$(DEVICES))
86	.PHONY: all clean $(DEVICES) $(CLEAN_DEVICES) deploy deploy-lpc1768 deploy-lpc11u24
87
88	all: $(DEVICES)
89
90	clean: $(CLEAN_DEVICES)
91
92	export
93	$(DEVICES):
94	@echo Building for device $@
95	@$(MAKE) -f $(BUILD_DIR)/$@.mk all
96
97	$(CLEAN_DEVICES): %.clean:
98	@echo Cleaning up for device $*
99	@$(MAKE) -f $(BUILD_DIR)/$*.mk clean
100
101	ifdef LPC_DEPLOY
102	deploy deploy-lpc1768:
103	@echo Deploying to target.
104	$(subst PROJECT,LPC1768/$(PROJECT),$(LPC_DEPLOY))
105
106	deploy-lpc11u24:
107	@echo Deploying to target.
108	$(subst PROJECT,LPC11U24/$(PROJECT),$(LPC_DEPLOY))
109	endif