====== Hardware/Software Co-Design How-To ======

This page contains supplementary material for supporting the Hardware/Software Co-Design course and is open to the public. **This does not replace the official course page in Fénix!**

----

===== Install Vitis Unified Suit =====

General instructions on how to correctly install Vitis and add Digilent's board files can be found [[https://digilent.com/reference/programmable-logic/guides/installing-vivado-and-vitis|here]].

==== Common Issues ====

  - **Vitis installation on Linux hangs at generating installed device list.** Install the following libraries: ''libncurses5'', ''libtinfo5'', ''libncurses5-dev'', ''libncursesw5-dev''. (Original post [[https://support.xilinx.com/s/question/0D52E00006iHjbcSAC/vivado-20211-installation-hangs-at-generating-installed-device-list?language=en_US|here]])
  - **Export IP fails**. Follow the instructions [[https://support.xilinx.com/s/article/76960?language=en_US|here]] to apply the patch that solves the known bug.
  - **Generate HDL wrapper hangs.** Change syntax checker from Sigasi to Vivado. (Original post [[https://support.xilinx.com/s/question/0D52E00006nZOwpSAG/creating-hdl-wrapper-never-stops?language=en_US|here]])
  - **Vitis IDE crashes during debug session.** In certain systems, using Vitis IDE's integrated terminal to communicate with the development board through serial causes Vitis IDE to crash. To avoid this, use a third-party serial client such as ''minicom'', ''screen'', or ''PuTTY''.