Main Content

Supported EDA Tools and Hardware

Cosimulation Requirements

To get started, see Set Up MATLAB-HDL Simulator Connection or Start HDL Simulator for Cosimulation in Simulink.

Cadence Xcelium Requirements

MATLAB® and Simulink® support Cadence® verification tools using HDL Verifier™. Only the 64-bit version of Xcelium™ is supported for cosimulation. Use this recommended version, which has been fully tested against the current release:

  • Xcelium 2022.09

The HDL Verifier shared libraries (liblfihdls*.so, liblfihdlc*.so) are built using the gcc included in the Cadence Xcelium simulator platform distribution. If you are building your own application, choose the version of the library that matches the version of gcc that you are using. See the HDL simulator documentation for more details about how to build and link your own applications.

Mentor Graphics Questa and ModelSim Usage Requirements

MATLAB and Simulink support Mentor Graphics® verification tools using HDL Verifier. Use the following recommended versions. Each version has been fully tested against the current release:

  • Questa® Core/Prime 2023.2

  • ModelSim® PE 2023.2

Note

HDL Verifier does not support these versions of ModelSim:

  • ModelSim ME

  • ModelSim-Intel® FPGA Edition

  • ModelSim-Intel Starter Edition

  • QuestaSim-Intel FPGA Edition

  • QuestaSim-Intel Starter Edition

Vivado Simulator Requirements

MATLAB and Simulink support Xilinx® Vivado® verification tool using HDL Verifier. Use this recommended version, which has been fully tested against the current release:

  • Xilinx Vivado 2023.1.2

FPGA Verification Requirements

Xilinx Usage Requirements

MATLAB and Simulink support Xilinx design tools using HDL Verifier. Use the FPGA-in-the-loop (FIL) tools with these recommended versions:

  • Xilinx Vivado 2023.1.2

  • Xilinx ISE 14.7

    Note

    Xilinx ISE is required for FPGA boards in the Spartan®-6, Virtex®-4, Virtex-5, and Virtex-6 families.

For tool setup instructions, see Set Up FPGA Design Software Tools.

Intel Quartus Usage Requirements

MATLAB and Simulink support Intel design tools using HDL Verifier. Use the FIL tools with these recommended versions:

  • Intel Quartus® Prime Standard 22.1.1

  • Intel Quartus Prime Pro 22.4 (supported for Intel Arria® 10, Cyclone® 10 GX, and Intel Agilex® 7 only)

  • Intel Quartus II 13.1 (supported for Intel Cyclone III boards only)

For tool setup instructions, see Set Up FPGA Design Software Tools.

Microchip Usage Requirements

MATLAB and Simulink support Microchip design tools using HDL Verifier. Use the FIL tools with these recommended versions:

  • Microchip Libero® SoC v2022.1

These features require a gold or platinum license from Microchip. For tool setup instructions, see Set Up FPGA Design Software Tools.

FPGA Board Connections

Additional boards can be custom added with the FPGA Board Manager. See Supported FPGA Device Families for Board Customization.

JTAG Connection.  You can run FPGA-in-the-loop, FPGA data capture, or AXI manager over a JTAG cable to your board. However, each feature requires exclusive use of the JTAG cable, so you cannot run more than one feature at the same time. To allow other tools access to the JTAG cable, such as programming the FPGA, and Xilinx ChipScope, you must discontinue the JTAG connection in MATLAB. To release the JTAG cable:

  • FPGA-in-the-loop — Close the Simulink model, or call the release method of the System object™.

  • FPGA data capture — Close the FPGA Data Capture tool, release the System object, or close the Simulink model.

  • AXI manager — Call the release method of the object.

However, the nonblocking capture mode enables you to simultaneously use FPGA data capture and AXI manager, which share a common JTAG interface. For more information, see Simultaneous Use of FPGA Data Capture and AXI Manager.

VendorRequired HardwareRequired Software
Intel

