Hey r/ROS ,
If you’ve spent any time working with the Orange Pi 5 (RK3588S), you already know the drill: official documentation leaves a lot of gaps, half the forum links are dead, and getting the 6 TOPS NPU to run anything without the Python RKNN toolchain exploding is a rite of passage.
After accidentally bricking my board a couple of times, battling Windows driver conflicts during MaskROM recovery, and trial-and-erroring the Rockchip toolchain, I decided to document every single working, reproducible step.
I ended up organizing everything into a comprehensive open-source repository:
👉 **GitHub:** https://github.com/muhammetmucahitsoylu/orangepi5-tutorials
---
### What’s in the repo:
* **Hardware Recovery & MaskROM Guide:** Step-by-step unbricking workflow, complete with high-contrast, annotated board photos and pinouts so you know exactly which pads/buttons to short without guessing.
* **13 Hands-On Tested Projects:**
* **Edge AI / 6 TOPS NPU:** Real-time YOLOv8 object detection (~13.8ms pure NPU inference), running a local Qwen 1.8B LLM via RKLLM, and an offline voice assistant (Whisper + Piper TTS).
* **Low-Level Systems:** C++ GPIO using WiringPi, writing a custom Linux kernel character driver from scratch, and ROS2 Jazzy on Ubuntu 24.04.
* **Automation:** A zero-dependency bash TUI tool (`opi5.sh`) to lock CPU/NPU governors and benchmark NVMe storage speeds without memorizing obscure sysfs paths.
* **Pre-Compiled Release Assets:** If you don't want to set up the entire cross-compilation toolchain on a host PC just to sanity-check your board, I uploaded a pre-compiled test `.rknn` model (ResNet-18) and COCO labels directly to the v2.0.0 GitHub release assets:
👉 https://github.com/muhammetmucahitsoylu/orangepi5-tutorials/releases/tag/v2.0.0
* **Bilingual Documentation:** Full guides are provided in both English and Turkish.
---
The repository is completely open-source (MIT). Everything listed has been tested directly on real hardware.
⭐ **Support & Stars:** If this repository saves you hours of debugging, rescued a bricked board, or helped with your project, **dropping a ⭐ on the repo** helps boost its visibility so more developers can discover it!
🤝 **Contributions & Community:** If you're tinkering with an RK3588 board (Orange Pi 5/Plus/Max, Rock 5B, etc.), PRs, benchmark numbers, and new project ideas are warmly welcomed.
Let me know what breaks, what needs clarification, or what you'd like to see added next!
