]> git.donarmstrong.com Git - qmk_firmware.git/blob - Makefile
add jump_bootloader.
[qmk_firmware.git] / Makefile
1 # Hey Emacs, this is a -*- makefile -*-
2 #----------------------------------------------------------------------------
3 # WinAVR Makefile Template written by Eric B. Weddington, Jörg Wunsch, et al.
4 #
5 # Released to the Public Domain
6 #
7 # Additional material for this makefile was written by:
8 # Peter Fleury
9 # Tim Henigan
10 # Colin O'Flynn
11 # Reiner Patommel
12 # Markus Pfaff
13 # Sander Pool
14 # Frederik Rouleau
15 # Carlos Lamas
16 #
17 #----------------------------------------------------------------------------
18 # On command line:
19 #
20 # make all = Make software.
21 #
22 # make clean = Clean out built project files.
23 #
24 # make coff = Convert ELF to AVR COFF.
25 #
26 # make extcoff = Convert ELF to AVR Extended COFF.
27 #
28 # make program = Download the hex file to the device, using avrdude.
29 #                Please customize the avrdude settings below first!
30 #
31 # make debug = Start either simulavr or avarice as specified for debugging, 
32 #              with avr-gdb or avr-insight as the front end for debugging.
33 #
34 # make filename.s = Just compile filename.c into the assembler code only.
35 #
36 # make filename.i = Create a preprocessed source file for use in submitting
37 #                   bug reports to the GCC project.
38 #
39 # To rebuild project do "make clean" then "make all".
40 #----------------------------------------------------------------------------
41
42
43 # Target file name (without extension).
44 TARGET = mykey
45
46
47 # List C source files here. (C dependencies are automatically generated.)
48 SRC =   $(TARGET).c \
49         keymap.c \
50         matrix.c \
51         usb_device.c \
52         usb_keyboard.c \
53         usb_debug.c \
54         print.c \
55         jump_bootloader.c
56
57
58 # MCU name, you MUST set this to match the board you are using
59 # type "make clean" after changing this, so all files will be rebuilt
60 #MCU = at90usb162       # Teensy 1.0
61 MCU = atmega32u4        # Teensy 2.0
62 #MCU = at90usb646       # Teensy++ 1.0
63 #MCU = at90usb1286      # Teensy++ 2.0
64
65
66 # Processor frequency.
67 #   Normally the first thing your program should do is set the clock prescaler,
68 #   so your program will run at the correct speed.  You should also set this
69 #   variable to same clock speed.  The _delay_ms() macro uses this, and many
70 #   examples use this variable to calculate timings.  Do not add a "UL" here.
71 F_CPU = 16000000
72
73
74 # Output format. (can be srec, ihex, binary)
75 FORMAT = ihex
76
77
78 # Object files directory
79 #     To put object files in current directory, use a dot (.), do NOT make
80 #     this an empty or blank macro!
81 OBJDIR = .
82
83
84 # List C++ source files here. (C dependencies are automatically generated.)
85 CPPSRC = 
86
87
88 # List Assembler source files here.
89 #     Make them always end in a capital .S.  Files ending in a lowercase .s
90 #     will not be considered source files but generated files (assembler
91 #     output from the compiler), and will be deleted upon "make clean"!
92 #     Even though the DOS/Win* filesystem matches both .s and .S the same,
93 #     it will preserve the spelling of the filenames, and gcc itself does
94 #     care about how the name is spelled on its command-line.
95 ASRC =
96
97
98 # Optimization level, can be [0, 1, 2, 3, s]. 
99 #     0 = turn off optimization. s = optimize for size.
100 #     (Note: 3 is not always the best optimization level. See avr-libc FAQ.)
101 OPT = s
102
103
104 # Debugging format.
105 #     Native formats for AVR-GCC's -g are dwarf-2 [default] or stabs.
106 #     AVR Studio 4.10 requires dwarf-2.
107 #     AVR [Extended] COFF format requires stabs, plus an avr-objcopy run.
108 DEBUG = dwarf-2
109
110
111 # List any extra directories to look for include files here.
112 #     Each directory must be seperated by a space.
113 #     Use forward slashes for directory separators.
114 #     For a directory that has spaces, enclose it in quotes.
115 EXTRAINCDIRS = 
116
117
118 # Compiler flag to set the C Standard level.
119 #     c89   = "ANSI" C
120 #     gnu89 = c89 plus GCC extensions
121 #     c99   = ISO C99 standard (not yet fully implemented)
122 #     gnu99 = c99 plus GCC extensions
123 CSTANDARD = -std=gnu99
124
125
126 # Place -D or -U options here for C sources
127 CDEFS = -DF_CPU=$(F_CPU)UL
128
129
130 # Place -D or -U options here for ASM sources
131 ADEFS = -DF_CPU=$(F_CPU)
132
133
134 # Place -D or -U options here for C++ sources
135 CPPDEFS = -DF_CPU=$(F_CPU)UL
136 #CPPDEFS += -D__STDC_LIMIT_MACROS
137 #CPPDEFS += -D__STDC_CONSTANT_MACROS
138
139
140
141 #---------------- Compiler Options C ----------------
142 #  -g*:          generate debugging information
143 #  -O*:          optimization level
144 #  -f...:        tuning, see GCC manual and avr-libc documentation
145 #  -Wall...:     warning level
146 #  -Wa,...:      tell GCC to pass this to the assembler.
147 #    -adhlns...: create assembler listing
148 CFLAGS = -g$(DEBUG)
149 CFLAGS += $(CDEFS)
150 CFLAGS += -O$(OPT)
151 CFLAGS += -funsigned-char
152 CFLAGS += -funsigned-bitfields
153 CFLAGS += -ffunction-sections
154 CFLAGS += -fpack-struct
155 CFLAGS += -fshort-enums
156 CFLAGS += -Wall
157 CFLAGS += -Wstrict-prototypes
158 #CFLAGS += -mshort-calls
159 #CFLAGS += -fno-unit-at-a-time
160 #CFLAGS += -Wundef
161 #CFLAGS += -Wunreachable-code
162 #CFLAGS += -Wsign-compare
163 CFLAGS += -Wa,-adhlns=$(<:%.c=$(OBJDIR)/%.lst)
164 CFLAGS += $(patsubst %,-I%,$(EXTRAINCDIRS))
165 CFLAGS += $(CSTANDARD)
166
167
168 #---------------- Compiler Options C++ ----------------
169 #  -g*:          generate debugging information
170 #  -O*:          optimization level
171 #  -f...:        tuning, see GCC manual and avr-libc documentation
172 #  -Wall...:     warning level
173 #  -Wa,...:      tell GCC to pass this to the assembler.
174 #    -adhlns...: create assembler listing
175 CPPFLAGS = -g$(DEBUG)
176 CPPFLAGS += $(CPPDEFS)
177 CPPFLAGS += -O$(OPT)
178 CPPFLAGS += -funsigned-char
179 CPPFLAGS += -funsigned-bitfields
180 CPPFLAGS += -fpack-struct
181 CPPFLAGS += -fshort-enums
182 CPPFLAGS += -fno-exceptions
183 CPPFLAGS += -Wall
184 CPPFLAGS += -Wundef
185 #CPPFLAGS += -mshort-calls
186 #CPPFLAGS += -fno-unit-at-a-time
187 #CPPFLAGS += -Wstrict-prototypes
188 #CPPFLAGS += -Wunreachable-code
189 #CPPFLAGS += -Wsign-compare
190 CPPFLAGS += -Wa,-adhlns=$(<:%.cpp=$(OBJDIR)/%.lst)
191 CPPFLAGS += $(patsubst %,-I%,$(EXTRAINCDIRS))
192 #CPPFLAGS += $(CSTANDARD)
193
194
195 #---------------- Assembler Options ----------------
196 #  -Wa,...:   tell GCC to pass this to the assembler.
197 #  -adhlns:   create listing
198 #  -gstabs:   have the assembler create line number information; note that
199 #             for use in COFF files, additional information about filenames
200 #             and function names needs to be present in the assembler source
201 #             files -- see avr-libc docs [FIXME: not yet described there]
202 #  -listing-cont-lines: Sets the maximum number of continuation lines of hex 
203 #       dump that will be displayed for a given single line of source input.
204 ASFLAGS = $(ADEFS) -Wa,-adhlns=$(<:%.S=$(OBJDIR)/%.lst),-gstabs,--listing-cont-lines=100
205
206
207 #---------------- Library Options ----------------
208 # Minimalistic printf version
209 PRINTF_LIB_MIN = -Wl,-u,vfprintf -lprintf_min
210
211 # Floating point printf version (requires MATH_LIB = -lm below)
212 PRINTF_LIB_FLOAT = -Wl,-u,vfprintf -lprintf_flt
213
214 # If this is left blank, then it will use the Standard printf version.
215 PRINTF_LIB = 
216 #PRINTF_LIB = $(PRINTF_LIB_MIN)
217 #PRINTF_LIB = $(PRINTF_LIB_FLOAT)
218
219
220 # Minimalistic scanf version
221 SCANF_LIB_MIN = -Wl,-u,vfscanf -lscanf_min
222
223 # Floating point + %[ scanf version (requires MATH_LIB = -lm below)
224 SCANF_LIB_FLOAT = -Wl,-u,vfscanf -lscanf_flt
225
226 # If this is left blank, then it will use the Standard scanf version.
227 SCANF_LIB = 
228 #SCANF_LIB = $(SCANF_LIB_MIN)
229 #SCANF_LIB = $(SCANF_LIB_FLOAT)
230
231
232 MATH_LIB = -lm
233
234
235 # List any extra directories to look for libraries here.
236 #     Each directory must be seperated by a space.
237 #     Use forward slashes for directory separators.
238 #     For a directory that has spaces, enclose it in quotes.
239 EXTRALIBDIRS = 
240
241
242
243 #---------------- External Memory Options ----------------
244
245 # 64 KB of external RAM, starting after internal RAM (ATmega128!),
246 # used for variables (.data/.bss) and heap (malloc()).
247 #EXTMEMOPTS = -Wl,-Tdata=0x801100,--defsym=__heap_end=0x80ffff
248
249 # 64 KB of external RAM, starting after internal RAM (ATmega128!),
250 # only used for heap (malloc()).
251 #EXTMEMOPTS = -Wl,--section-start,.data=0x801100,--defsym=__heap_end=0x80ffff
252
253 EXTMEMOPTS =
254
255
256
257 #---------------- Linker Options ----------------
258 #  -Wl,...:     tell GCC to pass this to linker.
259 #    -Map:      create map file
260 #    --cref:    add cross reference to  map file
261 LDFLAGS = -Wl,-Map=$(TARGET).map,--cref
262 LDFLAGS += -Wl,--relax
263 LDFLAGS += -Wl,--gc-sections
264 LDFLAGS += $(EXTMEMOPTS)
265 LDFLAGS += $(patsubst %,-L%,$(EXTRALIBDIRS))
266 LDFLAGS += $(PRINTF_LIB) $(SCANF_LIB) $(MATH_LIB)
267 #LDFLAGS += -T linker_script.x
268
269
270
271 #---------------- Programming Options (avrdude) ----------------
272
273 # Programming hardware
274 # Type: avrdude -c ?
275 # to get a full listing.
276 #
277 AVRDUDE_PROGRAMMER = stk500v2
278
279 # com1 = serial port. Use lpt1 to connect to parallel port.
280 AVRDUDE_PORT = com1    # programmer connected to serial device
281
282 AVRDUDE_WRITE_FLASH = -U flash:w:$(TARGET).hex
283 #AVRDUDE_WRITE_EEPROM = -U eeprom:w:$(TARGET).eep
284
285
286 # Uncomment the following if you want avrdude's erase cycle counter.
287 # Note that this counter needs to be initialized first using -Yn,
288 # see avrdude manual.
289 #AVRDUDE_ERASE_COUNTER = -y
290
291 # Uncomment the following if you do /not/ wish a verification to be
292 # performed after programming the device.
293 #AVRDUDE_NO_VERIFY = -V
294
295 # Increase verbosity level.  Please use this when submitting bug
296 # reports about avrdude. See <http://savannah.nongnu.org/projects/avrdude> 
297 # to submit bug reports.
298 #AVRDUDE_VERBOSE = -v -v
299
300 AVRDUDE_FLAGS = -p $(MCU) -P $(AVRDUDE_PORT) -c $(AVRDUDE_PROGRAMMER)
301 AVRDUDE_FLAGS += $(AVRDUDE_NO_VERIFY)
302 AVRDUDE_FLAGS += $(AVRDUDE_VERBOSE)
303 AVRDUDE_FLAGS += $(AVRDUDE_ERASE_COUNTER)
304
305
306
307 #---------------- Debugging Options ----------------
308
309 # For simulavr only - target MCU frequency.
310 DEBUG_MFREQ = $(F_CPU)
311
312 # Set the DEBUG_UI to either gdb or insight.
313 # DEBUG_UI = gdb
314 DEBUG_UI = insight
315
316 # Set the debugging back-end to either avarice, simulavr.
317 DEBUG_BACKEND = avarice
318 #DEBUG_BACKEND = simulavr
319
320 # GDB Init Filename.
321 GDBINIT_FILE = __avr_gdbinit
322
323 # When using avarice settings for the JTAG
324 JTAG_DEV = /dev/com1
325
326 # Debugging port used to communicate between GDB / avarice / simulavr.
327 DEBUG_PORT = 4242
328
329 # Debugging host used to communicate between GDB / avarice / simulavr, normally
330 #     just set to localhost unless doing some sort of crazy debugging when 
331 #     avarice is running on a different computer.
332 DEBUG_HOST = localhost
333
334
335
336 #============================================================================
337
338
339 # Define programs and commands.
340 SHELL = sh
341 CC = avr-gcc
342 OBJCOPY = avr-objcopy
343 OBJDUMP = avr-objdump
344 SIZE = avr-size
345 AR = avr-ar rcs
346 NM = avr-nm
347 AVRDUDE = avrdude
348 REMOVE = rm -f
349 REMOVEDIR = rm -rf
350 COPY = cp
351 WINSHELL = cmd
352
353
354 # Define Messages
355 # English
356 MSG_ERRORS_NONE = Errors: none
357 MSG_BEGIN = -------- begin --------
358 MSG_END = --------  end  --------
359 MSG_SIZE_BEFORE = Size before: 
360 MSG_SIZE_AFTER = Size after:
361 MSG_COFF = Converting to AVR COFF:
362 MSG_EXTENDED_COFF = Converting to AVR Extended COFF:
363 MSG_FLASH = Creating load file for Flash:
364 MSG_EEPROM = Creating load file for EEPROM:
365 MSG_EXTENDED_LISTING = Creating Extended Listing:
366 MSG_SYMBOL_TABLE = Creating Symbol Table:
367 MSG_LINKING = Linking:
368 MSG_COMPILING = Compiling C:
369 MSG_COMPILING_CPP = Compiling C++:
370 MSG_ASSEMBLING = Assembling:
371 MSG_CLEANING = Cleaning project:
372 MSG_CREATING_LIBRARY = Creating library:
373
374
375
376
377 # Define all object files.
378 OBJ = $(SRC:%.c=$(OBJDIR)/%.o) $(CPPSRC:%.cpp=$(OBJDIR)/%.o) $(ASRC:%.S=$(OBJDIR)/%.o) 
379
380 # Define all listing files.
381 LST = $(SRC:%.c=$(OBJDIR)/%.lst) $(CPPSRC:%.cpp=$(OBJDIR)/%.lst) $(ASRC:%.S=$(OBJDIR)/%.lst) 
382
383
384 # Compiler flags to generate dependency files.
385 GENDEPFLAGS = -MMD -MP -MF .dep/$(@F).d
386
387
388 # Combine all necessary flags and optional flags.
389 # Add target processor to flags.
390 ALL_CFLAGS = -mmcu=$(MCU) -I. $(CFLAGS) $(GENDEPFLAGS)
391 ALL_CPPFLAGS = -mmcu=$(MCU) -I. -x c++ $(CPPFLAGS) $(GENDEPFLAGS)
392 ALL_ASFLAGS = -mmcu=$(MCU) -I. -x assembler-with-cpp $(ASFLAGS)
393
394
395
396
397
398 # Default target.
399 all: begin gccversion sizebefore build sizeafter end
400
401 # Change the build target to build a HEX file or a library.
402 build: elf hex eep lss sym
403 #build: lib
404
405
406 elf: $(TARGET).elf
407 hex: $(TARGET).hex
408 eep: $(TARGET).eep
409 lss: $(TARGET).lss
410 sym: $(TARGET).sym
411 LIBNAME=lib$(TARGET).a
412 lib: $(LIBNAME)
413
414
415
416 # Eye candy.
417 # AVR Studio 3.x does not check make's exit code but relies on
418 # the following magic strings to be generated by the compile job.
419 begin:
420         @echo
421         @echo $(MSG_BEGIN)
422
423 end:
424         @echo $(MSG_END)
425         @echo
426
427
428 # Display size of file.
429 HEXSIZE = $(SIZE) --target=$(FORMAT) $(TARGET).hex
430 #ELFSIZE = $(SIZE) --mcu=$(MCU) --format=avr $(TARGET).elf
431 ELFSIZE = $(SIZE) $(TARGET).elf
432
433 sizebefore:
434         @if test -f $(TARGET).elf; then echo; echo $(MSG_SIZE_BEFORE); $(ELFSIZE); \
435         2>/dev/null; echo; fi
436
437 sizeafter:
438         @if test -f $(TARGET).elf; then echo; echo $(MSG_SIZE_AFTER); $(ELFSIZE); \
439         2>/dev/null; echo; fi
440
441
442
443 # Display compiler version information.
444 gccversion : 
445         @$(CC) --version
446
447
448
449 # Program the device.  
450 program: $(TARGET).hex $(TARGET).eep
451         $(AVRDUDE) $(AVRDUDE_FLAGS) $(AVRDUDE_WRITE_FLASH) $(AVRDUDE_WRITE_EEPROM)
452
453
454 # Generate avr-gdb config/init file which does the following:
455 #     define the reset signal, load the target file, connect to target, and set 
456 #     a breakpoint at main().
457 gdb-config: 
458         @$(REMOVE) $(GDBINIT_FILE)
459         @echo define reset >> $(GDBINIT_FILE)
460         @echo SIGNAL SIGHUP >> $(GDBINIT_FILE)
461         @echo end >> $(GDBINIT_FILE)
462         @echo file $(TARGET).elf >> $(GDBINIT_FILE)
463         @echo target remote $(DEBUG_HOST):$(DEBUG_PORT)  >> $(GDBINIT_FILE)
464 ifeq ($(DEBUG_BACKEND),simulavr)
465         @echo load  >> $(GDBINIT_FILE)
466 endif
467         @echo break main >> $(GDBINIT_FILE)
468
469 debug: gdb-config $(TARGET).elf
470 ifeq ($(DEBUG_BACKEND), avarice)
471         @echo Starting AVaRICE - Press enter when "waiting to connect" message displays.
472         @$(WINSHELL) /c start avarice --jtag $(JTAG_DEV) --erase --program --file \
473         $(TARGET).elf $(DEBUG_HOST):$(DEBUG_PORT)
474         @$(WINSHELL) /c pause
475
476 else
477         @$(WINSHELL) /c start simulavr --gdbserver --device $(MCU) --clock-freq \
478         $(DEBUG_MFREQ) --port $(DEBUG_PORT)
479 endif
480         @$(WINSHELL) /c start avr-$(DEBUG_UI) --command=$(GDBINIT_FILE)
481
482
483
484
485 # Convert ELF to COFF for use in debugging / simulating in AVR Studio or VMLAB.
486 COFFCONVERT = $(OBJCOPY) --debugging
487 COFFCONVERT += --change-section-address .data-0x800000
488 COFFCONVERT += --change-section-address .bss-0x800000
489 COFFCONVERT += --change-section-address .noinit-0x800000
490 COFFCONVERT += --change-section-address .eeprom-0x810000
491
492
493
494 coff: $(TARGET).elf
495         @echo
496         @echo $(MSG_COFF) $(TARGET).cof
497         $(COFFCONVERT) -O coff-avr $< $(TARGET).cof
498
499
500 extcoff: $(TARGET).elf
501         @echo
502         @echo $(MSG_EXTENDED_COFF) $(TARGET).cof
503         $(COFFCONVERT) -O coff-ext-avr $< $(TARGET).cof
504
505
506
507 # Create final output files (.hex, .eep) from ELF output file.
508 %.hex: %.elf
509         @echo
510         @echo $(MSG_FLASH) $@
511         $(OBJCOPY) -O $(FORMAT) -R .eeprom -R .fuse -R .lock -R .signature $< $@
512
513 %.eep: %.elf
514         @echo
515         @echo $(MSG_EEPROM) $@
516         -$(OBJCOPY) -j .eeprom --set-section-flags=.eeprom="alloc,load" \
517         --change-section-lma .eeprom=0 --no-change-warnings -O $(FORMAT) $< $@ || exit 0
518
519 # Create extended listing file from ELF output file.
520 %.lss: %.elf
521         @echo
522         @echo $(MSG_EXTENDED_LISTING) $@
523         $(OBJDUMP) -h -S -z $< > $@
524
525 # Create a symbol table from ELF output file.
526 %.sym: %.elf
527         @echo
528         @echo $(MSG_SYMBOL_TABLE) $@
529         $(NM) -n $< > $@
530
531
532
533 # Create library from object files.
534 .SECONDARY : $(TARGET).a
535 .PRECIOUS : $(OBJ)
536 %.a: $(OBJ)
537         @echo
538         @echo $(MSG_CREATING_LIBRARY) $@
539         $(AR) $@ $(OBJ)
540
541
542 # Link: create ELF output file from object files.
543 .SECONDARY : $(TARGET).elf
544 .PRECIOUS : $(OBJ)
545 %.elf: $(OBJ)
546         @echo
547         @echo $(MSG_LINKING) $@
548         $(CC) $(ALL_CFLAGS) $^ --output $@ $(LDFLAGS)
549
550
551 # Compile: create object files from C source files.
552 $(OBJDIR)/%.o : %.c
553         @echo
554         @echo $(MSG_COMPILING) $<
555         $(CC) -c $(ALL_CFLAGS) $< -o $@ 
556
557
558 # Compile: create object files from C++ source files.
559 $(OBJDIR)/%.o : %.cpp
560         @echo
561         @echo $(MSG_COMPILING_CPP) $<
562         $(CC) -c $(ALL_CPPFLAGS) $< -o $@ 
563
564
565 # Compile: create assembler files from C source files.
566 %.s : %.c
567         $(CC) -S $(ALL_CFLAGS) $< -o $@
568
569
570 # Compile: create assembler files from C++ source files.
571 %.s : %.cpp
572         $(CC) -S $(ALL_CPPFLAGS) $< -o $@
573
574
575 # Assemble: create object files from assembler source files.
576 $(OBJDIR)/%.o : %.S
577         @echo
578         @echo $(MSG_ASSEMBLING) $<
579         $(CC) -c $(ALL_ASFLAGS) $< -o $@
580
581
582 # Create preprocessed source for use in sending a bug report.
583 %.i : %.c
584         $(CC) -E -mmcu=$(MCU) -I. $(CFLAGS) $< -o $@ 
585
586
587 # Target: clean project.
588 clean: begin clean_list end
589
590 clean_list :
591         @echo
592         @echo $(MSG_CLEANING)
593         $(REMOVE) $(TARGET).hex
594         $(REMOVE) $(TARGET).eep
595         $(REMOVE) $(TARGET).cof
596         $(REMOVE) $(TARGET).elf
597         $(REMOVE) $(TARGET).map
598         $(REMOVE) $(TARGET).sym
599         $(REMOVE) $(TARGET).lss
600         $(REMOVE) $(SRC:%.c=$(OBJDIR)/%.o)
601         $(REMOVE) $(SRC:%.c=$(OBJDIR)/%.lst)
602         $(REMOVE) $(SRC:.c=.s)
603         $(REMOVE) $(SRC:.c=.d)
604         $(REMOVE) $(SRC:.c=.i)
605         $(REMOVEDIR) .dep
606
607
608 # Create object files directory
609 $(shell mkdir $(OBJDIR) 2>/dev/null)
610
611
612 # Include the dependency files.
613 -include $(shell mkdir .dep 2>/dev/null) $(wildcard .dep/*)
614
615
616 # Listing of phony targets.
617 .PHONY : all begin finish end sizebefore sizeafter gccversion \
618 build elf hex eep lss sym coff extcoff \
619 clean clean_list program debug gdb-config