When running software or hardware emulation in the command line flow, it is necessary to create an emulation configuration file, emconfig.json, used by the runtime library during emulation. The emulation configuration file defines the device type and quantity of devices to emulate for the specified platform. A single emconfig.json file can be used for both software and hardware emulation.
To use the
to automate the creation of the emulation file, specify the target platform and
additional options in the
emconfigutil command line:
emconfigutil --platform <platform_name> [options]
At a minimum, you must specify the target platform through the
-–platform option to generate the required emconfig.json file. The specified platform must be the same as
specified during the host and hardware builds.
emconfigutil options are
provided in the following table.
||Target device||Required. Defines the target device from the specified platform.
For a list of supported devices, refer to Supported Platforms.
||Any positive integer||Optional. Specifies number of devices. The default is 1.|
||Valid directory||Optional. Specifies the output directory. When running emulation, the emconfig.json file must be in the same directory as the host executable. The default is to write the output in the current directory.|
||N/A||Optional. Specifies that intermediate files are not deleted and remain after the command is executed. The default is to remove temporary files.|
||Valid Xilinx parameters and properties.||Optional. Specifies additional parameters and
This example sets the search path for the target platforms.
||N/A||Prints command help.|
emconfigutilcommand generates the emconfig.json configuration file in the output directory or the current working directory.
$EMCONFIG_PATHvariable, or must be found in the same directory as the host executable.
The following example creates a configuration file targeting two
$emconfigutil --xilinx_u200_qdma_201910_1 --nd 2