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:
BFE Engineering
2026-08-31 12:31:27 -06:00
parent 80d9a9539b
commit 42fb386f60
111 changed files with 1261 additions and 1261 deletions
+6 -6
View File
@@ -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.