MacBook Pro 15,1 — Custom Speaker DSP Graph

A high-performance PipeWire filter-chain audio DSP graph for the built-in speakers of the MacBook Pro 15,1 (2018/2019 Intel T2) running Linux (t2linux).

Note

Not a kernel driver. This graph connects to WirePlumber's hidden alsa_output.platform-sound.RawSpeakers sink, delivering Apple-grade warm voicing, multiband dynamic control, driver crossover, FIR correction, and hard driver safety backstops.

---

⚡ Key Improvements Over Upstream

Upstream graphs (asahi-audio / t2-apple-audio-dsp) target a measurement-flat response that can sound thin, treble-heavy, and distort at high volumes due to missing driver limiters.

Issue in Upstream	Solution in This Graph	Result
Thin / Cold Sound	+3 dB/octave equal-energy warm voicing curve	Rich, warm, balanced audio at all volumes
Distortion at High Volume	Post-FIR driver limiters (wlim & tlim)	Clean output at 100% volume without amp clipping
Woofer Over-Excursion	60 Hz high-pass + 8-band multiband compressor	Cone doesn't bottom out on heavy bass beats
No Deep Sub-Bass	Psychoacoustic sub-bass (virtualbass via Bankstown)	Extended perceived low-end without physical strain
Fixed EQ	Isolated 8-band user_eq preference node	Custom tone presets that survive git updates

---

🎛️ Signal Processing Chain

The signal flows through tone controls, dynamic management, ISO-226 loudness tracking, FIR driver correction, and physical driver protection limiters:

flowchart TD
    subgraph Stage1 ["1. Input & Voicing"]
        In["🔊 Audio Input"]:::input --> UserEQ["🎚️ User EQ (8-Band Tone Control)"]:::eq
        UserEQ --> EQ["🎼 Voicing EQ (+3dB/oct Warmth & 60Hz HPF)"]:::eq
    end

    subgraph Stage2 ["2. Dynamics & Headroom Management"]
        EQ --> VB["🔊 Virtual Bass (Bankstown Sub-Harmonics)"]:::dynamics
        VB --> MBComp["📊 Multiband Compressor (8-Band LSP)"]:::dynamics
        MBComp --> Limiter["🛡️ Main Limiter (Broadband Lookahead)"]:::limiter
        Limiter --> LoudComp["👂 Loudness Comp (ISO-226 Equal Loudness)"]:::dynamics
    end

    subgraph Stage3 ["3. Crossover & Driver FIR Correction"]
        LoudComp --> Copy["🔀 4-Channel Crossover Splitter"]:::input
        
        subgraph Tweeters ["Tweeter Channels"]
            Copy --> ConvLT["🔊 Tweeter L FIR (convLT)"]:::fir
            Copy --> ConvRT["🔊 Tweeter R FIR (convRT)"]:::fir
        end
        
        subgraph Woofers ["Woofer Channels"]
            Copy --> ConvLW["🔊 Woofer L FIR (convLW)"]:::fir
            Copy --> ConvRW["🔊 Woofer R FIR (convRW)"]:::fir
        end
    end

    subgraph Stage4 ["4. Driver Safety Backstops & Output"]
        ConvLT --> TLim["🛡️ Tweeter Limiter (-1 dB Ceiling)"]:::limiter
        ConvRT --> TLim
        ConvLW --> WLim["🛡️ Woofer Limiter (-2 dB Ceiling)"]:::limiter
        ConvRW --> WLim

        TLim --> Out["🔈 RawSpeakers Sink"]:::input
        WLim --> Out
    end

    classDef input fill:#2d3748,stroke:#4a5568,color:#fff;
    classDef eq fill:#2b6cb0,stroke:#3182ce,color:#fff;
    classDef dynamics fill:#d69e2e,stroke:#d69e2e,color:#000;
    classDef fir fill:#805ad5,stroke:#9f7aea,color:#fff;
    classDef limiter fill:#c53030,stroke:#e53e3e,color:#fff;

---

🚀 Quick Start

1. Install Dependencies

Installs required LSP & SWH plugins via your distro package manager (dnf, pacman, apt, zypper) and builds Bankstown from source:

./install-deps.sh

2. Apply Graph

Preflights FIR paths and plugin URIs, builds the effective graph, copies it to WirePlumber, and reloads:

./apply.sh

Tip

Ensure the "MacBook Pro 15,1 DSP Speakers" sink is selected in your desktop sound settings.

---

🎚️ Sound Profiles & User EQ

Customize tone settings without modifying calibrated internal DSP stages. user_eq sits at the front of the chain, meaning even aggressive boosts are safely governed by the multiband compressor and limiters.

Quick Preset Application

1. Copy the example override file:

   cp user_eq.example.json user_eq.json
   

2. Edit user_eq.json with desired linear gain values (g_0 through g_7) and apply:

   ./apply.sh
   

Recommended Presets

Preset	70 Hz (g_0)	110 Hz (g_1)	220 Hz (g_2)	450 Hz (g_3)	1 kHz (g_4)	2.5 kHz (g_5)	6 kHz (g_6)	10 kHz (g_7)
Reference (Flat)	1.00	1.00	1.00	1.00	1.00	1.00	1.00	1.00
Rock / Pop	1.00	1.26	1.00	0.94	1.00	1.12	1.19	1.12
Classical / Acoustic	1.00	1.00	1.06	1.00	1.00	1.00	1.12	1.12
Electronic / Hip-Hop	1.26	1.19	1.00	0.94	1.00	1.00	1.06	1.00
Movie (Dialogue Focus)	0.84	0.94	1.00	1.06	1.19	1.19	1.06	1.00
Movie (Action / Bass)	1.41	1.12	1.00	1.00	1.00	1.06	1.12	1.12
Late-Night (Low Level)	0.63	0.79	1.00	1.00	1.06	1.12	1.00	0.94

(Linear values: 1.0 = 0 dB, 1.41 ≈ +3 dB, 0.71 ≈ -3 dB)

---

🛠️ Quick Tuning Reference

If your physical hardware unit needs custom dynamic tuning:

• Woofer Ceiling: Edit wlim.control.limit in graph.json (Default: -2 dB. Lower to -3 / -4 dB for stricter mechanical limiting).
• Overall Bass Punch: Adjust equalizer.control (g_1 through g_5).
• Sub-Bass Harmonics: Adjust virtualbass.control.amt (Default: 1.0).

---

📚 Documentation Index

• 📖 INSTALL.md — Comprehensive installation guide, system prerequisites, package manager details, and troubleshooting.
• 🎓 README.advanced.md — Complete electroacoustic design rationale, magnitude-vs-power analysis, gain staging equations, issue tracebacks, and exhaustive parameter tables.
• 📊 mb-compressor-params.md — Port-by-port reference for the 8-band LSP multiband compressor.

---

🔄 Reverting to Stock

To return to the stock PipeWire graph provided by t2-apple-audio-dsp:

sudo cp /path/to/t2-apple-audio-dsp/configs/15_1/graph.json \
        /usr/share/t2-linux-audio/15_1/graph.json
systemctl --user restart wireplumber