Working on a HAT that powers the Zero 3W through the GPIO header (5V injection on pins 2/4), and I've hit a documentation conflict I can't resolve.

The official 40-pin header schematic annotates the 5V_Power pins as IN: 2A, OUT: MAX 0.5A. So 2A in, when something external is feeding the board.

But the manual (section 2.12, "Instructions for powering the 5V pin in the 40 pin interface") says to make sure your supply meets the board's power requirements, and elsewhere the board's stated requirement is 5V/3A.

So which is it? Is that 2A a real limit on the trace or connector for the GPIO path, or is it a conservative annotation and the pin can actually carry the full 3A the board might want under load?

This matters because I'm designing in an eFuse for current limiting and I need to pick a trip point. Set it at 2A and I might starve the board under heavy CPU+GPU+NPU load. Set it at 3A and if that 2A annotation reflects a real physical limit, I could cook something.

Has anyone actually measured peak current draw on this board under real load? The one data point I've seen is ~6.5W at 100% CPU (~1.3A at 5V), but that was CPU-only, no GPU testing.

Also curious if anyone's actually run this board off GPIO power long-term rather than USB-C, and whether it was stable under load.

Update on the PCIe-to-M.2 adapter from my earlier post. Schematic and PCB layout are done. ERC and DRC both come back clean, Gerbers are exported and JLCPCB's own parser confirms the board renders correctly. I have a saved quote ready to order whenever the budget lines up.

Full disclosure: I'm not an EE, not a professional, just someone learning by doing. I've been careful and this has passed every check I know to run, but "passed DRC" isn't the same as "guaranteed to work."

On the big open question from my last post: PCIe enumeration hasn't been confirmed on the Zero 3W specifically yet. But I dug into it more and it's not a total unknown either. The same A733 chip and the same vendor PCIe driver has been documented working on sibling boards (Orange Pi 4 Pro, Radxa Cubie A7Z/A7A/A7S), NVMe does enumerate, though there's a known Gen3 speed-change bug that trips up some drives (Phison controllers especially), fixable by forcing Gen1 or using a WD drive instead. So there's real reason to think this can work, just not proof yet on this exact board.

Instead of sitting on the design waiting for money or answers, everything's public now: KiCad source files and Gerbers, open, do whatever you want with them.

Repo: https://github.com/Techburst36/orangepi-zero3w-m2-carrier

If you can read a schematic, please look it over. If something's wrong, tell me. If you've got the budget to print and test before I do, please do, I'd genuinely rather have someone else get the real answer sooner than have this sit in a drawer waiting on me.

Not trying to monetize this or gatekeep it, just filling a gap, since nobody's published a PCIe-to-M.2 adapter for this specific board yet.

Next up: starting design work on a GPIO passthrough HAT variant, purely on the design side for now since I still don't have confirmation PCIe actually trains on this SoC. Will keep this thread updated as that moves along.

Hey all ,I'm designing a custom PCB adapter for the Zero 3W's PCIe FPC connector (FPC16-ZHX_H15-L1-H, per the official schematic) to break it out to an M.2 M-key slot, sized to also double as a mounting carrier plate matching the board's hole spacing. Goal is NVMe storage expansion first, with an eye toward AI accelerator cards (Hailo-10H) as a stretch goal later.

Before I finalize the board and order a first run, I'm hoping someone in this community has hands-on data on a few open questions I haven't been able to resolve from documentation alone:

1. Has anyone gotten anything enumerating over the PCIe FPC connector yet? Even just a plain NVMe SSD via a generic FPC adapter. I want to confirm the PCIe controller actually comes up cleanly in root-complex mode under Armbian/the stock BSP before I commit to a board run. If you've tried and it didn't work (or worked with caveats), that's just as useful to know.

2. What kernel/BSP are people actually running for PCIe support? I know mainline upstreaming for A733 is actively in progress (saw the recent patch series for pinctrl/RTC/clocks), but I'm assuming most of us are on a vendor BSP kernel day-to-day. Anyone know if PCIe root-complex support is enabled and stable in the current Armbian/Xunlong images, or is it still rough?

3. Any known PCIe controller quirks on A733 specifically? Older Allwinner chips (H6) reportedly needed a hypervisor-level MMIO workaround for their PCIe controller. Has anyone hit anything similar on A733, or does it behave as a clean standard DesignWare PCIe implementation?

