Files

287 lines
8.6 KiB
Python

"""
环境检查脚本
检查FINN部署所需的环境和依赖
"""
import os
import sys
import subprocess
import platform
EXPECTED_PYNQ_VERSION = "2.7"
EXPECTED_XILINX_VERSION = "2020.2"
def configure_stdio():
"""Avoid console encoding failures when run from Windows terminals."""
for stream in (sys.stdout, sys.stderr):
if hasattr(stream, "reconfigure"):
stream.reconfigure(encoding="utf-8", errors="replace")
configure_stdio()
def check_python_version():
"""检查Python版本"""
print("检查Python版本...")
version = sys.version_info
print(f" Python版本: {version.major}.{version.minor}.{version.micro}")
if version.major < 3 or (version.major == 3 and version.minor < 7):
print(" ✗ Python版本过低,需要3.7或更高")
return False
else:
print(" ✓ Python版本满足要求")
return True
def check_docker():
"""检查Docker是否安装"""
print("\n检查Docker...")
try:
result = subprocess.run(['docker', '--version'],
capture_output=True, text=True)
if result.returncode == 0:
print(f" {result.stdout.strip()}")
print(" ✓ Docker已安装")
return True
else:
print(" ✗ Docker未正确安装")
return False
except FileNotFoundError:
print(" ✗ Docker未安装")
print("\n 安装Docker:")
if platform.system() == 'Windows':
print(" 1. 下载Docker Desktop: https://www.docker.com/products/docker-desktop")
print(" 2. 安装并启用WSL2后端")
elif platform.system() == 'Linux':
print(" curl -fsSL https://get.docker.com -o get-docker.sh")
print(" sudo sh get-docker.sh")
elif platform.system() == 'Darwin':
print(" 1. 下载Docker Desktop for Mac")
print(" 2. 或使用Homebrew: brew install --cask docker")
return False
def check_docker_running():
"""检查Docker是否运行"""
print("\n检查Docker服务...")
try:
result = subprocess.run(['docker', 'ps'],
capture_output=True, text=True)
if result.returncode == 0:
print(" ✓ Docker服务正在运行")
return True
else:
print(" ✗ Docker服务未运行")
print(" 请启动Docker Desktop")
return False
except:
print(" ✗ 无法连接到Docker")
return False
def check_finn_image():
"""检查FINN Docker镜像"""
print("\n检查FINN镜像...")
try:
result = subprocess.run(['docker', 'images', 'xilinx/finn'],
capture_output=True, text=True)
if 'xilinx/finn' in result.stdout:
print(" ✓ FINN镜像已下载")
return True
else:
print(" ✗ FINN镜像未下载")
print("\n 下载FINN镜像:")
print(" docker pull xilinx/finn:latest")
print(" (镜像大小约5GB,需要一些时间)")
return False
except:
return False
def check_xilinx_tools():
"""检查Linux/VMware中的Xilinx工具链。"""
print("\n检查Xilinx工具链...")
xilinx_path = os.environ.get("FINN_XILINX_PATH", "/opt/Xilinx")
xilinx_version = os.environ.get("FINN_XILINX_VERSION", EXPECTED_XILINX_VERSION)
vivado_dir = os.path.join(xilinx_path, "Vivado", xilinx_version)
vivado_settings = os.path.join(vivado_dir, "settings64.sh")
print(f" 期望版本: {xilinx_version}")
print(f" 安装根目录: {xilinx_path}")
if platform.system() == "Windows":
windows_candidate = os.path.join("F:\\", "ZYNQ_", "Vivado", xilinx_version, "bin", "vivado.bat")
if os.path.exists(windows_candidate):
print(f" ⚠ 检测到Windows版Vivado: {windows_candidate}")
print(" FINN bitstream构建应在VMware/Linux中使用Linux版Xilinx工具链")
else:
print(" ⚠ 当前在Windows中检查,无法验证Linux容器内Vivado可执行性")
return False
if not os.path.isdir(vivado_dir):
print(f" ✗ 未找到Vivado目录: {vivado_dir}")
print(" 请安装Linux版Vivado/Vitis/Vitis HLS 2020.2,或设置FINN_XILINX_PATH")
return False
if not os.path.exists(vivado_settings):
print(f" ✗ 未找到settings64.sh: {vivado_settings}")
return False
try:
result = subprocess.run(
["bash", "-lc", f"source '{vivado_settings}' && vivado -version"],
capture_output=True,
text=True,
timeout=60,
)
if result.returncode != 0:
print(" ✗ vivado -version执行失败")
print(result.stderr.strip())
return False
first_line = result.stdout.splitlines()[0] if result.stdout else ""
print(f" ✓ {first_line}")
return True
except Exception as e:
print(f" ✗ 无法执行vivado: {e}")
return False
def check_python_packages():
"""检查Python包"""
print("\n检查Python包...")
required_packages = {
'torch': 'PyTorch',
'torchvision': 'TorchVision',
'onnx': 'ONNX',
'onnxruntime': 'ONNX Runtime',
'PIL': 'Pillow',
'numpy': 'NumPy',
}
all_installed = True
for package, name in required_packages.items():
try:
__import__(package)
print(f" ✓ {name}")
except ImportError:
print(f" ✗ {name} 未安装")
all_installed = False
if not all_installed:
print("\n 安装依赖:")
print(" pip install -r requirements.txt")
return all_installed
def check_model_files():
"""检查模型文件"""
print("\n检查模型文件...")
project_root = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
files_to_check = {
'PyTorch模型': os.path.join(project_root, 'data', 'models', 'best_model.pth'),
'ONNX模型': os.path.join(project_root, 'data', 'models', 'model.onnx'),
}
all_exist = True
for name, path in files_to_check.items():
if os.path.exists(path):
size_mb = os.path.getsize(path) / (1024 * 1024)
print(f" ✓ {name}: {size_mb:.1f} MB")
else:
print(f" ✗ {name} 不存在")
all_exist = False
if not os.path.exists(files_to_check['PyTorch模型']):
print("\n 请先完成模型训练:")
print(" cd pc_training")
print(" python train.py --data_dir ../data/processed --pretrained --epochs 50")
if not os.path.exists(files_to_check['ONNX模型']):
print("\n 导出ONNX模型:")
print(" cd pc_training")
print(" python quantize.py --model_path ../data/models/best_model.pth --export_onnx")
return all_exist
def check_disk_space():
"""检查磁盘空间"""
print("\n检查磁盘空间...")
try:
import shutil
total, used, free = shutil.disk_usage("/")
free_gb = free / (1024 ** 3)
print(f" 可用空间: {free_gb:.1f} GB")
if free_gb < 50:
print(" ⚠ 磁盘空间不足,建议至少50GB")
print(" FINN转换需要大量临时空间")
return False
else:
print(" ✓ 磁盘空间充足")
return True
except:
print(" ⚠ 无法检查磁盘空间")
return True
def main():
"""主函数"""
print("=" * 60)
print("FINN部署环境检查")
print("=" * 60)
checks = {
'Python版本': check_python_version(),
'Docker安装': check_docker(),
'Xilinx 2020.2工具链': check_xilinx_tools(),
'Python包': check_python_packages(),
'模型文件': check_model_files(),
'磁盘空间': check_disk_space(),
}
# 如果Docker已安装,检查更多
if checks['Docker安装']:
checks['Docker服务'] = check_docker_running()
if checks['Docker服务']:
checks['FINN镜像'] = check_finn_image()
# 总结
print("\n" + "=" * 60)
print("检查结果总结")
print("=" * 60)
for name, passed in checks.items():
status = "✓" if passed else "✗"
print(f" {status} {name}")
all_passed = all(checks.values())
print("\n" + "=" * 60)
if all_passed:
print("✓ 环境检查通过!")
print("\n可以开始FINN部署:")
print(" bash quickstart.sh")
else:
print("✗ 环境检查未通过")
print("\n请根据上述提示完成环境配置")
print("=" * 60)
if __name__ == '__main__':
main()