1 # Determine what keyboard we are building and setup the build environment.
3 # We support folders up to 5 levels deep below `keyboards/`. This file is
4 # responsible for determining which folder is being used and doing the
5 # corresponding environment setup.
15 # Set the filename for the final firmware binary
16 KEYBOARD_FILESAFE
:= $(subst /,_
,$(KEYBOARD
))
17 TARGET ?
= $(KEYBOARD_FILESAFE
)_
$(KEYMAP
)
18 KEYBOARD_OUTPUT
:= $(BUILD_DIR
)/obj_
$(KEYBOARD_FILESAFE
)
19 STM32_PATH
:= quantum
/stm32
24 # For split boards we need to set a master half.
30 ifeq ($(MASTER
),right
)
31 OPT_DEFS
+= -DMASTER_IS_ON_RIGHT
33 ifneq ($(MASTER
),left
)
34 $(error MASTER does not have a valid value
(left
/right
))
39 OPT_DEFS
+= -DSKIP_VERSION
42 # Determine which subfolders exist.
43 KEYBOARD_FOLDER_PATH_1
:= $(KEYBOARD
)
44 KEYBOARD_FOLDER_PATH_2
:= $(patsubst %/,%,$(dir $(KEYBOARD_FOLDER_PATH_1
)))
45 KEYBOARD_FOLDER_PATH_3
:= $(patsubst %/,%,$(dir $(KEYBOARD_FOLDER_PATH_2
)))
46 KEYBOARD_FOLDER_PATH_4
:= $(patsubst %/,%,$(dir $(KEYBOARD_FOLDER_PATH_3
)))
47 KEYBOARD_FOLDER_PATH_5
:= $(patsubst %/,%,$(dir $(KEYBOARD_FOLDER_PATH_4
)))
48 KEYBOARD_FOLDER_1
:= $(notdir $(KEYBOARD_FOLDER_PATH_1
))
49 KEYBOARD_FOLDER_2
:= $(notdir $(KEYBOARD_FOLDER_PATH_2
))
50 KEYBOARD_FOLDER_3
:= $(notdir $(KEYBOARD_FOLDER_PATH_3
))
51 KEYBOARD_FOLDER_4
:= $(notdir $(KEYBOARD_FOLDER_PATH_4
))
52 KEYBOARD_FOLDER_5
:= $(notdir $(KEYBOARD_FOLDER_PATH_5
))
54 KEYBOARD_PATH_1
:= keyboards
/$(KEYBOARD_FOLDER_PATH_1
)
55 KEYBOARD_PATH_2
:= keyboards
/$(KEYBOARD_FOLDER_PATH_2
)
56 KEYBOARD_PATH_3
:= keyboards
/$(KEYBOARD_FOLDER_PATH_3
)
57 KEYBOARD_PATH_4
:= keyboards
/$(KEYBOARD_FOLDER_PATH_4
)
58 KEYBOARD_PATH_5
:= keyboards
/$(KEYBOARD_FOLDER_PATH_5
)
60 ifneq ("$(wildcard $(KEYBOARD_PATH_5)/)","")
61 KEYBOARD_PATHS
+= $(KEYBOARD_PATH_5
)
63 ifneq ("$(wildcard $(KEYBOARD_PATH_4)/)","")
64 KEYBOARD_PATHS
+= $(KEYBOARD_PATH_4
)
66 ifneq ("$(wildcard $(KEYBOARD_PATH_3)/)","")
67 KEYBOARD_PATHS
+= $(KEYBOARD_PATH_3
)
69 ifneq ("$(wildcard $(KEYBOARD_PATH_2)/)","")
70 KEYBOARD_PATHS
+= $(KEYBOARD_PATH_2
)
72 ifneq ("$(wildcard $(KEYBOARD_PATH_1)/)","")
73 KEYBOARD_PATHS
+= $(KEYBOARD_PATH_1
)
77 # Pull in rules.mk files from all our subfolders
78 ifneq ("$(wildcard $(KEYBOARD_PATH_5)/rules.mk)","")
79 include $(KEYBOARD_PATH_5
)/rules.mk
81 ifneq ("$(wildcard $(KEYBOARD_PATH_4)/rules.mk)","")
82 include $(KEYBOARD_PATH_4
)/rules.mk
84 ifneq ("$(wildcard $(KEYBOARD_PATH_3)/rules.mk)","")
85 include $(KEYBOARD_PATH_3
)/rules.mk
87 ifneq ("$(wildcard $(KEYBOARD_PATH_2)/rules.mk)","")
88 include $(KEYBOARD_PATH_2
)/rules.mk
90 ifneq ("$(wildcard $(KEYBOARD_PATH_1)/rules.mk)","")
91 include $(KEYBOARD_PATH_1
)/rules.mk
95 MAIN_KEYMAP_PATH_1
:= $(KEYBOARD_PATH_1
)/keymaps
/$(KEYMAP
)
96 MAIN_KEYMAP_PATH_2
:= $(KEYBOARD_PATH_2
)/keymaps
/$(KEYMAP
)
97 MAIN_KEYMAP_PATH_3
:= $(KEYBOARD_PATH_3
)/keymaps
/$(KEYMAP
)
98 MAIN_KEYMAP_PATH_4
:= $(KEYBOARD_PATH_4
)/keymaps
/$(KEYMAP
)
99 MAIN_KEYMAP_PATH_5
:= $(KEYBOARD_PATH_5
)/keymaps
/$(KEYMAP
)
101 # Check for keymap.json first, so we can regenerate keymap.c
102 include build_json.mk
104 ifeq ("$(wildcard $(KEYMAP_PATH))", "")
105 # Look through the possible keymap folders until we find a matching keymap.c
106 ifneq ("$(wildcard $(MAIN_KEYMAP_PATH_5)/keymap.c)","")
107 -include $(MAIN_KEYMAP_PATH_5
)/rules.mk
108 KEYMAP_C
:= $(MAIN_KEYMAP_PATH_5
)/keymap.c
109 KEYMAP_PATH
:= $(MAIN_KEYMAP_PATH_5
)
110 else ifneq ("$(wildcard $(MAIN_KEYMAP_PATH_4)/keymap.c)","")
111 -include $(MAIN_KEYMAP_PATH_4
)/rules.mk
112 KEYMAP_C
:= $(MAIN_KEYMAP_PATH_4
)/keymap.c
113 KEYMAP_PATH
:= $(MAIN_KEYMAP_PATH_4
)
114 else ifneq ("$(wildcard $(MAIN_KEYMAP_PATH_3)/keymap.c)","")
115 -include $(MAIN_KEYMAP_PATH_3
)/rules.mk
116 KEYMAP_C
:= $(MAIN_KEYMAP_PATH_3
)/keymap.c
117 KEYMAP_PATH
:= $(MAIN_KEYMAP_PATH_3
)
118 else ifneq ("$(wildcard $(MAIN_KEYMAP_PATH_2)/keymap.c)","")
119 -include $(MAIN_KEYMAP_PATH_2
)/rules.mk
120 KEYMAP_C
:= $(MAIN_KEYMAP_PATH_2
)/keymap.c
121 KEYMAP_PATH
:= $(MAIN_KEYMAP_PATH_2
)
122 else ifneq ("$(wildcard $(MAIN_KEYMAP_PATH_1)/keymap.c)","")
123 -include $(MAIN_KEYMAP_PATH_1
)/rules.mk
124 KEYMAP_C
:= $(MAIN_KEYMAP_PATH_1
)/keymap.c
125 KEYMAP_PATH
:= $(MAIN_KEYMAP_PATH_1
)
126 else ifneq ($(LAYOUTS
),)
127 # If we haven't found a keymap yet fall back to community layouts
128 include build_layout.mk
130 $(error Could not find keymap
)
131 # this state should never be reached
135 ifeq ($(strip $(CTPC
)), yes
)
136 CONVERT_TO_PROTON_C
=yes
139 ifeq ($(strip $(CONVERT_TO_PROTON_C
)), yes
)
140 TARGET
:= $(TARGET
)_proton_c
141 include $(STM32_PATH
)/proton_c.mk
142 OPT_DEFS
+= -DCONVERT_TO_PROTON_C
145 ifneq ($(FORCE_LAYOUT
),)
146 TARGET
:= $(TARGET
)_
$(FORCE_LAYOUT
)
149 include quantum
/mcu_selection.mk
152 OPT_DEFS
+= -DQMK_STM32
153 KEYBOARD_PATHS
+= $(STM32_PATH
)
157 # Find all the C source files to be compiled in subfolders.
160 KEYBOARD_C_1
:= $(KEYBOARD_PATH_1
)/$(KEYBOARD_FOLDER_1
).c
161 KEYBOARD_C_2
:= $(KEYBOARD_PATH_2
)/$(KEYBOARD_FOLDER_2
).c
162 KEYBOARD_C_3
:= $(KEYBOARD_PATH_3
)/$(KEYBOARD_FOLDER_3
).c
163 KEYBOARD_C_4
:= $(KEYBOARD_PATH_4
)/$(KEYBOARD_FOLDER_4
).c
164 KEYBOARD_C_5
:= $(KEYBOARD_PATH_5
)/$(KEYBOARD_FOLDER_5
).c
166 ifneq ("$(wildcard $(KEYBOARD_C_5))","")
167 KEYBOARD_SRC
+= $(KEYBOARD_C_5
)
169 ifneq ("$(wildcard $(KEYBOARD_C_4))","")
170 KEYBOARD_SRC
+= $(KEYBOARD_C_4
)
172 ifneq ("$(wildcard $(KEYBOARD_C_3))","")
173 KEYBOARD_SRC
+= $(KEYBOARD_C_3
)
175 ifneq ("$(wildcard $(KEYBOARD_C_2))","")
176 KEYBOARD_SRC
+= $(KEYBOARD_C_2
)
178 ifneq ("$(wildcard $(KEYBOARD_C_1))","")
179 KEYBOARD_SRC
+= $(KEYBOARD_C_1
)
182 # Generate KEYBOARD_name_subname for all levels of the keyboard folder
183 KEYBOARD_FILESAFE_1
:= $(subst .
,,$(subst /,_
,$(KEYBOARD_FOLDER_PATH_1
)))
184 KEYBOARD_FILESAFE_2
:= $(subst .
,,$(subst /,_
,$(KEYBOARD_FOLDER_PATH_2
)))
185 KEYBOARD_FILESAFE_3
:= $(subst .
,,$(subst /,_
,$(KEYBOARD_FOLDER_PATH_3
)))
186 KEYBOARD_FILESAFE_4
:= $(subst .
,,$(subst /,_
,$(KEYBOARD_FOLDER_PATH_4
)))
187 KEYBOARD_FILESAFE_5
:= $(subst .
,,$(subst /,_
,$(KEYBOARD_FOLDER_PATH_5
)))
189 ifneq ("$(wildcard $(KEYBOARD_PATH_5)/)","")
190 OPT_DEFS
+= -DKEYBOARD_
$(KEYBOARD_FILESAFE_5
)
192 ifneq ("$(wildcard $(KEYBOARD_PATH_4)/)","")
193 OPT_DEFS
+= -DKEYBOARD_
$(KEYBOARD_FILESAFE_4
)
195 ifneq ("$(wildcard $(KEYBOARD_PATH_3)/)","")
196 OPT_DEFS
+= -DKEYBOARD_
$(KEYBOARD_FILESAFE_3
)
198 ifneq ("$(wildcard $(KEYBOARD_PATH_2)/)","")
199 OPT_DEFS
+= -DKEYBOARD_
$(KEYBOARD_FILESAFE_2
)
201 ifneq ("$(wildcard $(KEYBOARD_PATH_1)/)","")
202 OPT_DEFS
+= -DKEYBOARD_
$(KEYBOARD_FILESAFE_1
)
205 # Setup the define for QMK_KEYBOARD_H. This is used inside of keymaps so
206 # that the same keymap may be used on multiple keyboards.
208 # We grab the most top-level include file that we can. That file should
209 # use #ifdef statements to include all the neccesary subfolder includes,
212 # https://docs.qmk.fm/#/feature_layouts?id=tips-for-making-layouts-keyboard-agnostic
214 ifneq ("$(wildcard $(KEYBOARD_PATH_1)/$(KEYBOARD_FOLDER_1).h)","")
215 QMK_KEYBOARD_H
= $(KEYBOARD_FOLDER_1
).h
217 ifneq ("$(wildcard $(KEYBOARD_PATH_2)/$(KEYBOARD_FOLDER_2).h)","")
218 QMK_KEYBOARD_H
= $(KEYBOARD_FOLDER_2
).h
220 ifneq ("$(wildcard $(KEYBOARD_PATH_3)/$(KEYBOARD_FOLDER_3).h)","")
221 QMK_KEYBOARD_H
= $(KEYBOARD_FOLDER_3
).h
223 ifneq ("$(wildcard $(KEYBOARD_PATH_4)/$(KEYBOARD_FOLDER_4).h)","")
224 QMK_KEYBOARD_H
= $(KEYBOARD_FOLDER_4
).h
226 ifneq ("$(wildcard $(KEYBOARD_PATH_5)/$(KEYBOARD_FOLDER_5).h)","")
227 QMK_KEYBOARD_H
= $(KEYBOARD_FOLDER_5
).h
230 # Determine and set parameters based on the keyboard's processor family.
231 # We can assume a ChibiOS target When MCU_FAMILY is defined since it's
239 PLATFORM_KEY
=arm_atsam
247 # Find all of the config.h files and add them to our CONFIG_H define.
249 ifneq ("$(wildcard $(KEYBOARD_PATH_5)/config.h)","")
250 CONFIG_H
+= $(KEYBOARD_PATH_5
)/config.h
252 ifneq ("$(wildcard $(KEYBOARD_PATH_4)/config.h)","")
253 CONFIG_H
+= $(KEYBOARD_PATH_4
)/config.h
255 ifneq ("$(wildcard $(KEYBOARD_PATH_3)/config.h)","")
256 CONFIG_H
+= $(KEYBOARD_PATH_3
)/config.h
258 ifneq ("$(wildcard $(KEYBOARD_PATH_2)/config.h)","")
259 CONFIG_H
+= $(KEYBOARD_PATH_2
)/config.h
261 ifneq ("$(wildcard $(KEYBOARD_PATH_1)/config.h)","")
262 CONFIG_H
+= $(KEYBOARD_PATH_1
)/config.h
266 ifneq ("$(wildcard $(KEYBOARD_PATH_1)/post_config.h)","")
267 POST_CONFIG_H
+= $(KEYBOARD_PATH_1
)/post_config.h
269 ifneq ("$(wildcard $(KEYBOARD_PATH_2)/post_config.h)","")
270 POST_CONFIG_H
+= $(KEYBOARD_PATH_2
)/post_config.h
272 ifneq ("$(wildcard $(KEYBOARD_PATH_3)/post_config.h)","")
273 POST_CONFIG_H
+= $(KEYBOARD_PATH_3
)/post_config.h
275 ifneq ("$(wildcard $(KEYBOARD_PATH_4)/post_config.h)","")
276 POST_CONFIG_H
+= $(KEYBOARD_PATH_4
)/post_config.h
278 ifneq ("$(wildcard $(KEYBOARD_PATH_5)/post_config.h)","")
279 POST_CONFIG_H
+= $(KEYBOARD_PATH_5
)/post_config.h
282 # Userspace setup and definitions
283 ifeq ("$(USER_NAME)","")
284 USER_NAME
:= $(KEYMAP
)
286 USER_PATH
:= users
/$(USER_NAME
)
288 -include $(USER_PATH
)/rules.mk
289 ifneq ("$(wildcard $(USER_PATH)/config.h)","")
290 CONFIG_H
+= $(USER_PATH
)/config.h
293 # Object files directory
294 # To put object files in current directory, use a dot (.), do NOT make
295 # this an empty or blank macro!
296 KEYMAP_OUTPUT
:= $(BUILD_DIR
)/obj_
$(TARGET
)
298 ifneq ("$(wildcard $(KEYMAP_PATH)/config.h)","")
299 CONFIG_H
+= $(KEYMAP_PATH
)/config.h
302 # project specific files
303 SRC
+= $(KEYBOARD_SRC
) \
307 # Optimize size but this may cause error "relocation truncated to fit"
308 #EXTRALDFLAGS = -Wl,--relax
311 VPATH
+= $(KEYMAP_PATH
)
312 VPATH
+= $(USER_PATH
)
313 VPATH
+= $(KEYBOARD_PATHS
)
314 VPATH
+= $(COMMON_VPATH
)
316 include common_features.mk
317 include $(TMK_PATH
)/protocol.mk
318 include $(TMK_PATH
)/common.mk
319 include bootloader.mk
321 SRC
+= $(patsubst %.c
,%.clib
,$(LIB_SRC
))
322 SRC
+= $(patsubst %.c
,%.clib
,$(QUANTUM_LIB_SRC
))
323 SRC
+= $(TMK_COMMON_SRC
)
324 OPT_DEFS
+= $(TMK_COMMON_DEFS
)
325 EXTRALDFLAGS
+= $(TMK_COMMON_LDFLAGS
)
327 include $(TMK_PATH
)/$(PLATFORM_KEY
).mk
328 ifneq ($(strip $(PROTOCOL
)),)
329 include $(TMK_PATH
)/protocol
/$(strip $(shell echo
$(PROTOCOL
) | tr
'[:upper:]' '[:lower:]')).mk
331 include $(TMK_PATH
)/protocol
/$(PLATFORM_KEY
).mk
334 # TODO: remove this bodge?
335 PROJECT_DEFS
:= $(OPT_DEFS
)
336 PROJECT_INC
:= $(VPATH
) $(EXTRAINCDIRS
) $(KEYBOARD_PATHS
)
337 PROJECT_CONFIG
:= $(CONFIG_H
)
339 ifeq ($(strip $(VISUALIZER_ENABLE
)), yes
)
340 VISUALIZER_DIR
= $(QUANTUM_DIR
)/visualizer
341 VISUALIZER_PATH
= $(QUANTUM_PATH
)/visualizer
342 include $(VISUALIZER_PATH
)/visualizer.mk
345 CONFIG_H
+= $(POST_CONFIG_H
)
346 ALL_CONFIGS
:= $(PROJECT_CONFIG
) $(CONFIG_H
)
348 OUTPUTS
:= $(KEYMAP_OUTPUT
) $(KEYBOARD_OUTPUT
)
349 $(KEYMAP_OUTPUT
)_SRC
:= $(SRC
)
350 $(KEYMAP_OUTPUT
)_DEFS
:= $(OPT_DEFS
) $(GFXDEFS
) \
351 -DQMK_KEYBOARD
=\"$(KEYBOARD
)\" -DQMK_KEYBOARD_H
=\"$(QMK_KEYBOARD_H
)\" -DQMK_KEYBOARD_CONFIG_H
=\"$(KEYBOARD_PATH_1
)/config.h
\" \
352 -DQMK_KEYMAP
=\"$(KEYMAP
)\" -DQMK_KEYMAP_H
=\"$(KEYMAP
).h
\" -DQMK_KEYMAP_CONFIG_H
=\"$(KEYMAP_PATH
)/config.h
\" \
353 -DQMK_SUBPROJECT
-DQMK_SUBPROJECT_H
-DQMK_SUBPROJECT_CONFIG_H
354 $(KEYMAP_OUTPUT
)_INC
:= $(VPATH
) $(EXTRAINCDIRS
)
355 $(KEYMAP_OUTPUT
)_CONFIG
:= $(CONFIG_H
)
356 $(KEYBOARD_OUTPUT
)_SRC
:= $(CHIBISRC
) $(GFXSRC
)
357 $(KEYBOARD_OUTPUT
)_DEFS
:= $(PROJECT_DEFS
) $(GFXDEFS
)
358 $(KEYBOARD_OUTPUT
)_INC
:= $(PROJECT_INC
) $(GFXINC
)
359 $(KEYBOARD_OUTPUT
)_CONFIG
:= $(PROJECT_CONFIG
)
362 all: build check-size
363 build
: elf cpfirmware
367 include show_options.mk
368 include $(TMK_PATH
)/rules.mk