add_files

Description

Adds design source files to the current project.

The tool searches the current directory for any header files included in the design source. To use header files stored in other directories, use the -cflags option to include those directories to the search path.

Syntax

add_files [OPTIONS] <src_files>
  • <src_files> lists one or more supported source files.

Options

-blackbox <file_name.json>

Specify the JSON file to be used for RTL blackbox. The information in this file is used by the HLS compiler during synthesizing and running C and co-simulation. See Adding RTL Blackbox Functions for more information.

-cflags <string>

A string with any GCC compilation options.

- csimflags <string>

A string with any desired simulation compilation options. Flags specified with this option are only applied to simulation compilation, which includes C simulation and RTL co-simulation, not synthesis compilation. This option does not impact the -cflags option.

-tb

Specifies any files used as part of the design test bench.

These files are not synthesized. They are used when post-synthesis verification is executed by the cosim_design command.

This option does not allow design files to be included in the list of source files. Use a separate add_files command to add design files and test bench files.

Examples

Add three design files to the project.


add_files a.cpp
add_files b.cpp
add_files c.cpp

Add multiple files with a single command line.


add_files "a.cpp b.cpp c.cpp"

Use the-tb option to add test bench files to the project. This example adds multiple files with a single command, including:

  • The test bench a_test.cpp
  • All data files read by the test bench:
    • input_stimuli.dat
    • out.gold.dat
      
      add_files -tb "a_test.cpp input_stimuli.dat out.gold.dat"
      

    If the test bench data files in the previous example are stored in a separate directory (for example test_data), the directory can be added to the project in place of the individual data files.

    add_files -tb a_test.cpp
    add_files -tb test_data