USB Blaster I or USB Blaster II download cable

  • USB Blaster I or II driver

  • For Windows® operating systems: Quartus Prime executable directory must be on system path.

  • For Linux® operating systems: versions below Quartus II 13.1 are not supported. Quartus II 14.1 is not supported. Only 64-bit Quartus is supported. Quartus library directory must be on LD_LIBRARY_PATH before starting MATLAB. Prepend the Linux distribution library path before the Quartus library on LD_LIBRARY_PATH. For example, /lib/x86_64-linux-gnu:$QUARTUS_PATH.

Xilinx

Digilent® download cable

  • If your board has an onboard Digilent USB-JTAG module, use a USB cable

  • If your board has a standard Xilinx 14 pin JTAG connector, use with HS2 or HS3 cable from Digilent

  • For Windows operating systems: Xilinx Vivado executable directory must be on system path.

  • For Linux operating systems: Digilent Adept 2. For the installation steps, see Install Digilent Adept 2 Runtime.

FTDI USB-JTAG cable

  • Supported for boards with onboard FT4232H, FT232H, or FT2232H devices implementing USB-to JTAG

Install these D2XX drivers.

  • For Windows operating systems: 2.12.36.4 (64 bit)

  • For Linux operating systems: 1.4.27 (64 bit)

For the installation guide, see D2XX Drivers from the FTDI Chip website.

MicrochipJTAG connection not supported

Note

  • The Xilinx Platform Cable USB II is not supported for FPGA verification.

  • When simulating your FPGA design through Digilent JTAG cable with Simulink or MATLAB, you cannot use any debugging software that requires access to JTAG, such as Vivado Logic Analyzer.

Ethernet Connection.  You can run FPGA-in-the-loop, FPGA data capture, or AXI manager over an Ethernet connection. To use FPGA data capture and AXI manager over an Ethernet connection in a single HDL project, connect the FPGA data capture and AXI manager IPs to the same Ethernet MAC Hub IP using different port addresses.

On Zynq® SoC devices you can access the Ethernet interface only through the processing system (PS). To implement Ethernet communication between the host and the hardware board, operation system (OS) and related software applications must run on the PS. Use the hardware setup app to guide you in setting up the SD card and boot the board with a compatible OS.

Required HardwareSupported InterfacesaRequired Software
  • Gigabit Ethernet card

  • Cross-over Ethernet cable

  • FPGA board with supported Ethernet connection

  • SD card (for Zynq SoC devices)

  • Gigabit Ethernet — GMII

  • Gigabit Ethernet — RGMII

  • Gigabit Ethernet — SGMII

  • Ethernet — MII

  • Ethernet — RMII

There are no software requirements for an Ethernet connection, but ensure that the firewall on the host computer does not prevent UDP communication.

a The HDL Verifier Support Package for Microchip FPGA Boards supports only SGMII interfaces.

Note

  • FPGA data capture and AXI manager support GMII, MII, and SGMII interfaces only.

  • RMII is supported with Vivado versions older than 2019.2.

  • Ethernet connection to Virtex-7 VC707 is not supported for Vivado versions older than 2013.4.

  • AXI manager and FPGA data capture in HDL Workflow Advisor support programmable logic (PL) Ethernet only. PS Ethernet is not supported.

  • FPGA data capture in HDL Workflow Advisor does not support the SGMII interface.

USB Ethernet Connection.  You can run FPGA-in-the-loop or AXI manager over a USB Ethernet connection.

Use a USB 3.0 or USB 2.0 cable based on the type of USB cable your hardware board supports. If you use a USB 2.0 cable for a board that supports USB 3.0, the cable provides lesser data throughput.

Required HardwareRequired Software
USB 3.0 or USB 2.0 cable

Supported FPGA Devices for FPGA Verification

HDL Verifier supports FIL simulation, FPGA data capture, and AXI manager on the devices shown in the following table. The board definition files for these boards are in the Download FPGA Board Support Package. You can add other FPGA boards for use with FIL, FPGA data capture, and AXI manager with FPGA board customization (FPGA Board Customization).

