OVMS3-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_BUILD_SIGNED_BINARIES
ifndef IS_BOOTLOADER_BUILD
# for locally signed secure boot image, add a signing step to get from unsigned app to signed app
APP_BIN_UNSIGNED := $(APP_BIN:.bin=-unsigned.bin)

$(APP_BIN): $(APP_BIN_UNSIGNED) $(SECURE_BOOT_SIGNING_KEY) $(SDKCONFIG_MAKEFILE)
	$(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) | erase_flash
	@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) | erase_flash
	@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

.PHONY: erase_flash
erase_flash:
	@echo "Erasing entire flash..."
	$(ESPTOOLPY_SERIAL) erase_flash
Initial public version 2016-08-17 15:08:22 +00: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 07:47:09 +00:00			`ESPFLASHMODE ?= $(CONFIG_ESPTOOLPY_FLASHMODE)`
Add flash freq selection to menuconfig 2016-09-02 04:29:01 +00:00			`ESPFLASHFREQ ?= $(CONFIG_ESPTOOLPY_FLASHFREQ)`
bootloader, menuconfig: add flash size setting support 2016-10-18 11:03:59 +00:00			`ESPFLASHSIZE ?= $(CONFIG_ESPTOOLPY_FLASHSIZE)`
Initial public version 2016-08-17 15:08:22 +00: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 07:48:40 +00:00			`ESPTOOLPY_SRC := $(COMPONENT_PATH)/esptool/esptool.py`
			`ESPTOOLPY := $(PYTHON) $(ESPTOOLPY_SRC) --chip esp32`
Initial public version 2016-08-17 15:08:22 +00:00			`ESPTOOLPY_SERIAL := $(ESPTOOLPY) --port $(ESPPORT) --baud $(ESPBAUD)`

build system: Add espefuse/espsecure support for secure boot 2016-10-31 23:50:16 +00: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 06:33:30 +00:00			`export ESPSECUREPY # is used in bootloader_support component`
build system: Add espefuse/espsecure support for secure boot 2016-10-31 23:50:16 +00:00
bootloader, menuconfig: add flash size setting support 2016-10-18 11:03:59 +00: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 23:50:16 +00:00			`ESPTOOL_ELF2IMAGE_OPTIONS :=`

bootloader, menuconfig: add flash size setting support 2016-10-18 11:03:59 +00: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 10:43:47 +00: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 09:11:27 +00:00			`ESPTOOL_ALL_FLASH_ARGS += $(CONFIG_APP_OFFSET) $(APP_BIN)`
Initial public version 2016-08-17 15:08:22 +00:00
Secure boot: Option for app & partition table signing to happen outside build system 2016-12-19 02:06:21 +00:00			`ifdef CONFIG_SECURE_BOOT_BUILD_SIGNED_BINARIES`
Secure boot: initial image signature support 2016-11-03 06:33:30 +00:00			`ifndef IS_BOOTLOADER_BUILD`
Secure boot: Option for app & partition table signing to happen outside build system 2016-12-19 02:06:21 +00:00			`# for locally signed secure boot image, add a signing step to get from unsigned app to signed app`
secure boot: Functional partition table & app signature verification 2016-11-07 04:45:57 +00:00			`APP_BIN_UNSIGNED := $(APP_BIN:.bin=-unsigned.bin)`

Secure boot: Option for app & partition table signing to happen outside build system 2016-12-19 02:06:21 +00:00			`$(APP_BIN): $(APP_BIN_UNSIGNED) $(SECURE_BOOT_SIGNING_KEY) $(SDKCONFIG_MAKEFILE)`
Secure boot: Correctly re-sign if signing key changes, better error if missing 2016-11-25 03:13:05 +00:00			`$(ESPSECUREPY) sign_data --keyfile $(SECURE_BOOT_SIGNING_KEY) -o $@ $<`
Secure boot: initial image signature support 2016-11-03 06:33:30 +00:00			`endif`
			`endif`
secure boot: Functional partition table & app signature verification 2016-11-07 04:45:57 +00: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-14 03:48:10 +00:00			`$(ESPTOOLPY) elf2image $(ESPTOOL_FLASH_OPTIONS) $(ESPTOOL_ELF2IMAGE_OPTIONS) -o $@ $<`
Initial public version 2016-08-17 15:08:22 +00:00
Build system: Add `make erase_flash` target 2016-12-19 23:00:04 +00:00			`flash: all_binaries $(ESPTOOLPY_SRC) \| erase_flash`
'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 23:12:17 +00: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-25 03:09:26 +00:00			`ifdef CONFIG_SECURE_BOOT_ENABLED`
build system: Add espefuse/espsecure support for secure boot 2016-10-31 23:50:16 +00: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-11 01:29:38 +00:00			`$(ESPTOOLPY_WRITE_FLASH) $(ESPTOOL_ALL_FLASH_ARGS)`
Initial public version 2016-08-17 15:08:22 +00:00
Build system: Add `make erase_flash` target 2016-12-19 23:00:04 +00:00			`app-flash: $(APP_BIN) $(ESPTOOLPY_SRC) \| erase_flash`
'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 23:12:17 +00: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-11 01:29:38 +00: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 07:48:40 +00: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-16 00:12:48 +00: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`
Build system: Add `make erase_flash` target 2016-12-19 23:00:04 +00:00
			`.PHONY: erase_flash`
			`erase_flash:`
			`@echo "Erasing entire flash..."`
			`$(ESPTOOLPY_SERIAL) erase_flash`