vmcValidate - 2024.2 English

Vitis Model Composer User Guide (UG1483)

Document ID
UG1483
Release Date
2024-11-13
Version
2024.2 English

The vmcValidate function provides a programmatic way to invoke the Vitis Model Composer code generator.

Syntax

status = vmcValidate('modelName')
status = vmcValidate('MyModel', 'MyModel_hubInfo.json')
status = vmcValidate('MyModel', 'closeProgressWindow', 1)
[status, designInfo] = vmcValidate('MyModel', ...)

Description

vmcValidate invokes the Vitis Model Composer code generator and returns a status code.

It is functionally equivalent to opening the Model Composer Hub block and clicking the Validate button.

vmcValidate is a blocking function that returns 0 when code generation completes successfully. A non-zero return code indicates an error during code generation.

Example

To programmatically select the subsystem on which to operate, you can use the vmchub_set_param function to set the SelectSubsystem property. For example:

vmchub_set_param('modelName/Vitis Model Composer Hub', 'modelName/DUT_ss',  'SelectSubsystem', 1);

Then call vmcValidate.:

vmcValidate('MyModel') uses the settings of the Model Composer Hub block present in 'MyModel'.

[status, designInfo] = vmcValidate('MyModel') additionally gives an information struct for HDL designs. In the case of AIE and HLS this struct will be empty.

status = vmcValidate('MyModel', hubParams='MyModel_hubInfo.json') uses the settings from the JSON file to generate code.

status = vmcValidate('MyModel', hubParams='MyModel_hubInfo.json', targetSubsystem='MyModel/MySubsystem') selects the subsystem for which to generate code.

status = vmcValidate('MyModel', closeProgressWindow=1) closes the progress window after the code generation is done.