Device FamilyBoardEthernetJTAGPCI ExpressUSB EthernetComments
FILFPGA Data CaptureAXI ManagerFILFPGA Data CaptureAXI ManagerFILaFPGA Data CaptureAXI ManagerFILAXI Manager

Xilinx Artix®-7

Digilent Nexys™ 4 Artix-7

        
Artix-7 35T Arty FPGA Evaluation Kit      

Xilinx Kintex®-7

Kintex-7 FPGA KC705 Evaluation Kit    

Xilinx Kintex UltraScale™

Kintex UltraScale FPGA KCU105 Evaluation Kit

     

Xilinx Kintex UltraScale+™

Kintex UltraScale+ FPGA KCU116 Evaluation Kit

      For more information, see PCI Express AXI Manager.

Xilinx Spartan-6

Spartan-6 SP605 Development Board           
Spartan-6 SP601 Development Board           
XUP Atlys Spartan-6           

Xilinx Spartan-7

Digilent Arty S7-25         

Xilinx Versal®

Versal AI Core Series VCK190 Evaluation Kit

        

Xilinx Virtex UltraScale

Virtex UltraScale FPGA VCU108 Evaluation Kit

     

Xilinx Virtex UltraScale+

Virtex UltraScale+ FPGA VCU118 Evaluation Kit

     

Xilinx Virtex-7

Virtex-7 FPGA VC707 Evaluation Kit    
Virtex-7 FPGA VC709 Connectivity Kit       

Xilinx Virtex-6

Virtex-6 FPGA ML605 Evaluation Kit           

Xilinx Virtex-5

Virtex ML505 Development Board           
Virtex ML506 Development Board           
Virtex ML507 Development Board           
Virtex XUPV5–LX110T Development Board           

Xilinx Virtex-4

Virtex ML401 Development Board          

Note

Support for Virtex-4 device family will be removed in a future release.

Virtex ML402 Development Board          
Virtex ML403 Development Board          

Xilinx Zynq

Zynq-7000 SoC ZC702 Evaluation Kit

    

This board supports PS Ethernet.

Zynq-7000 SoC ZC706 Evaluation Kit    

This board supports PS Ethernet.

ZedBoard™    

Use the USB port marked "PROG" for programming.

This board supports PS Ethernet.

ZYBO™ Zynq-7000 Development Board

         
PicoZed™ SDR Development Kit         
MiniZed™          

Xilinx Zynq UltraScale+

Zynq UltraScale+ MPSoC ZCU102 Evaluation Kit

    

This board supports PS Ethernet.

Zynq UltraScale+ MPSoC ZCU104 Evaluation Kit

         

Zynq UltraScale+ MPSoC ZCU106 Evaluation Kit

         

Zynq UltraScale+ RFSoC ZCU111 Evaluation Kit

      

This board supports PS Ethernet.

Zynq UltraScale+ RFSoC ZCU216 Evaluation Kit

    

This board supports PS Ethernet.

Intel Agilex 7Intel Agilex 7 FPGA I-Series Transceiver-SoC Development Kit          

This board supports PS Ethernet.

Intel Arria II

Arria II GX FPGA Development Kit      

Intel Arria V

Arria V SoC Development Board - Rev. C        
Arria V Starter Kit      

Intel Arria 10

Arria 10 SoC Development Kit      

For Ethernet connection, use Quartus Prime 16.1 or newer.

Arria 10 GX FPGA Development Kit    

For Ethernet connection, use Quartus Prime 16.1 or newer.

Quartus Prime 18.0 is not recommended for Arria 10 GX over PCI Express®.

Intel Cyclone IV

Cyclone IV GX FPGA Development Kit     
DE2-115 Development and Education Board      The Altera® DE2-115 FPGA development board has two Ethernet ports. FIL uses only Ethernet 0 port. Make sure that you connect your host computer with the Ethernet 0 port on the board via an Ethernet cable.
BeMicro SDK       

