Prerequisites:
Python bin to be used for config_helper.py:
setenv PATH "<your-Vitis-install-path>/lin64/2025.1/Vitis/aietools/tps/lnx64/python-3.13.0/bin:$PATH"
DSPLIB IPs can be configured using a Python script called config_helper.py. The config_helper.py script assists users in establishing a valid configuration for any DSPLIB IP. This script communicates with the user through the console interface.
The config helper will print either a legal set or a legal range for a parameter, asking the user to input a value. If the parameter is set to a legal value, the config helper will move to the next parameter on the parameter list of the chosen IP. If the given value is not legal, the config helper will return an error and ask the user to choose a legal value from the legal set/range. The user can go back to the previous parameter by entering z or Z and can exit at any time.
Once all the parameters are set, the config helper will output a top-level file. For AI Engine IPs, a graph_<ip_name>_<instance_name>.txt file will be generated. This contains a top-level graph class to instantiate the IP. The user can use the PRINT_GRAPH option to print the graph on the console. For VSS IPs, a cfg_<ip_name>_<instance_name>.cfg file will be generated. Note that the PART parameter in the VSS config_helper is a representation of the device that the VSS generator supports rather than being the exact part name that is supported. Please accept the default part name for the device that you would like to support and extract the other parameters using config_helper. In the output cfg file that the config_helper creates, you can then edit the part name to any other part of the same device type before building the VSS.
The user can use the .cfg file as the input to the top-level VSS Makefile. If the output top-level file is not needed, the user can call config_helper.py with the NO_INSTANCE argument.