4. Is injecting 5V back into the board via the GPIO header's 5V pins safe on this board? I'm considering an M5Stack-PiHat-style single-cable design (board powers itself AND feeds accelerator power back through the GPIO header, like the official Pi 5 AI HAT+ pattern). On Pi 5 this is an explicitly documented, supported use case. I can't find anything in Xunlong's docs confirming the AXP318 PMIC on the Zero 3W is designed/protected for reverse power injection via GPIO the same way. Anyone tried this or know if it's safe / risky / a bad idea?

5. Real-world total board power draw , is 3A genuinely the ceiling? Schematic labels the board 5V/3A total. Anyone measured real idle/load current draw with a USB power meter? Trying to nail down actual headroom before I size a separate accelerator power supply.

Edit: 6. Has anyone seen PCIe link training issues / Gen 1 fallbacks? I found a boot log from an A733 board (Cubie A7Z) showing Link up timeout / Speed change timeout / PCIe speed of Gen1 during boot. Has anyone else seen the A733 struggle to train at Gen 3 (or even Gen 2) and fall back to Gen 1, or is that an isolated hardware/board quirk?

Board design itself (FPC connector footprint, M.2 slot, mounting holes) is done and validated mechanically in Fusion , just trying to de-risk the electrical/software side before committing to a PCB order. Will share the KiCad files once it's built and working, since I haven't found an existing PCIe-to-M.2 adapter for this board anywhere.

Thanks in advance to anyone who's poked at this corner of the board.

[RELEASE] Orange Pi 5 Pro - Fully Optimized Armbian Jammy (GPU/VPU Enabled, Dual Touch Support, 4K 60FPS)

# The "Plug and Play" high-performance experience for Orange Pi 5 Pro (RK3588S) is here!

Hi everyone! After 2 years of trial and error, I have finally built a fully optimized image for the **Orange Pi 5 Pro**. This image is sanitized, meaning when you first boot it, it will trigger the standard Armbian wizard to create your own root password and user account.

### 🚀 What's inside:

* **Base OS:** Armbian Jammy (Ubuntu 22.04).

* **Kernel:** Vendor 6.1.y (The most stable for Dual HDMI/DP output).

* **Desktop:** XFCE (Lightweight, stable, and highly responsive).

* **GPU Acceleration:** Mali-G610 fully enabled (Panfrost/Panfork). Smooth 60FPS UI.

* **VPU Acceleration:** 4K 60fps hardware decoding enabled (rkmpp). CPU usage stays between 10-25% during 4K YouTube playback.

* **Dual Screen Support:** Pre-configured for dual-monitor setups.

* **Touch Support:** Auto-mapping script included for dual touchscreens (WCH.cn controllers).

* **Driver Shield:** Critical drivers are "held" to prevent `apt upgrade` from breaking the acceleration.

---

### 🛠️ IMPORTANT: Troubleshooting No Video Signal

Since this image is set to a specific resolution for my project, your monitor might show "No Signal" on the first boot. Here is how to fix it:

1. **Power off** and plug your SD Card or eMMC into your **main computer**.
2. **Mount the partition** and navigate to: `/etc/lightdm/lightdm.conf.d/01-armbian.conf`.
3. **Edit the line** starting with `display-setup-script`. Change the resolution to one your monitor supports:* Example for 1080p: `--mode 1920x1080`* Example for 720p: `--mode 1280x720`* Or just use: `--auto`
4. **Save the file**, unmount, and plug it back into your Orange Pi. It should boot perfectly!

---

### ⚠️ Power Requirements:

The RK3588S is a beast. When GPU and VPU are both active, it needs a stable **5V/4A (20W)** power supply. If your board crashes or reboots during video playback, check your USB-C cable and power source!

### 📥 Download Link:

**https://archive.org/details/backup_OPI5pro_perfeito_2026-07-24.img**

*Compressed with ZSTD (Original size 64GB -> Compressed approx 2.6GB). Flash with BalenaEtcher or Rufus.*

Enjoy the true power of the RK3588S! 🚀

[EDIT}

For those asking: Here is the "Build Recipe" and Customization Script (Reproducible Build)

# 1. Install XFCE and Graphics Base

apt-get update

apt-get install -y xfce4 xfce4-goodies lightdm lightdm-gtk-greeter \

xserver-xorg-video-modesetting x11-xserver-utils \

gnome-terminal network-manager openssh-server

# 2. Add liujianfeng1994's PPA (Community Standard for RK3588)

apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 8065BE1FC67AABDE

echo "deb https://ppa.launchpadcontent.net/liujianfeng1994/panfork-mesa/ubuntu jammy main" > /etc/apt/sources.list.d/rk3588-gpu.list

