Troubleshooting; Vivado Issues; Vitis Issues; Jtag Connection Issues - Enclustra Mars AX3 User Manual

5 Troubleshooting

5.1

Vivado Issues

If the changes in the block design (including licenses for special IPs) are not propagated into im-
plementation, open the Hierarchy tab in Vivado and regenerate the block design files:
1. Right click on the block design file (.bd)
2. Click on Reset Output Products
3. Click on Generate Output Products
5.2

Vitis Issues

If the platform generation in Vitis is not successful or the generated platform is not selectable for
applications:
1. Close Vitis
2. Delete the workspace folder
3. Restart Vitis and try creating the platform again.
5.3

JTAG Connection Issues

If the JTAG cable is not detected, the following steps should be followed:
1. Make sure that the hardware configuration is made according to Section 3.2
2. If built-in JTAG is used, check that the FTDI device is configured to Xilinx JTAG mode. This
can be done using the Enclustra MCT software [5]. More information on the Xilinx JTAG mode
configuration on the Mars PM3 base board can be retrieved from the Mars PM3 base board
user manual [4].
3. Check that only one JTAG adapter is active and connected to the hardware at a given moment.
Make sure that you are not using both built-in JTAG and Xilinx Platform Cable USB.
4. Remove the USB connection and the power supply from the Mars PM3 base board and close
Vitis
5. Reconnect the USB and power supply and start Vitis again
6. Check for UART Connection Issues (refer to Section 5.4)
7. Reboot the computer if the problem persists
If no device is detected, shutdown the hw_server process e.g. in the Windows Task Manager and
try again.
5.4

UART Connection Issues

If the computer is not able to recognize the USB UART on the Mars PM3 base board:
1. Check that the USB cable is connected properly
2. Check that the FTDI VCP drivers are installed
(a) Disconnect all JTAG connections
(b) Open Device Manager
(c) Universal Serial Bus controllers
enable Load VCP checkbox
(d) Reboot the computer if the COM port is still not detected
3. Reinstall the FTDI drivers if the problem persists
If the computer does not output any character in the terminal program:
1. Check that the FTDI device is set to UART mode:
(a) Download and open FT_Prog utility (this is a third party tool offered by the FTDI company
to configure FTDI devices)
D-0000-492-002
Reset
Generate OK
USB Serial Converter A/B
22 / 24
Properties Advanced tab
Version 2022.1_v1.0.2, 04.01.2023