#!/usr/bin/env python3 """Read-only, bounded comparison of a CV181X EmxRes project and an explicit SDK tree.""" from __future__ import annotations import argparse import json import re from pathlib import Path import bsp_preflight import project_guard CONFIG_RE = re.compile(r"^(CONFIG_[A-Za-z0-9_]+)=(.+)$", re.MULTILINE) CONFIG_PREFIXES = ( "CONFIG_CHIP_", "CONFIG_BOARD_", "CONFIG_DDR_CFG_", "CONFIG_TOOLCHAIN_", "CONFIG_STORAGE_TYPE_", "CONFIG_NANDFLASH_", ) CONFIG_KEYS = {"CONFIG_ARCH", "CONFIG_SDK_VER", "CONFIG_ENABLE_FREERTOS", "CONFIG_BOOT_IMAGE_SINGLE_DTB"} def selected_config(path: Path) -> dict[str, str]: if not path.is_file() or path.is_symlink(): return {} return { key: value for key, value in CONFIG_RE.findall(path.read_text(encoding="utf-8")) if key in CONFIG_KEYS or key.startswith(CONFIG_PREFIXES) } def sync_scripts_match(project: Path) -> bool: kernel = project / "configs/kernel/ep_kernel.sh" uboot = project / "configs/uboot/ep_uboot.sh" if any(not path.is_file() or path.is_symlink() for path in (kernel, uboot)): return False kernel_lines = {line.strip() for line in kernel.read_text(encoding="utf-8").splitlines() if line.strip() and not line.lstrip().startswith("#")} uboot_lines = {line.strip() for line in uboot.read_text(encoding="utf-8").splitlines() if line.strip() and not line.lstrip().startswith("#")} return all(token in kernel_lines for token in ( "EP_KERNEL_BUILD_TOP=build/boards/cv181x/$CV_BUILD_TYPE", "EP_KERNEL_BASE_DTSI=build/boards/default/dts/cv181x", "cp $EP_KERNEL_CONFIGS_PATH/memmap.py $EP_KERNEL_BUILD_TOP/memmap.py", "cp $EP_KERNEL_CONFIGS_PATH/cvitek_$CV_BUILD_TYPE\"_defconfig\" $EP_KERNEL_BUILD_TOP/linux/cvitek_$CV_BUILD_TYPE\"_defconfig\"", "cp $EP_KERNEL_CONFIGS_PATH/*.dts $EP_KERNEL_BUILD_TOP/dts_arm/", "cp $EP_KERNEL_CONFIGS_PATH/*.dtsi $EP_KERNEL_BASE_DTSI/", )) and all(token in uboot_lines for token in ( "EP_UBOOT_BUILD_TOP=build/boards/cv181x/$CV_BUILD_TYPE", "cp $EP_UBOOT_CONFIGS_PATH/$CV_BUILD_TYPE\"_defconfig\" $EP_UBOOT_BUILD_TOP/", "cp $EP_UBOOT_CONFIGS_PATH/cvitek_$CV_BUILD_TYPE\"_defconfig\" $EP_UBOOT_BUILD_TOP/u-boot/cvitek_$CV_BUILD_TYPE\"_defconfig\"", "cp $EP_UBOOT_CONFIGS_PATH/partition_spinand.xml $EP_UBOOT_BUILD_TOP/partition/partition_spinand.xml", "cp $EP_UBOOT_CONFIGS_PATH/cvi_board_init.c $EP_UBOOT_BUILD_TOP/u-boot/cvi_board_init.c", )) def mapped_files(build_type: str, project: Path) -> list[tuple[Path, Path]]: board = Path("build/boards/cv181x") / build_type files = [ (Path("configs/uboot") / f"{build_type}_defconfig", board / f"{build_type}_defconfig"), (Path("configs/uboot") / f"cvitek_{build_type}_defconfig", board / "u-boot" / f"cvitek_{build_type}_defconfig"), (Path("configs/uboot/cvi_board_init.c"), board / "u-boot/cvi_board_init.c"), (Path("configs/uboot/partition_spinand.xml"), board / "partition/partition_spinand.xml"), (Path("configs/kernel/memmap.py"), board / "memmap.py"), (Path("configs/kernel") / f"cvitek_{build_type}_defconfig", board / "linux" / f"cvitek_{build_type}_defconfig"), ] for path in sorted((project / "configs/kernel").glob("*.dts")): files.append((path.relative_to(project), board / "dts_arm" / path.name)) for path in sorted((project / "configs/kernel").glob("*.dtsi")): files.append((path.relative_to(project), Path("build/boards/default/dts/cv181x") / path.name)) return files def inspect(project: Path, sdk_root: Path) -> dict[str, object]: if project.is_symlink() or not project.is_dir() or sdk_root.is_symlink() or not sdk_root.is_dir(): raise ValueError("项目与 SDK 必须是存在的普通目录，不能是软链接") root = project_guard.normalize_root(project.parent) project = project_guard.direct_child(root, project.name, "project", True) sdk_root = sdk_root.resolve() env_path = project / "buildEnvConfig.sh" if not env_path.is_file() or env_path.is_symlink(): raise ValueError("项目缺少普通 buildEnvConfig.sh") env = bsp_preflight.parse_assignments(env_path) if not env.get("EP_CHIP", "").startswith("CV181"): raise ValueError("本检查器仅适用于 EP_CHIP=CV181* 项目") if env.get("EP_COMPANY") != "Cvitek" or env.get("EP_FLASH_TYPE") != "nand": raise ValueError("本检查器目前只核对 Cvitek CV181X SPI NAND 构建链") if not env.get("EP_SDK_VER") or sdk_root.name != env["EP_SDK_VER"]: raise ValueError("指定 SDK 目录名与项目 EP_SDK_VER 不符") layout = bsp_preflight.resolve_board_layout(project, env.get("EP_CHIP")) if layout["error"] or layout["layout"] != "split-kernel-uboot": raise ValueError(str(layout["error"] or "需要 kernel/uboot 分目录布局")) if not sync_scripts_match(project): raise ValueError("同步脚本与已知 CV181X 复制契约不符；不猜测 SDK 写入目标") build_type = str(layout["board_build_type"]) alerts: list[dict[str, str]] = [] if not build_type.startswith(env["EP_CHIP"].lower() + "_") or "spinand" not in build_type: alerts.append({"code": "board_identity", "message": "板级配置名与芯片或 NAND 类型不一致，需人工核对"}) mappings: list[dict[str, object]] = [] for source_rel, dest_rel in mapped_files(build_type, project): source = project / source_rel dest = sdk_root / dest_rel resolved = dest.resolve(strict=False) entry: dict[str, object] = { "project_file": str(source), "sdk_path": str(dest), "sdk_real_path": str(resolved), "sdk_is_symlink": dest.is_symlink(), "project_exists": source.is_file() and not source.is_symlink(), "sdk_exists": dest.is_file(), "same_content": None, } if not resolved.is_relative_to(sdk_root): entry["sdk_exists"] = False alerts.append({"code": "sdk_link_escape", "message": f"SDK 目标软链接越出指定 SDK: {dest_rel}"}) elif source.is_file() and not source.is_symlink() and dest.is_file(): entry["same_content"] = project_guard.sha256_file(source) == project_guard.sha256_file(dest) if entry["sdk_is_symlink"]: alerts.append({"code": "shared_sdk_target", "message": f"复制可能改写公共目标: {resolved}"}) if entry["same_content"] is False: alerts.append({"code": "sdk_copy_differs", "message": f"项目与 SDK 当前内容不同: {source_rel}"}) else: alerts.append({"code": "mapping_missing", "message": f"项目或 SDK 文件缺失: {source_rel}"}) if entry["sdk_is_symlink"] and entry["same_content"] is None and resolved.is_relative_to(sdk_root): alerts.append({"code": "shared_sdk_target", "message": f"复制可能改写公共目标: {resolved}"}) mappings.append(entry) source_config = project / "configs/uboot" / f"{build_type}_defconfig" expected = selected_config(source_config) actual = selected_config(sdk_root / "build/.config") differences = [ {"key": key, "project": value, "sdk_generated": actual.get(key)} for key, value in sorted(expected.items()) if actual.get(key) != value ] if actual else [] if not actual: alerts.append({"code": "generated_config_missing", "message": "SDK build/.config 不存在，无法核对生成配置"}) elif differences: alerts.append({"code": "generated_config_differs", "message": "生成配置与项目板级配置存在差异；可能属于其他项目或未重新生成"}) tool = root / "tools/BuildCvitekSDKTool.sh" order = "unknown" if tool.is_file() and not tool.is_symlink(): content = tool.read_text(encoding="utf-8") positions = [content.find(s) for s in ("defconfig $CV_BUILD_TYPE", "Ep_Uboot_Config_Func", "Ep_Kernel_Config_Func")] if -1 not in positions: order = "sync-after-defconfig" if positions[0] < positions[1] and positions[0] < positions[2] else "other" if order == "sync-after-defconfig": alerts.append({"code": "sync_after_defconfig", "message": "工具先生成 .config 再同步项目配置；顶层配置变更可能不在当次生效"}) return { "schema_version": 1, "kind": "cv181x-sdk-readonly-inspection", "project": str(project), "sdk_root": str(sdk_root), "chip": env["EP_CHIP"], "sdk_version": env.get("EP_SDK_VER"), "board_build_type": build_type, "build_order": order, "mappings": mappings, "generated_config_differences": differences, "alerts": alerts, "note": "只读磁盘快照；未执行同步、编译或板上验证。映射以已识别的复制脚本为前提。", } def main() -> int: parser = argparse.ArgumentParser(description=__doc__) parser.add_argument("--project", required=True, type=Path) parser.add_argument("--sdk-root", required=True, type=Path) args = parser.parse_args() try: result = inspect(args.project, args.sdk_root) except (ValueError, OSError, UnicodeDecodeError, project_guard.GuardError) as exc: print(json.dumps({"passed": False, "error": str(exc)}, ensure_ascii=False, indent=2)) return 2 print(json.dumps(result, ensure_ascii=False, indent=2)) return 0 if __name__ == "__main__": raise SystemExit(main())