Method prepare_firmware

ci/docker_utils/qemu_esp32_docker.py:429–484

Prepare firmware files for mounting into Docker container. Args: firmware_path: Path to firmware.bin or build directory Returns: Path to the prepared firmware directory

(self, firmware_path: Path)

                raise e

    def prepare_firmware(self, firmware_path: Path) -> Path:
        """Prepare firmware files for mounting into Docker container.

        Args:
            firmware_path: Path to firmware.bin or build directory

        Returns:
            Path to the prepared firmware directory
        """
        # Create temporary directory for firmware files
        temp_dir = Path(tempfile.mkdtemp(prefix="qemu_firmware_"))

        try:
            if firmware_path.is_file() and firmware_path.suffix == ".bin":
                # Copy single firmware file
                shutil.copy2(firmware_path, temp_dir / "firmware.bin")
                # Create proper 4MB flash image for QEMU
                self._create_flash_image(firmware_path, temp_dir / "flash.bin")
            else:
                # Copy entire build directory
                if firmware_path.is_dir():
                    # Copy relevant files from build directory
                    patterns = ["*.bin", "*.elf", "partitions.csv", "flash_args"]
                    for pattern in patterns:
                        for file in firmware_path.glob(pattern):
                            shutil.copy2(file, temp_dir)

                    # Also check for PlatformIO build structure
                    pio_build = firmware_path / ".pio" / "build" / "esp32dev"
                    if pio_build.exists():
                        for pattern in patterns:
                            for file in pio_build.glob(pattern):
                                shutil.copy2(file, temp_dir)

                    # Create proper flash.bin file from firmware.bin
                    firmware_bin = temp_dir / "firmware.bin"
                    if firmware_bin.exists():
                        # Create proper 4MB flash image for QEMU
                        self._create_flash_image(firmware_bin, temp_dir / "flash.bin")
                    else:
                        # Create a minimal 4MB flash.bin for testing
                        flash_bin = temp_dir / "flash.bin"
                        flash_bin.write_bytes(
                            b"\xff" * (4 * 1024 * 1024)
                        )  # 4MB of 0xFF
                else:
                    raise ValueError(f"Invalid firmware path: {firmware_path}")

            return temp_dir
        except KeyboardInterrupt as ki:
            handle_keyboard_interrupt(ki)
            raise
        except Exception as e:
            # Clean up on error
            shutil.rmtree(temp_dir, ignore_errors=True)
            raise e

    def _create_flash_image(