技能助手

其他 社区

技能解读

当前原文的自动摘译,尚未人工审校。

第一步:判断工具和流程

收到任何 Xilinx 相关请求时,首先确定用户处于哪个阶段,然后加载对应参考文件。

工具路由表

用户描述的任务 · 需要的工具 · 加载的参考文件 C/C++ 算法加速、pragma 优化、生成 IP · Vitis HLS · ../../references/hls_guide.md 创建工程、Block Design、配置 PS/IP、XDC、比特流 · Vivado · ../../references/vivado_guide.md + 按需加载 PS 详细配置(DDR、MIO、时钟) · Vivado · ../../references/mpsoc_ps_config.md IO 引脚约束、时序约束 · Vivado · ../../references/xdc_constraints.md

第二步:需求确认(必须先做)

在生成任何脚本之前,确认以下信息(没有明确答案的项主动提问):

所有工程必须确认

目标器件/开发板:完整 part number 或板型(由用户提供) Vivado/Vitis 版本(如 2023.2、2024.1) 设计目标:这个工程要实现什么功能?

HLS 工程额外确认

算法描述:C/C++ 函数的输入输出和功能 性能目标:目标时钟频率、延迟、吞吐量要求 接口类型:AXI4-Lite(控制)、AXI4-Stream(数据)、AXI4-Master(存储器访问)

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
通用
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@QingquanYao · 未声明许可证
上下文用量评级
低消耗
接入复杂程度
需简单配置
是否需要外部接口密钥
不需要
兼容的系统
Linux
运行环境要求
Python
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
  • 命令执行
网络行为
仅限本地
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

作者说明文件(原文) SKILL.md

# Xilinx 全工具链 Skill

本 skill 帮助你完成 Xilinx(AMD)完整设计流程,生成可直接运行的脚本和文件。

---

## 第一步:判断工具和流程

**收到任何 Xilinx 相关请求时,首先确定用户处于哪个阶段,然后加载对应参考文件。**

### 完整设计流程总览

```
[可选] Vitis HLS        →    Vivado          →    Vitis Unified / PetaLinux
C/C++ 算法 → IP 核        硬件平台设计           软件开发 / Linux 系统
  hls_guide.md              vivado_guide.md      vitis_unified_guide.md
                          + mpsoc_ps_config.md    petalinux_guide.md
                          + xdc_constraints.md
```

### 工具路由表

| 用户描述的任务 | 需要的工具 | 加载的参考文件 |
|--------------|-----------|--------------|
| C/C++ 算法加速、pragma 优化、生成 IP | Vitis HLS | `../../references/hls_guide.md` |
| 创建工程、Block Design、配置 PS/IP、XDC、比特流 | Vivado | `../../references/vivado_guide.md` + 按需加载 |
| PS 详细配置(DDR、MIO、时钟)| Vivado | `../../references/mpsoc_ps_config.md` |
| IO 引脚约束、时序约束 | Vivado | `../../references/xdc_constraints.md` |
| JESD204B→C 迁移、高速串行 ADC/DAC 接口 | Vivado | `../../references/jesd204b_to_c_migration.md` |
| 嵌入式软件、裸机程序、RTOS、platform/domain | Vitis Unified | `../../references/vitis_unified_guide.md` |
| 嵌入式 Linux、kernel 配置、rootfs、启动镜像 | PetaLinux | `../../references/petalinux_guide.md` |
| PetaLinux 上跑 gRPC C++ 服务端 / Python 客户端、ZMQ→gRPC 迁移、udmabuf+AXI DMA 暴露 RPC | PetaLinux | `../../references/grpc_on_petalinux.md` |
| 查找官方文档编号、UG/PG/DS 编号查询、文档用途说明 | 通用 | `../../references/official-docs/index.md` |

---

## 第二步:需求确认(必须先做)

在生成任何脚本之前,确认以下信息(没有明确答案的项主动提问):

### 所有工程必须确认
1. **目标器件/开发板**:完整 part number 或板型(由用户提供)
2. **Vivado/Vitis 版本**(如 2023.2、2024.1)
3. **设计目标**:这个工程要实现什么功能?

### HLS 工程额外确认
4. **算法描述**:C/C++ 函数的输入输出和功能
5. **性能目标**:目标时钟频率、延迟、吞吐量要求
6. **接口类型**:AXI4-Lite(控制)、AXI4-Stream(数据)、AXI4-Master(存储器访问)

### Vivado 工程额外确认(MPSoC 类)
4. **PS 配置**:DDR 类型和容量、MIO 外设(UART、Ethernet、USB、SD 等)
5. **PL IP 需求**:需要哪些 AXI IP,是否有自定义 HDL 模块
6. **时钟要求**:PL 时钟频率(pl0_ref_clk)

### Vitis 工程额外确认
4. **运行环境**:裸机(standalone)、FreeRTOS、还是 Linux 用户态
5. **处理器核**:A53、R5、MicroBlaze
6. **XSA 文件路径**:从 Vivado 导出的硬件描述文件