Intel Cyclone III

Cyclone III FPGA Starter Kit       

Altera Cyclone III boards are supported with Quartus II 13.1

Note

Support for Cyclone III device family will be removed in a future release.

Cyclone III FPGA Development Kit      
Altera Nios II Embedded Evaluation Kit, Cyclone III Edition      

Intel Cyclone V

Cyclone V GX FPGA Development Kit      
Cyclone V SoC Development Kit        Rev. C or D
Cyclone V GT FPGA Development Kit     
Terasic Atlas-SoC Kit / DE0-Nano SoC Kit        
Arrow® SoCKit Development Kit        

Intel Cyclone 10 LP

Altera Cyclone 10 LP Evaluation Kit

        

Intel Cyclone 10 GX

Altera Cyclone 10 GX FPGA Development Kit

      

Must be used with Quartus Prime Pro.

Intel MAX® 10

Arrow DECA MAX 10 FPGA Evaluation Kit

       

Intel Stratix® IV

Stratix IV GX FPGA Development Kit      

Intel Stratix V

DSP Development Kit, Stratix V Edition
     

Microchip Polarfire®

Microchip Polarfire Evaluation Kit

          See Installing Microchip Polarfire Evaluation Kit.

Microchip RTG4®

RTG4-DEV-KIT

           

Microchip SmartFusion® 2

Microchip SmartFusion 2 SoC FPGA Advanced Development Kit

          See Installing Microchip SmartFusion 2 SoC FPGA Advanced Development Kit.

a FIL over PCI Express connection is supported only for 64-bit Windows operating systems.

Limitations

  • For FPGA development boards that have more than one FPGA device, only one such device can be used with FIL.

FPGA Board Support Packages.  The FPGA board support packages contain the definition files for all supported boards. You can download one or more vendor-specific packages. To use FIL, download at least one of these packages, or customize your own board definition file. See Create Custom FPGA Board Definition.

To see the list of HDL Verifier support packages, visit HDL Verifier Supported Hardware. To download an FPGA board support package:

  • On the MATLAB Home tab, in the Environment section, click Add-Ons > Get Hardware Support Packages.

Supported FPGA Device Families for Board Customization

HDL Verifier supports the following FPGA device families for board customization; that is, when you create your own board definition file. See FPGA Board Customization. PCI Express is not a supported connection for board customization.

Note

The HDL Verifier Support Package for Microchip FPGA Boards does not support board customization.

Device FamilyRestrictions
XilinxArtix 7 
Kintex 7 

Kintex UltraScale

 

Kintex UltraScale+

 
Spartan 6

Ethernet PHY RGMII is not supported.

Spartan 7 
Virtex 4

Note

Support for Virtex-4 device family will be removed in a future release.

Virtex 5 
Virtex 6 
Virtex 7

Supports Ethernet PHY SGMII only.

Virtex UltraScale

 

Virtex UltraScale+

 
Zynq 7000 

Zynq UltraScale+

 
IntelArria II 
Arria V 
Arria 10  
Cyclone III

Note

Support for Cyclone III device family will be removed in a future release.

Cyclone IV 
Cyclone V 
Cyclone 10 LP 
Cyclone 10 GX 
MAX 10  
Stratix IV 
Stratix V 

UVM and DPI Component Generation Requirements

UVM and DPI component generation supports the same versions of Cadence Xcelium and Mentor Graphics Questa and ModelSim as for cosimulation. You can generate a DPI component for use with either 64-bit or 32-bit Xcelium.

In addition, UVM and DPI Component generation also supports:

  • Synopsys® VCS® mT-2022.06-SP2

Note

When you run a DPI component in ModelSim 10.5b on Debian® 8.3, you may encounter a library incompatibility error:

