Function main

ci/docker_utils/qemu_esp32_docker.py:695–750

()

def main():
    parser = argparse.ArgumentParser(
        description="Run ESP32 firmware in QEMU using Docker"
    )
    parser.add_argument(
        "firmware_path", type=Path, help="Path to firmware.bin file or build directory"
    )
    parser.add_argument(
        "--docker-image",
        type=str,
        help=f"Docker image to use (default: {DEFAULT_DOCKER_IMAGE})",
    )
    parser.add_argument(
        "--flash-size", type=int, default=4, help="Flash size in MB (default: 4)"
    )
    parser.add_argument(
        "--timeout", type=int, default=30, help="Timeout in seconds (default: 30)"
    )
    parser.add_argument(
        "--interrupt-regex", type=str, help="Regex pattern to interrupt execution"
    )
    parser.add_argument(
        "--interactive", action="store_true", help="Run in interactive mode"
    )
    parser.add_argument("--output-file", type=str, help="File to write QEMU output to")
    parser.add_argument(
        "--machine",
        type=str,
        default="esp32",
        help="QEMU machine type: esp32, esp32c3, esp32s3 (default: esp32)",
    )
    parser.add_argument(
        "--skip-pull",
        action="store_true",
        help="Skip pulling Docker image (assumes image already exists)",
    )

    args = parser.parse_args()

    if not args.firmware_path.exists():
        print(
            f"ERROR: Firmware path does not exist: {args.firmware_path}",
            file=sys.stderr,
        )
        return 1

    runner = DockerQEMURunner(docker_image=args.docker_image)
    return runner.run(
        firmware_path=args.firmware_path,
        timeout=args.timeout,
        interrupt_regex=args.interrupt_regex,
        interactive=args.interactive,
        output_file=args.output_file,
        machine=args.machine,
        skip_pull=args.skip_pull,
    )