* add 'mavrdude' target into tmk_core/avr.mk I made it a little convenient when writing the same binary to multiple Pro Micro. * rename target name 'mavrdude' to 'avrdude-loop' * modify docs/flashing.md about avrdude-loop * mdify docs/flashing.md again * modifi docs/flashing.md 3rd
		
			
				
	
	
		
			283 lines
		
	
	
		
			10 KiB
		
	
	
	
		
			Makefile
		
	
	
	
	
	
			
		
		
	
	
			283 lines
		
	
	
		
			10 KiB
		
	
	
	
		
			Makefile
		
	
	
	
	
	
# Hey Emacs, this is a -*- makefile -*-
 | 
						|
##############################################################################
 | 
						|
# Compiler settings
 | 
						|
#
 | 
						|
CC = avr-gcc
 | 
						|
OBJCOPY = avr-objcopy
 | 
						|
OBJDUMP = avr-objdump
 | 
						|
SIZE = avr-size
 | 
						|
AR = avr-ar rcs
 | 
						|
NM = avr-nm
 | 
						|
HEX = $(OBJCOPY) -O $(FORMAT) -R .eeprom -R .fuse -R .lock -R .signature
 | 
						|
EEP = $(OBJCOPY) -j .eeprom --set-section-flags=.eeprom="alloc,load" --change-section-lma .eeprom=0 --no-change-warnings -O $(FORMAT)
 | 
						|
BIN =
 | 
						|
 | 
						|
COMMON_VPATH += $(DRIVER_PATH)/avr
 | 
						|
 | 
						|
COMPILEFLAGS += -funsigned-char
 | 
						|
COMPILEFLAGS += -funsigned-bitfields
 | 
						|
COMPILEFLAGS += -ffunction-sections
 | 
						|
COMPILEFLAGS += -fdata-sections
 | 
						|
COMPILEFLAGS += -fpack-struct
 | 
						|
COMPILEFLAGS += -fshort-enums
 | 
						|
 | 
						|
CFLAGS += $(COMPILEFLAGS)
 | 
						|
CFLAGS += -fno-inline-small-functions
 | 
						|
CFLAGS += -fno-strict-aliasing
 | 
						|
 | 
						|
CPPFLAGS += $(COMPILEFLAGS)
 | 
						|
CPPFLAGS += -fno-exceptions -std=c++11
 | 
						|
 | 
						|
LDFLAGS +=-Wl,--gc-sections
 | 
						|
 | 
						|
OPT_DEFS += -DF_CPU=$(F_CPU)UL
 | 
						|
 | 
						|
MCUFLAGS = -mmcu=$(MCU)
 | 
						|
 | 
						|
# List any extra directories to look for libraries here.
 | 
						|
#     Each directory must be seperated by a space.
 | 
						|
#     Use forward slashes for directory separators.
 | 
						|
#     For a directory that has spaces, enclose it in quotes.
 | 
						|
EXTRALIBDIRS =
 | 
						|
 | 
						|
 | 
						|
#---------------- External Memory Options ----------------
 | 
						|
 | 
						|
# 64 KB of external RAM, starting after internal RAM (ATmega128!),
 | 
						|
# used for variables (.data/.bss) and heap (malloc()).
 | 
						|
#EXTMEMOPTS = -Wl,-Tdata=0x801100,--defsym=__heap_end=0x80ffff
 | 
						|
 | 
						|
# 64 KB of external RAM, starting after internal RAM (ATmega128!),
 | 
						|
# only used for heap (malloc()).
 | 
						|
#EXTMEMOPTS = -Wl,--section-start,.data=0x801100,--defsym=__heap_end=0x80ffff
 | 
						|
 | 
						|
EXTMEMOPTS =
 | 
						|
 | 
						|
#---------------- Debugging Options ----------------
 | 
						|
 | 
						|
# Debugging format.
 | 
						|
#     Native formats for AVR-GCC's -g are dwarf-2 [default] or stabs.
 | 
						|
#     AVR Studio 4.10 requires dwarf-2.
 | 
						|
#     AVR [Extended] COFF format requires stabs, plus an avr-objcopy run.
 | 
						|
DEBUG = dwarf-2
 | 
						|
 | 
						|
# For simulavr only - target MCU frequency.
 | 
						|
DEBUG_MFREQ = $(F_CPU)
 | 
						|
 | 
						|
