2020 February 29 Breaking Changes Update (#8064)
[jackhill/qmk/firmware.git] / Makefile
CommitLineData
db5c3b74
FS
1ifndef VERBOSE
2.SILENT:
3endif
4
6410f0c0
FS
5# Never run this makefile in parallel, as it could screw things up
6# It won't affect the submakes, so you still get the speedup from specifying -jx
7.NOTPARALLEL:
8
b26ded3a 9# Allow the silent with lower caps to work the same way as upper caps
87322659
FS
10ifdef silent
11 SILENT = $(silent)
12endif
13
14ifdef SILENT
b26ded3a 15 SUB_IS_SILENT := $(SILENT)
87322659
FS
16endif
17
b26ded3a 18# We need to make sure that silent is always turned off at the top level
f787f429 19# Otherwise the [OK], [ERROR] and [WARN] messages won't be displayed correctly
b26ded3a 20override SILENT := false
87322659 21
eac4bab3 22ifndef SUB_IS_SILENT
9813a6f9
JC
23ifndef SKIP_GIT
24 QMK_VERSION := $(shell git describe --abbrev=0 --tags 2>/dev/null)
25endif
26
88198a96 27ifneq ($(QMK_VERSION),)
800ec55d 28$(info QMK Firmware $(QMK_VERSION))
88198a96 29endif
cb64a886 30endif
88198a96 31
f787f429 32ON_ERROR := error_occurred=1
03e31ef8 33
224fc8a2
FS
34BREAK_ON_ERRORS = no
35
86706de0
FS
36STARTING_MAKEFILE := $(firstword $(MAKEFILE_LIST))
37ROOT_MAKEFILE := $(lastword $(MAKEFILE_LIST))
c83af545 38ROOT_DIR := $(dir $(ROOT_MAKEFILE))
f97ae2b1
FS
39ifeq ($(ROOT_DIR),)
40 ROOT_DIR := .
41endif
86706de0
FS
42ABS_STARTING_MAKEFILE := $(abspath $(STARTING_MAKEFILE))
43ABS_ROOT_MAKEFILE := $(abspath $(ROOT_MAKEFILE))
44ABS_STARTING_DIR := $(dir $(ABS_STARTING_MAKEFILE))
45ABS_ROOT_DIR := $(dir $(ABS_ROOT_MAKEFILE))
46STARTING_DIR := $(subst $(ABS_ROOT_DIR),,$(ABS_STARTING_DIR))
d956dd12
FS
47BUILD_DIR := $(ROOT_DIR)/.build
48TEST_DIR := $(BUILD_DIR)/test
f787f429 49ERROR_FILE := $(BUILD_DIR)/error_occurred
86706de0 50
44441de8 51MAKEFILE_INCLUDED=yes
0d5caead 52
78976d8f 53# Helper function to process the newt element of a space separated path
b26ded3a 54# It works a bit like the traditional functional head tail
f787f429 55# so the CURRENT_PATH_ELEMENT will become the new head
b26ded3a 56# and the PATH_ELEMENTS are the rest that are still unprocessed
86706de0
FS
57define NEXT_PATH_ELEMENT
58 $$(eval CURRENT_PATH_ELEMENT := $$(firstword $$(PATH_ELEMENTS)))
59 $$(eval PATH_ELEMENTS := $$(wordlist 2,9999,$$(PATH_ELEMENTS)))
60endef
61
78976d8f 62# We change the / to spaces so that we more easily can work with the elements
b26ded3a
FS
63# separately
64PATH_ELEMENTS := $(subst /, ,$(STARTING_DIR))
65# Initialize the path elements list for further processing
86706de0
FS
66$(eval $(call NEXT_PATH_ELEMENT))
67
78976d8f 68# This function sets the KEYBOARD; KEYMAP and SUBPROJECT to the correct
b26ded3a 69# variables depending on which directory you stand in.
78976d8f
I
70# It's really a very simple if else chain, if you squint enough,
71# but the makefile syntax makes it very verbose.
b26ded3a 72# If we are in a subfolder of keyboards
bbecd276 73#
800ec55d
JH
74# *** No longer needed **
75#
76# ifeq ($(CURRENT_PATH_ELEMENT),keyboards)
77# $(eval $(call NEXT_PATH_ELEMENT))
78# KEYBOARD := $(CURRENT_PATH_ELEMENT)
79# $(eval $(call NEXT_PATH_ELEMENT))
80# # If we are in a subfolder of keymaps, or in other words in a keymap
81# # folder
82# ifeq ($(CURRENT_PATH_ELEMENT),keymaps)
83# $(eval $(call NEXT_PATH_ELEMENT))
84# KEYMAP := $(CURRENT_PATH_ELEMENT)
85# # else if we are not in the keyboard folder itself
86# else ifneq ($(CURRENT_PATH_ELEMENT),)
87# # the we can assume it's a subproject, as no other folders
88# # should have make files in them
89# SUBPROJECT := $(CURRENT_PATH_ELEMENT)
90# $(eval $(call NEXT_PATH_ELEMENT))
91# # if we are inside a keymap folder of a subproject
92# ifeq ($(CURRENT_PATH_ELEMENT),keymaps)
93# $(eval $(call NEXT_PATH_ELEMENT))
94# KEYMAP := $(CURRENT_PATH_ELEMENT)
95# endif
96# endif
97# endif
98
99define GET_KEYBOARDS
9813a6f9 100ifndef ALT_GET_KEYBOARDS
800ec55d
JH
101 All_RULES_MK := $$(patsubst $(ROOT_DIR)/keyboards/%/rules.mk,%,$$(wildcard $(ROOT_DIR)/keyboards/*/rules.mk))
102 All_RULES_MK += $$(patsubst $(ROOT_DIR)/keyboards/%/rules.mk,%,$$(wildcard $(ROOT_DIR)/keyboards/*/*/rules.mk))
103 All_RULES_MK += $$(patsubst $(ROOT_DIR)/keyboards/%/rules.mk,%,$$(wildcard $(ROOT_DIR)/keyboards/*/*/*/rules.mk))
104 All_RULES_MK += $$(patsubst $(ROOT_DIR)/keyboards/%/rules.mk,%,$$(wildcard $(ROOT_DIR)/keyboards/*/*/*/*/rules.mk))
105
106 KEYMAPS_MK := $$(patsubst $(ROOT_DIR)/keyboards/%/rules.mk,%,$$(wildcard $(ROOT_DIR)/keyboards/*/keymaps/*/rules.mk))
107 KEYMAPS_MK += $$(patsubst $(ROOT_DIR)/keyboards/%/rules.mk,%,$$(wildcard $(ROOT_DIR)/keyboards/*/*/keymaps/*/rules.mk))
108 KEYMAPS_MK += $$(patsubst $(ROOT_DIR)/keyboards/%/rules.mk,%,$$(wildcard $(ROOT_DIR)/keyboards/*/*/*/keymaps/*/rules.mk))
109 KEYMAPS_MK += $$(patsubst $(ROOT_DIR)/keyboards/%/rules.mk,%,$$(wildcard $(ROOT_DIR)/keyboards/*/*/*/*/keymaps/*/rules.mk))
110
111 KEYBOARDS := $$(sort $$(filter-out $$(KEYMAPS_MK), $$(All_RULES_MK)))
9813a6f9
JC
112else
113 KEYBOARDS := $(shell find keyboards/ -type f -iname "rules.mk" | grep -v keymaps | sed 's!keyboards/\(.*\)/rules.mk!\1!' | sort | uniq)
114endif
800ec55d
JH
115endef
116
117$(eval $(call GET_KEYBOARDS))
86706de0 118
a6d35000 119# Only consider folders with makefiles, to prevent errors in case there are extra folders
800ec55d
JH
120#KEYBOARDS += $(patsubst $(ROOD_DIR)/keyboards/%/rules.mk,%,$(wildcard $(ROOT_DIR)/keyboards/*/*/rules.mk))
121
6172273c 122.PHONY: list-keyboards
800ec55d
JH
123list-keyboards:
124 echo $(KEYBOARDS)
f97ae2b1 125
cb64a886
JH
126define PRINT_KEYBOARD
127 $(info $(PRINTING_KEYBOARD))
128endef
129
6172273c 130.PHONY: generate-keyboards-file
cb64a886
JH
131generate-keyboards-file:
132 $(foreach PRINTING_KEYBOARD,$(KEYBOARDS),$(eval $(call PRINT_KEYBOARD)))
cb64a886 133
6172273c 134.PHONY: clean
ce3adcd6 135clean:
612dc232 136 echo -n 'Deleting .build/ ... '
ce3adcd6 137 rm -rf $(BUILD_DIR)
612dc232 138 echo 'done.'
139
140.PHONY: distclean
141distclean: clean
142 echo -n 'Deleting *.bin and *.hex ... '
cb1aeb42 143 rm -f *.bin *.hex
612dc232 144 echo 'done.'
ce3adcd6 145
f787f429 146#Compatibility with the old make variables, anything you specify directly on the command line
b26ded3a 147# always overrides the detected folders
459ddace
FS
148ifdef keyboard
149 KEYBOARD := $(keyboard)
150endif
459ddace
FS
151ifdef keymap
152 KEYMAP := $(keymap)
153endif
154
b26ded3a 155# Uncomment these for debugging
800ec55d
JH
156# $(info Keyboard: $(KEYBOARD))
157# $(info Keymap: $(KEYMAP))
158# $(info Subproject: $(SUBPROJECT))
159# $(info Keyboards: $(KEYBOARDS))
f97ae2b1 160
b26ded3a 161
f787f429 162# Set the default goal depending on where we are running make from
b26ded3a 163# this handles the case where you run make without any arguments
800ec55d 164.DEFAULT_GOAL := all:all
3fa66258 165ifneq ($(KEYMAP),)
800ec55d 166 .DEFAULT_GOAL := $(KEYBOARD):$(KEYMAP)
3fa66258 167else ifneq ($(KEYBOARD),)
b26ded3a
FS
168 # Inside a keyboard folder, build all keymaps for all subprojects
169 # Note that this is different from the old behaviour, which would
170 # build only the default keymap of the default keyboard
800ec55d 171 .DEFAULT_GOAL := $(KEYBOARD):all
3fa66258
FS
172endif
173
86706de0 174
b26ded3a 175# Compare the start of the RULE variable with the first argument($1)
800ec55d 176# If the rules equals $1 or starts with $1:, RULE_FOUND is set to true
e6e67533 177# and $1 is removed from the RULE variable
b26ded3a 178# Otherwise the RULE_FOUND variable is set to false, and RULE left as it was
e6e67533 179# The function is a bit tricky, since there's no built in $(startswith) function
286b3b80 180define COMPARE_AND_REMOVE_FROM_RULE_HELPER
e6e67533
FS
181 ifeq ($1,$$(RULE))
182 RULE:=
183 RULE_FOUND := true
184 else
800ec55d
JH
185 STARTCOLON_REMOVED=$$(subst START$1:,,START$$(RULE))
186 ifneq ($$(STARTCOLON_REMOVED),START$$(RULE))
e6e67533 187 RULE_FOUND := true
800ec55d 188 RULE := $$(STARTCOLON_REMOVED)
e6e67533
FS
189 else
190 RULE_FOUND := false
191 endif
192 endif
193endef
194
b26ded3a
FS
195# This makes it easier to call COMPARE_AND_REMOVE_FROM_RULE, since it makes it behave like
196# a function that returns the value
286b3b80
FS
197COMPARE_AND_REMOVE_FROM_RULE = $(eval $(call COMPARE_AND_REMOVE_FROM_RULE_HELPER,$1))$(RULE_FOUND)
198
199
b26ded3a 200# Recursively try to find a match for the start of the rule to be checked
dfe510d5
FS
201# $1 The list to be checked
202# If a match is found, then RULE_FOUND is set to true
203# and MATCHED_ITEM to the item that was matched
1c69acb7 204define TRY_TO_MATCH_RULE_FROM_LIST_HELPER3
1df64987 205 ifneq ($1,)
286b3b80 206 ifeq ($$(call COMPARE_AND_REMOVE_FROM_RULE,$$(firstword $1)),true)
1df64987 207 MATCHED_ITEM := $$(firstword $1)
78976d8f 208 else
1c69acb7
FS
209 $$(eval $$(call TRY_TO_MATCH_RULE_FROM_LIST_HELPER3,$$(wordlist 2,9999,$1)))
210 endif
211 endif
212endef
213
214# A recursive helper function for finding the longest match
f787f429 215# $1 The list to be checked
78976d8f 216# It works by always removing the currently matched item from the list
1c69acb7
FS
217# and call itself recursively, until a match is found
218define TRY_TO_MATCH_RULE_FROM_LIST_HELPER2
78976d8f 219 # Stop the recursion when the list is empty
1c69acb7
FS
220 ifneq ($1,)
221 RULE_BEFORE := $$(RULE)
222 $$(eval $$(call TRY_TO_MATCH_RULE_FROM_LIST_HELPER3,$1))
223 # If a match is found in the current list, otherwise just return what we had before
224 ifeq ($$(RULE_FOUND),true)
f787f429 225 # Save the best match so far and call itself recursively
1c69acb7
FS
226 BEST_MATCH := $$(MATCHED_ITEM)
227 BEST_MATCH_RULE := $$(RULE)
228 RULE_FOUND := false
229 RULE := $$(RULE_BEFORE)
230 $$(eval $$(call TRY_TO_MATCH_RULE_FROM_LIST_HELPER2,$$(filter-out $$(MATCHED_ITEM),$1)))
1df64987 231 endif
1c69acb7
FS
232 endif
233endef
234
235
236# Recursively try to find the longest match for the start of the rule to be checked
237# $1 The list to be checked
238# If a match is found, then RULE_FOUND is set to true
239# and MATCHED_ITEM to the item that was matched
240define TRY_TO_MATCH_RULE_FROM_LIST_HELPER
241 BEST_MATCH :=
242 $$(eval $$(call TRY_TO_MATCH_RULE_FROM_LIST_HELPER2,$1))
243 ifneq ($$(BEST_MATCH),)
244 RULE_FOUND := true
245 RULE := $$(BEST_MATCH_RULE)
246 MATCHED_ITEM := $$(BEST_MATCH)
247 else
248 RULE_FOUND := false
249 MATCHED_ITEM :=
dfe510d5
FS
250 endif
251endef
252
b26ded3a 253# Make it easier to call TRY_TO_MATCH_RULE_FROM_LIST
286b3b80
FS
254TRY_TO_MATCH_RULE_FROM_LIST = $(eval $(call TRY_TO_MATCH_RULE_FROM_LIST_HELPER,$1))$(RULE_FOUND)
255
9ee6d4a2
FS
256define ALL_IN_LIST_LOOP
257 OLD_RULE$1 := $$(RULE)
258 $$(eval $$(call $1,$$(ITEM$1)))
259 RULE := $$(OLD_RULE$1)
260endef
261
262define PARSE_ALL_IN_LIST
263 $$(foreach ITEM$1,$2,$$(eval $$(call ALL_IN_LIST_LOOP,$1)))
264endef
dfe510d5 265
b26ded3a 266# The entry point for rule parsing
800ec55d 267# parses a rule in the format <keyboard>:<keymap>:<target>
b26ded3a 268# but this particular function only deals with the first <keyboard> part
091fab51
FS
269define PARSE_RULE
270 RULE := $1
271 COMMANDS :=
800ec55d 272 # If the rule starts with all, then continue the parsing from
b26ded3a 273 # PARSE_ALL_KEYBOARDS
800ec55d 274 ifeq ($$(call COMPARE_AND_REMOVE_FROM_RULE,all),true)
d2115f7d 275 KEYBOARD_RULE=all
091fab51 276 $$(eval $$(call PARSE_ALL_KEYBOARDS))
6d7cd639
FS
277 else ifeq ($$(call COMPARE_AND_REMOVE_FROM_RULE,test),true)
278 $$(eval $$(call PARSE_TEST))
b26ded3a
FS
279 # If the rule starts with the name of a known keyboard, then continue
280 # the parsing from PARSE_KEYBOARD
091fab51 281 else ifeq ($$(call TRY_TO_MATCH_RULE_FROM_LIST,$$(KEYBOARDS)),true)
d2115f7d 282 KEYBOARD_RULE=$$(MATCHED_ITEM)
091fab51 283 $$(eval $$(call PARSE_KEYBOARD,$$(MATCHED_ITEM)))
b26ded3a
FS
284 # Otherwise use the KEYBOARD variable, which is determined either by
285 # the current directory you run make from, or passed in as an argument
c83af545
FS
286 else ifneq ($$(KEYBOARD),)
287 $$(eval $$(call PARSE_KEYBOARD,$$(KEYBOARD)))
1ad5578d
FS
288 else
289 $$(info make: *** No rule to make target '$1'. Stop.)
800ec55d
JH
290 $$(info |)
291 $$(info | QMK's make format recently changed to use folder locations and colons:)
292 $$(info | make project_folder:keymap[:target])
293 $$(info | Examples:)
294 $$(info | make planck/rev4:default:dfu)
295 $$(info | make planck:default)
296 $$(info |)
091fab51 297 endif
9ee6d4a2
FS
298endef
299
091fab51 300# $1 = Keyboard
800ec55d 301# Parses a rule in the format <keymap>:<target>
b26ded3a 302# the keyboard is already known when entering this function
091fab51 303define PARSE_KEYBOARD
800ec55d
JH
304 # If we want to compile the default subproject, then we need to
305 # include the correct makefile to determine the actual name of it
091fab51 306 CURRENT_KB := $1
800ec55d
JH
307
308 # KEYBOARD_FOLDERS := $$(subst /, , $(CURRENT_KB))
309
310 DEFAULT_FOLDER := $$(CURRENT_KB)
311
312 # We assume that every rules.mk will contain the full default value
313 $$(eval include $(ROOT_DIR)/keyboards/$$(CURRENT_KB)/rules.mk)
314 ifneq ($$(DEFAULT_FOLDER),$$(CURRENT_KB))
315 $$(eval include $(ROOT_DIR)/keyboards/$$(DEFAULT_FOLDER)/rules.mk)
316 endif
317 CURRENT_KB := $$(DEFAULT_FOLDER)
318
319 # 5/4/3/2/1
320 KEYBOARD_FOLDER_PATH_1 := $$(CURRENT_KB)
321 KEYBOARD_FOLDER_PATH_2 := $$(patsubst %/,%,$$(dir $$(KEYBOARD_FOLDER_PATH_1)))
322 KEYBOARD_FOLDER_PATH_3 := $$(patsubst %/,%,$$(dir $$(KEYBOARD_FOLDER_PATH_2)))
323 KEYBOARD_FOLDER_PATH_4 := $$(patsubst %/,%,$$(dir $$(KEYBOARD_FOLDER_PATH_3)))
324 KEYBOARD_FOLDER_PATH_5 := $$(patsubst %/,%,$$(dir $$(KEYBOARD_FOLDER_PATH_4)))
800ec55d
JH
325
326 KEYMAPS :=
327 # get a list of all keymaps
328 KEYMAPS += $$(notdir $$(patsubst %/.,%,$$(wildcard $(ROOT_DIR)/keyboards/$$(KEYBOARD_FOLDER_PATH_1)/keymaps/*/.)))
329 KEYMAPS += $$(notdir $$(patsubst %/.,%,$$(wildcard $(ROOT_DIR)/keyboards/$$(KEYBOARD_FOLDER_PATH_2)/keymaps/*/.)))
330 KEYMAPS += $$(notdir $$(patsubst %/.,%,$$(wildcard $(ROOT_DIR)/keyboards/$$(KEYBOARD_FOLDER_PATH_3)/keymaps/*/.)))
331 KEYMAPS += $$(notdir $$(patsubst %/.,%,$$(wildcard $(ROOT_DIR)/keyboards/$$(KEYBOARD_FOLDER_PATH_4)/keymaps/*/.)))
332 KEYMAPS += $$(notdir $$(patsubst %/.,%,$$(wildcard $(ROOT_DIR)/keyboards/$$(KEYBOARD_FOLDER_PATH_5)/keymaps/*/.)))
bd642d08 333 # this might be needed, but in a different form
32f18cf6 334 #KEYMAPS := $$(sort $$(filter-out $$(KEYBOARD_FOLDER_1) $$(KEYBOARD_FOLDER_2) \
800ec55d
JH
335 $$(KEYBOARD_FOLDER_3) $$(KEYBOARD_FOLDER_4) $$(KEYBOARD_FOLDER_5), $$(KEYMAPS)))
336
337 KEYBOARD_LAYOUTS :=
bbecd276 338 ifneq ("$$(wildcard $(ROOT_DIR)/keyboards/$$(KEYBOARD_FOLDER_PATH_5)/rules.mk)","")
800ec55d 339 LAYOUTS :=
bbecd276 340 $$(eval include $(ROOT_DIR)/keyboards/$$(KEYBOARD_FOLDER_PATH_5)/rules.mk)
800ec55d
JH
341 KEYBOARD_LAYOUTS := $$(sort $$(LAYOUTS) $$(KEYBOARD_LAYOUTS))
342 endif
bbecd276 343 ifneq ("$$(wildcard $(ROOT_DIR)/keyboards/$$(KEYBOARD_FOLDER_PATH_4)/rules.mk)","")
800ec55d 344 LAYOUTS :=
bbecd276 345 $$(eval include $(ROOT_DIR)/keyboards/$$(KEYBOARD_FOLDER_PATH_4)/rules.mk)
800ec55d
JH
346 KEYBOARD_LAYOUTS := $$(sort $$(LAYOUTS) $$(KEYBOARD_LAYOUTS))
347 endif
bbecd276 348 ifneq ("$$(wildcard $(ROOT_DIR)/keyboards/$$(KEYBOARD_FOLDER_PATH_3)/rules.mk)","")
800ec55d 349 LAYOUTS :=
bbecd276 350 $$(eval include $(ROOT_DIR)/keyboards/$$(KEYBOARD_FOLDER_PATH_3)/rules.mk)
800ec55d
JH
351 KEYBOARD_LAYOUTS := $$(sort $$(LAYOUTS) $$(KEYBOARD_LAYOUTS))
352 endif
bbecd276 353 ifneq ("$$(wildcard $(ROOT_DIR)/keyboards/$$(KEYBOARD_FOLDER_PATH_2)/rules.mk)","")
800ec55d 354 LAYOUTS :=
bbecd276 355 $$(eval include $(ROOT_DIR)/keyboards/$$(KEYBOARD_FOLDER_PATH_2)/rules.mk)
800ec55d
JH
356 KEYBOARD_LAYOUTS := $$(sort $$(LAYOUTS) $$(KEYBOARD_LAYOUTS))
357 endif
bbecd276 358 ifneq ("$$(wildcard $(ROOT_DIR)/keyboards/$$(KEYBOARD_FOLDER_PATH_1)/rules.mk)","")
800ec55d 359 LAYOUTS :=
bbecd276 360 $$(eval include $(ROOT_DIR)/keyboards/$$(KEYBOARD_FOLDER_PATH_1)/rules.mk)
800ec55d
JH
361 KEYBOARD_LAYOUTS := $$(sort $$(LAYOUTS) $$(KEYBOARD_LAYOUTS))
362 endif
363
364 LAYOUT_KEYMAPS :=
365 $$(foreach LAYOUT,$$(KEYBOARD_LAYOUTS),$$(eval LAYOUT_KEYMAPS += $$(notdir $$(patsubst %/.,%,$$(wildcard $(ROOT_DIR)/layouts/*/$$(LAYOUT)/*/.)))))
bbecd276 366
800ec55d
JH
367 KEYMAPS := $$(sort $$(KEYMAPS) $$(LAYOUT_KEYMAPS))
368
369 # if the rule after removing the start of it is empty (we haven't specified a kemap or target)
370 # compile all the keymaps
371 ifeq ($$(RULE),)
372 $$(eval $$(call PARSE_ALL_KEYMAPS))
373 # The same if all was specified
374 else ifeq ($$(call COMPARE_AND_REMOVE_FROM_RULE,all),true)
375 $$(eval $$(call PARSE_ALL_KEYMAPS))
2df3799e 376 # List all keymaps for the given keyboard
377 else ifeq ($$(call COMPARE_AND_REMOVE_FROM_RULE,list-keymaps),true)
378 $$(eval $$(call LIST_ALL_KEYMAPS))
800ec55d
JH
379 # Try to match the specified keyamp with the list of known keymaps
380 else ifeq ($$(call TRY_TO_MATCH_RULE_FROM_LIST,$$(KEYMAPS)),true)
381 $$(eval $$(call PARSE_KEYMAP,$$(MATCHED_ITEM)))
382 # Otherwise try to match the keymap from the current folder, or arguments to the make command
383 else ifneq ($$(KEYMAP),)
384 $$(eval $$(call PARSE_KEYMAP,$$(KEYMAP)))
d2115f7d
JC
385 # Otherwise if we are running make all:<user> just skip
386 else ifeq ($$(KEYBOARD_RULE),all)
387 # $$(info Skipping: No user keymap for $$(CURRENT_KB))
800ec55d
JH
388 # Otherwise, make all keymaps, again this is consistent with how it works without
389 # any arguments
78976d8f 390 else
800ec55d 391 $$(eval $$(call PARSE_ALL_KEYMAPS))
091fab51 392 endif
e6e67533
FS
393endef
394
b26ded3a
FS
395# if we are going to compile all keyboards, match the rest of the rule
396# for each of them
091fab51
FS
397define PARSE_ALL_KEYBOARDS
398 $$(eval $$(call PARSE_ALL_IN_LIST,PARSE_KEYBOARD,$(KEYBOARDS)))
1df64987
FS
399endef
400
401# $1 Subproject
b26ded3a
FS
402# When entering this, the keyboard and subproject are known, so now we need
403# to determine which keymaps are going to get compiled
800ec55d 404# define PARSE_SUBPROJECT
d2ff66a9 405
800ec55d 406# endef
9b02e66c 407
78976d8f 408# If we want to parse all subprojects, but the keyboard doesn't have any,
b26ded3a 409# then use defaultsp instead
800ec55d
JH
410# define PARSE_ALL_SUBPROJECTS
411# ifeq ($$(SUBPROJECTS),)
412# $$(eval $$(call PARSE_SUBPROJECT,defaultsp))
413# else
414# $$(eval $$(call PARSE_ALL_IN_LIST,PARSE_SUBPROJECT,$$(SUBPROJECTS)))
415# endif
416# endef
1df64987 417
2df3799e 418# Prints a list of all known keymaps for the given keyboard
419define LIST_ALL_KEYMAPS
420 COMMAND_true_LIST_KEYMAPS := \
421 printf "$$(KEYMAPS)\n";
422 COMMAND_false_LIST_KEYMAPS := \
423 printf "$$(MSG_AVAILABLE_KEYMAPS)\n"; \
424 printf "$$(KEYMAPS)\n";
425 COMMANDS += LIST_KEYMAPS
426endef
427
dfe510d5 428# $1 Keymap
b26ded3a
FS
429# This is the meat of compiling a keyboard, when entering this, everything is known
430# keyboard, subproject, and keymap
431# Note that we are not directly calling the command here, but instead building a list,
432# which will later be processed
9b02e66c 433define PARSE_KEYMAP
dfe510d5 434 CURRENT_KM = $1
87bf34a5 435 # The rest of the rule is the target
800ec55d
JH
436 # Remove the leading ":" from the target, as it acts as a separator
437 MAKE_TARGET := $$(patsubst :%,%,$$(RULE))
b26ded3a 438 # We need to generate an unique indentifer to append to the COMMANDS list
800ec55d
JH
439 CURRENT_KB_UNDER := $$(subst /,_,$$(CURRENT_KB))
440 COMMAND := COMMAND_KEYBOARD_$$(CURRENT_KB_UNDER)_KEYMAP_$$(CURRENT_KM)
b26ded3a
FS
441 # If we are compiling a keyboard without a subproject, we want to display just the name
442 # of the keyboard, otherwise keyboard/subproject
800ec55d 443 KB_SP := $$(CURRENT_KB)
b26ded3a 444 # Format it in bold
db5c3b74 445 KB_SP := $(BOLD)$$(KB_SP)$(NO_COLOR)
b26ded3a 446 # Specify the variables that we are passing forward to submake
800ec55d 447 MAKE_VARS := KEYBOARD=$$(CURRENT_KB) KEYMAP=$$(CURRENT_KM)
b26ded3a 448 # And the first part of the make command
87bf34a5 449 MAKE_CMD := $$(MAKE) -r -R -C $(ROOT_DIR) -f build_keyboard.mk $$(MAKE_TARGET)
b26ded3a
FS
450 # The message to display
451 MAKE_MSG := $$(MSG_MAKE_KB)
452 # We run the command differently, depending on if we want more output or not
453 # The true version for silent output and the false version otherwise
27a673f5
FS
454 $$(eval $$(call BUILD))
455endef
456
457define BUILD
458 MAKE_VARS += VERBOSE=$(VERBOSE) COLOR=$(COLOR)
459 COMMANDS += $$(COMMAND)
87322659
FS
460 COMMAND_true_$$(COMMAND) := \
461 printf "$$(MAKE_MSG)" | \
462 $$(MAKE_MSG_FORMAT); \
d924eb59 463 LOG=$$$$($$(MAKE_CMD) $$(MAKE_VARS) SILENT=true 2>&1) ; \
67b294ca
FS
464 if [ $$$$? -gt 0 ]; \
465 then $$(PRINT_ERROR_PLAIN); \
466 elif [ "$$$$LOG" != "" ] ; \
467 then $$(PRINT_WARNING_PLAIN); \
468 else \
469 $$(PRINT_OK); \
470 fi;
87322659 471 COMMAND_false_$$(COMMAND) := \
f29730da 472 printf "$$(MAKE_MSG)\n\n"; \
f4429ba4
FS
473 $$(MAKE_CMD) $$(MAKE_VARS) SILENT=false; \
474 if [ $$$$? -gt 0 ]; \
f787f429 475 then error_occurred=1; \
f4429ba4 476 fi;
9b02e66c 477endef
f97ae2b1 478
f787f429 479# Just parse all the keymaps for a specific keyboard
091fab51
FS
480define PARSE_ALL_KEYMAPS
481 $$(eval $$(call PARSE_ALL_IN_LIST,PARSE_KEYMAP,$$(KEYMAPS)))
e6e67533
FS
482endef
483
27a673f5
FS
484define BUILD_TEST
485 TEST_NAME := $1
486 MAKE_TARGET := $2
487 COMMAND := $1
488 MAKE_CMD := $$(MAKE) -r -R -C $(ROOT_DIR) -f build_test.mk $$(MAKE_TARGET)
20696a9e 489 MAKE_VARS := TEST=$$(TEST_NAME) FULL_TESTS="$$(FULL_TESTS)"
88198a96 490 MAKE_MSG := $$(MSG_MAKE_TEST)
27a673f5 491 $$(eval $$(call BUILD))
1b963117
FS
492 ifneq ($$(MAKE_TARGET),clean)
493 TEST_EXECUTABLE := $$(TEST_DIR)/$$(TEST_NAME).elf
494 TESTS += $$(TEST_NAME)
495 TEST_MSG := $$(MSG_TEST)
496 $$(TEST_NAME)_COMMAND := \
497 printf "$$(TEST_MSG)\n"; \
498 $$(TEST_EXECUTABLE); \
499 if [ $$$$? -gt 0 ]; \
f787f429 500 then error_occurred=1; \
1b963117
FS
501 fi; \
502 printf "\n";
503 endif
27a673f5
FS
504endef
505
6d7cd639 506define PARSE_TEST
fc855cb3 507 TESTS :=
800ec55d
JH
508 TEST_NAME := $$(firstword $$(subst :, ,$$(RULE)))
509 TEST_TARGET := $$(subst $$(TEST_NAME),,$$(subst $$(TEST_NAME):,,$$(RULE)))
1b963117
FS
510 ifeq ($$(TEST_NAME),all)
511 MATCHED_TESTS := $$(TEST_LIST)
512 else
513 MATCHED_TESTS := $$(foreach TEST,$$(TEST_LIST),$$(if $$(findstring $$(TEST_NAME),$$(TEST)),$$(TEST),))
514 endif
27a673f5 515 $$(foreach TEST,$$(MATCHED_TESTS),$$(eval $$(call BUILD_TEST,$$(TEST),$$(TEST_TARGET))))
6d7cd639
FS
516endef
517
518
b26ded3a 519# Set the silent mode depending on if we are trying to compile multiple keyboards or not
f787f429 520# By default it's on in that case, but it can be overridden by specifying silent=false
b26ded3a 521# from the command line
87322659
FS
522define SET_SILENT_MODE
523 ifdef SUB_IS_SILENT
524 SILENT_MODE := $(SUB_IS_SILENT)
525 else ifeq ($$(words $$(COMMANDS)),1)
526 SILENT_MODE := false
527 else
528 SILENT_MODE := true
529 endif
530endef
531
db5c3b74
FS
532include $(ROOT_DIR)/message.mk
533
224fc8a2
FS
534ifeq ($(strip $(BREAK_ON_ERRORS)), yes)
535HANDLE_ERROR = exit 1
536else
537HANDLE_ERROR = echo $$error_occurred > $(ERROR_FILE)
538endif
539
d956dd12
FS
540# The empty line is important here, as it will force a new shell to be created for each command
541# Otherwise the command line will become too long with a lot of keyboards and keymaps
542define RUN_COMMAND
f787f429 543+error_occurred=0;\
d956dd12 544$(COMMAND_$(SILENT_MODE)_$(COMMAND))\
224fc8a2 545if [ $$error_occurred -gt 0 ]; then $(HANDLE_ERROR); fi;
d956dd12
FS
546
547
548endef
549define RUN_TEST
f787f429 550+error_occurred=0;\
2acfd2ab 551$($(TEST)_COMMAND)\
224fc8a2 552if [ $$error_occurred -gt 0 ]; then $(HANDLE_ERROR); fi;
1ff5fb00
FS
553
554
d956dd12 555endef
e6e67533 556
b26ded3a 557# Let's match everything, we handle all the rule parsing ourselves
e6e67533 558.PHONY: %
78976d8f 559%:
b26ded3a 560 # Check if we have the CMP tool installed
245f77b8 561 cmp $(ROOT_DIR)/Makefile $(ROOT_DIR)/Makefile >/dev/null 2>&1; if [ $$? -gt 0 ]; then printf "$(MSG_NO_CMP)"; exit 1; fi;
99500243 562 # Ensure that python3 is installed. This check can be removed after python is used in more places.
563 if ! python3 --version 1> /dev/null 2>&1; then printf "$(MSG_PYTHON_MISSING)"; fi
b26ded3a 564 # Check if the submodules are dirty, and display a warning if they are
1d1f2b4e 565ifndef SKIP_GIT
7c0edbe8 566 if [ ! -e lib/chibios ]; then git submodule sync lib/chibios && git submodule update --depth 50 --init lib/chibios; fi
567 if [ ! -e lib/chibios-contrib ]; then git submodule sync lib/chibios-contrib && git submodule update --depth 50 --init lib/chibios-contrib; fi
568 if [ ! -e lib/ugfx ]; then git submodule sync lib/ugfx && git submodule update --depth 50 --init lib/ugfx; fi
569 if [ ! -e lib/lufa ]; then git submodule sync lib/lufa && git submodule update --depth 50 --init lib/lufa; fi
60c6e79e
FS
570 git submodule status --recursive 2>/dev/null | \
571 while IFS= read -r x; do \
572 case "$$x" in \
573 \ *) ;; \
574 *) printf "$(MSG_SUBMODULE_DIRTY)";break;; \
575 esac \
576 done
1d1f2b4e 577endif
d956dd12 578 rm -f $(ERROR_FILE) > /dev/null 2>&1
e6e67533 579 $(eval $(call PARSE_RULE,$@))
87322659 580 $(eval $(call SET_SILENT_MODE))
b26ded3a
FS
581 # Run all the commands in the same shell, notice the + at the first line
582 # it has to be there to allow parallel execution of the submake
583 # This always tries to compile everything, even if error occurs in the middle
584 # But we return the error code at the end, to trigger travis failures
9f63cd0d 585 # The sort at this point is to remove duplicates
586 $(foreach COMMAND,$(sort $(COMMANDS)),$(RUN_COMMAND))
d956dd12 587 if [ -f $(ERROR_FILE) ]; then printf "$(MSG_ERRORS)" & exit 1; fi;
9f63cd0d 588 $(foreach TEST,$(sort $(TESTS)),$(RUN_TEST))
78976d8f 589 if [ -f $(ERROR_FILE) ]; then printf "$(MSG_ERRORS)" & exit 1; fi;
e6e67533 590
800ec55d
JH
591# These no longer work because of the colon system
592
b26ded3a 593# All should compile everything
800ec55d
JH
594# .PHONY: all
595# all: all-keyboards test-all
3fa66258 596
f787f429 597# Define some shortcuts, mostly for compatibility with the old syntax
800ec55d
JH
598# .PHONY: all-keyboards
599# all-keyboards: all\:all\:all
e6e67533 600
800ec55d
JH
601# .PHONY: all-keyboards-defaults
602# all-keyboards-defaults: all\:default
db5c3b74 603
800ec55d
JH
604# .PHONY: test
605# test: test-all
1b963117 606
800ec55d
JH
607# .PHONY: test-clean
608# test-clean: test-all-clean
60c6e79e 609
927ef813 610lib/%:
611 git submodule sync $?
612 git submodule update --init $?
613
6172273c 614.PHONY: git-submodule
ed56a685 615git-submodule:
616 git submodule sync --recursive
2e0c63e0 617 git submodule update --init --recursive --progress
ed56a685 618
738b8d2b
FS
619ifdef SKIP_VERSION
620SKIP_GIT := yes
621endif
622
b26ded3a 623# Generate the version.h file
78976d8f
I
624ifndef SKIP_GIT
625 GIT_VERSION := $(shell git describe --abbrev=6 --dirty --always --tags 2>/dev/null || date +"%Y-%m-%d-%H:%M:%S")
26eef35f
JY
626 CHIBIOS_VERSION := $(shell cd lib/chibios && git describe --abbrev=6 --dirty --always --tags 2>/dev/null || date +"%Y-%m-%d-%H:%M:%S")
627 CHIBIOS_CONTRIB_VERSION := $(shell cd lib/chibios-contrib && git describe --abbrev=6 --dirty --always --tags 2>/dev/null || date +"%Y-%m-%d-%H:%M:%S")
78976d8f
I
628else
629 GIT_VERSION := NA
26eef35f
JY
630 CHIBIOS_VERSION := NA
631 CHIBIOS_CONTRIB_VERSION := NA
78976d8f 632endif
738b8d2b 633ifndef SKIP_VERSION
60c6e79e
FS
634BUILD_DATE := $(shell date +"%Y-%m-%d-%H:%M:%S")
635$(shell echo '#define QMK_VERSION "$(GIT_VERSION)"' > $(ROOT_DIR)/quantum/version.h)
6d7cd639 636$(shell echo '#define QMK_BUILDDATE "$(BUILD_DATE)"' >> $(ROOT_DIR)/quantum/version.h)
26eef35f
JY
637$(shell echo '#define CHIBIOS_VERSION "$(CHIBIOS_VERSION)"' >> $(ROOT_DIR)/quantum/version.h)
638$(shell echo '#define CHIBIOS_CONTRIB_VERSION "$(CHIBIOS_CONTRIB_VERSION)"' >> $(ROOT_DIR)/quantum/version.h)
738b8d2b
FS
639else
640BUILD_DATE := NA
641endif
6d7cd639 642
245f77b8 643include $(ROOT_DIR)/testlist.mk