fix(elf2image): support --flash-mmu-page-config for all chips

This commit fixes the issue where the `--flash-mmu-page-config` option
did not work for chips that do not have configurable MMU page sizes.

esptool/bin_image.py

@@ -180,6 +180,7 @@ class ELFSection(ImageSegment):
 class BaseFirmwareImage(object):
     SEG_HEADER_LEN = 8
     SHA256_DIGEST_LEN = 32
+    IROM_ALIGN = 0
     MMU_PAGE_SIZE_CONF: Tuple[int, ...] = ()
 
     """ Base class with common firmware image functions """
@@ -414,14 +415,23 @@ class BaseFirmwareImage(object):
         self.segments = segments
 
     def set_mmu_page_size(self, size):
-        """
+        """Set the MMU page size for the image if supported by the chip."""
-        If supported, this should be overridden by the chip-specific class.
+        if not self.MMU_PAGE_SIZE_CONF and size != self.IROM_ALIGN:
-        Gets called in elf2image.
+            # For chips where MMU page size cannot be set or is fixed, just log a warning and use default if there is one.
-        """
+            print(
-        print(
+                f"Warning: Changing MMU page size is not supported on {self.ROM_LOADER.CHIP_NAME}! "
-            "WARNING: Changing MMU page size is not supported on {}! "
+                f"Defaulting to {self.IROM_ALIGN // 1024}KB."
-            "Defaulting to 64KB.".format(self.ROM_LOADER.CHIP_NAME)
+                if self.IROM_ALIGN != 0
-        )
+                else ""
+            )
+        elif self.MMU_PAGE_SIZE_CONF and size not in self.MMU_PAGE_SIZE_CONF:
+            # For chips with configurable MMU page sizes, error is raised when the size is not valid.
+            valid_sizes = ", ".join(f"{x // 1024}KB" for x in self.MMU_PAGE_SIZE_CONF)
+            raise FatalError(
+                f"{size} bytes is not a valid {self.ROM_LOADER.CHIP_NAME} page size, select from {valid_sizes}."
+            )
+        else:
+            self.IROM_ALIGN = size
 
 
 class ESP8266ROMFirmwareImage(BaseFirmwareImage):
@@ -622,8 +632,6 @@ class ESP32FirmwareImage(BaseFirmwareImage):
 
     IROM_ALIGN = 65536
 
-    MMU_PAGE_SIZE_CONF: Tuple[int, ...] = (IROM_ALIGN,)
-
     def __init__(self, load_file=None, append_digest=True, ram_only_header=False):
         super(ESP32FirmwareImage, self).__init__()
         self.secure_pad = None
@@ -1133,14 +1141,6 @@ class ESP32C2FirmwareImage(ESP32FirmwareImage):
     ROM_LOADER = ESP32C2ROM
     MMU_PAGE_SIZE_CONF = (16384, 32768, 65536)
 
-    def set_mmu_page_size(self, size):
-        if size not in self.MMU_PAGE_SIZE_CONF:
-            valid_sizes = ", ".join(f"{x // 1024}KB" for x in self.MMU_PAGE_SIZE_CONF)
-            raise FatalError(
-                f"{size} bytes is not a valid {self.ROM_LOADER.CHIP_NAME} page size, select from {valid_sizes}."
-            )
-        self.IROM_ALIGN = size
-
 
 ESP32C2ROM.BOOTLOADER_IMAGE = ESP32C2FirmwareImage
 
@@ -1151,14 +1151,6 @@ class ESP32C6FirmwareImage(ESP32FirmwareImage):
     ROM_LOADER = ESP32C6ROM
     MMU_PAGE_SIZE_CONF = (8192, 16384, 32768, 65536)
 
-    def set_mmu_page_size(self, size):
-        if size not in self.MMU_PAGE_SIZE_CONF:
-            valid_sizes = ", ".join(f"{x // 1024}KB" for x in self.MMU_PAGE_SIZE_CONF)
-            raise FatalError(
-                f"{size} bytes is not a valid {self.ROM_LOADER.CHIP_NAME} page size, select from {valid_sizes}."
-            )
-        self.IROM_ALIGN = size
-
 
 ESP32C6ROM.BOOTLOADER_IMAGE = ESP32C6FirmwareImage
 

test/test_imagegen.py

@@ -583,7 +583,7 @@ class TestMMUPageSize(BaseTestCase):
             output = capsys.readouterr().out
             print(output)
             assert (
-                "App description segment is not aligned to MMU page size, probably linker script issue or wrong MMU page size. Use --flash-mmu-page-size to set it manually."
+                "App description segment is not aligned to MMU page size, probably linker script issue or wrong MMU page size. Try to set MMU page size parameter manually."
                 in output
             )
         finally: