The canonical Troubleshooting guide lives in the AkiraSDK submodule.
To avoid duplicating content that evolves with the SDK, this guide is maintained in AkiraSDK. Refer to it directly — the local copy in the submodule is always in sync.
Where to Find Troubleshooting Guides
| Location | Path |
|---|---|
| Online (canonical) | github.com/ArturR0k3r/AkiraSDK — TROUBLESHOOTING.md |
| Local submodule | AkiraSDK/docs/TROUBLESHOOTING.md |
Topics Covered
- Display Issues — Blank screen, wrong colors, flickering
- GPIO Problems — Reads returning incorrect values, output not toggling
- Sensor Issues — No data, sampling rate, calibration
- RF Communication — Init failures, send/receive errors
- Timer Issues — Incorrect elapsed time, timer drift
- Storage Problems — File not found, write failures, quota exceeded
- BLE Issues — Connection failures, characteristic write errors
- HID Problems — Keyboard not recognized, mouse drift
- Network Issues — Connection timeouts, socket errors
- Memory / Crash — Stack overflows, heap exhaustion, OOB traps
- Build Errors — Compiler, linker, manifest embedding errors
AkiraOS-Level Troubleshooting
For issues related to the AkiraOS firmware itself (build failures, flash errors, boot problems), see:
Related Documentation
- SDK API Reference — Complete function reference
- Best Practices — Patterns for reliable apps
- Building WASM Apps — Build toolchain and workflow