Troubleshooting - Troubleshooting - 2026.1 English - UG1864

Vitis Functional Simulation User Guide (UG1864)

Document_ID
UG1864
Release_Date
2026-06-23
Version
2026.1 English
Symptom Cause and Fix
vfs or varray not found Source <Vitis_install_path>/settings64.{sh,csh} before launching MATLAB.
bfloat16 is not supported for HLS Kernels bfloat16 / bfloat8 / mx* are AIE-ML only. Use an HLS-compatible type (int*, float, half, fi, …).
Number of input vitis arrays does not match the number of input ports Use kernel.getInputSpec() to confirm the expected port count.
Unsupported operation when using + - .* ./ on a varray Arithmetic is not defined on varray objects. Cast to a native MATLAB type first (int32(a) + int32(b)). Refer to MATLAB varray : Arithmetic.
AXI4-Stream sideband mismatch The port expects or rejects sideband signals. Refer to AXI4-Stream Sideband (axis).
mexhost errors / missing PID Check with vfs.getpid(). In debug mode, restart MATLAB only if mexhost itself is stuck.