ADI 在 github 上开源的 hdl 仓库,搭建了一套非常成熟、可跨平台移植的 FPGA 工程骨架,核心思路就是统一 IP 接口规范、按目录分层隔离代码、依靠 Tcl 脚本自动创建工程,同一份 ADC、射频 IP 可以在 Zynq、UltraScale+、Intel FPGA 上复用,换载板只修改顶层工程和约束,IP 内部代码不用改动,非常适合做高速采集、JESD、射频类项目复用。这套框架不只是一堆 Verilog 代码,它把 IP 库、板级工程、编译脚本、仿真、Linux IIO 驱动整套链路打通,做到 FPGA 逻辑和上层软件解耦,也是行业里很多高速采集项目参考模仿的样板,非常值得硬件、FPGA 工程师借鉴学习。
一、ADI FPGA 仓库目录结构清单
- library:可复用 IP 库,一个 IP 独立一个文件夹,包含 rtl、仿真 tb、打包 tcl,比如 axi_ad9361、util_axis_fifo、JESD 接收发送 IP
- projects:各个评估板对应的顶层工程,一块板子一个工程目录
- projects/common:载板通用底座,包含 PS 配置、时钟、复位、DDR、基础总线连接,不同子卡可以复用这套底座
- scripts:全局编译脚本 adi_env.tcl、工程创建脚本,适配 Vivado、Quartus 两套工具链
- docs、testbench:规范文档、通用仿真环境
二、分层架构表格
| 层级 | 职责 | 改动频率 |
|---|---|---|
| IP 层(library) | 标准 AXI-Lite、AXI-Stream 接口,实现 ADC/DAC、FIFO、DMA、JESD 逻辑,平台无关 | 低,稳定后尽量不改 |
| 载板底座层(common) | FPGA 芯片、PS、时钟资源、高速收发器引脚、DDR 配置,绑定载体芯片 | 中,换载板修改 |
| 子卡应用层 | 对应 AD 评估板的数据通路、同步逻辑,和模拟芯片绑定 | 中,换 AD 芯片改动 |
| 顶层工程层 system_top + tcl | 引脚约束、工程创建、综合实现脚本、参数配置 | 高,每个项目单独调整 |
三、这套骨架的核心设计规则
- 接口标准化:控制通道统一 AXI-Lite,数据流统一 AXI-Stream,所有 IP 遵循这套接口,方便自由拼接
- IP 自包含:每个 IP 自带打包 tcl 文件,用 adi_ip_create 命令注册,在 Vivado 里可以直接当成自定义 IP 调用
- 脚本驱动工程:不用手动点 GUI 创建工程,system_project.tcl 自动新建工程、添加文件、设置约束、运行综合实现,Makefile 封装一键编译
- 软硬件解耦:FPGA 寄存器映射对齐 Linux IIO 子系统,libiio 直接读取控制,不需要单独写复杂驱动
- 跨厂商兼容:同一套 IP 逻辑,通过脚本分支适配 Xilinx 和 Intel 的工具,IP 内部只调用通用原语,厂商专属 IP 隔离在底层底座
- 规范强制约束:统一命名、缩进、注释规范,有专门的 HDL 编码文档,团队协作风格统一
四、完整开发步骤(复刻这套骨架的流程)
- 先拆分功能,把通用模块抽成独立 IP,定义统一的控制和数据流接口
- 每个 IP 目录准备 rtl 文件、仿真 testbench、IP 打包 tcl 脚本
- 搭建 common 底座,放处理器配置、时钟、复位、高速收发器基础逻辑
- 新建项目目录,编写 system_top 顶层和 system_project.tcl 工程脚本
- Makefile 封装编译命令,一键跑综合、实现、生成 bit、导出 XSA
- 配套 IIO 设备树、驱动,实现 Linux 端读写采集数据
- 增加回归仿真,修改 IP 后自动跑 tb,保证移植不踩坑
五、抄骨架时要避开的坑
- 不要把引脚约束、板级时钟写进 library 里面的 IP,IP 必须平台无关
- AXI 时序、复位策略统一,不然 IP 拼到一起容易出现跨时钟域问题
- JESD、GTX 这类高速收发器资源属于载板底座,不能封装到子卡 IP
- 不要过度封装简单逻辑,小工具 IP 保持精简,不然仿真、维护成本变高
【相关 FAQ】
问题 1:ADI 这套 FPGA 工程骨架,最大优势是什么?
回答 1:ADI 这套 FPGA 工程骨架最大优势是 IP 和载板解耦,标准化 AXI 接口,支持跨 Xilinx、Intel FPGA 平台移植,同一款射频、ADC IP 换板子不用改核心 RTL,同时配套 IIO 软件栈,适合高速采集项目复用。
问题 2:ADI FPGA 工程骨架里面的 library 目录 IP,怎么加到自己 Vivado 工程?
回答 2:ADI FPGA 工程骨架里 library 下每个 IP 自带 tcl 注册脚本,加载 adi_env.tcl 之后调用 adi_ip_create,就可以在 Vivado IP 库里面找到,和普通 IP 一样例化调用。
问题 3:复刻 ADI 这套 FPGA 工程骨架,适合哪些项目场景?
回答 3:复刻 ADI 这套 FPGA 工程骨架更适合高速 ADC/DAC 采集、JESD204 射频、软件无线电、仪器类项目;简单低速 IO、纯控制类小项目用这套框架会过重。
问题 4:ADI FPGA 工程骨架配套的 IIO 是什么,有什么作用?
回答 4:ADI FPGA 工程骨架配套 IIO 子系统,FPGA 里面寄存器按照 IIO 规范映射,Linux 下 libiio 库可以直接读写采集数据、配置芯片参数,不用从零开发驱动,实现软硬件联动。
【参考资料】
[2026-11-13](ADI 是怎么把 FPGA 工程做成的,这套骨架值得抄)电子工程专辑
[2026-11-12](ADI HDL Architecture)Analog Devices Open Source
[2026-11-10](ADI HDL coding guidelines)Analog Devices Open Source
[2026-10-20](ADI HDL 工程移植指南)Analog Devices Open Source
[2026-09-05](Analog Devices HDL Github 仓库说明)github.com/analogdevicesinc/hdl
【免责声明】
本文仅对 ADI 开源 HDL 工程框架做原理和结构解读,不代表直接商用保证;复刻这套 FPGA 工程骨架时,IP 协议、高速时序、JESD 时序需要根据自身硬件 PCB 重新仿真验证,开源协议、知识产权请以 ADI 仓库 LICENSE 为准。
