Files

T

BFE EngineeringandClaude Fable 5 5155224594 public-readiness: scrub internal details, split licensing, hosted kernel-build

Preparing the repo to go public (ADR-0007):

- CI: kernel-build moves from the self-hosted runner to ubuntu-latest
  (installs its own cross toolchain + qemu, caches the pristine tarball).
  On a public repo a registered self-hosted runner is reachable from
  approved fork-PR workflows — i.e. arbitrary code on private
  infrastructure — and the build never actually needed the SDK host.
  ADR-0004 marked superseded-in-part; docs/ci-cd.md rewritten (site
  specifics now live only in the private deployment log).
- Licensing: LICENSE gains the GPL-2.0 carve-out for patches/ and the
  kernel source excerpts (Linux derivatives; per-driver provenance was
  already tracked in PROVENANCE.md); patches/README.md states it too.
- Scrubbed from the tip: bench-unit dev credentials and its gadget IP
  (m2-boot notes), the site AP SSID+BSSID and a neighboring AP's BSSID
  and the device WLAN MAC (wifi bring-up evidence — BSSIDs are
  geolocatable), the runner mesh IP. NOTE: these remain in git history;
  decision on a pre-publication history rewrite is separate.
- Emoji cleanup across 21 tracked files (kernel port docs, review report,
  enforce-mcdc.sh) per repo text conventions: status marks became
  [x]/[wip]/[ ]/OK plain text.
- "[maintainer]-gated" process phrasing normalized to "maintainer-gated"
  (attributions in dated evidence docs kept).

Verified: zero emojis tracked; scrub grep clean; patches carry no internal
references; ci.yml parses; shellcheck unchanged.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018HUayid7W5w7jBdb9Rrj1K

2026-08-30 07:25:57 -06:00

2.9 KiB

Raw Blame History

GMAC (wired 10/100 ethernet) — VERIFIED on warden-c8a3 (2026-08-25)

Result: eth0: Link is Up - 100Mbps/Full - flow control rx/tx on our self-built 6.18.46. The 86-Panel's RMII MAC + on-die 10/100 FEPHY works; a real link negotiated on the bench.

What was ported

Mainline drivers/net/ethernet/stmicro/stmmac/dwmac-rk.c already supports many rockchip SoCs (incl. rv1108/rv1126) but not rv1106. Added an rv1106_ops (ported from the vendor 5.10 dwmac-rk.c) + the compatible:

#define RV1106_VOGRF_GMAC_CLK_CON        0x60004   /* in grf syscon@ff000000 (size 0x68000) */
#define RV1106_VOGRF_MACPHY_RMII_MODE    GRF_BIT(0)
#define RV1106_VOGRF_GMAC_CLK_RMII_DIV2  GRF_BIT(2)     /* 100M */
#define RV1106_VOGRF_GMAC_CLK_RMII_DIV20 GRF_CLR_BIT(2) /* 10M */
#define RV1106_VOGRF_MACPHY_CON0         0x60028

rv1106_set_to_rmii()      -> writes VOGRF_GMAC_CLK_CON = RMII_MODE | DIV2
rv1106_set_speed(if,spd)  -> VOGRF_GMAC_CLK_CON = DIV20 (10M) / DIV2 (100M)   [mainline sig: returns int]
rv1106_integrated_phy_powerup/down -> rk_gmac_integrated_fephy_power{up,down}(priv, CON0)

static const struct rk_gmac_ops rv1106_ops = {
	.set_to_rmii = rv1106_set_to_rmii,
	.set_speed = rv1106_set_speed,
	.integrated_phy_powerup = rv1106_integrated_phy_powerup,
	.integrated_phy_powerdown = rv1106_integrated_phy_powerdown,
};
/* OF: { "rockchip,rv1106-gmac", &rv1106_ops } */

Adaptations vs the vendor 5.10 ops

Mainline rk_gmac_ops uses .set_speed(bsp_priv, interface, speed) returning int (vendor: .set_rmii_speed(bsp_priv, speed) void) — adapted.
Split .integrated_phy_power(up) into mainline's .integrated_phy_powerup / .integrated_phy_powerdown, each calling mainline's single-reg rk_gmac_integrated_fephy_power{up,down}(priv, CON0).
Bandgap trim OMITTED: the vendor also wrote an OTP-derived bandgap value to MACPHY_CON1; that's an analog optimisation the FEPHY runs without, and mainline's fephy helper doesn't carry it. Link came up 100M/Full without it. (If signal integrity ever needs it, the bgs OTP cell now reads — see rng-otp/.)

DT / config

&gmac { status = "okay"; } — the dtsi ethernet@ffa80000 node already has clocks/resets/phy-mode="rmii"/phy-handle=&rmii_phy + the integrated ethernet-phy@2 (phy-is-integrated). rockchip,grf=<&grf> (the big syscon covers the 0x60xxx VOGRF offsets). The bgs/txlevel nvmem-cells are present but mainline reads neither, so GMAC does not depend on OTP.
Kconfig: STMMAC_ETH, STMMAC_PLATFORM, DWMAC_ROCKCHIP, ROCKCHIP_PHY (=y).

Evidence

rk_gmac-dwmac ffa80000.ethernet eth0: configuring for phy/rmii link mode → eth0: Link is Up - 100Mbps/Full - flow control rx/tx. PHY bound at stmmac-0:02 (integrated). The internal FEPHY reports id 0044.1400; it bound to the Generic PHY (mainline net/phy/rockchip.c INTERNAL_EPHY_ID is 0x1234d400) — phy-is-integrated + c22 was sufficient for a full-duplex 100M link.

2.9 KiB Raw Blame History