# Set the DEBUG_UI to either gdb or insight.
 | 
						|
# DEBUG_UI = gdb
 | 
						|
DEBUG_UI = insight
 | 
						|
 | 
						|
# Set the debugging back-end to either avarice, simulavr.
 | 
						|
DEBUG_BACKEND = avarice
 | 
						|
#DEBUG_BACKEND = simulavr
 | 
						|
 | 
						|
# GDB Init Filename.
 | 
						|
GDBINIT_FILE = __avr_gdbinit
 | 
						|
 | 
						|
# When using avarice settings for the JTAG
 | 
						|
JTAG_DEV = /dev/com1
 | 
						|
 | 
						|
# Debugging port used to communicate between GDB / avarice / simulavr.
 | 
						|
DEBUG_PORT = 4242
 | 
						|
 | 
						|
# Debugging host used to communicate between GDB / avarice / simulavr, normally
 | 
						|
#     just set to localhost unless doing some sort of crazy debugging when
 | 
						|
#     avarice is running on a different computer.
 | 
						|
DEBUG_HOST = localhost
 | 
						|
 | 
						|
#============================================================================
 | 
						|
# Autodetect teensy loader
 | 
						|
ifndef TEENSY_LOADER_CLI
 | 
						|
    ifneq (, $(shell which teensy-loader-cli 2>/dev/null))
 | 
						|
        TEENSY_LOADER_CLI ?= teensy-loader-cli
 | 
						|
    else
 | 
						|
        TEENSY_LOADER_CLI ?= teensy_loader_cli
 | 
						|
    endif
 | 
						|
endif
 | 
						|
 | 
						|
# Generate a .qmk for the QMK-FF
 | 
						|