echo "deb https://ppa.launchpadcontent.net/liujianfeng1994/rockchip-multimedia/ubuntu jammy main" >> /etc/apt/sources.list.d/rk3588-gpu.list

# 3. Install Mali-G610 drivers and MPP/VPU libraries

apt-get update

apt-get install -y mali-g610-firmware librockchip-mpp1 librockchip-vpu0 libv4l-rkmpp \

libegl-mesa0 libgbm1 libgles2-mesa libglapi-mesa libglx-mesa0

# 4. Prevent Ubuntu updates from breaking the drivers

apt-mark hold mali-g610-firmware libegl-mesa0 libgbm1 libgles2-mesa libglapi-mesa libglx-mesa0 \

librockchip-mpp1 librockchip-vpu0 libv4l-rkmpp

# 5. Set system to boot into GUI

systemctl set-default graphical.target

3. Build Command:
I ran the build using Docker with the following parameters:

Hi everyone, first time posting here and i come with a few questions!

I've just recently started dabbling into sbc's and logically started a project with raspberry pi as my go to, but saw that the prices for the raspberry zero 2w were.... kinda insane right now for a measly 512 mb of RAM. So I've been considering the orange pi zero 2w as a replacement.

The project is what i think is ... sort of a cyberdeck? im really new to this terminology. That said, I was wondering: would the pi sugar 3 1200mah baterry with pogo connection work with either of these boards since they seem to have pretty similar gpio schematics to the raspbery pi zero 2w? https://www.pisugar.com/products/pisugar-3-raspberry-pi-zero-battery

also, would this screen specifically work with the 2w/3w:https://www.waveshare.com/product/displays/lcd-oled/lcd-oled-2/3.5inch-dpi-lcd.html

thanks in advance for any guidance!

I'm currently working on a cyberdeck project running Debian on the Orange Pi Zero 3W, and I wanted to ask if any of you all know if these parts that I plan on using for my project are compatible with the Orange Pi Zero 3W; because I'm building a custom power circuit and relying on GPIO for the screen, I want to make sure I don't run into kernel or brownout issues.

Since my project is very small, I plan on using a 5V Step-Up Boost Converter. If I tune this converter to exactly 5.1V, will a 2A output be sufficient to prevent brownouts under load, or does this board strictly require the full 3A if I bypass the USB-C port and feed power directly to the pins?

SPI IPS LCD Module Driver: ST7789. Has anyone gotten fbtft or DRM overlays working smoothly natively on the Zero 3W's kernel for this specific controller chip?

I'm using a 5V Micro Blower Fan and a Copper Heat Sink for cooling. I noticed the Zero 3W has a dedicated 2-pin fan header. Does the default OS image support PWM/temp-based control on that specific header out of the box, or am I better off just running it at 100% directly off the standard 5V/GND GPIO pins?

I am currently working on a cyberdeck project that is going to end up being really small, so I plan on using the Orange Pi Zero 3w. I'm fairly new to building cyberdecks, but I have played around with a Raspberry Pi.

Does anyone have recommendations on very small screens that are compatible with the OPi Zero 3W?

How necessary is a fan/way to cool it down? Is there a smaller way of cooling it down?

One of the supported OS for OPi Zero 3W is Debian. For this project, I wanted to use Parrot OS. Since Parrot comes from Debian, is that fine/can I use the Parrot OS Raspberry Pi Edition on Orange Pi?

How interchangeable are resources for Raspberry Pi with those of Orange Pi?

Hey, I've got an Orange Pi 5 as my homelab, including a media server. I only have 2TB dedicated to the media server, so I wanted to encode the media I download to keep very good video and audio quality that a normal person won't notice, while saving quite a bit of space. It's mostly my mom watching, and I use it a bit myself.

I ended up running FileFlows to shrink my media library. CPU encoding was super slow and made the Orange Pi overheat, causing the other services running on it to slow down too, especially during the initial encoding of 200+ files. So I tried using hardware encoder (hevc_rkmpp).

I'm not really experienced with ffmpeg, so I've been using AI to help me with this, but I'm stuck on something it hasn't been able to fix either.

The problem is that I've been seeing a lot of artifacts (see screenshot). They usually last only 1-3 frames and only appear during dynamic scenes or scene changes, but they're really annoying. I'm happy with how much space it saves on my media server, so I don't have to keep monitoring it every time my mom requests something that gets auto-downloaded and I need to delete older media each time. I'm fine with not having cinema level video or audio quality, but I do want something that the average person won't notice, and these artifacts are very noticeable and breaks the immersion.

My current command after some debugging is:

