esp-idf/components/esptool_py/Makefile.projbuild

# Component support for esptool.py. Doesn't do much by itself,
# components have their own flash targets that can use these variables.
ESPPORT ?= $(CONFIG_ESPTOOLPY_PORT)
ESPBAUD ?= $(CONFIG_ESPTOOLPY_BAUD)
ESPFLASHMODE ?= $(CONFIG_ESPTOOLPY_FLASHMODE)
ESPFLASHFREQ ?= $(CONFIG_ESPTOOLPY_FLASHFREQ)
ESPFLASHSIZE ?= $(CONFIG_ESPTOOLPY_FLASHSIZE)

PYTHON ?= $(call dequote,$(CONFIG_PYTHON))

# two commands that can be used from other components
# to invoke esptool.py (with or without serial port args)
#
ESPTOOLPY_SRC := $(COMPONENT_PATH)/esptool/esptool.py
ESPTOOLPY := $(PYTHON) $(ESPTOOLPY_SRC) --chip esp32
ESPTOOLPY_SERIAL := $(ESPTOOLPY) --port $(ESPPORT) --baud $(ESPBAUD)

# Supporting esptool command line tools
ESPEFUSEPY := $(PYTHON) $(COMPONENT_PATH)/esptool/espefuse.py
ESPSECUREPY := $(PYTHON) $(COMPONENT_PATH)/esptool/espsecure.py
export ESPSECUREPY  # is used in bootloader_support component

ESPTOOL_FLASH_OPTIONS := --flash_mode $(ESPFLASHMODE) --flash_freq $(ESPFLASHFREQ) --flash_size $(ESPFLASHSIZE)

ESPTOOL_ELF2IMAGE_OPTIONS :=

ESPTOOLPY_WRITE_FLASH=$(ESPTOOLPY_SERIAL) write_flash $(if $(CONFIG_ESPTOOLPY_COMPRESSED),-z) $(ESPTOOL_FLASH_OPTIONS)

ESPTOOL_ALL_FLASH_ARGS += $(CONFIG_APP_OFFSET) $(APP_BIN)

ifdef CONFIG_SECURE_BOOT_ENABLED
ifndef IS_BOOTLOADER_BUILD
# for secure boot, add a signing step to get from unsiged app to signed app
APP_BIN_UNSIGNED := $(APP_BIN:.bin=-unsigned.bin)

$(APP_BIN): $(APP_BIN_UNSIGNED) $(SECURE_BOOT_SIGNING_KEY)
	$(ESPSECUREPY) sign_data --keyfile $(SECURE_BOOT_SIGNING_KEY) -o $@ $<
endif
endif
# non-secure boot (or bootloader), both these files are the same
APP_BIN_UNSIGNED ?= $(APP_BIN)

$(APP_BIN_UNSIGNED): $(APP_ELF) $(ESPTOOLPY_SRC)
	$(ESPTOOLPY) elf2image $(ESPTOOL_FLASH_OPTIONS) $(ESPTOOL_ELF2IMAGE_OPTIONS) -o $@ $<

flash: all_binaries $(ESPTOOLPY_SRC)
	@echo "Flashing binaries to serial port $(ESPPORT) (app at offset $(CONFIG_APP_OFFSET))..."
ifdef CONFIG_SECURE_BOOT_ENABLED
	@echo "(Secure boot enabled, so bootloader not flashed automatically. See 'make bootloader' output)"
endif
	$(ESPTOOLPY_WRITE_FLASH) $(ESPTOOL_ALL_FLASH_ARGS)

app-flash: $(APP_BIN) $(ESPTOOLPY_SRC)
	@echo "Flashing app to serial port $(ESPPORT), offset $(CONFIG_APP_OFFSET)..."
	$(ESPTOOLPY_WRITE_FLASH) $(CONFIG_APP_OFFSET) $(APP_BIN)