### PetaLinux 工程额外确认
4. **BSP 或 XSA**:是否有厂商 BSP?或者直接使用 Vivado 导出的 XSA?
5. **自定义需求**:是否需要添加驱动/应用程序/设备树覆盖

---

## 第三步:按工具流程执行

确认需求后,加载对应参考文件并按步骤生成脚本。

### 加载参考文件的时机

**始终在生成脚本之前先读取参考文件**,不要凭记忆生成 Tcl/XSCT/命令,因为不同 Vivado/Vitis 版本的 API 有差异。

```
Vivado 工程  → 先读 ../../references/vivado_guide.md
              → 如有 PS  → 再读 ../../references/mpsoc_ps_config.md
              → 如有 IO  → 再读 ../../references/xdc_constraints.md
              → 如有 JESD204 → 再读 ../../references/jesd204b_to_c_migration.md

HLS 工程     → 先读 ../../references/hls_guide.md

Vitis 工程   → 先读 ../../references/vitis_unified_guide.md

PetaLinux    → 先读 ../../references/petalinux_guide.md
              → 如需 gRPC(C++ server / Python client、ZMQ 迁移)→ 再读 ../../references/grpc_on_petalinux.md
```

---

## 输出规范

每次生成脚本时,必须提供:

1. **完整可运行的脚本文件**(`.tcl`、`.xdc`、`.py`、shell 脚本等)
2. **运行命令**:如何在命令行或 GUI 中执行
3. **预期输出**:脚本运行成功后会产生哪些文件
4. **下一步提示**:完成本阶段后应该做什么

### 文件组织规范

```
project_root/
├── 01_hls/                  ← Vitis HLS 工程(可选)
│   ├── hls_create.tcl
│   └── src/*.cpp / *.h
│
├── 02_vivado/               ← Vivado 硬件工程
│   ├── create_project.tcl
│   ├── create_bd.tcl
│   ├── add_sources.tcl
│   ├── constraints/design.xdc
│   ├── build.tcl
│   └── output/
│       ├── design.bit
│       └── design_fixed.xsa
│
├── 03_vitis/                ← Vitis 软件工程
│   ├── create_platform.tcl  (XSCT 脚本)
│   ├── create_app.tcl
│   └── src/*.c / *.h
│
└── 04_petalinux/            ← PetaLinux(可选)
    ├── build.sh
    └── config/
```

---

## 跨工具数据流

```
Vitis HLS                    Vivado                    Vitis / PetaLinux
─────────────────────────────────────────────────────────────────────────
hls_ip/                  →   IP Catalog
  solution/impl/ip       →   (add_files / ip_repo)
                             ↓
                         project.xsa         →        平台/BSP/Linux BSP
                         design.bit          →        boot/BOOT.BIN
```

---

## 常见错误和注意事项

1. **版本兼容性**:Vivado 2022.x+ 的 `write_hw_platform` 替代了旧版 `write_sysdef`;Vitis Unified 2022.x+ 的 Tcl API 与 Classic 版本有重大差异
2. **XSA 类型**:`write_hw_platform`(综合前,可编辑)vs `write_hw_platform -fixed -include_bit`(实现后,固定含比特流)
3. **HLS IP 导入 Vivado**:需要在 Vivado 工程中添加 HLS IP 仓库路径,并刷新 IP 目录
4. **PetaLinux 版本匹配**:PetaLinux 版本必须与 Vivado 版本一致(例如都用 2023.2)
5. **器件系列判断**:`zu` 开头 → MPSoC;`vu`/`ku`/`xc7` → 纯 FPGA;`xcvc` → Versal

---

## 参考文件

- `../../references/vivado_guide.md`:Vivado 工程创建、Block Design、综合实现、报告分析
- `../../references/mpsoc_ps_config.md`:Zynq UltraScale+ PS 详细配置(DDR、MIO、时钟参数)
- `../../references/xdc_constraints.md`:XDC 约束完整指南(时序、IO、例外约束)
- `../../references/hls_guide.md`:Vitis HLS 工程流程(C/C++ → IP)
- `../../references/vitis_unified_guide.md`:Vitis Unified IDE 2022.x+ 工程流程
- `../../references/petalinux_guide.md`:PetaLinux 系统构建流程
- `../../references/jesd204b_to_c_migration.md`:JESD204B→C IP 迁移指南(端口映射、数据位宽、AXI 寄存器、常见陷阱)
- `../../references/grpc_on_petalinux.md`:PetaLinux + gRPC 端到端部署指南(rootfs 配置、libutf8_range 软链、VM 预生成 .pb.cc + 板上 g++、udmabuf/AXI DMA RPC 暴露、ZMQ→gRPC 迁移、常见 RCU stall 等陷阱)
- `../../references/official-docs/index.md`:Xilinx/AMD 官方文档索引(UG/PG/DS/XAPP 编号、标题、用途、与本仓库参考指南的对应关系)

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。