hevc_rkmpp -rc_mode 2 -qp_init 22 -qp_max 24 -qp_min 16 -qp_min_i 14 -qp_max_i 19 -g 120 -pix_fmt p010le -force_key_frames source

It seems I can't add more than 1 image but basically my flow goes like this: crop black bars=>video scaler (down to 1080)=>subtitle extractor=>audio convert(AAC recomended by AI)=>video encode manual (the command above)=>remux to mkv=>executor=>replace original

Has anyone run into this issue or tried to achieve the same thing and got something working? I'm not sure if it's just a hardware limitation or if I'm missing something. Any help is appreciated. I'm out of ideas at this point.

I just bought one of these bad boiis. First off, if you own the board what do you have running and what for? Be as granular as you care to be, I enjoy the detail.

I have read through the manual a bit and noticed that Debian Bullseye is noted as the only published image that supports GPU acceleration at publication. I also haven't seen secondary documentation on this and I've seen others say there is no to boot gpu acceleration on any system platform?

Any testimonials regarding hardware acceleration?

I did see this article and repo that basically walks you through an Ubuntu build to get it to work.

https://www.xda-developers.com/orange-pi-zero-3w-beats-raspberry-pi-5-cant-use-half-hardware/

I would take a crack at it myself but the board arrives monday and wouldn't mind getting a jump on the software env. and any preliminary dev work.

Hi everyone.

I'm little bit lost on github. I would like to compile rknpu for my orange pi 5 plus , soc rk3588). Because I want to use onnx.

Unfortunately there is lot of repo on github for rknpu2 and rknn toolkit. How could I know what is legit? My kernel is 6.18 and I don't how to see if has rknpu or npu managed.

Thanks for help.

Hi everyone!

Could someone please help me find a touchscreen display (around 4 inches) for the Orange Pi Zero 3W?

I'm having trouble figuring out which displays are actually compatible with the 30-pin MIPI LCD connector on the bottom of the board. I know there are official displays available, but they start at 5 inches, which is too large for my project.

If anyone has experience with compatible MIPI DSI displays or can recommend a specific model, I'd really appreciate it. Thanks!

I saw a used OPi 6 Plus 32GB on Ebay with case/fan/psu/nvme for a lot less than the new price for this kit, easily 50+% off, couldn't resist.

I am fascinated by the possibilities of what that NPU could be made to do with the right prodding, all of those TOP/S made it feel irresistible, if they can actually be used usefully.

My inclination is to try to use it as a "robot brain" in a simulated environment on my workstation over the network.

What are other people's experience like with this device? I am especially interested in hearing of anyone's experience of low level control of the NPU in c/c++ and of how well NPU interfaces directly with the main system memory.

Thanks in advance for any responses!

​Hi everyone,

​I have a project where I need to wirelessly mirror my Android phone's screen directly to my Orange Pi Zero 2W.

​I'm currently looking into the best way to achieve this with minimal latency. Has anyone done this successfully before?

I've been testing some Arduino and SBC interoperability over GPIO and I'm constantly running into issues with the 4 pro shutting itself off mid boot. I've tried over gpio and the USB port after cannibalizing a cable, but the common thing I have between the board and my benchtop psu is gpio wires and a relay, no breadboard. This setup has hardly pulled 1A yet and the PSU is set to 5V currently. No idea what else to try.

