This version (13 Sep 2022 10:45) was approved by Michael Bradley.The Previously approved version (31 May 2022 16:38) is available.
Table of Contents
Troubleshooting Guide for ADI Kuiper Linux for ACE Evaluation
If you are having problems connecting to an ADI Product Evaluation Board on a supported Linux platform with ACE, the following suggestions may help. If your issue is not addressed here, please search in the EngineerZone forums, and ask a question in the corresponding product support forum.
Ensure your Product Evaluation Board is supported by ADI Kuiper Linux for ACE Evaluation. You can search for Product Evaluation board information using en/design-center/evaluation-hardware-and-software/evaluation-boards-kits.html
You should also make sure your software stack is up to date:
- ADI Kuiper Linux for ACE Evaluation SD Card - The latest release and how to create an SD card image is here: ADI Kuiper Linux for ACE Evaluation
- ACE Application - Use the 'Check For Updates' option in the ACE sidebar
- Libiio Wrapper - Can be updated/installed from within ACE, see ACE Software
- ACE Evaluation Board Plug-ins - Open the 'Plug-in Manager' using the option in the ACE sidebar, and select 'Available Updates' and click refresh. Use the search field (magnifying glass) to filter relevant updates.
ZedBoard Hardware
LD13/POWER Green LED does not turn on
This LED indicates that the 12V is present and SW8/POWER is turned on.
Solution: Check the mains power adapter is properly plugged in and mains power is turned on, and switch SW8/POWER is in the 'ON' position.
LD12/DONE Blue LED does not turn on
This LED indicates that the FPGA has been programmed during the boot process. If this LED does not turn on, it indicates the the FPGA has not been programmed.
Solution: Check the boot mode jumpers are set to select the SD Card as the primary boot device, per the table below, and that the SD Card is correctly orientated and fully inserted into the card slot on the underside of the board.
| Jumper | JP11/MIO6 | JP10/MIO5 | JP9/MIO4 | JP8/MIO3 | JP7/MIO2 |
|---|---|---|---|---|---|
| Position | GND | 3V3 | 3V3 | GND | GND |
The SD card image may not be correct or may have been corrupted. Follow the instruction here to re-image the card: ADI Kuiper Linux for ACE Evaluation
LD7 Red LED does not flash
LD7 Red LED should start to flash 20-30 seconds after powering on the Zedboard, to indicate that the boot process is complete, and the system is ready for use.
Solution: The SD card image may not be correct or may have been corrupted. Follow the instruction here to re-image the card: ADI Kuiper Linux for ACE Evaluation
LD11 Orange LED is Continuously on
LD11 Orange LED is the USB UART activity light that flashes on to indicate when there is serial traffic on the UART. In some cases, typically when the board is being rebooted, this LED may remain on continuously, that corresponds to the board failing to reboot.
Solution: A physical reset of the ZedBoard is required, either by pressing BTN6/PS-RST or by power cycling with SW8/POWER.
No USB Gadget visible in Device Manager
A correctly configured host controller board running the ADI Kuiper Linux for ACE Evaluation image, should be visible in the Windows Device Manager as a number of USB gadgets. Looking at the hardware shown under the 'USB Serial Bus Devices' node in the Windows Device Manager, there should be an 'IIO' child node, and under the 'Ports (COM & LPT) one or more serial ports that are part of a composite USB device. Selecting one of these devices, and choosing the View » Devices by Connection menu option will show them as group.
Solution: If the IIO and serial devices are not shown, ensure the USB micro-B cable is connected to J13/USB_OTG port on the Zedboard. If one or more of these USB gadgets have warning icon overlays, then the drivers may need to be installed and/or updated. Latest drivers are available here and a link to the version provided with ACE can be found by pressing the 'Help' button, and looking in the 'Application Resources » IIO Resources' panel section.
ACE Software
Evaluation Board does not appear in 'Attached Hardware' view
No button appears in the 'Attached Hardware' view on the Start tab representing the Product Evaluation Board attached to the host controller board.
Solution: Check that the LibIIO wrapper program is installed and running by looking in the Windows Taskbar for a minimized Console type application, that when opened should look like this:
If the Libiio Wrapper program is running, click the 'Refresh Attached Hardware' button. Unplugging and re-plugging a USB device may also help.
If the Libiio Wrapper program is not running in the taskbar it may need to be installed and/or ACE restarted. Assuming an up-to-date version of ACE, installation can be done from within ACE by selecting 'Help' from the ACE sidebar, expanding the Application Resources section, and using the Libiio Wrapper installer link in the IIO Resources section.
More recent versions of ACE can prompt the user to install the Libiio wrapper if it is not already installed when a supported controller board running IIO software is detected.
No matching plug-in found or Generic IIO plug-in used
A button appears in the 'Attached Hardware' view on the Start tab representing the Product Evaluation Board attached to the host controller board, but on double-clicking the button ACE reports that no matching plug-in is installed or a generic IIO plug-in is opened instead.
Solution: If the board is supported in ACE for used with the ADI Kuiper Linux for ACE Evaluation image, then using the plug-in manager search for the board plug-in and install it from within ACE. If the board is not supported, but is running an IIO software stack, then the Generic IIO board plug-in may be used to provide basic functionality.
resources/tools-software/linux-software/adi-kuiper_ace_troubleshooting.txt · Last modified: 13 Sep 2022 10:45 by Michael Bradley