# Submodules normally added in component.mk, but can be added
# at the project level as long as qualified path
COMPONENT_SUBMODULES += $(COMPONENT_PATH)/esptool
Initial public version 2016-08-17 11:08:22 -04:00			`# Component support for esptool.py. Doesn't do much by itself,`
			`# components have their own flash targets that can use these variables.`
			`ESPPORT ?= $(CONFIG_ESPTOOLPY_PORT)`
			`ESPBAUD ?= $(CONFIG_ESPTOOLPY_BAUD)`
Add QIO/QOUT/DIO/DOUT select for esptool.py 2016-09-01 03:47:09 -04:00			`ESPFLASHMODE ?= $(CONFIG_ESPTOOLPY_FLASHMODE)`
Add flash freq selection to menuconfig 2016-09-02 00:29:01 -04:00			`ESPFLASHFREQ ?= $(CONFIG_ESPTOOLPY_FLASHFREQ)`
bootloader, menuconfig: add flash size setting support 2016-10-18 07:03:59 -04:00			`ESPFLASHSIZE ?= $(CONFIG_ESPTOOLPY_FLASHSIZE)`
Initial public version 2016-08-17 11:08:22 -04:00
			`PYTHON ?= $(call dequote,$(CONFIG_PYTHON))`

			`# two commands that can be used from other components`
			`# to invoke esptool.py (with or without serial port args)`
			`#`
make: Add macro to test for & try to fix up files required for submodules Now applied to both esptool.py & esp32 wifi libs 2016-09-12 03:48:40 -04:00			`ESPTOOLPY_SRC := $(COMPONENT_PATH)/esptool/esptool.py`
			`ESPTOOLPY := $(PYTHON) $(ESPTOOLPY_SRC) --chip esp32`
Initial public version 2016-08-17 11:08:22 -04:00			`ESPTOOLPY_SERIAL := $(ESPTOOLPY) --port $(ESPPORT) --baud $(ESPBAUD)`

build system: Add espefuse/espsecure support for secure boot 2016-10-31 19:50:16 -04:00			`# Supporting esptool command line tools`
			`ESPEFUSEPY := $(PYTHON) $(COMPONENT_PATH)/esptool/espefuse.py`
			`ESPSECUREPY := $(PYTHON) $(COMPONENT_PATH)/esptool/espsecure.py`
Secure boot: initial image signature support 2016-11-03 02:33:30 -04:00			`export ESPSECUREPY # is used in bootloader_support component`
build system: Add espefuse/espsecure support for secure boot 2016-10-31 19:50:16 -04:00
bootloader, menuconfig: add flash size setting support 2016-10-18 07:03:59 -04:00			`ESPTOOL_FLASH_OPTIONS := --flash_mode $(ESPFLASHMODE) --flash_freq $(ESPFLASHFREQ) --flash_size $(ESPFLASHSIZE)`

build system: Add espefuse/espsecure support for secure boot 2016-10-31 19:50:16 -04:00			`ESPTOOL_ELF2IMAGE_OPTIONS :=`

bootloader, menuconfig: add flash size setting support 2016-10-18 07:03:59 -04:00			`ESPTOOLPY_WRITE_FLASH=$(ESPTOOLPY_SERIAL) write_flash $(if $(CONFIG_ESPTOOLPY_COMPRESSED),-z) $(ESPTOOL_FLASH_OPTIONS)`
esptool.py & Makefile: Fix compressed upload support (enabled by default) 2016-08-22 06:43:47 -04:00
make: 'make all' default target builds everything, 'make flash' flashes everything Also added 'make help' target which prints some useful usage summary. 2016-08-18 05:11:27 -04:00			`ESPTOOL_ALL_FLASH_ARGS += $(CONFIG_APP_OFFSET) $(APP_BIN)`
Initial public version 2016-08-17 11:08:22 -04:00
secure boot & flash encryption: Rework configuration options Add UART bootloader disable options for flash encryption 2016-11-24 22:09:26 -05:00			`ifdef CONFIG_SECURE_BOOT_ENABLED`
Secure boot: initial image signature support 2016-11-03 02:33:30 -04:00			`ifndef IS_BOOTLOADER_BUILD`
secure boot: Functional partition table & app signature verification 2016-11-06 23:45:57 -05:00			`# for secure boot, add a signing step to get from unsiged app to signed app`
			`APP_BIN_UNSIGNED := $(APP_BIN:.bin=-unsigned.bin)`

