Main Content

hdlsetuphlstoolpath

Set up system environment to access High-Level Synthesis (HLS) software

Since R2022a

collapse all in page

Syntax

hdlsetuphlstoolpath("ToolName","Cadence Stratus","ToolPath",synthesisToolPath,"SimulationToolPath",simulationToolPath)
hdlsetuphlstoolpath("ToolName","Xilinx Vitis HLS","ToolPath",synthesisToolPath)
hdlsetuphlstoolpath("ToolName","SystemC","SystemCIncludePath",systemCIncludePath,"SystemCLibraryPath",systemCLibraryPath)

Description

hdlsetuphlstoolpath("ToolName","Cadence Stratus","ToolPath",synthesisToolPath,"SimulationToolPath",simulationToolPath) adds Cadence Stratus as a third-party HLS tool to your system path. It sets up the system environment variables for the synthesis tool. To configure one or more supported third-party HLS tools to use with HDL Coder™, use the hdlsetuphlstoolpath function. You cannot set up third-party HLS tools in Simulink® Online™.

Before opening the HDL Workflow Advisor, add the tool to your system path. If you already have the HDL Workflow Advisor open, see Add Synthesis Tool for Current HDL Workflow Advisor Session. HDL Workflow Advisor is not available in Simulink Online.

For Cadence Stratus, the supported target language is SystemC.

example

hdlsetuphlstoolpath("ToolName","Xilinx Vitis HLS","ToolPath",synthesisToolPath) adds Xilinx Vitis HLS as a third-party HLS tool to your system path. It sets up the system environment variables for the synthesis tool. To configure one or more supported third-party HLS tools to use with HDL Coder, use the hdlsetuphlstoolpath function. You cannot set up third-party HLS tools in Simulink Online.

For Xilinx Vitis HLS, the supported target language is SynthesizableC++.

example

hdlsetuphlstoolpath("ToolName","SystemC","SystemCIncludePath",systemCIncludePath,"SystemCLibraryPath",systemCLibraryPath) creates system environmental variables to set up the SystemC™ library. MATLAB® uses these environmental variables MATLAB to simulate the generated HLS code.

example

Examples

collapse all

The following command sets the synthesis tool path to point to an installed Cadence® Stratus executable file. You must have already installed Cadence Stratus version 21.2 or above.

hdlsetuphlstoolpath("ToolName","Cadence Stratus","ToolPath","/usr/cadence/stratus/bin/",...
 "SimulationToolPath","/usr/cadence/xcel/tools/bin");

To check your Cadence Stratus synthesis tool set up in MATLAB, launch the tool by using this command:

!stratus_ide

The following command sets the synthesis tool path to point to an installed Xilinx Vitis HLS executable file. You must have already installed Xilinx Vitis HLS version 2023.1.

hdlsetuphlstoolpath("ToolName","Xilinx Vitis HLS","ToolPath","/usr/Vivado/2023.1/Vitis_HLS/2023.1/bin");

To check your Vitis HLS synthesis tool set up in MATLAB, launch the tool by using this command:

!vitis_hls

You must have SystemC 2.3.3 installed.

To setup SystemC library in your Linux® platform, use this command in the MATLAB Command Window.

hdlsetuphlstoolpath("ToolName","SystemC","SystemCIncludePath",...
"/usr/local/systemc-2.3.3/include","SystemCLibraryPath","/usr/local/systemc-2.3.3/lib-linux64");

Use this command to set up the SystemC library in the Windows® platform.

hdlsetuphlstoolpath("ToolName","SystemC","SystemCIncludePath","C:\systemc-2.3.3\include",...
        "SystemCLibraryPath","C:\systemc-2.3.3\lib\win64\Release");

Input Arguments

collapse all

Full path to the synthesis tool executable or batch file, specified as a character vector.

Example: "/usr/cadence/stratus/bin/"

Full path to the simulation tool executable, specified as a character vector.

Example: '/usr/cadence/xcelium/tools/bin'

Note

For Cadence Stratus supported simulation tool is Xcelium™.

Full path to the SystemC include file, specified as a character vector. The systemc.h header file must be present in the specified SystemC include directory.

Example: '/usr/local/systemc-2.3.3/include'

Full path to the SystemC library file, specified as a character vector. The libsystemc.a in Linux or systemc.lib in Windows header file must be present in the specified SystemC library directory.

Example: "/usr/local/systemc-2.3.3/lib-linux64" (Linux)

Example: "C:\systemc-2.3.3\lib\win64\Release" (Windows)

Note

You can change the include and library file paths as per your installed location.

Tips

  • The hdlsetuphlstoolpath function changes the system path and system environment variables for only the current MATLAB session. To execute hdlsetuphlstoolpath programmatically when MATLAB starts, add hdlsetuphlstoolpath to your startup.m script.

Version History

Introduced in R2022a

expand all

See Also

|

Topics