rk3328-vpu-clocks
Canonical: https://git.bun-arcturus.ts.net/git/rk3328-vpu-clocks.git
— self-hosted githost, anonymously readable via Tailscale Funnel. This
GitHub repository is a read-only mirror kept in sync from the canonical
repo.
One-patch fix for the crippled VPU/decoder clocks on RK3328 boards
(Rock Pi E and friends) running the Rockchip BSP (rkr) kernel with the
mpp media stack.
TL;DR: out of the box, 4K HEVC decode runs at 33.8 fps — 57% of the
datasheet’s 60 fps spec — because the device tree boots the decoder
clocks at 100 MHz and the mpp driver’s auto-frequency path never fires on
RK3328. Apply the DTS patch (or the boot-script alternative) and decode
runs at the driver’s own declared advanced rate:
| Clocks |
Decode 4K HEVC |
dec→RGA→null |
| stock boot pins (100/50 MHz) |
33.79 fps |
31.55 fps |
| decoder + RGA @ 400 MHz |
70.21 fps (117% of spec) |
40.84 fps |
Full story: blog.md. Persistence options:
persistence.md.
Contents
| Path |
What |
0001-*.patch |
the DTS fix, ready for git am / patch -p1 against any rk3328 BSP kernel tree (tested on 6.12.81-rkr12) |
scripts/cru.c |
25-line /dev/mem RK3328 CRU peek/poke tool (the investigation instrument; also used by the boot pin) |
scripts/vpu-clocks.initd |
OpenRC boot-time pin — the no-rebuild fix |
scripts/vpu-clocks.service |
systemd boot-time pin — same, for systemd-based images (Armbian etc.) |
scripts/vpu-clock-watchdog.sh |
repin loop: re-asserts the clock pins if anything moves them |
scripts/vpu-clock-watchdog.initd / .service |
runner units for the watchdog |
blog.md |
how the bug was found and fixed |
persistence.md |
making the fix survive reboots, three ways |
Quick start
Option A — rebuild the DTB only (recommended):
git am 0001-arm64-dts-rockchip-pin-RK3328-rkvdec-RGA-clocks-at-the-mpp-advanced-rate.patch
make ARCH=arm64 dtbs # rk3328 dtb rebuilds in seconds
# deploy rk3328-<board>.dtb the way your image does, reboot
Option B — no rebuild:
gcc -O2 -o /usr/local/bin/cru scripts/cru.c
install -m755 scripts/vpu-clocks.service /etc/systemd/system/ # or .initd for OpenRC
systemctl enable --now vpu-clocks # or rc-update add vpu-clocks default
Verify
grep -E "vdec|rga" /sys/kernel/debug/clk/clk_summary # expect 400 MHz entries
# then: 4K HEVC decode should roughly double its fps
Notes
- The venc (H.264 encoder) side is intentionally not pinned: that
driver self-manages its clocks (resume → 300 MHz, idle → 50 MHz), and
400 MHz measured no encode gain. Leave it alone.
- The root fix would be a driver patch making
rkvdec2_set_freq()
actually fire on RK3328 — see blog.md for the evidence trail
(/proc/mpp_service/rkvdec/* rates stay 0 forever). The DTS pin is
the correct, simple workaround until someone finds that bug.
- Tested on: Rock Pi E (RK3328), kernel 6.12.81-rkr12 (Radxa/BSP
linux-6.12-stan-rkr1.1), mpp 1.3.10, ffmpeg-rockchip.
License
Kernel patch: GPL-2.0 (it is a DTS change against the kernel tree).
Scripts: GPL-2.0-or-later.