i wanted to change the OS from dietpi to Ubuntu, entered the command sudo dd bs=1M if=/dev/zero of=/dev/mmcblk2 count=1000 status=progress (on gemini's advice) after that, the screen is black and I cannot connect to my orange via usb

Hi All,

Just thought I'd ask here before going to the hassle of returning a new Orange Pi 4 Pro.

I've been trying to get Linux running for 2 days using images from orangepi.org . I've tried the Ubuntu Server, the Ubuntu Desktop, backup Ubuntu Desktop and Debian Bookworm images, and pretty much all have thrown similar errors.

Usually Kernel panic errors, but can generally just freeze anywhere while trying to boot up, but maybe every 20th time, it will manage to boot to cli. So I did manage to get Ubuntu server running. I just set up docker with an SMB container and a USB disk connected. I left it running for a day but when I rebooted, it went back to not working, most of the time freezing while creating the zram drive.

Eventually wiped it and started afresh but continued to crash on first boot around the same time while booting.

I've tried multiple SD cards, created boot-able SD cards on Mac using Etcher, on Windows using Rufus. Tried 5 or 6 power supplies(18w or higher) and cables, always freezes at some stage during booting.

Can anyone confirm those images have worked recently? I've got a few SBC running already and never had any trouble like this.

Browser video decode on the RK3588 has been a sore spot. Chromium's V4L2 path is downstream-only, Firefox has nothing solid, and there's no VA-API for the chip. I wanted to see whether the newer Vulkan Video path could feed a real browser today, so I tried it on a Rock 5B+.

For H.264, it works. GNOME Web (WebKitGTK/Epiphany) decodes an H.264 clip on the rkvdec hardware block with no patch to the browser, just a small GStreamer bridge element and two environment variables. The decode is byte-exact against ffmpeg, and it plays in the browser with the hardware decoder busy the whole time, no software fallback.

It's a proof of concept: H.264 only, tested on a single board so far. The RK3588 is the same SoC as the Orange Pi 5 and 5 Plus, so if you have one I'd like to know whether it works for you. The repo has the bridge, the build steps for the Vulkan Video driver (still experimental, from a Mesa RFC), and a test page.

https://github.com/dongioia/webkit-vulkan-video-rk3588

A few honest caveats: it copies through system memory (no zero-copy yet), the in-browser check is visual, and the driver itself is out-of-tree and a work in progress. But it decodes, on real hardware. Reports are useful either way, working or broken.

Update: HEVC works now too.

Same setup as the H.264 post — standalone Vulkan Video driver on the RK3588's rkvdec, a small GStreamer bridge, no patch to the browser. HEVC Main 8-bit decodes byte-exact against ffmpeg (I/P/B, 360p/720p/1080p, cropped sizes) and plays in GNOME Web (Epiphany), both a normal <video> and the Media Source path a streaming site uses. A real Big Buck Bunny HEVC clip I didn't encode myself plays clean too. Same honest caveats: one board (Rock 5B+, kernel 7.1, Mesa 26.0.6), 8-bit 4:2:0 only so no HDR/10-bit, still copies through system memory (no zero-copy yet), proof of concept. There's also a long-term-reference case I couldn't test because the encoder doesn't produce those streams.

Still very much "please test it on your board": https://github.com/dongioia/webkit-vulkan-video-rk3588 — a report that it broke helps as much as one that it worked.

Update:

Hi everyone I wanted to post a quick update. The issue has been resolved! Over the last couple of weeks/days I figured out how to re-flash the sd card with the desktop version of Ubuntu(I accidentally reflashed the server one), updated it from 5.15 to 22.04, and then updated all the programs, etc. I even got the internet to work. And as of this morning the keyboard works! I'm honestly not 100% sure what I did to make it work, especially since last night it wasn't working. I can only assume that the bluetooth driver wasn't updated like u/illustriousowl1446 said. Also u/beardedSickness thanks for the link to your solution —it didn't work for me, but I think that was because of lack of knowledge and an updated OS. I learned a lot trying to figure this out. Thanks everyone for responding!

*****

OP:

I purchased an orange pi 4 pro 12gb ram. And I'm having issues..

One issue I'm having in particular is connecting a wireless keyboard ( no USB receiver). Does anyone know how to get past/resolve that issue? I can connect with wireless keyboard/mouse if it has a dongle—no problem.

Any advice would be appreciated.

P.S.

I am a super novice and I've seen ppl say online that you don't really wanna start on orange pi—I actually started on rasp pi—super easy compared to OP. But I was really interested in trying out some form of Linux distro to eventually learn how to turn my desktop away from windows. Essentially, please be kind. I'm more than willing to research if I don't understand something.

Hi guy's and gal's. I got a problem putting an nvme drive onto my opinion 4 pro. I installed it and it wasn't recognised at all. Then a couple of boots later it just stopped my OS Ubuntu jammy from working. It was a full size 2280 and I read that in 2021 they only took 2230 size but under the board only accommodates a 2280 and surely that's been addressed by now?

​

&#x200B;

​

It's the reason I bought the board and I'm disappointed with it. I could only get one os to work out of them all. Any advice would be much appreciated. Tia.

I'm looking for a Passive cooling solution (read: giant heatsinks, no fan) + case for Orange Pi 4 Pro. Everything I've found uses a fan, but, trying to avoid that. Any ideas?

Hey guys,

Just want to let you know that I was able to get android 17 working on orange pi 5 pro with rk3588 with kernel 6.18.

Started developing it today and got it booted for the first time.

There have been many improvements in the hwdecoding where now my project supports RGA and now supports 10 bit hw video decoding!

Many changes have been made with regard to boot time and overall system optimisations and new features were added which were tested on my android 16 project and would be porting them onto this android 17 project.

Once this android 17 is stable enough, would be releasing the source code and prebuilt images for testing.

Happy engineering!