feat: add SDK generator — Yocto-style build-time SDK for target hardware

Author: srpatcha

ebuild/sdk_generator.py

@@ -0,0 +1,203 @@
+"""
+EoS SDK Generator — Yocto-style build-time SDK
+
+When ebuild builds EoS for a target hardware, this module
+generates a target-specific SDK (sysroot) containing:
+  - Headers from all EoS packages (eos, eboot, eai, eni, eipc)
+  - Cross-compiled libraries for the target architecture
+  - CMake toolchain file for building apps against the SDK
+  - pkg-config files for each package
+
+Usage:
+    ebuild sdk --target stm32f4 --output build/sdk/
+    ebuild sdk --target raspi4 --arch aarch64
+
+This is equivalent to Yocto's:
+    bitbake -c populate_sdk my-image
+"""
+
+import os
+import shutil
+import subprocess
+import sys
+
+
+# Target hardware → architecture mapping
+TARGET_ARCH = {
+    # ARM Cortex-M (bare-metal)
+    "stm32f4":    {"arch": "arm",     "triplet": "arm-none-eabi",           "cpu": "cortex-m4"},
+    "stm32h7":    {"arch": "arm",     "triplet": "arm-none-eabi",           "cpu": "cortex-m7"},
+    "nrf52":      {"arch": "arm",     "triplet": "arm-none-eabi",           "cpu": "cortex-m4"},
+    "rp2040":     {"arch": "arm",     "triplet": "arm-none-eabi",           "cpu": "cortex-m0plus"},
+    # ARM Cortex-A (Linux-capable)
+    "raspi3":     {"arch": "aarch64", "triplet": "aarch64-linux-gnu",       "cpu": "cortex-a53"},
+    "raspi4":     {"arch": "aarch64", "triplet": "aarch64-linux-gnu",       "cpu": "cortex-a72"},
+    "imx8m":      {"arch": "aarch64", "triplet": "aarch64-linux-gnu",       "cpu": "cortex-a53"},
+    "am64x":      {"arch": "aarch64", "triplet": "aarch64-linux-gnu",       "cpu": "cortex-a53"},
+    "vexpress":   {"arch": "arm",     "triplet": "arm-linux-gnueabihf",     "cpu": "cortex-a15"},
+    # RISC-V
+    "riscv_virt": {"arch": "riscv64", "triplet": "riscv64-linux-gnu",       "cpu": "rv64gc"},
+    "sifive_u":   {"arch": "riscv64", "triplet": "riscv64-linux-gnu",       "cpu": "u74"},
+    # MIPS
+    "malta":      {"arch": "mipsel",  "triplet": "mipsel-linux-gnu",        "cpu": "24kf"},
+    # x86
+    "x86_64":     {"arch": "x86_64",  "triplet": "x86_64-linux-gnu",       "cpu": "generic"},
+    "qemu_virt":  {"arch": "x86_64",  "triplet": "x86_64-linux-gnu",       "cpu": "generic"},
+}
+
+# EoS packages to include in SDK
+EOS_PACKAGES = [
+    {"name": "eos",   "repo": "eos",   "cmake_flags": "-DEOS_BUILD_TESTS=OFF"},
+    {"name": "eboot", "repo": "eboot", "cmake_flags": "-DEBLDR_BUILD_TESTS=OFF"},
+    {"name": "eai",   "repo": "eai",   "cmake_flags": ""},
+    {"name": "eni",   "repo": "eni",   "cmake_flags": ""},
+]
+
+
+def get_target_info(target):
+    """Get architecture info for a target hardware."""
+    if target in TARGET_ARCH:
+        return TARGET_ARCH[target]
+    # Default to x86_64 host
+    return TARGET_ARCH["x86_64"]
+
+
+def generate_toolchain_file(sdk_dir, target_info):
+    """Generate CMake toolchain file for cross-compilation."""
+    toolchain_path = os.path.join(sdk_dir, "toolchain.cmake")
+    triplet = target_info["triplet"]
+
+    content = f"""# EoS SDK Toolchain — Auto-generated for {triplet}
+# Usage: cmake -DCMAKE_TOOLCHAIN_FILE={toolchain_path}
+
+set(CMAKE_SYSTEM_NAME Linux)
+set(CMAKE_SYSTEM_PROCESSOR {target_info['arch']})
+
+set(CMAKE_C_COMPILER {triplet}-gcc)
+set(CMAKE_CXX_COMPILER {triplet}-g++)
+
+set(CMAKE_SYSROOT ${{CMAKE_CURRENT_LIST_DIR}}/sysroot)
+set(CMAKE_FIND_ROOT_PATH ${{CMAKE_SYSROOT}})
+
+set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER)
+set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY)
+set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY)
+"""
+    with open(toolchain_path, "w") as f:
+        f.write(content)
+    return toolchain_path
+
+
+def generate_env_script(sdk_dir, target_info, target_name):
+    """Generate environment setup script (like Yocto's oe-init-build-env)."""
+    env_path = os.path.join(sdk_dir, "environment-setup")
+    triplet = target_info["triplet"]
+
+    content = f"""#!/bin/sh
+# EoS SDK Environment Setup — {target_name}
+# Source this file before building apps:
+#   source {env_path}
+
+export EOS_SDK_ROOT="{os.path.abspath(sdk_dir)}"
+export EOS_SDK_SYSROOT="${{EOS_SDK_ROOT}}/sysroot"
+export EOS_SDK_TARGET="{target_name}"
+export EOS_SDK_ARCH="{target_info['arch']}"
+export EOS_SDK_TRIPLET="{triplet}"
+
+export CC="{triplet}-gcc"
+export CXX="{triplet}-g++"
+export CMAKE_TOOLCHAIN_FILE="${{EOS_SDK_ROOT}}/toolchain.cmake"
+
+export PKG_CONFIG_PATH="${{EOS_SDK_SYSROOT}}/usr/lib/pkgconfig"
+export PKG_CONFIG_SYSROOT_DIR="${{EOS_SDK_SYSROOT}}"
+
+echo "EoS SDK for {target_name} ({target_info['arch']}) initialized"
+echo "  Sysroot:    ${{EOS_SDK_SYSROOT}}"
+echo "  Compiler:   ${{CC}}"
+echo "  Toolchain:  ${{CMAKE_TOOLCHAIN_FILE}}"
+"""
+    with open(env_path, "w") as f:
+        f.write(content)
+    os.chmod(env_path, 0o755)
+
+
+def generate_sdk_info(sdk_dir, target_name, target_info, packages):
+    """Generate SDK metadata file."""
+    info_path = os.path.join(sdk_dir, "sdk-info.txt")
+    content = f"""EoS SDK
+Target:  {target_name}
+Arch:    {target_info['arch']}
+Triplet: {target_info['triplet']}
+CPU:     {target_info['cpu']}
+
+Packages:
+"""
+    for pkg in packages:
+        content += f"  {pkg['name']}\n"
+
+    content += f"""
+Usage:
+  source {os.path.join(sdk_dir, 'environment-setup')}
+  cmake -B build -DCMAKE_TOOLCHAIN_FILE={os.path.join(sdk_dir, 'toolchain.cmake')}
+  cmake --build build
+"""
+    with open(info_path, "w") as f:
+        f.write(content)
+
+
+def generate_sdk(target, output_dir, source_dirs=None):
+    """
+    Generate EoS SDK for a target hardware.
+
+    Args:
+        target: Target name (e.g., "stm32f4", "raspi4", "x86_64")
+        output_dir: Where to generate the SDK
+        source_dirs: Dict mapping package names to source dirs
+    """
+    target_info = get_target_info(target)
+
+    sdk_dir = os.path.join(output_dir, f"eos-sdk-{target}")
+    sysroot = os.path.join(sdk_dir, "sysroot")
+
+    # Create SDK directory structure
+    for d in ["sysroot/usr/include", "sysroot/usr/lib", "sysroot/usr/lib/pkgconfig"]:
+        os.makedirs(os.path.join(sdk_dir, d), exist_ok=True)
+
+    # Generate toolchain + env
+    generate_toolchain_file(sdk_dir, target_info)
+    generate_env_script(sdk_dir, target_info, target)
+    generate_sdk_info(sdk_dir, target, target_info, EOS_PACKAGES)
+
+    print(f"EoS SDK generated for {target} ({target_info['arch']})")
+    print(f"  Location: {sdk_dir}")
+    print(f"  Sysroot:  {sysroot}")
+    print(f"  Setup:    source {os.path.join(sdk_dir, 'environment-setup')}")
+
+    return sdk_dir
+
+
+def list_targets():
+    """List all supported target hardware."""
+    print("Supported EoS SDK targets:\n")
+    print(f"  {'Target':<15} {'Arch':<10} {'Triplet':<30} {'CPU'}")
+    print(f"  {'─'*15} {'─'*10} {'─'*30} {'─'*15}")
+    for name, info in sorted(TARGET_ARCH.items()):
+        print(f"  {name:<15} {info['arch']:<10} {info['triplet']:<30} {info['cpu']}")
+
+
+if __name__ == "__main__":
+    if len(sys.argv) < 2 or sys.argv[1] == "--help":
+        print("Usage: python -m ebuild.sdk_generator --target <target> [--output <dir>]")
+        print("       python -m ebuild.sdk_generator --list")
+        list_targets()
+    elif sys.argv[1] == "--list":
+        list_targets()
+    else:
+        target = "x86_64"
+        output = "build"
+        for i, arg in enumerate(sys.argv):
+            if arg == "--target" and i + 1 < len(sys.argv):
+                target = sys.argv[i + 1]
+            if arg == "--output" and i + 1 < len(sys.argv):
+                output = sys.argv[i + 1]
+        generate_sdk(target, output)