esp-idf/components/app_update/Makefile.projbuild

# Generate partition binary
#
.PHONY: blank_ota_data erase_otadata read_otadata

OTATOOL_PY := $(PYTHON) $(COMPONENT_PATH)/otatool.py
PARTTOOL_PY := $(PYTHON) $(IDF_PATH)/components/partition_table/parttool.py

# Generate blank partition file
BLANK_OTA_DATA_FILE = $(BUILD_DIR_BASE)/ota_data_initial.bin

# Copy PARTITION_TABLE_CSV_PATH definition here from $IDF_PATH/components/partition_table/Makefile.projbuild
# to avoid undefined variables warning for PARTITION_TABLE_CSV_PATH
ifndef PARTITION_TABLE_CSV_PATH
PARTITION_TABLE_ROOT := $(call dequote,$(if $(CONFIG_PARTITION_TABLE_CUSTOM),$(PROJECT_PATH),$(IDF_PATH)/components/partition_table))
PARTITION_TABLE_CSV_PATH := $(call dequote,$(abspath $(PARTITION_TABLE_ROOT)/$(call dequote,$(CONFIG_PARTITION_TABLE_FILENAME))))
endif

$(BLANK_OTA_DATA_FILE): partition_table_get_info $(PARTITION_TABLE_CSV_PATH) | check_python_dependencies
	$(shell if [ "$(OTA_DATA_OFFSET)" != "" ] && [ "$(OTA_DATA_SIZE)" != "" ]; then \
				$(PYTHON) $(IDF_PATH)/components/partition_table/gen_empty_partition.py $(OTA_DATA_SIZE) $(BLANK_OTA_DATA_FILE); \
			fi; )
	$(eval BLANK_OTA_DATA_FILE = $(shell if [ "$(OTA_DATA_OFFSET)" != "" ] && [ "$(OTA_DATA_SIZE)" != "" ]; then \
			echo $(BLANK_OTA_DATA_FILE); else echo " "; fi) )

blank_ota_data: $(BLANK_OTA_DATA_FILE)

# If there is no otadata partition, both OTA_DATA_OFFSET and BLANK_OTA_DATA_FILE 
# expand to empty values.
ESPTOOL_ALL_FLASH_ARGS += $(OTA_DATA_OFFSET) $(BLANK_OTA_DATA_FILE)

ESPTOOL_ARGS := --esptool-args port=$(CONFIG_ESPTOOLPY_PORT) baud=$(CONFIG_ESPTOOLPY_BAUD) before=$(CONFIG_ESPTOOLPY_BEFORE) after=$(CONFIG_ESPTOOLPY_AFTER)

erase_otadata: $(PARTITION_TABLE_CSV_PATH) partition_table_get_info | check_python_dependencies
	$(OTATOOL_PY) $(ESPTOOL_ARGS) --partition-table-file $(PARTITION_TABLE_CSV_PATH) \
	--partition-table-offset $(PARTITION_TABLE_OFFSET) \
	erase_otadata

read_otadata: $(PARTITION_TABLE_CSV_PATH) partition_table_get_info | check_python_dependencies
	$(OTATOOL_PY) $(ESPTOOL_ARGS) --partition-table-file $(PARTITION_TABLE_CSV_PATH) \ 
	--partition-table-offset $(partition_table_offset) \ 
	read_otadata

erase_ota: erase_otadata
	@echo "WARNING: erase_ota is deprecated. Use erase_otadata instead."

all: blank_ota_data
flash: blank_ota_data
ifdef CONFIG_SECURE_FLASH_ENCRYPTION_MODE_DEVELOPMENT
encrypted-flash: blank_ota_data
endif

TMP_DEFINES := $(BUILD_DIR_BASE)/app_update/tmp_cppflags.txt
export TMP_DEFINES

clean:
	rm -f $(BLANK_OTA_DATA_FILE)
	rm -f $(TMP_DEFINES)
make: Add feature to cmd 'make flash' - reset ota_data partition Add a command `make erase_ota` - erases otadata if it there is in the partition table otherwise error 'Partition table does not have ota_data partition'. Closes https://github.com/espressif/esp-idf/issues/1821 2018-06-25 06:53:10 +00:00			`# Generate partition binary`
			`#`
make: use otatool and parttool for build 2018-11-15 21:01:41 +00:00			`.PHONY: blank_ota_data erase_otadata read_otadata`
make: Add feature to cmd 'make flash' - reset ota_data partition Add a command `make erase_ota` - erases otadata if it there is in the partition table otherwise error 'Partition table does not have ota_data partition'. Closes https://github.com/espressif/esp-idf/issues/1821 2018-06-25 06:53:10 +00:00
make: use otatool and parttool for build 2018-11-15 21:01:41 +00:00			`OTATOOL_PY := $(PYTHON) $(COMPONENT_PATH)/otatool.py`
			`PARTTOOL_PY := $(PYTHON) $(IDF_PATH)/components/partition_table/parttool.py`
