T

marfrit 5541e01d26 iter2 phase2: vendoring spec concrete + dependency chain re-verified

Fetched gsth265parser.c (5409 lines) + .h (2440 lines) from GStreamer
main mirror. Plus GstBitReader (~600 LOC vendored separately) as
the parser's only non-self-contained dependency.

License LGPL v2.1+ (Intel + Sreerenj Balachandran), preserves verbatim
in vendored copies; compatible with backend COPYING.LGPL. Add README
note listing the two vendored files.

GLib adaptation mapped to 6 mechanical replacements:
  GArray/g_array_* -> plain C dynamic arrays (count+ptr)
  g_malloc/g_free  -> libc malloc/free
  g_clear_pointer  -> inline free+NULL
  g_assert         -> propagate parser-failure-code (NOT abort!)
  gboolean/gint/etc -> stdbool/stdint
  GST_DEBUG_*      -> backend's request_log/error_log

Vendor the FULL parser unchanged per upstream-alignment rule; dead
code (PPS/slice/SEI parsing we don't strictly need) is acceptable
to preserve upstream-bug-fix-sync simplicity.

Header strategy concretized: new src/hevc-ctrls/v4l2-hevc-ext-controls.h
~50 lines with verbatim kernel UAPI defs; runtime probe via
VIDIOC_QUERYCTRL at backend init, stored per-driver_data, gated by
both kernel-supports + active driver-kind is vdpu381/383.

Build system impact: 2-line Makefile.am addition, no autoconf, no
pkg-config changes. Compile time uptick acceptable.

New constraints (6 total):
  1. Vendored LGPL header verbatim preservation + README note
  2. Hand-build install path (carries from iter1)
  3. Reboot needed after HEVC OOPS recovery (iter2 test cycle)
  5. Replace g_assert with error propagation, not abort
  6. Parser interpretation may differ from kernel even with same spec

Ready for Phase 3 (mostly inherited from iter1 + iter2 phase 0).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

2026-05-16 08:42:07 +00:00

iter1_close.md

meta-iter1 close: consolidated phases 2-8 with rationale

2026-05-16 08:32:33 +00:00

phase0_findings_iter2.md

iter2 phase0 update: upstream-consumer survey closes Q1 + Q2

2026-05-16 08:38:52 +00:00

phase0_findings.md

iter1 phase0: substrate + prior-art survey (HEVC reclassified)

2026-05-16 08:10:40 +00:00

phase1_goal_iter2.md

iter2 phase1: HEVC backend extension goal + vendoring spec

2026-05-16 08:41:22 +00:00

phase1_goal.md

iter1 phase1: lock meta-campaign goal + sub-iteration ledger

2026-05-16 08:32:06 +00:00

phase2_situation_iter2.md

iter2 phase2: vendoring spec concrete + dependency chain re-verified

2026-05-16 08:42:07 +00:00

README.md

scaffold: kernel-side sibling campaign for RK3588 decoder enablement

2026-05-16 08:07:55 +00:00

README.md

ampere-kernel-decoders

Kernel-side sibling campaign to ampere-fourier (which validated the userspace libva backend on RK3588 at iter1 close, 3 codecs working) and fresnel-fourier (the RK3399 peer). Focuses on the kernel-side enablement required to unblock the three codec blockers iter1 of ampere-fourier surfaced:

HEVC kernel OOPS in rkvdec_hevc_prepare_hw_st_rps (__pi_memcmp fault, cascades to v4l2_mem2mem wedge). Tracked at marfrit/kernel-agent#11 [ka:experiment].
VP9 not exposed on RK3588 rkvdec — kernel doesn't register V4L2_PIX_FMT_VP9_FRAME on the VDPU381/383 variant_ops. Tracked at marfrit/kernel-agent#12 [ka:experiment].
(AV1 backend iter39 is userspace work, not in this campaign's scope; tracked at marfrit/libva-v4l2-request-fourier#2.)

Topology

Property	Value
Working tree (substrate kernel)	`boltzmann:~/src/linux-rockchip` branch `linux-rk3588-marfrit`
Board patches	`boltzmann:~/src/misc_patches/genbook/kernel/000*.patch` (6 board DTS/config patches; the ampere baseline package consumes these)
Experiment target host	ampere (CoolPi CM5 GenBook, RK3588)
Baseline kernel for regression-checks	`linux-ampere-fourier 7.0rc3.kafr1-1` (vanilla torvalds v7.0-rc3 + `genbook/kernel/000*` only — NO codec patches)
Patch destination	kernel-agent experiment branches per issue; promoted to `linux-ampere-fourier` only via explicit operator decision per `feedback_characterize_before_change` (campaign-experiment patches stay OUT of baseline)
Build host	boltzmann (primary aarch64 builder per kernel-agent README) + ampere as fallback secondary
Patch landing pad	`marfrit/kernel-agent/patches/{soc,driver}/...` scope-tagged per kernel-agent's tree convention

Scope (in flux until Phase 0 close)

In scope (iter1 candidate):

HEVC OOPS fix — minimal-blast-radius candidate patch for rkvdec_hevc_prepare_hw_st_rps, validated on ampere by re-running ampere-fourier Phase 3 with HEVC added.
Survey upstream prior art (linux-rockchip, linux-media, linux-mm, Kwiboo, Bootlin, Collabora) before writing any code — there may already be a fix in v7.0-rc4+ or in an out-of-tree branch.

Out of scope (likely iter2+):

VP9 enablement (broader work — VDPU381/383 variant_ops surface, DTS bindings, potentially backend codec table updates). Separate iteration.
Multi-core support for rkvdec/hantro (the "missing multi-core support, ignoring this instance" lines in dmesg). Upstream work; out of fleet-scope.

Explicitly NOT in scope:

Codec patches on the baseline linux-ampere-fourier package. Per operator policy 2026-05-16, ampere baseline stays clean mainline + board DTS. Codec enablement = kernel-agent experiment branches only.

Process

8(+1)-phase loop per feedback_dev_process.md, same as ampere-fourier / fresnel-fourier. Notable for this campaign:

Phase 0 includes an upstream prior-art survey (linux-rockchip + linux-media + linux-mm + Kwiboo + Bootlin). This is non-optional — writing a kernel patch without first checking whether the fix already exists upstream is the wrong workflow. Memory feedback_no_upstream says no PR/MR/RFC from us by default; that's about publishing, not consuming. Consume aggressively.
Phase 5 review uses the sonnet-architect subagent pattern (Plan with model: sonnet), same as ampere-fourier. Memory rule feedback_review_empirical_over_theoretical applies — test-compile reviewer-suggested struct/field mappings before adopting amendments.
Phase 6 implementation produces kernel patches in ~/src/linux-rockchip on boltzmann + accompanying kernel-agent experiment branch entries. No patches land in marfrit-packages/arch/linux-ampere-fourier/ directly.
Phase 7 verification re-runs ampere-fourier iter1's Phase 3 scripts with HEVC added to the codec list. Predicted outcome anchors against ampere-fourier iter1's baseline numbers.

Predecessor work this campaign builds on

../ampere-fourier/ iter1 — the baseline floor this campaign regresses against. Re-anchoring to ampere-fourier's N=3 FPS numbers + per-codec SSIM floors for any codec that flips from "blocked" to "validated."
marfrit/kernel-agent — the experiment-branch home + issue tracker.
marfrit/kernel-agent/issues/11 — HEVC bug ticket with the OOPS trace + reproducer.
marfrit/kernel-agent/issues/12 — VP9 enablement ticket.
Memory feedback_rkvdec_patch_reachability — VDPU381/383 vs RK3399 legacy path boundary.
Memory feedback_characterize_before_change — campaign-process rule from ampere-fourier iter1.

Operator-facing repo URL

git.reauktion.de/marfrit/ampere-kernel-decoders — to be created at iter1 close if there's something publish-worthy (matches the fresnel-fourier / ampere-fourier convention). Local-only at ~/src/ampere-kernel-decoders/ on noether for now.

Description

RK3588 decoder enablement on ampere (CoolPi CM5 GenBook). Sibling kernel-side campaign to marfrit/ampere-fourier (userspace consumer). Meta-campaign coordinating HEVC OOPS investigation (iter2: F1 negative-result), VP9 enablement (iter4), AV1 backend probe (sibling). Process: 8(+1)-phase loop.

Readme 194 KiB