Intel® High Level Synthesis Compiler Pro Edition: Best Practices Guide

ID 683152
Date 4/01/2024
Document Table of Contents

10. Advanced Troubleshooting

As you develop components with the Intel® HLS Compiler Pro Edition, you might encounter issues whose solution is unclear.
The issues typically fall into the following categories:
  • Your component behaves differently in simulation and emulation.
  • Your component has unexpectedly poor performance, resource utilization, or both.

(Windows only) Long Path Issues

Components kept in directories that result in a long path name might not compile properly or fail in simulation. Check your compilation log or simulation log (debug.log) to determine if the path length is a cause of the failures. Errors that indicate that a file could not be found can indicate that your paths might be too long.

The Intel® HLS Compiler uses the component name in many of the directories that it creates. Long component names can introduce long path issues even if your component is in a relatively shallow location in your directory structure.

To resolve a long path issue, try the following actions:
  • Move your component up the directory hierarchy.
  • Use a shorter name for your component.