# Check Cloud AI accelerator card health and functionality

Use the following examples to check the card health and functionality.

1. Check PCIe enumeration.

lspci | grep Qualcomm
        01:00.0 Unassigned class [ff00]: Qualcomm Device a100
        Copy to clipboard

    A PCIe enumeration failure can indicate an unsecure connection. Try re-inserting the card, or troubleshoot with a different PCIe card.
2. Check device nodes.

ls /dev/mhi*
        mhi0_QAIC_DIAG   mhi1_QAIC_DIAG  mhi2_QAIC_DIAG
        mhi0_QAIC_QDSS   mhi1_QAIC_QDSS  mhi2_QAIC_QDSS
        Copy to clipboard

    - For every card, `QAIC_DIAG`, `AIC_QDSS` nodes are created.
    - If `mhi*` folders don’t exist, check the MSI settings in the UEFI/BIOS setup.
3. Check the card health and status with `qaic-util`.

sudo /opt/qti-aic/tools/qaic-util -q | grep -e Status -e QID
        Copy to clipboard

    This example shows a system with four Cloud AI SoCs (each card has one or more SoCs based on the SKU).

> 
> 
> - `Status: Ready` indicates the card(s) is in good health.
>     - `Status: Error` indicates the respective card(s) hasn’t booted up completely.
>     - Card could still be booting. Wait for a few minutes and retry the previous command.
>     - Card error could be due to several reasons: unsupported OS/Platform or secure boot.

QID 0
          Status:Ready
        QID 1
          Status:Ready
        QID 2
          Status:Ready
        QID 3
          Status:Ready
        Copy to clipboard

4. Run a test inference workload with the `qaic-runner` CLI to check hardware and software functionality.

sudo /opt/qti-aic/exec/qaic-runner -t /opt/qti-aic/test-data/aic100/v2/1nsp/1nsp-conv-hmx/ -a 14 -n 5000 -d 0
        Copy to clipboard

    Test options include the following:

> 
> 
> - `-a` edit value based on number of NSPs in a specified QAIC device ID (QID).
>     - `-d` specify QID to run the workload on.

    Expected result:

Input file: /opt/qti-aic/test-data/aic100/v2/1nsp/1nsp-conv-hmx//user_idx0_in.bin
        
        ---- Stats ----
        
        InferenceCnt 5000 TotalDuration 15094us BatchSize 1 Inf/Sec 331257.453
        Copy to clipboard

    A positive value for `Inf/Sec` indicates that the hardware and software are functioning correctly. The `Inf/Sec` reported depends on `-a` specified in the command.

See [System management](https://docs.qualcomm.com/doc/80-92111-1/topic/models-and-workflows.html#sys-mgmt) for more information about the utilities and APIs to monitor card and SoC health.

## Next steps

- Review the steps to [install the Cloud AI accelerator cards](https://docs.qualcomm.com/doc/80-92111-1/topic/references.html#cards).
- [Download and install the Cloud AI SDKs](https://docs.qualcomm.com/doc/80-92111-1/topic/references.html#download).
- [Models, workflows, and system management](https://docs.qualcomm.com/doc/80-92111-1/topic/models-and-workflows.html#deploy-models)

Last Published: May 13, 2026

[Previous Topic
Check 32 MSI](https://docs.qualcomm.com/bundle/publicresource/80-92111-1/topics/msi.md) [Next Topic
References](https://docs.qualcomm.com/bundle/publicresource/80-92111-1/topics/references.md)