Secure boot: Correctly re-sign if signing key changes, better error if missing 2016-11-24 22:13:05 -05:00			`$(APP_BIN): $(APP_BIN_UNSIGNED) $(SECURE_BOOT_SIGNING_KEY)`
			`$(ESPSECUREPY) sign_data --keyfile $(SECURE_BOOT_SIGNING_KEY) -o $@ $<`
Secure boot: initial image signature support 2016-11-03 02:33:30 -04:00			`endif`
			`endif`
secure boot: Functional partition table & app signature verification 2016-11-06 23:45:57 -05:00			`# non-secure boot (or bootloader), both these files are the same`
			`APP_BIN_UNSIGNED ?= $(APP_BIN)`

			`$(APP_BIN_UNSIGNED): $(APP_ELF) $(ESPTOOLPY_SRC)`
Merge branch 'master' into feature/build_component_project_vars 2016-11-13 22:48:10 -05:00			`$(ESPTOOLPY) elf2image $(ESPTOOL_FLASH_OPTIONS) $(ESPTOOL_ELF2IMAGE_OPTIONS) -o $@ $<`
Initial public version 2016-08-17 11:08:22 -04:00
make: Add macro to test for & try to fix up files required for submodules Now applied to both esptool.py & esp32 wifi libs 2016-09-12 03:48:40 -04:00			`flash: all_binaries $(ESPTOOLPY_SRC)`
'make flash' targets: Print serial port when flashing Inspired by github #30 and related mentions where selected serial port is not clear from the make output. 2016-10-03 19:12:17 -04:00			`@echo "Flashing binaries to serial port $(ESPPORT) (app at offset $(CONFIG_APP_OFFSET))..."`
secure boot & flash encryption: Rework configuration options Add UART bootloader disable options for flash encryption 2016-11-24 22:09:26 -05:00			`ifdef CONFIG_SECURE_BOOT_ENABLED`
build system: Add espefuse/espsecure support for secure boot 2016-10-31 19:50:16 -04:00			`@echo "(Secure boot enabled, so bootloader not flashed automatically. See 'make bootloader' output)"`
			`endif`
build system: Remove need for $(Q) macro in recipes, use --silent in MAKEFLAGS instead 2016-11-10 20:29:38 -05:00			`$(ESPTOOLPY_WRITE_FLASH) $(ESPTOOL_ALL_FLASH_ARGS)`
Initial public version 2016-08-17 11:08:22 -04:00
make: Add macro to test for & try to fix up files required for submodules Now applied to both esptool.py & esp32 wifi libs 2016-09-12 03:48:40 -04:00			`app-flash: $(APP_BIN) $(ESPTOOLPY_SRC)`
'make flash' targets: Print serial port when flashing Inspired by github #30 and related mentions where selected serial port is not clear from the make output. 2016-10-03 19:12:17 -04:00			`@echo "Flashing app to serial port $(ESPPORT), offset $(CONFIG_APP_OFFSET)..."`
build system: Remove need for $(Q) macro in recipes, use --silent in MAKEFLAGS instead 2016-11-10 20:29:38 -05:00			`$(ESPTOOLPY_WRITE_FLASH) $(CONFIG_APP_OFFSET) $(APP_BIN)`
make: Add macro to test for & try to fix up files required for submodules Now applied to both esptool.py & esp32 wifi libs 2016-09-12 03:48:40 -04:00
build system: Refactor SubmoduleCheck to work project-wide Required at project level because some components use header files in other components' submodules, and one component with a submodule (esptool.py) doesn't have or need a component.mk. 2016-11-15 19:12:48 -05:00			`# Submodules normally added in component.mk, but can be added`
			`# at the project level as long as qualified path`
			`COMPONENT_SUBMODULES += $(COMPONENT_PATH)/esptool`