qmk: $(BUILD_DIR)/$(TARGET).hex
 | 
						|
	zip $(TARGET).qmk -FSrj $(KEYMAP_PATH)/*
 | 
						|
	zip $(TARGET).qmk -u $<
 | 
						|
	printf "@ $<\n@=firmware.hex\n" | zipnote -w $(TARGET).qmk
 | 
						|
	printf "{\n  \"generated\": \"%s\"\n}" "$$(date)" > $(BUILD_DIR)/$(TARGET).json
 | 
						|
	if [ -f $(KEYBOARD_PATH_5)/info.json ]; then \
 | 
						|
		jq -s '.[0] * .[1]' $(BUILD_DIR)/$(TARGET).json $(KEYBOARD_PATH_5)/info.json | ex -sc 'wq!$(BUILD_DIR)/$(TARGET).json' /dev/stdin; \
 | 
						|
	fi
 | 
						|
	if [ -f $(KEYBOARD_PATH_4)/info.json ]; then \
 | 
						|
		jq -s '.[0] * .[1]' $(BUILD_DIR)/$(TARGET).json $(KEYBOARD_PATH_4)/info.json | ex -sc 'wq!$(BUILD_DIR)/$(TARGET).json' /dev/stdin; \
 | 
						|
	fi
 | 
						|
	if [ -f $(KEYBOARD_PATH_3)/info.json ]; then \
 | 
						|
		jq -s '.[0] * .[1]' $(BUILD_DIR)/$(TARGET).json $(KEYBOARD_PATH_3)/info.json | ex -sc 'wq!$(BUILD_DIR)/$(TARGET).json' /dev/stdin; \
 | 
						|
	fi
 | 
						|
	if [ -f $(KEYBOARD_PATH_2)/info.json ]; then \
 | 
						|
		jq -s '.[0] * .[1]' $(BUILD_DIR)/$(TARGET).json $(KEYBOARD_PATH_2)/info.json | ex -sc 'wq!$(BUILD_DIR)/$(TARGET).json' /dev/stdin; \
 | 
						|
	fi
 | 
						|
	if [ -f $(KEYBOARD_PATH_1)/info.json ]; then \
 | 
						|
		jq -s '.[0] * .[1]' $(BUILD_DIR)/$(TARGET).json $(KEYBOARD_PATH_1)/info.json | ex -sc 'wq!$(BUILD_DIR)/$(TARGET).json' /dev/stdin; \
 | 
						|
	fi
 | 
						|
	zip $(TARGET).qmk -urj $(BUILD_DIR)/$(TARGET).json
 | 
						|
	printf "@ $(TARGET).json\n@=info.json\n" | zipnote -w $(TARGET).qmk
 | 
						|
 | 
						|
# Program the device.
 | 
						|
program: $(BUILD_DIR)/$(TARGET).hex $(BUILD_DIR)/$(TARGET).eep check-size
 | 
						|
	$(PROGRAM_CMD)
 | 
						|
 | 
						|
teensy: $(BUILD_DIR)/$(TARGET).hex check-size cpfirmware
 | 
						|
	$(TEENSY_LOADER_CLI) -mmcu=$(MCU) -w -v $(BUILD_DIR)/$(TARGET).hex
 | 
						|
 | 
						|
BATCHISP ?= batchisp
 | 
						|
 | 
						|
flip: $(BUILD_DIR)/$(TARGET).hex check-size
 | 
						|
	$(BATCHISP) -hardware usb -device $(MCU) -operation erase f
 | 
						|
	$(BATCHISP) -hardware usb -device $(MCU) -operation loadbuffer $(BUILD_DIR)/$(TARGET).hex program
 | 
						|
	$(BATCHISP) -hardware usb -device $(MCU) -operation start reset 0
 | 
						|
 | 
						|
DFU_PROGRAMMER ?= dfu-programmer
 | 
						|
GREP ?= grep
 | 
						|
 | 
						|
dfu: $(BUILD_DIR)/$(TARGET).hex cpfirmware check-size
 | 
						|
	until $(DFU_PROGRAMMER) $(MCU) get bootloader-version; do\
 | 
						|
		echo "Error: Bootloader not found. Trying again in 5s." ;\
 | 
						|
		sleep 5 ;\
 | 
						|
	done
 | 
						|
	if $(DFU_PROGRAMMER) --version 2>&1 | $(GREP) -q 0.7 ; then\
 | 
						|
		$(DFU_PROGRAMMER) $(MCU) erase --force;\
 | 
						|
	else\
 | 
						|
		$(DFU_PROGRAMMER) $(MCU) erase;\
 | 
						|
	fi
 | 
						|
	$(DFU_PROGRAMMER) $(MCU) flash $(BUILD_DIR)/$(TARGET).hex
 | 
						|
	$(DFU_PROGRAMMER) $(MCU) reset
 | 
						|
 | 
						|
dfu-start:
 | 
						|
	$(DFU_PROGRAMMER) $(MCU) reset
 | 
						|
	$(DFU_PROGRAMMER) $(MCU) start
 | 
						|
 | 
						|
flip-ee: $(BUILD_DIR)/$(TARGET).hex $(BUILD_DIR)/$(TARGET).eep
 | 
						|
	$(COPY) $(BUILD_DIR)/$(TARGET).eep $(BUILD_DIR)/$(TARGET)eep.hex
 | 
						|
	$(BATCHISP) -hardware usb -device $(MCU) -operation memory EEPROM erase
 | 
						|
	$(BATCHISP) -hardware usb -device $(MCU) -operation memory EEPROM loadbuffer $(BUILD_DIR)/$(TARGET)eep.hex program
 | 
						|
	$(BATCHISP) -hardware usb -device $(MCU) -operation start reset 0
 | 
						|
	$(REMOVE) $(BUILD_DIR)/$(TARGET)eep.hex
 | 
						|
 | 
						|
dfu-ee: $(BUILD_DIR)/$(TARGET).hex $(BUILD_DIR)/$(TARGET).eep
 | 
						|
	if $(DFU_PROGRAMMER) --version 2>&1 | $(GREP) -q 0.7 ; then\
 | 
						|
		$(DFU_PROGRAMMER) $(MCU) flash --eeprom $(BUILD_DIR)/$(TARGET).eep;\
 | 
						|
	else\
 | 
						|
		$(DFU_PROGRAMMER) $(MCU) flash-eeprom $(BUILD_DIR)/$(TARGET).eep;\
 | 
						|
	fi
 | 
						|
	$(DFU_PROGRAMMER) $(MCU) reset
 | 
						|
 | 
						|
define EXEC_AVRDUDE
 | 
						|
	USB= ;\
 | 
						|
	if $(GREP) -q -s Microsoft /proc/version; then \
 | 
						|
		echo 'ERROR: AVR flashing cannot be automated within the Windows Subsystem for Linux (WSL) currently. Instead, take the .hex file generated and flash it using AVRDUDE, AVRDUDESS, or XLoader.'; \
 | 
						|
	else \
 | 
						|
		printf "Detecting USB port, reset your controller now."; \
 | 
						|
		ls /dev/tty* > /tmp/1; \
 | 
						|
		while [ -z $$USB ]; do \
 | 
						|
			sleep 0.5; \
 | 
						|
			printf "."; \
 | 
						|
			ls /dev/tty* > /tmp/2; \
 | 
						|
			USB=`comm -13 /tmp/1 /tmp/2 | $(GREP) -o '/dev/tty.*'`; \
 | 
						|
			mv /tmp/2 /tmp/1; \
 | 
						|
		done; \
 | 
						|
		echo ""; \
 | 
						|
		echo "Detected controller on USB port at $$USB"; \
 | 
						|
		if $(GREP) -q -s 'MINGW\|MSYS' /proc/version; then \
 | 
						|
			USB=`echo "$$USB" | perl -pne 's/\/dev\/ttyS(\d+)/COM.($$1+1)/e'`; \
 | 
						|
			echo "Remapped MSYS2 USB port to $$USB"; \
 | 
						|
		fi; \
 | 
						|
		sleep 1; \
 | 
						|
		avrdude -p $(MCU) -c avr109 -P $$USB -U flash:w:$(BUILD_DIR)/$(TARGET).hex; \
 | 
						|
	fi
 | 
						|
endef
 | 
						|
 | 
						|
avrdude: $(BUILD_DIR)/$(TARGET).hex check-size cpfirmware
 | 
						|
	$(call EXEC_AVRDUDE)
 | 
						|
 | 
						|
avrdude-loop: $(BUILD_DIR)/$(TARGET).hex check-size cpfirmware
 | 
						|
	while true; do \
 | 
						|
	    $(call EXEC_AVRDUDE) ; \
 | 
						|
	done
 | 
						|
 | 
						|
# Convert hex to bin.
 | 
						|
bin: $(BUILD_DIR)/$(TARGET).hex
 | 
						|
	$(OBJCOPY) -Iihex -Obinary $(BUILD_DIR)/$(TARGET).hex $(BUILD_DIR)/$(TARGET).bin
 | 
						|
	$(COPY) $(BUILD_DIR)/$(TARGET).bin $(TARGET).bin;
 | 
						|
 | 
						|
# copy bin to FLASH.bin
 | 
						|
flashbin: bin
 | 
						|
	$(COPY) $(BUILD_DIR)/$(TARGET).bin FLASH.bin;
 | 
						|
 | 
						|
# Generate avr-gdb config/init file which does the following:
 | 
						|
#     define the reset signal, load the target file, connect to target, and set
 | 
						|
#     a breakpoint at main().
 | 
						|
gdb-config:
 | 
						|
	@$(REMOVE) $(GDBINIT_FILE)
 | 
						|
	@echo define reset >> $(GDBINIT_FILE)
 | 
						|
	@echo SIGNAL SIGHUP >> $(GDBINIT_FILE)
 | 
						|
	@echo end >> $(GDBINIT_FILE)
 | 
						|
	@echo file $(BUILD_DIR)/$(TARGET).elf >> $(GDBINIT_FILE)
 | 
						|
	@echo target remote $(DEBUG_HOST):$(DEBUG_PORT)  >> $(GDBINIT_FILE)
 | 
						|
ifeq ($(DEBUG_BACKEND),simulavr)
 | 
						|
	@echo load  >> $(GDBINIT_FILE)
 | 
						|
endif
 | 
						|
	@echo break main >> $(GDBINIT_FILE)
 | 
						|
 | 
						|
debug: gdb-config $(BUILD_DIR)/$(TARGET).elf
 | 
						|
ifeq ($(DEBUG_BACKEND), avarice)
 | 
						|
	@echo Starting AVaRICE - Press enter when "waiting to connect" message displays.
 | 
						|
	@$(WINSHELL) /c start avarice --jtag $(JTAG_DEV) --erase --program --file \
 | 
						|
	$(BUILD_DIR)/$(TARGET).elf $(DEBUG_HOST):$(DEBUG_PORT)
 | 
						|
	@$(WINSHELL) /c pause
 | 
						|
 | 
						|
else
 | 
						|
	@$(WINSHELL) /c start simulavr --gdbserver --device $(MCU) --clock-freq \
 | 
						|
	$(DEBUG_MFREQ) --port $(DEBUG_PORT)
 | 
						|
endif
 | 
						|
	@$(WINSHELL) /c start avr-$(DEBUG_UI) --command=$(GDBINIT_FILE)
 | 
						|
 | 
						|
 | 
						|
 | 
						|
 | 
						|
# Convert ELF to COFF for use in debugging / simulating in AVR Studio or VMLAB.
 | 
						|
COFFCONVERT = $(OBJCOPY) --debugging
 | 
						|
COFFCONVERT += --change-section-address .data-0x800000
 | 
						|
COFFCONVERT += --change-section-address .bss-0x800000
 | 
						|
COFFCONVERT += --change-section-address .noinit-0x800000
 | 
						|
COFFCONVERT += --change-section-address .eeprom-0x810000
 | 
						|
 | 
						|
 | 
						|
 | 
						|
coff: $(BUILD_DIR)/$(TARGET).elf
 | 
						|
	@$(SECHO) $(MSG_COFF) $(BUILD_DIR)/$(TARGET).cof
 | 
						|
	$(COFFCONVERT) -O coff-avr $< $(BUILD_DIR)/$(TARGET).cof
 | 
						|
 | 
						|
 | 
						|
extcoff: $(BUILD_DIR)/$(TARGET).elf
 | 
						|
	@$(SECHO) $(MSG_EXTENDED_COFF) $(BUILD_DIR)/$(TARGET).cof
 | 
						|
	$(COFFCONVERT) -O coff-ext-avr $< $(BUILD_DIR)/$(TARGET).cof
 | 
						|
 | 
						|
bootloader:
 | 
						|
	make -C lib/lufa/Bootloaders/DFU/ clean
 | 
						|
	printf "#ifndef QMK_KEYBOARD\n#define QMK_KEYBOARD\n\n" > lib/lufa/Bootloaders/DFU/Keyboard.h
 | 
						|
	printf "%s\n" "`$(GREP) "MANUFACTURER\s" $(ALL_CONFIGS) -h | tail -1`" >> lib/lufa/Bootloaders/DFU/Keyboard.h
 | 
						|
	printf "%s Bootloader\n" "`$(GREP) "PRODUCT\s" $(ALL_CONFIGS) -h | tail -1 | tr -d '\r'`" >> lib/lufa/Bootloaders/DFU/Keyboard.h
 | 
						|
	printf "%s\n" "`$(GREP) "QMK_ESC_OUTPUT\s" $(ALL_CONFIGS) -h | tail -1`" >> lib/lufa/Bootloaders/DFU/Keyboard.h
 | 
						|
	printf "%s\n" "`$(GREP) "QMK_ESC_INPUT\s" $(ALL_CONFIGS) -h | tail -1`" >> lib/lufa/Bootloaders/DFU/Keyboard.h
 | 
						|
	printf "%s\n" "`$(GREP) "QMK_LED\s" $(ALL_CONFIGS) -h | tail -1`" >> lib/lufa/Bootloaders/DFU/Keyboard.h
 | 
						|
	printf "%s\n" "`$(GREP) "QMK_SPEAKER\s" $(ALL_CONFIGS) -h | tail -1`" >> lib/lufa/Bootloaders/DFU/Keyboard.h
 | 
						|
	printf "\n#endif" >> lib/lufa/Bootloaders/DFU/Keyboard.h
 | 
						|
	make -C lib/lufa/Bootloaders/DFU/
 | 
						|
	printf "BootloaderDFU.hex copied to $(TARGET)_bootloader.hex\n"
 | 
						|
	cp lib/lufa/Bootloaders/DFU/BootloaderDFU.hex $(TARGET)_bootloader.hex
 | 
						|
 | 
						|
production: $(BUILD_DIR)/$(TARGET).hex bootloader cpfirmware
 | 
						|
	@cat $(BUILD_DIR)/$(TARGET).hex | awk '/^:00000001FF/ == 0' > $(TARGET)_production.hex
 | 
						|
	@cat $(TARGET)_bootloader.hex >> $(TARGET)_production.hex
 | 
						|
	echo "File sizes:"
 | 
						|
	$(SIZE) $(TARGET).hex $(TARGET)_bootloader.hex $(TARGET)_production.hex
 | 
						|
 |