# kernel-agent manifest for ampere (CoolPi GenBook / Rockchip RK3588)
#
# Status: minimal baseline established 2026-05-16 after the
# linux-rk3588-marfrit tip @ f8f3ad9 baseline produced a black-screen
# regression on ampere (display blank, software-state OK). Bisect
# narrowed the working baseline to mainline v7.0-rc3 + 3 settled
# patches: pwm15 pinctrl + pwm-fan thermal + RK806 system-power-controller.
#
# The suspend/resume + wakeup series (sleep fixes / patch 0010 family in
# misc_patches) is WORK-IN-PROGRESS and intentionally NOT included here
# until upstream-ready.
#
# Other linux-rk3588-marfrit commits (lid switch, USB-C PD, speaker,
# 8 cherry-picks from Shawn Lin / Cristian Ciocaltea / Sebastian Reichel
# / Pedro Alves) are also DEFERRED — one or more of them caused the
# black-screen regression and the offender hasn't been identified yet.

host: ampere
arch: arm64
soc: rockchip/rk3588
board: coolpi-cm5-genbook
distro: archlinux-arm

baseline:
  tree: torvalds/linux
  url: https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
  ref: v7.0-rc3
  upstream_compat: linux-7.0

# Scope-tagged patch includes. Each entry resolves to
# patches/<scope>/.../<file>.patch in marfrit/kernel-agent.
#
# pwm15 patch is technically SoC-level (rk3588-extra-pinctrl.dtsi) but
# kept under board/coolpi-genbook/ for now because the only consumer in
# the fleet is ampere (boltzmann is rk3588 too but UEFI/edk2 boot, no
# pwm15 user). Move to patches/soc/rockchip/rk3588/ once a second
# consumer shows up.
includes:
  - board/coolpi-genbook/0001-arm64-dts-rockchip-rk3588-Add-pwm15-pinctrl-entries.patch
  - board/coolpi-genbook/0002-arm64-dts-rockchip-rk3588-coolpi-cm5-genbook-Add-pwm.patch
  - board/coolpi-genbook/0003-arm64-dts-rockchip-rk3588-coolpi-cm5-fix-power-off-b.patch

# Explicitly NOT included (decision logged):
#   - misc_patches/genbook/kernel/0010 (sleep fixes / WIP — re-evaluate
#     once Markus closes the suspend/resume thread)
#   - lid switch / USB-C PD / speaker / Shawn Lin pcie3 phy series /
#     Collabora clk/dts/dw-dp fixes / Sebastian Reichel hdmirx
#     (all currently suspect for black-screen regression; re-bisect
#     individually before re-adding)

config:
  source: /proc/config.gz on running ampere kernel (7.0.0-rc3-ARCH+)
  strategy: snapshot, fold to baseline, accept-new with rationale on diff

package:
  name: linux-ampere-fourier
  versioning: "${baseline_ref}.kafr${pkgrel}"  # e.g. 7.0rc3.kafr1
  install_mode: alongside  # coexists with arch_mainline label in /boot/firmware
  conflicts: []
  provides: []
  kernel_suffix: -ampere-fourier  # /boot/firmware/Image-7.0.0-rc3-ampere-fourier
  bootloader: extlinux  # /boot/firmware/extlinux/extlinux.conf

verify:
  bar1_ssh_heartbeat: required
  bar2_pkg_version: required
  bar3_dtb_match:
    - pwm15 pinctrl entries present in rk3588-extra-pinctrl.dtsi
    - pwm-fan node bound to pwm15 with cooling-cells in coolpi-cm5-genbook.dts
    - rockchip,system-power-controller property on rk806 in coolpi-cm5.dtsi
  bar4_per_patch_probe:
    - display: SDDM greeter visible on eDP panel (visual, manual)
    - power-off: `shutdown -h now` actually cuts RK806 rails (visual: backlight off + fan stops)
    - pwm-fan: thermal_zone trip_points reachable, fan spins at high load
  bar5_burn_in: skip  # laptop, runtime not constant

build_host:
  primary: ampere        # native build; native verifies toolchain identity with ARCH+
  fallback: boltzmann    # rk3588 LXD host, larger CPU pool
  # No distcc per feedback_kernel_agent_no_distcc.md (2026-05-09).

backup:
  pre_install: hertz:/sparfuxdata/kernel-agent-backups/ampere/${replaced_version}/