This version (08 Apr 2024 14:36) was approved by iulia Moldovan.The Previously approved version (11 Jul 2022 09:22) is available.Diff

HDL Git Repository

We are in the process of migrating our documentation to GitHubIO. This page is outdated. Please check out our latest guide at

All the HDL sources can be found in the following git repository:

We assume that the user is familiar with git. Knows how to clone the repository, how to check its status or how to switch between branches.

A basic git knowledge is required in order to work with these source files, if you do not have any, don't worry! There are a lot of great resources and tutorials about git all over the web.

If you want to pull down the sources as soon as possible, just do the following few steps:

  1. Install Git from here
  2. Open up Git bash, change your current directory to a place where you want to keep the hdl source
  3. Clone the repository using these instructions

Folder structure

The root of the HDL repository has the following structure:

├─ .github
├─ docs
├─ projects
├─ library
├─ .gitattributes
├─ .gitignore
├─ Makefile

The repository is divided into two separate sections:

  • projects with all the currently supported projects
  • library with all the Analog Devices Inc. proprietary IP cores and hdl modules, which are required to build the projects

The file .gitattributes is used to properly handle different line endings. And the .gitignore specifies intentionally untracked files that Git should ignore. The root Makefile can be used to build all the project of the repository. To learn more about hdl Makefiles visit the Building & Generating programming files section.

The projects are structured as following

├─ projects
│    ├ ad6676evb
│    ├ ad9467_fmc
│    ·
│    ├ common
│    ├ fmcomms2
│    │   ├ ac701
│    │   ├ common
│    │   ├ kc705
│    │   ·
│    │   ├ zed
│    │   └ Makefile
│    ├ adrv9009
│    ├ scripts
│    ·
│    └ Makefile
└─ library

Besides the project folders, there are two special folders inside the /hdl/projects:

  • common: This folder contains all the base designs, for all currently supported FPGA development boards. Be aware if you see your board on this list, it does not necessarily mean that you can use it with your FMC board.
  • scripts: In all cases, we are interacting with the development tools (Vivado/Quartus) using Tcl scripts. In this folder are defined all the custom Tcl processes, which are used to create a project, define the system and generate programming files for the FPGA.

Inside a project folder, you can find folders with an FPGA carrier name (e.g. ZC706) which in general contains all the carrier board specific files, and a folder called common which contains the project specific files. If you can not find your FPGA board name in a project folder, that means your FPGA board with that particular FMC board is not supported.

The library are structured as following

├─ projects
├─ library
│   ├─ axi_ad6676
│   ├─ axi_ad9122
│   ├─ axi_ad9144
│   ·
│   ├─ common
│   ├─ interfaces
│   ├─ scripts
│   ├─ util_pack
│   ·
│   └ Makefile

The library folder contains all the IP cores and common modules. An IP, in general, contains Verilog files, which describe the hardware logic, constraint files, to ease timing closure, and Tcl scripts, which generate all the other files required for IP integration (*_ip.tcl for Vivado and *_hw.tcl for Quartus) .

Regarding Vivado, all the IPs must be 'packed' before being used in a design. To find more information about how to build the libraries please visit the Building & Generating programming files section.

Repository Releases and Branches

The repository may contain multiple branches and tags. The master branch is the development branch (latest sources, but not stable). If you check out this branch, some builds may fail. If you are not into any kind of experimentation, you should only check out one of the release branch.

All our release branches have the following naming convention: hdl_[year_of_release]_r[1 or 2]. (e.g. hdl_2014_r2)

ADI does two releases each year when all the projects get an update to support the latest tools and get additional new features. The master branch is always synchronized with the latest release. If you are in doubt, ask us on FPGA Engineer Zone.

You can find the release notes on the Github page of the repository:

Need help?

resources/fpga/docs/git.txt · Last modified: 08 Apr 2024 14:36 by iulia Moldovan