Verify hardware before you trust the software

The commands now include the expected result and the failure signatures we actually saw.

OUR OBSERVATIONLast verified: 2026-09-27 · Build 1.9.37

Quick reference. The long path with checkpoints: chapter 05 of the guide.

Capture a baseline

lspci | grep -i brainchip

Expected: Four BrainChip entries when all four cards are present, behind bus 0001.

dmesg | grep akida-pcie | tail

Expected: Host DDR 16777216 bytes and a successful probe such as `probed (akd1500_3)`.

ls -l /dev/akd1500_*

Expected: `/dev/akd1500_0` … `_3` in the four-card setup.

python3 -c "import akida; print([str(d) for d in akida.devices()])"

Expected: A list like `PCIe/AKD1500/16MB/0`, `.../1`, `.../2`, `.../3`.

Known-bad signatures

Signature	Meaning	Action
`DMA wait completion timed out`	Card hung while link can remain up	PCIe remove/rescan or UI card reset.
`Error reading at 0x... errno(110)`	Same failure from runtime	Recover card; test whether fault follows card/slot.
`Camera frontend has timed out`	Camera path failure; loose CSI ribbon observed	Reseat cable, reboot, camera baseline.

sudo systemctl stop vorsa
echo 1 | sudo tee /sys/bus/pci/devices/<addr>/remove
sleep 2
echo 1 | sudo tee /sys/bus/pci/rescan
sudo systemctl start vorsa

Expected: Card probes again and returns to `akida.devices()`.