---

FMQL平台 Icraft工具 Windows安装与测试（详细教程）

一、前言

在 FMQL AI 平台开发过程中，Icraft 是核心工具之一，它主要用于：

• AI模型编译
• AI模型仿真
• 模型部署前验证

通过 Icraft 可以完成：

模型训练 → 模型导出 → Icraft编译 → 仿真验证 → 板端部署

本文记录 FMQL平台 Icraft工具在 Windows 下的完整安装和验证流程。

适合人群：

• FMQL平台初学者
• AI开发板用户
• FPGA+AI开发人员

本文暂时先记录模型工程当中的C++模型编译仿真，后续在补充Python模型编译仿真。

---

二、目录导航

本文结构如下：

1 Icraft环境安装
   1.1 Icraft安装
   1.2 安装cmake和Visual Studio
   1.3 Python API安装
   1.4 模型编译
   1.5 模型仿真

2 常见问题（避坑指南）

---

三、Icraft环境安装

Icraft开发环境主要包含以下组件：

软件	作用
Icraft	AI模型编译工具
Python API	提供给Python接口库
Python	运行脚本环境
Visual Studio	C++编译环境
CMake	工程构建工具

---

3.1 Icraft安装

从复旦微获取Icraft工具或从板卡供应商获取。

以3.6.2举例，进入 Icraft 安装目录：

Icraft_v3.6.2

依次运行：

Icraft_Setup.exe
CustomOp_Setup.exe

安装完成后，打开 PowerShell 验证：

icraft --version

若出现版本信息说明安装成功，如下图。

---

---

3.2 安装 CMake 和 Visual Studio

Icraft 的 C++ 示例需要使用cmake 和 Visual Studio 2022。

安装 cmake ，此处我安装的是 3.28.1 版本，安装完成，打开 PowerShell 验证：

cmake --version

若出现版本信息说明安装成功，如下图。

安装Visual Studio软件 ，此处安装 Visual Studio Community 2022 版本， 安装时要选择工作负荷，此处要勾选C++桌面开发如下图，其它保持默认即可

设置安装的路径，自定义，哪个磁盘空间大，就安装到哪里

---

3.3 Python 安装

安装 Python 3.8.10 版本，该版本是Icraft要求的版本，另外是有windows可执行程序，后续版本无可直接安装的程序。

安装时，勾选添加环境变量，如下

安装完成，在 powershell 测试版本，如下

3.4 Python API安装

Icraft Windows 提供 Python 扩展包，找复旦微或板卡供应商获取：

icraft-3.6.2-cp38-none-win_amd64.whl

安装方法：

pip install icraft-3.6.2-cp38-none-win_amd64.whl

卸载：

pip uninstall icraft

安装完成后可以在 powershell 中测试，如下图无报错，表示正常：

---

3.5 模型编译

模型工程可从复旦微或板卡供应商获取，以tutorial-runtime-tt3.6.2工程示例。

进入 Icraft tutorial 目录：

tutorial-runtime-tt3.6.2

进入编译目录：

quick_start/compile

执行编译：

icraft compile config/yolov5s_soft.toml

编译完成后 在imodel目录下生成yolov5s_soft目录，是一些 json，raw模型文件，如下图：

---

将 编译生成的 yolov5s_soft 目录，复制到 tutorial-runtime-tt3.6.2\quick_start\deploy\C++_demo\modelzoo\yolov5\imodel 目录下，供仿真使用，如下图

3.6 模型仿真

C++模型仿真。

进入目录：

quick_start/deploy/C++_demo/modelzoo/yolov5

创建 build_win 目录，输入如下指令创建目录，或者桌面操作创建目录：

进入 build_win 目录 执行如下指令，此时执行cmake时会用到 visual studio 的一些依赖：

检查 C++_demo/modelzoo/yolov5/cfg/yolov5s.yaml 中的sim字段已经设置为true

在build_win目录下，运行如下命令 获取仿真结果，如下图。

---

五、避坑指南（持续更新）

1 版本兼容问题

感觉工具版本必须要和复旦微的参考文档保持一致，工具的版本要保持一致，不同的版本会出现意想不到的问题。

---

六、总结

本文介绍了 FMQL 平台 Icraft 工具在 Windows 下的完整安装流程，包括：

• Icraft工具安装
• Python环境搭建
• C++编译环境配置
• AI模型编译
• AI模型仿真

---