make dump_otadata: Displays app ota_seq and crc on console 2018-08-22 08:51:36 +00:00
make: use otatool and parttool for build 2018-11-15 21:01:41 +00:00			`# Generate blank partition file`
			`BLANK_OTA_DATA_FILE = $(BUILD_DIR_BASE)/ota_data_initial.bin`
make dump_otadata: Displays app ota_seq and crc on console 2018-08-22 08:51:36 +00:00
make: fix undefined variables warning for PARTITION_TABLE_BIN Closes https://github.com/espressif/esp-idf/issues/3136 2019-03-27 13:02:55 +00:00			`# Copy PARTITION_TABLE_CSV_PATH definition here from $IDF_PATH/components/partition_table/Makefile.projbuild`
			`# to avoid undefined variables warning for PARTITION_TABLE_CSV_PATH`
			`ifndef PARTITION_TABLE_CSV_PATH`
			`PARTITION_TABLE_ROOT := $(call dequote,$(if $(CONFIG_PARTITION_TABLE_CUSTOM),$(PROJECT_PATH),$(IDF_PATH)/components/partition_table))`
			`PARTITION_TABLE_CSV_PATH := $(call dequote,$(abspath $(PARTITION_TABLE_ROOT)/$(call dequote,$(CONFIG_PARTITION_TABLE_FILENAME))))`
			`endif`

			`$(BLANK_OTA_DATA_FILE): partition_table_get_info $(PARTITION_TABLE_CSV_PATH) \| check_python_dependencies`
make: fix unexpected operator warning 2018-12-03 10:11:13 +00:00			`$(shell if [ "$(OTA_DATA_OFFSET)" != "" ] && [ "$(OTA_DATA_SIZE)" != "" ]; then \`
app_update: implement Python API for otatool 2019-05-27 03:08:28 +00:00			`$(PYTHON) $(IDF_PATH)/components/partition_table/gen_empty_partition.py $(OTA_DATA_SIZE) $(BLANK_OTA_DATA_FILE); \`
make: use otatool and parttool for build 2018-11-15 21:01:41 +00:00			`fi; )`
make: fix unexpected operator warning 2018-12-03 10:11:13 +00:00			`$(eval BLANK_OTA_DATA_FILE = $(shell if [ "$(OTA_DATA_OFFSET)" != "" ] && [ "$(OTA_DATA_SIZE)" != "" ]; then \`
make: use otatool and parttool for build 2018-11-15 21:01:41 +00:00			`echo $(BLANK_OTA_DATA_FILE); else echo " "; fi) )`
make dump_otadata: Displays app ota_seq and crc on console 2018-08-22 08:51:36 +00:00
make: use otatool and parttool for build 2018-11-15 21:01:41 +00:00			`blank_ota_data: $(BLANK_OTA_DATA_FILE)`
make dump_otadata: Displays app ota_seq and crc on console 2018-08-22 08:51:36 +00:00
make: Add feature to cmd 'make flash' - reset ota_data partition Add a command `make erase_ota` - erases otadata if it there is in the partition table otherwise error 'Partition table does not have ota_data partition'. Closes https://github.com/espressif/esp-idf/issues/1821 2018-06-25 06:53:10 +00:00			`# If there is no otadata partition, both OTA_DATA_OFFSET and BLANK_OTA_DATA_FILE`
			`# expand to empty values.`
			`ESPTOOL_ALL_FLASH_ARGS += $(OTA_DATA_OFFSET) $(BLANK_OTA_DATA_FILE)`

make, cmake: pass config esptool args for otatool invocation Closes https://github.com/espressif/esp-idf/issues/3135 2019-03-28 06:08:32 +00:00			`ESPTOOL_ARGS := --esptool-args port=$(CONFIG_ESPTOOLPY_PORT) baud=$(CONFIG_ESPTOOLPY_BAUD) before=$(CONFIG_ESPTOOLPY_BEFORE) after=$(CONFIG_ESPTOOLPY_AFTER)`

