Verification

After installing the SDKs, verify that your Cloud AI hardware and software are functioning correctly.

Quick Verification Checklist

Step

Action

Expected Result

1

Verify PCIe enumeration

Qualcomm devices listed

2

Check device nodes

/dev/accel/accel* files exist

3

Check card health

Status: Ready

4

Run test inference

Positive Inf/Sec value

Verify PCIe Enumeration

lspci | grep Qualcomm

Expected output:

03:00.0 Processing accelerators: Qualcomm Device a100

Note

If no devices appear, try:

  • Re-seating the card

  • Testing with a different PCIe slot

  • Verifying PCIe power connections

Check Device Nodes

ls /dev/accel/accel*

Expected output:

/dev/accel/accel0  /dev/accel/accel1  /dev/accel/accel2  /dev/accel/accel3

One device node is created for each Cloud AI SoC.

Note

If device nodes are missing, verify MSI settings in your BIOS.

Check Card Health

/opt/qti-aic/tools/qaic-util -q | grep -e Status -e QID

Expected output:

QID 0
  Status:Ready
QID 1
  Status:Ready
QID 2
  Status:Ready
QID 3
  Status:Ready

Status meanings:

Status

Description

Ready

Card is healthy and operational

Error

Card has not booted completely

Tip

If status shows Error:

  • Wait a few minutes and retry (card may still be booting)

  • Check for unsupported OS/platform

  • Verify secure boot settings

Run Test Inference

Execute a test workload to verify hardware and software integration:

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

Command options:

  • -t - Path to test data

  • -a - Number of NSPs in the target QID

  • -n - Number of iterations

  • -d - QID to run the workload on

Expected output:

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

A positive Inf/Sec value confirms that hardware and software are functioning correctly.

Troubleshooting

No Qualcomm devices in lspci

  • Reseat the PCIe card

  • Try a different PCIe slot

  • Check power connections to the card

  • Verify card compatibility with your motherboard

Missing /dev/accel nodes

  • Enable MSI in BIOS (Intel VT-d or AMD IOMMU)

  • Verify 32 MSIs are available (see MSI configuration)

  • Reinstall Platform SDK

Status: Error on card

  • Allow more time for boot (up to 5 minutes)

  • Check kernel compatibility

  • Review system logs: dmesg | grep qaic

  • Verify secure boot configuration

Low Inf/Sec in test

  • Adjust -a parameter to match your card’s NSP count

  • Check for thermal throttling

  • Verify PCIe link speed: lspci -vvv -s <device> | grep LnkSta

Next Steps

Your Cloud AI system is ready. Continue to: