Skip to content

analogdevicesinc/hdl

ADI HDL Logo

Build Status Build Status

GitHub Pages EngineerZone Analog Wiki


HDL Reference Designs

Analog Devices, Inc. HDL libraries and projects for various reference design and prototyping systems. This repository contains HDL code (Verilog or VHDL) and the required Tcl scripts to create and build a specific FPGA example design using the AMD Xilinx and/or Intel tool chains.

Support

The HDL is provided "AS IS". Support is only provided on EngineerZone.

If you feel you can not, or do not want to ask questions on EngineerZone, you should not use or look at the HDL found in this repository. Just like you have the freedom and rights to use this software in your products (with the obligations found in individual licenses) and get support on EngineerZone, you have the freedom and rights not to use this software and get data sheet level support from traditional ADI contacts that you may have.

There is no free replacement for consulting services. If you have questions that are best handed one-on-one engagement, and are time sensitive, consider hiring a consultant. If you want to find a consultant who is familiar with the HDL found in this repository - ask on EngineerZone.

Getting started

This repository supports reference designs for different Analog Devices boards based on AMD Xilinx and Intel FPGA development boards or standalone.

Prerequisites

or

Please make sure that you have the required tool versions.

How to build a project

For building a project (generate a bitstream), you have to use the GNU Make tool. If you're a Windows user, please checkout this page, to see how you can install this tool.

To build a project, checkout the latest release, after that just cd to the project that you want to build and run make:

cd projects/fmcomms2/zcu102
make

A more comprehensive build guide can be found under the following link: https://analogdevicesinc.github.io/hdl/user_guide/build_hdl.html

Building documentation (developer purposes only)

Click here for details on how to build the documentation and open it locally on your machine.

Ensure pip is newer than version 23.

pip install pip --upgrade

Install the documentation tools.

(cd docs ; pip install -r requirements.txt --upgrade)

Build the libraries (recommended).

(cd library ; make)

Build the documentation with Sphinx.

(cd docs ; make html)

The generated documentation will be available at docs/_build/html.

Which branch should I use?

  • If you want to use the most stable code base, always use the latest release branch.
  • If you want to use the latest, but sometimes unstable, check out the main branch.

The AMD Xilinx Vivado/Intel Quartus versions for each branch can be found here, or in the script that sets these versions, while checked out on your desired branch.

Use already built files

You can download already built files and use them as they are. For the main branch, they are available at the link inside this document. Keep in mind that the ones from the main branch are not stable all the time. We suggest using the latest release branch, see here. The files are built from main branch whenever there are new commits in HDL or Linux repositories.

⚠️ Pay attention when using already built files from the main branch, as they are not tested in hardware!

Software

In general, all the projects have no-OS (baremetal) and a Linux support. See no-OS repository or Linux repository for more information.

License

In this HDL repository, there are many different and unique modules, consisting of various HDL (Verilog or VHDL) components. The individual modules are developed independently, and may be accompanied by separate and unique license terms.

The user should read each of these license terms, and understand the freedoms and responsibilities that he or she has by using this source/core.

See LICENSE for more details. The separate license files cab be found here:

Comprehensive user guide

See HDL User Guide for a more detailed guide.