make: fix undefined variables warning for PARTITION_TABLE_BIN Closes https://github.com/espressif/esp-idf/issues/3136 2019-03-27 13:02:55 +00:00			`erase_otadata: $(PARTITION_TABLE_CSV_PATH) partition_table_get_info \| check_python_dependencies`
make, cmake: pass config esptool args for otatool invocation Closes https://github.com/espressif/esp-idf/issues/3135 2019-03-28 06:08:32 +00:00			`$(OTATOOL_PY) $(ESPTOOL_ARGS) --partition-table-file $(PARTITION_TABLE_CSV_PATH) \`
partition_table,app_update: use config partition table offset 2019-06-04 07:49:55 +00:00			`--partition-table-offset $(PARTITION_TABLE_OFFSET) \`
			`erase_otadata`
make dump_otadata: Displays app ota_seq and crc on console 2018-08-22 08:51:36 +00:00
make: fix undefined variables warning for PARTITION_TABLE_BIN Closes https://github.com/espressif/esp-idf/issues/3136 2019-03-27 13:02:55 +00:00			`read_otadata: $(PARTITION_TABLE_CSV_PATH) partition_table_get_info \| check_python_dependencies`
make, cmake: pass config esptool args for otatool invocation Closes https://github.com/espressif/esp-idf/issues/3135 2019-03-28 06:08:32 +00:00			`$(OTATOOL_PY) $(ESPTOOL_ARGS) --partition-table-file $(PARTITION_TABLE_CSV_PATH) \`
partition_table,app_update: use config partition table offset 2019-06-04 07:49:55 +00:00			`--partition-table-offset $(partition_table_offset) \`
			`read_otadata`
make: Add feature to cmd 'make flash' - reset ota_data partition Add a command `make erase_ota` - erases otadata if it there is in the partition table otherwise error 'Partition table does not have ota_data partition'. Closes https://github.com/espressif/esp-idf/issues/1821 2018-06-25 06:53:10 +00:00
make: use otatool and parttool for build 2018-11-15 21:01:41 +00:00			`erase_ota: erase_otadata`
			`@echo "WARNING: erase_ota is deprecated. Use erase_otadata instead."`
make: Add feature to cmd 'make flash' - reset ota_data partition Add a command `make erase_ota` - erases otadata if it there is in the partition table otherwise error 'Partition table does not have ota_data partition'. Closes https://github.com/espressif/esp-idf/issues/1821 2018-06-25 06:53:10 +00:00
			`all: blank_ota_data`
			`flash: blank_ota_data`
Improve flash encryption documentation and add Development & Release modes This MR improves existing flash encryption document to provide simplified steps Adds two new modes for user: Development & Release Adds a simple example Supports encrypted write through make command 2019-01-21 14:14:56 +00:00			`ifdef CONFIG_SECURE_FLASH_ENCRYPTION_MODE_DEVELOPMENT`
			`encrypted-flash: blank_ota_data`
			`endif`
make: Add feature to cmd 'make flash' - reset ota_data partition Add a command `make erase_ota` - erases otadata if it there is in the partition table otherwise error 'Partition table does not have ota_data partition'. Closes https://github.com/espressif/esp-idf/issues/1821 2018-06-25 06:53:10 +00:00
esp32: Add firmware version to app Added a new structure esp_app_desc_t. It has info about firmware: version, secure_version, project_name, time/date build and IDF version. Added the ability to add a custom structure with a description of the firmware. The esp_app_desc_t is located in fixed place in start of ROM secotor. It is located after structures esp_image_header_t and esp_image_segment_header_t. app_version is filed from PROJECT_VER variable (if set in custom make file) or PROJECT_PATH/version.txt or git repo (git describe). Add API to get app_desc from partition. 2018-10-05 12:29:07 +00:00			`TMP_DEFINES := $(BUILD_DIR_BASE)/app_update/tmp_cppflags.txt`
			`export TMP_DEFINES`

make: Add feature to cmd 'make flash' - reset ota_data partition Add a command `make erase_ota` - erases otadata if it there is in the partition table otherwise error 'Partition table does not have ota_data partition'. Closes https://github.com/espressif/esp-idf/issues/1821 2018-06-25 06:53:10 +00:00			`clean:`
esp32: Add firmware version to app Added a new structure esp_app_desc_t. It has info about firmware: version, secure_version, project_name, time/date build and IDF version. Added the ability to add a custom structure with a description of the firmware. The esp_app_desc_t is located in fixed place in start of ROM secotor. It is located after structures esp_image_header_t and esp_image_segment_header_t. app_version is filed from PROJECT_VER variable (if set in custom make file) or PROJECT_PATH/version.txt or git repo (git describe). Add API to get app_desc from partition. 2018-10-05 12:29:07 +00:00			`rm -f $(BLANK_OTA_DATA_FILE)`
			`rm -f $(TMP_DEFINES)`