Every troubleshooting reference lives in this directory. Start with the device error-code reference when a run fails, or jump to the environment-specific guide when the failure happens during build, test setup, or simulation.
| Document | What it covers |
|---|---|
| Device Error Codes | Runtime and CANN error classification, first-response triage, minimal reproductions, and links to focused diagnostic guides |
| Local Runtime Timeouts | Local and CI timeout defaults, override variables, and the required ordering for onboard watchdogs |
| a2a3 AICPU Shared-SO Device Fault | Diagnosing mass 507899/507018 cascades caused by an AICPU shared-library device fault |
| Sim CPU Oversubscription | Simulation hangs and false timeouts when AICPU and AICore host threads are CPU-starved |
| Document | What it covers |
|---|---|
| macOS Build and Lint Toolchain | Compiler, SDK, sysroot, and clang-tidy behavior in the macOS build pipeline |
| macOS libomp Collision | Duplicate OpenMP runtime crashes in single-process simulation CI and their mitigation |
| C++ Unit-Test gtest ABI Mismatch | Link failures caused by a system GoogleTest library built with the old libstdc++ ABI |
| Document | What it covers |
|---|---|
| DFX and Profiling | Timing, traces, dependencies, and resource-usage evidence for runs that complete or make partial progress |
| Testing | Test types, commands, platform selection, and failure-reproduction workflows |
| Debug a Failed Run | User-facing first-response path from the surfaced error to the focused guides in this directory |