** Warning: ** Warning: (vsim-7032) The 64-bit glibc RPM 
does not appear to be installed on this machine.  Calls to gcc may fail.
** Fatal: ** Error: (vsim-3827) Could not compile 'STUB_SYMS_OF_fooour.so':
To avoid this issue, on the Code Generation pane in Configuration Parameters, try these options:

  • Set the Build configuration to Faster Runs.

  • Or, set the Build configuration to Specify and specify the compiler flag -O3.

UVM generation also requires a UVM Reference Implementation, available for download from the UVM standard website. This feature is tested with the default shipped version for each supported simulator.

TLM Generation Requirements

With the current release, TLMG includes support for:

  • Compilers:

    • Visual Studio®: VS2008, VS2010, VS2012, VS2013, VS2015, and VS2017

    • Windows 7.1 SDK

    • gcc 6.3

  • SystemC™:

    • SystemC 2.3.1 (TLM included)

      You can download SystemC and TLM libraries at https://accellera.org. Consult the Accellera Systems Initiative website for information about how to build these libraries after downloading.

  • System C Modeling Library (SCML):

Troubleshooting

Path exceeds Windows limit.  When executing the HDL Verifier product examples on a Windows machine there can be errors caused by a Windows path limit of 260 characters. Sometimes the condition can be caught and you may receive an error such as the following:

Build failed because the build file name(s) exceed the Windows limit of 260 characters. Build from a working directory with a shorter path, to allow build files to be created with shorter filenames.

Often, however, the long path is created during the execution of third party tools such as Vivado or Quartus and the resulting error from those tools will seem to be unrelated. Some examples for such errors are:

  • ERROR: [Common 17-680] Path length exceeds 260-Byte maximum allowed by Windows: 
    c:\Users\user\OneDrive - MathWorks\Documents\MATLAB\Examples\R2022a\xilinxfpgaboards\
    ZynqEthernet\ethernetaximanagerzynq.srcs\sources_1\bd\design_1\ip\design_1_mig_7series_0_0\
    _tmp\/design_1_mig_7series_0_0/example_design/rtl/traffic_gen/mig_7series_v4_2_axi4_tg.v 
    Please consider using the OS subst command to shorten the path length by mapping part 
    of the path to a virtual drive letter. See Answer Record AR52787 for 
    more information. 
    Resolution: In Windows 7 or later, the mklink command can also be used to create a 
    symbolic link and shorten the path. 

  • WARNING: [Vivado 12-8222] Failed run(s) : 'clk_wiz_0_synth_1', 'simcycle_fifo_synth_1'
    wait_on_run: Time (s): cpu = 00:00:00 ; elapsed = 00:02:16 . 
    Memory (MB): peak = 1636.988 ; gain = 0.000
    # if {[get_property PROGRESS [get_runs synth_1]] != "100%"} {  
    #   error "ERROR: Synthesis failed"
    

  • Error (12006): Node instance "ident" instantiates undefined entity 
    "alt_sld_fab_altera_connection_identification_hub_171_gdd6b5i"
    Ensure that required library paths are specified correctly, 
    define the specified entity, or change the instantiation.
    If this entity represents Intel FPGA or third-party IP,
    generate the synthesis files for the IP.  

A long path may be suspected when the root folder for running the example is already fairly long, such as over 100 characters.

In both the detected and undetected long path scenarios, to avoid the errors, use one of these methods:

  • Map the example directory to a shorter letter drive alias. For example, the following will eliminate 122 characters from the path, allowing much more headroom for the 260 character limit.

    cmd> subst W: “C:\Users\janedoe\OneDrive - Personal\Documents\MATLAB\Examples\R2021b\hdlverifier\GettingStartedWithSimulinkHDLCosimExample”

  • After opening an example, copy the example directory to a directory with a short name (such as /tmp).

Unrecognized Function.  When you have more than one version of a third party tool, but only one version is licensed (or when only one version is supported by HDL Verifier), MATLAB might error out with "Unrecognized function" when calling that tool.

To make sure MATLAB opens the licensed version of your simulator you must:

  • Set the correct license variable with the path to the licence file.

  • Make sure that the Path variable points to your licensed executable version.