# Copyright (c) 2024 Espressif Systems (Shanghai) Co., Ltd.
# SPDX-License-Identifier: Apache-2.0

if SOC_FAMILY_ESPRESSIF_ESP32

config ESPTOOLPY_OCT_FLASH
	bool "Use Octal Flash"
	depends on SOC_SERIES_ESP32S3
	default n

config ESPTOOLPY_FLASH_MODE_AUTO_DETECT
	depends on SOC_SERIES_ESP32S3
	bool "Choose flash mode automatically (please read help)"
	default y
	help
	  This config option helps decide whether flash is Quad or Octal, but please note some limitations:

	  1. If the flash chip is an Octal one, even if one of "QIO", "QOUT", "DIO", "DOUT" options is
	      selected in `ESPTOOLPY_FLASHMODE`, our code will automatically change the
	      mode to "OPI" and the sample mode will be STR.
	  2. If the flash chip is a Quad one, even if "OPI" is selected in `ESPTOOLPY_FLASHMODE`, our code will
	     automatically change the mode to "DIO".
	  3. Please do not rely on this option when you are pretty sure that you are using Octal flash,
	     please enable `ESPTOOLPY_OCT_FLASH` option, then you can choose `DTR` sample mode
	     in `ESPTOOLPY_FLASH_SAMPLE_MODE`. Otherwise, only `STR` mode is available.
	  4. Enabling this feature reduces available internal RAM size (around 900 bytes).
	     If your IRAM space is insufficient and you're aware of your flash type,
	     disable this option and select corresponding flash type options.

choice ESPTOOLPY_FLASHMODE
	prompt "Flash SPI mode"
	default ESPTOOLPY_FLASHMODE_DIO
	default ESPTOOLPY_FLASHMODE_OPI if ESPTOOLPY_OCT_FLASH
	help
	  Mode the flash chip is flashed in, as well as the default mode for the
	  binary to run in.

config ESPTOOLPY_FLASHMODE_QIO
	bool "QIO"
	depends on !ESPTOOLPY_OCT_FLASH
config ESPTOOLPY_FLASHMODE_QOUT
	bool "QOUT"
	depends on !ESPTOOLPY_OCT_FLASH
config ESPTOOLPY_FLASHMODE_DIO
	bool "DIO"
	depends on !ESPTOOLPY_OCT_FLASH
config ESPTOOLPY_FLASHMODE_DOUT
	bool "DOUT"
	depends on !ESPTOOLPY_OCT_FLASH
config ESPTOOLPY_FLASHMODE_OPI
	bool "OPI"
	depends on ESPTOOLPY_OCT_FLASH

endchoice # ESPTOOLPY_FLASHMODE

choice ESPTOOLPY_FLASH_SAMPLE_MODE
	prompt "Flash Sampling Mode"
	default ESPTOOLPY_FLASH_SAMPLE_MODE_DTR if ESPTOOLPY_OCT_FLASH
	default ESPTOOLPY_FLASH_SAMPLE_MODE_STR if !ESPTOOLPY_OCT_FLASH

config ESPTOOLPY_FLASH_SAMPLE_MODE_STR
	bool "STR Mode"
config ESPTOOLPY_FLASH_SAMPLE_MODE_DTR
	bool "DTR Mode"
	depends on ESPTOOLPY_OCT_FLASH

endchoice # ESPTOOLPY_FLASH_SAMPLE_MODE

config ESPTOOLPY_FLASHMODE
	string
	default "dio" if ESPTOOLPY_FLASHMODE_QIO
	default "dio" if ESPTOOLPY_FLASHMODE_QOUT
	default "dio" if ESPTOOLPY_FLASHMODE_DIO
	default "dout" if ESPTOOLPY_FLASHMODE_DOUT
	# The 1st and 2nd bootloader doesn't support opi mode,
	# using fastrd instead. For now the ESPTOOL doesn't support
	# fasted (see ESPTOOL-274), using dout instead. In ROM the flash mode
	# information get from efuse, so don't care this dout choice.
	default "dout" if ESPTOOLPY_FLASHMODE_OPI

choice ESPTOOLPY_FLASHFREQ
	prompt "Flash SPI speed"
	default ESPTOOLPY_FLASHFREQ_40M if SOC_SERIES_ESP32
	default ESPTOOLPY_FLASHFREQ_80M if ESPTOOLPY_FLASHFREQ_80M_DEFAULT

config ESPTOOLPY_FLASHFREQ_120M
	bool "120 MHz"
	select SPI_FLASH_HPM_ENABLE
	depends on SOC_SERIES_ESP32S3 && ESPTOOLPY_FLASH_SAMPLE_MODE_STR
	help
		- Flash 120 MHz SDR mode is stable.
		- Flash 120 MHz DDR mode is an experimental feature, it works when
		the temperature is stable.

		Risks:
		If your chip powers on at a certain temperature, then after the temperature
		increases or decreases by approximately 20 Celsius degrees (depending on the
		chip), the program will crash randomly.

