docs: ASCII typography and style normalization across all repo text
Replace every em dash with real punctuation (rewrites, not hyphen swaps) in docs, code comments, scripts, configs, and the port records; convert en dashes, curly quotes, ellipsis glyphs, arrows, and section signs to ASCII; drop machine-writing tell phrases from living docs. ADR titles now use a colon. The M2 bring-up DTS model string carried an em dash into the patch series and its record echoes; fixed at both, and the full series re-verified to apply cleanly onto pristine 6.18.46. One comment in freshness.h deliberately names the em dash glyph the UI renders as the unknown mark; that is data, kept as prose naming it. Verified: cargo tests (sim, config-lint, rs485-bridge), shellcheck, both driver MC/DC harnesses, patches-apply.
This commit is contained in:
@@ -1,4 +1,4 @@
|
||||
# GMAC (wired 10/100 ethernet) — VERIFIED on warden-c8a3 (2026-08-25)
|
||||
# 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
|
||||
@@ -31,17 +31,17 @@ static const struct rk_gmac_ops 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.
|
||||
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/.)
|
||||
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
|
||||
- `&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
|
||||
@@ -49,8 +49,8 @@ static const struct rk_gmac_ops rv1106_ops = {
|
||||
- Kconfig: `STMMAC_ETH`, `STMMAC_PLATFORM`, `DWMAC_ROCKCHIP`, `ROCKCHIP_PHY` (=y).
|
||||
|
||||
## Evidence
|
||||
`rk_gmac-dwmac ffa80000.ethernet eth0: configuring for phy/rmii link mode` →
|
||||
`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) —
|
||||
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.
|
||||
|
||||
Reference in New Issue
Block a user