Aime/docs/06-iphone-bt.md

06 — iPhone-Telefonate über Bluetooth (HFP)

Das Board gibt sich gegenüber dem iPhone als Bluetooth-Headset aus („Aime“, AX210/hci0). iPhone-Anrufe laufen dadurch über das Board: Gegenseite → Aufnahme-Mix, Nutzer-Mikrofon (gegated) → iPhone-Uplink. Läuft parallel zum PC/USB-Gadget-Pfad — kein Umschalten; bei eingehendem Anruf pausiert der Nutzer sein PC-Video manuell.

Konfiguration (die funktionierende Kombination)

• WirePlumber-Drop-in: bluez5.roles = [a2dp_sink hfp_hf hsp_hs] + hfphsp-backend = native (oFono war ein Irrweg, deaktiviert).
• Frischer Pair nötig (auf dem iPhone „Gerät ignorieren“, dann neu koppeln) — alte Bonds machen Ärger.
• iPhone „Skynet16“ (B4:96…), bt-agent NoInputNoOutput, Gerät muss Trusted=yes sein (nach Re-Pair stand es auf NO → WirePlumber baut für untrusted Geräte keine HFP-Nodes → Aufnahme #58 hatte nur die Nahseite).
• Einziger Verzicht: BT-Ohrhörer als Aufnahmegerät (AG-Rolle) ist aus — Board ist HF-only.
• profile="off" zwischen Anrufen ist normal: HFP-Nodes existieren nur während eines aktiven Anrufs (eSCO/mSBC, 16 kHz).

Audio-Routing während eines Anrufs

flowchart LR
    subgraph IPHONE["iPhone (im Anruf)"]
        CALL["Telefonat"]
    end
    subgraph BOARD["Board (BT 'Aime')"]
        FAR["bluez_input.MAC.0<br/>= Gegenseite"]
        UP["bluez_output.MAC.1<br/>= Uplink zum iPhone"]
        MIX[("callmix")]
        GATE["micgate.out (gegatetes Mikro)"]
        HS["Headset-Hörer"]
    end
    CALL --> FAR
    FAR --> MIX
    FAR --> HS
    GATE --> UP --> CALL

Echo-Fix: WirePlumber verlinkte den Uplink zunächst mit callrec_mix (ungegatetes Mikro + Gegenseite selbst!) → Gegenseite hörte sich selbst. Korrekt: Uplink ← micgate.out. Vom Nutzer bestätigt echofrei.

Gegenseite → Headset-Hörer macht WirePlumber selbst (Default-Sink); der Watcher baut diesen Link nicht. callmix ist eine reine Aufnahme-Senke ohne Ausgang — Gegenseite → callmix macht die Gegenseite also aufnehmbar, nicht hörbar.

Automatik

sequenceDiagram
    participant IP as iPhone
    participant BZ as BlueZ/WirePlumber
    participant W as aime-iphone-route.sh (Watcher, 1 s Takt)
    participant PW as PipeWire

    IP->>BZ: Anruf beginnt (eSCO aufgebaut)
    BZ->>PW: HFP-Nodes erscheinen — NICHT atomar, Uplink oft vor Gegenseite
    BZ->>PW: Gegenseite → Headset-Hörer (WirePlumber-Default)
    loop jede Sekunde, solange Uplink-Node existiert
        W->>PW: Portnamen ermitteln (HFP = mono, playback_MONO/capture_MONO)
        W->>PW: Uplink ← micgate.out verlinken, falls fehlt
        W->>PW: nur wenn micgate BESTÄTIGT anliegt: callrec_mix → Uplink trennen
        W->>PW: Gegenseite → callmix verlinken, falls fehlt (Node kommt später!)
    end
    IP->>BZ: Anruf endet
    BZ->>PW: HFP-Nodes verschwinden (profile=off — normal)

• Watcher persistent: /opt/callrec/aime-iphone-route.sh + aime-iphone-route.service; überlebt Reboots (Config/Service/Bond+Trusted verifiziert).
• Der Watcher-Neustart lässt callmix/Loopbacks intakt.
• Jeder Link wird in JEDEM Durchlauf geprüft, nicht einmal pro Anruf — siehe Changelog 2026-07-30.
• Portnamen werden ermittelt, nicht hartcodiert. HFP/mSBC ist mono, die Ports heißen playback_MONO/capture_MONO, nicht input_FL/input_FR.
• Erst verlinken, dann trennen. callrec_mix → Uplink fliegt nur raus, wenn micgate.out am Uplink-Port bestätigt anliegt — sonst bleibt der Uplink ohne Quelle und die Gegenseite hört Stille.
• ⚠️ pw-link -l <node> filtert NICHT. Bei einem Namen, der nicht als Port auflösbar ist, kommt der gesamte Graph zurück. Jedes grep darauf ist immer wahr. Link-Zustand deshalb nur per links_of (exakter Port-Header aus einem Graph-Dump) prüfen, nie per grep über die ganze Ausgabe.

Kontrolle nach einem Anruf

journalctl -t aime-iphone-route — die eine Zeile sagt alles:

Ausgabe	Bedeutung
+micgate -callrec_mix +far-end	korrekt geroutet
keine Zeile	Watcher hat die HFP-Nodes nicht gesehen → Aufnahme hat nur die Nahseite
nur -callrec_mix	Uplink ohne Quelle → Gegenseite hört nichts (v2-Bug, behoben)
!no-micgate-uplink-keeping-callrec_mix	Uplink hörbar, aber mit Echo — micgate-Link ging nicht
(no-far-end-node-yet)	unkritisch, wenn eine spätere Zeile +far-end zeigt

Offen

• App-seitiger automatischer Aufnahme-Start bei iPhone-Anrufen.
• Voller E2E-Test „Anruf → Aufnahme → Analyse“ über den BT-Pfad.

Referenz: BT-Bond-Quirks (Ohrhörer, historisch)

Buds mit No-Bonding-Quirk: LinkKey musste manuell in /var/lib/bluetooth persistiert werden (btmon-Capture-Prozedur). RTL8821CU-Wedge-Recovery (USB-Reset, nur über LAN .50) — betrifft den alten Dongle, der entfernt wurde; nur noch relevant, falls die Hardware zurückkommt.