Hi everyone,
I've just released v1.0.11 of rockchip-vaapi, a VA-API driver for the RK3588 that bridges libva to Rockchip MPP for hardware video decode in Firefox and other VA-API applications.
**GitHub:** https://github.com/woodyst/rockchip-vaapi
---
## What it does
Enables hardware VP9 / H.264 / HEVC / VP8 decode in Firefox via VA-API → MPP → RK3588 VPU. DMA-BUF zero-copy display path. Tested on Orange Pi 5 Plus with Armbian and Firefox 128.
---
## What's new in v1.0.11
Previous versions would fall back to software after a few seconds of 4K content. This release fixes that — **4K@60fps is now stable**:
- **4K@60fps stable** — tested >30,000 frames in Firefox with clean DASH quality switches and no `NS_ERROR_DOM_MEDIA_FATAL_ERR`
- **Async EndPicture** — the driver was blocking Firefox's decode thread for up to 1.6s on each DASH segment keyframe, freezing the pipeline. EndPicture now returns immediately.
- **Race condition fix** — Firefox was getting a stale DMA-BUF before the decoded frame was ready, causing a green bar at the top of the screen.
- **Logging off by default** — ~500 fprintf/s were silently slowing down 60fps decode. Enable with `RK_VAAPI_LOG=/tmp/rk.log` when needed.
- **`mpv --vo=dmabuf-wayland`** — green screen fixed (COMPOSED_LAYERS export format)
- **`mpv --hwdec=vaapi-copy`** — green screen fixed (GetImage was a stub)
- **CMA requirement documented** — 4K needs `cma=512M`; includes `fdtput` fix for boards where the DTB overrides the kernel cmdline
---
## System requirements
- **CMA ≥ 512MB** — critical for 4K. Add `cma=512M` to your kernel cmdline. If it has no effect (DTB overrides it), see the `fdtput` fix in INSTALL.md.
- librockchip-mpp, libva2
- Firefox: `media.ffmpeg.vaapi.enabled = true` and `MOZ_DISABLE_RDD_SANDBOX=1`
---
## Quick install
```bash
git clone https://github.com/woodyst/rockchip-vaapi
cd rockchip-vaapi
make
sudo make install
```
Then launch Firefox:
```bash
LIBVA_DRIVER_NAME=rockchip MOZ_DISABLE_RDD_SANDBOX=1 firefox
```
Full instructions: https://github.com/woodyst/rockchip-vaapi/blob/main/INSTALL.md
---
Feedback and bug reports welcome.
Hi everyone, I've just released v1.0.11 of rockchip-vaapi, a VA-API driver for the RK3588 that bridges libva to Rockchip MPP for hardware video decode in Firefox and other VA-API applications. **GitHub:** https://github.com/woodyst/rockchip-vaapi --- ## What it does Enables hardware VP9 / H.264 / HEVC / VP8 decode in Firefox via VA-API → MPP → RK3588 VPU. DMA-BUF zero-copy display path. Tested on Orange Pi 5 Plus with Armbian and Firefox 128. --- ## What's new in v1.0.11 Previous versions would fall back to software after a few seconds of 4K content. This release fixes that — **4K@60fps is now stable**: - **4K@60fps stable** — tested >30,000 frames in Firefox with clean DASH quality switches and no `NS_ERROR_DOM_MEDIA_FATAL_ERR` - **Async EndPicture** — the driver was blocking Firefox's decode thread for up to 1.6s on each DASH segment keyframe, freezing the pipeline. EndPicture now returns immediately. - **Race condition fix** — Firefox was getting a stale DMA-BUF before the decoded frame was ready, causing a green bar at the top of the screen. - **Logging off by default** — ~500 fprintf/s were silently slowing down 60fps decode. Enable with `RK_VAAPI_LOG=/tmp/rk.log` when needed. - **`mpv --vo=dmabuf-wayland`** — green screen fixed (COMPOSED_LAYERS export format) - **`mpv --hwdec=vaapi-copy`** — green screen fixed (GetImage was a stub) - **CMA requirement documented** — 4K needs `cma=512M`; includes `fdtput` fix for boards where the DTB overrides the kernel cmdline --- ## System requirements - **CMA ≥ 512MB** — critical for 4K. Add `cma=512M` to your kernel cmdline. If it has no effect (DTB overrides it), see the `fdtput` fix in INSTALL.md. - librockchip-mpp, libva2 - Firefox: `media.ffmpeg.vaapi.enabled = true` and `MOZ_DISABLE_RDD_SANDBOX=1` --- ## Quick install ```bash git clone https://github.com/woodyst/rockchip-vaapi cd rockchip-vaapi make sudo make install ``` Then launch Firefox: ```bash LIBVA_DRIVER_NAME=rockchip MOZ_DISABLE_RDD_SANDBOX=1 firefox ``` Full instructions: https://github.com/woodyst/rockchip-vaapi/blob/main/INSTALL.md --- Feedback and bug reports welcome.