HDL Git repository#

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

ADI HDL 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.

Note

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

Note

If you want to contribute to our repository, check out this guide Contributing to HDL repository.

Folder structure#

The root of the HDL repository has the following structure:

.
+-- .github
+-- docs
+-- library
+-- projects
+-- scripts
+-- Makefile
+-- README.md
+-- LICENSE

The repository is divided into 5 separate sections:

  • .github with all our automations regarding coding checks, GitHub actions

  • docs with our GitHubIO documentation and regmap source files

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

  • projects with all the currently supported projects

  • scripts with our environment scripts that set tools versions, etc.

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 follows#

.
+-- docs
+-- library
+-- projects
¦   +-- ad40xx_fmc
¦   +-- ad4110
¦   .
¦   +-- common
¦   +-- dac_fmc_ebz
¦   ¦   +-- common
¦   ¦   +-- a10soc
¦   ¦   +-- vcu118
¦   ¦   .
¦   ¦   +-- zcu102
¦   ¦   +-- Makefile
¦   ¦   +-- Readme.md
¦   .
¦   +-- scripts
¦   .
¦   +-- Readme.md
¦   +-- Makefile
¦   +-- wiki_summary.sh
+-- README.md

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 follows#

.
+-- library
¦   +-- ad463x_data_capture
¦   +-- axi_ad3552r
¦   +-- axi_ad4858
¦   +-- axi_ad5766
¦   +-- axi_ad7606x
¦   +-- axi_ad7616
¦   +-- axi_ad7768
¦   +-- axi_ad777x
¦   +-- axi_ad9122
¦   .
¦   +-- common
¦   .
¦   +-- interfaces
¦   +-- jesd204
¦   +-- scripts
¦   .
¦   +-- Makefile
+-- projects
+-- README.md

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) .

Note

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 main 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 main branch is always synchronized with the latest release.** If you are in doubt, ask us on EngineerZone.

Note

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

https://github.com/analogdevicesinc/hdl/releases

The latest version of tools used on main can be found at: scripts/adi_env.tcl (required_vivado_version and required_quartus_version variables). For Intel Quartus Standard, the version is specified in each project that uses it, depending on the carrier.