287 lines
8.6 KiB
Python
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()
|