1 #-*-Makefile-*- vim:syntax=make
  2 #$Id: Makerules,v 1.6 2008/09/26 20:13:58 klueska Exp $
  3
  4 # @author Cory Sharp <cssharp@eecs.berkeley.edu>
  5
  6 ### --- This makefile requires GNU Make version 3.80 or newer.
  7
  8
  9 ### ---
 10 ### --- Prepare variables
 11 ### ---
 12
 13
 14 #  Get TOSDIR from ncc if it isn't set already.
 15 ifndef TOSDIR
 16 TOSDIR := $(shell ncc -print-tosdir)
 17 endif
 18
 19 #  Mung MAKERULES for Cygwin; see the warning below for more details.
 20 ifneq ($(findstring \,$(MAKERULES)),)
 21 MAKERULES := $(subst \,/,$(MAKERULES))
 22 define BACKSLASH_WARNING
 23 warning, MAKERULES contains backslashes.
 24
 25     The environment variable MAKERULES contains backslashes \'s.  This can
 26     cause shell scripts including ones in this make system to fail in
 27     strange ways.  I've changed those to forward slashes for you for this
 28     build.  However, you are strongly encouraged to respecify MAKERULES as
 29     either a standard unix-style path or as a mixed-style path where the
 30     backslashes are replaced with forward slashes /'s.
 31
 32 endef
 33 $(warning $(BACKSLASH_WARNING))
 34 endif
 35
 36 #  Deduce TINYOS_MAKE_PATH, the path to this file, if it's not defined already.
 37 ifndef TINYOS_MAKE_PATH
 38   ifdef MAKERULES
 39     TINYOS_MAKE_PATH := $(dir $(MAKERULES))
 40     TINYOS_MAKE_PATH := $(TINYOS_MAKE_PATH:%/=%)
 41   else
 42     TINYOS_MAKE_PATH := $(TOSDIR)/../support/make
 43   endif
 44 endif
 45
 46 #  Use a default Makelocal if it's not defined already.
 47 TINYOS_MAKELOCAL ?= $(TINYOS_MAKE_PATH)/Makelocal
 48
 49 #  Use a default Makedefaults if it's not defined already.
 50 TINYOS_MAKEDEFAULTS ?= $(TINYOS_MAKE_PATH)/Makedefaults
 51
 52 #  Allow users to specify additional directories to find TOSMake files.
 53 TOSMAKE_PATH += $(TINYOS_MAKE_PATH)
 54
 55 #  Save makecmdgoals (a read only var) to goals so that we can modify it.
 56 GOALS += $(MAKECMDGOALS)
 57
 58 #  Extract user options from goals of the form opt,arg, transform to opt=arg,
 59 #  and evaluate.  Then, reduce GOALS to have the args removed.
 60 OptRE := [,.]
 61 GoalOpts := $(shell perl -e 'print join " ", map {s{^(.*?)$(OptRE)}{\U$$1=};$$_} grep /$(OptRE)/, split /\s+/, "$(GOALS)";')
 62 GOALS := $(shell perl -e '$$_="$(GOALS)"; s{$(OptRE)\S*}{}g; print;')
 63 $(foreach opt,$(GoalOpts),$(eval $(opt)))
 64
 65
 66 ### ---
 67 ### --- Define make functions.
 68 ### --- (Lord, this is ugly. I want a real scripting language so bad.)
 69 ### ---
 70 ### --- The functions a user will generally be interested in are
 71 ### ---   TOSMake_include(file)
 72 ### ---   TOSMake_include_platform(dir)
 73 ### ---
 74
 75 #  names(words)
 76 #    Produce option names, like junk from /path/to/junk.target.
 77 names = $(sort $(basename $(notdir $(1))))
 78
 79 #  TOSMake_find(file_or_dir)
 80 #    Search for file_or_dir within TOSMAKE_PATH.  For the special case of
 81 #    initializing TOSMAKE_PATH itself, this function does not search
 82 #    TOSMAKE_PATH if file_or_dir begins with +.
 83 sh_search = for a in $(TOSMAKE_PATH); do [ -e "$$a/$$n" ] && echo "$$a/$$n" && break; done
 84 TOSMake_find = $(if $(filter +%,$(1)),$(1:+%=%),$(shell n="$(1)"; $(sh_search)))
 85
 86 #  TOSMake_makelist(dir,extension)
 87 #    Get a list of files with the given extension from a directory which MUST
 88 #    be a subdir under TOSMAKE_PATH.
 89 TOSMake_makelist = $(wildcard $(call TOSMake_find,$(1))/*.$(2))
 90
 91 #  TOSMake_include(file)
 92 #    Include a makefile which MUST be in a dir or subdir under TOSMAKE_PATH.
 93 TOSMake_include = $(eval include $(call TOSMake_find,$(1)))
 94
 95 #  TOSMake_extra_targets(name)
 96 #    Create a default make targets for a TOSMake extra full with its possible
 97 #    options afterward.
 98 define TOSMake_extra_targets
 99 $(subst :,%,$(1)): FORCE
100     @:
101 endef
102
103 #  TOSMake_include_dir(dir)
104 #    Pull in .extras and .targets from a directory which MUST be a subdir
105 #    under TOSMAKE_PATH.  Create default extra rules as necessary, etc.
106 TOSMake_include_dir = $(eval $(call TOSMake_include_dir_define,$(1)))
107 define TOSMake_include_dir_define
108 $(eval NEW_EXTRAS := $(call TOSMake_makelist,$(1),extra))
109 $(eval NEW_TARGETS := $(call TOSMake_makelist,$(1),target))
110 $(eval VALID_EXTRAS += $(NEW_EXTRAS))
111 $(eval VALID_TARGETS += $(NEW_TARGETS))
112 $(eval EXTRAS = $(filter $(call names,$(VALID_EXTRAS)),$(GOALS)))
113 $(eval TARGETS = $(filter $(call names,$(VALID_TARGETS)),$(GOALS)))
114 $(eval OTHERS = $(filter-out $(EXTRAS) $(TARGETS),$(GOALS)))
115 $(foreach file,$(NEW_EXTRAS) $(NEW_TARGETS),$(if $(filter $(call names,$(file)),$(GOALS)),$(eval include $(file))))
116 endef
117
118 TOSMake_accum_dir = $(eval $(call TOSMake_accum_dir_define,$(1)))
119 define TOSMake_accum_dir_define
120 $(eval NEW_EXTRAS := $(call TOSMake_makelist,$(1),extra))
121 $(eval NEW_TARGETS := $(call TOSMake_makelist,$(1),target))
122 $(eval VALID_EXTRAS += $(NEW_EXTRAS))
123 $(eval VALID_TARGETS += $(NEW_TARGETS))
124 $(eval TARGETS = $(filter $(call names,$(VALID_TARGETS)),$(GOALS)))
125 endef
126
127 #  TOSMake_include_platform(dir)
128 #    Pull in a directory as a new TOSMake platform, which MUST be a subdir of
129 #    TOSMAKE_PATH.  A platform directory must also have a .rules file, which
130 #    is automatically evaluated.
131 TOSMake_include_platform=$(eval $(call TOSMake_include_platform_define,$(1)))
132 define TOSMake_include_platform_define
133 $(call TOSMake_include_dir,$(1))
134 $(call TOSMake_include,$(1)/$(1).rules)
135 endef
136
137
138 ### ---
139 ### --- Include Makelocal and Makedefaults
140 ### ---
141
142 #  Makelocal comes first to allow overriding Makedefaults.
143 -include $(TINYOS_MAKELOCAL)
144 -include $(TINYOS_MAKEDEFAULTS)
145
146 PLATFORMDIR ?= $(TOSDIR)/platforms/$(PLATFORM)
147
148 #  Mark TOSMAKE_PATH with a + so that they're not searched for by TOSMake_find.
149 $(foreach incdir,$(addprefix +,$(TOSMAKE_PATH)),$(call TOSMake_accum_dir,$(incdir)))
150
151 $(foreach file,$(VALID_EXTRAS),$(if $(filter $(call names,$(file)),$(GOALS)),$(eval include $(file))))
152 $(foreach file,$(VALID_TARGETS),$(if $(filter $(call names,$(file)),$(GOALS)),$(eval include $(file))))
153
154 #  Make default rules for each extra with full argument
155 $(foreach goal,$(MAKECMDGOALS),$(if $(filter-out $(TARGETS) help,$(goal)),$(eval $(call TOSMake_extra_targets,$(goal)))))
156
157
158 ### ---
159 ### --- Define USAGE, print help if necessary or requested, etc.
160 ### ---
161
162 #  USAGE is printed out when help is requested.  Files other than this should
163 #  add text to HELP, not USAGE.
164 define USAGE
165
166
167 Usage:  make <target> <extras>
168         make <target> help
169
170         Valid targets: $(call names,$(VALID_TARGETS))
171         Valid extras: $(call names,$(VALID_EXTRAS))
172 $(HELP)
173
174 endef
175
176 #  If no target or an invalid target is specified, print usage.
177 ifeq ($(TARGETS),)
178   ifeq ($(GOALS),)
179     $(error $(USAGE)Please specify a valid target)
180   else
181     $(error $(USAGE)ERROR, "$(GOALS)" does not specify a valid target)
182   endif
183 endif
184
185 #  If the user specifically had help on the command line, don't build any
186 #  targets, instead display help information and exit with a nice error.
187 ifeq ($(filter help,$(GOALS)),help)
188 define USAGE
189
190
191 Usage:  make $(TARGETS) <extras>
192
193     Valid targets: $(call names,$(VALID_TARGETS))
194         Valid extras: $(call names,$(VALID_EXTRAS))
195 $(HELP)
196
197 endef
198 $(error $(USAGE)Thank you)
199 endif
200
201 $(COMPONENT).nc:
202     @echo "ERROR: You need to create a top level file called $(COMPONENT).nc, or modify your local Makefile to point to the real name of your top level component."
203     @false
204
205 .PHONY: FORCE