config ESPTOOLPY_FLASHFREQ_80M
	bool "80 MHz"
config ESPTOOLPY_FLASHFREQ_40M
	bool "40 MHz"
config ESPTOOLPY_FLASHFREQ_26M
	bool "26 MHz"
	depends on !SOC_SERIES_ESP32S3
config ESPTOOLPY_FLASHFREQ_20M
	bool "20 MHz"

endchoice # ESPTOOLPY_FLASHFREQ

config ESPTOOLPY_FLASHFREQ_80M_DEFAULT
	bool
	default y if SOC_SERIES_ESP32S2 || SOC_SERIES_ESP32S3 || SOC_SERIES_ESP32C3
	help
	  This is an invisible item, used to define the targets that defaults to use 80MHz Flash SPI speed.

config ESPTOOLPY_FLASHFREQ
	string
	# On some of the ESP chips, max boot frequency would be equal to (or even lower than) 80m.
	# We currently define this to `80m`.
	default '80m' if ESPTOOLPY_FLASHFREQ_120M
	default '80m' if ESPTOOLPY_FLASHFREQ_80M
	default '40m' if ESPTOOLPY_FLASHFREQ_40M
	default '26m' if ESPTOOLPY_FLASHFREQ_26M
	default '20m' if ESPTOOLPY_FLASHFREQ_20M
	default '20m' # if no clock can match in bin headers, go with minimal.

choice ESPTOOLPY_FLASHSIZE
	prompt "Flash size"
	default ESPTOOLPY_FLASHSIZE_2MB
	help
	  SPI flash size, in megabytes

	config ESPTOOLPY_FLASHSIZE_1MB
		bool "1 MB"
	config ESPTOOLPY_FLASHSIZE_2MB
		bool "2 MB"
	config ESPTOOLPY_FLASHSIZE_4MB
		bool "4 MB"
	config ESPTOOLPY_FLASHSIZE_8MB
		bool "8 MB"
	config ESPTOOLPY_FLASHSIZE_16MB
		bool "16 MB"
	config ESPTOOLPY_FLASHSIZE_32MB
		bool "32 MB"
	config ESPTOOLPY_FLASHSIZE_64MB
		bool "64 MB"
	config ESPTOOLPY_FLASHSIZE_128MB
		bool "128 MB"
endchoice

config ESPTOOLPY_FLASHSIZE
	string
	default "1MB" if ESPTOOLPY_FLASHSIZE_1MB
	default "2MB" if ESPTOOLPY_FLASHSIZE_2MB
	default "4MB" if ESPTOOLPY_FLASHSIZE_4MB
	default "8MB" if ESPTOOLPY_FLASHSIZE_8MB
	default "16MB" if ESPTOOLPY_FLASHSIZE_16MB
	default "32MB" if ESPTOOLPY_FLASHSIZE_32MB
	default "64MB" if ESPTOOLPY_FLASHSIZE_64MB
	default "128MB" if ESPTOOLPY_FLASHSIZE_128MB

config ESPTOOLPY_HEADER_FLASHSIZE_UPDATE
	bool "Detect flash size when flashing bootloader"
	default n
	help
	  If this option is set, flashing the project will automatically detect
	  the flash size of the target chip and update the bootloader image
	  before it is flashed.

	  Enabling this option turns off the image protection against corruption
	  by a SHA256 digest. Updating the bootloader image before flashing would
	  invalidate the digest.

choice ESPTOOLPY_BEFORE
	prompt "Before flashing"
	default ESPTOOLPY_BEFORE_RESET
	help
	  Configure whether esptool.py should reset the ESP32 before flashing.

	  Automatic resetting depends on the RTS & DTR signals being
	  wired from the serial port to the ESP32. Most USB development
	  boards do this internally.

	config ESPTOOLPY_BEFORE_RESET
	  bool "Reset to bootloader"
	config ESPTOOLPY_BEFORE_NORESET
	  bool "No reset"
endchoice # ESPTOOLPY_BEFORE

config ESPTOOLPY_BEFORE
	string
	default "default_reset" if ESPTOOLPY_BEFORE_RESET
	default "no_reset" if ESPTOOLPY_BEFORE_NORESET

choice ESPTOOLPY_AFTER
	prompt "After flashing"
	default ESPTOOLPY_AFTER_RESET
	help
	  Configure whether esptool.py should reset the ESP32 after flashing.

	  Automatic resetting depends on the RTS & DTR signals being
	  wired from the serial port to the ESP32. Most USB development
	  boards do this internally.

	config ESPTOOLPY_AFTER_RESET
	  bool "Reset after flashing"
	config ESPTOOLPY_AFTER_NORESET
	  bool "Stay in bootloader"
endchoice

config ESPTOOLPY_AFTER
	string
	default "hard_reset" if ESPTOOLPY_AFTER_RESET
	default "no_reset" if ESPTOOLPY_AFTER_NORESET

endif # SOC_FAMILY_ESPRESSIF_ESP32