ZHA – IKEA SYMFONISK Sound Remote GEN2 (Blueprint)

Home-Assistant-Blueprint zur Steuerung eines Media Players mit der IKEA SYMFONISK Sound Remote GEN2 (E2123) über ZHA.

---

Funktionen

Bedienung	Aktion
Play-Taste	Play / Pause
Drehrad im Uhrzeigersinn	Lautstärke lauter
Drehrad gegen den Uhrzeigersinn	Lautstärke leiser
Skip vorwärts	Nächster Titel
Skip rückwärts	Vorheriger Titel
● 1 Punkt – kurz / doppelt / lang	frei belegbar
●● 2 Punkte – kurz / doppelt / lang	frei belegbar

Zusätzlich:

• Optionale feste Lautstärke-Schritte – statt media_player.volume_up/down kann media_player.volume_set mit einer festen Schrittweite verwendet werden (Standard 25 Schritte = Sonos-App-Skala). Für Player, die keinen volume_level melden, wird automatisch auf volume_up/down zurückgefallen (Null-Guard).
• Target-Selector für den Media Player: Entität, Gerät, Bereich oder Label.
• Robuste Event-Auswertung – step_mode / move_mode werden je nach zigpy-Version als int (0/1) oder als Enum (StepMode.Up) geliefert; beide Formen werden akzeptiert.

---

Installation

Variante A – Import per URL (empfohlen)

Home Assistant → Einstellungen → Automationen & Szenen → Blueprints → Blueprint importieren und diese URL einfügen:

https://github.com/GITHUB_USER/ha-blueprint-ikea-symfonisk-gen2/blob/main/blueprints/automation/symfonisk_gen2/ikea_symfonisk_remote_gen2.yaml

GITHUB_USER muss vorher durch den eigenen GitHub-Benutzernamen ersetzt werden – auch im Feld source_url innerhalb des Blueprints und in den Badges oben.

Variante B – Manuell

1. Datei blueprints/automation/symfonisk_gen2/ikea_symfonisk_remote_gen2.yaml nach <config>/blueprints/automation/symfonisk_gen2/ kopieren.
2. Entwicklerwerkzeuge → YAML → Automationen neu laden.

---

Verwendung

1. Fernbedienung in ZHA anlernen (IKEA-Kopplung: Reset-Taste 4× kurz drücken).
2. Neue Automation aus dem Blueprint erstellen.
3. Fernbedienung und Media Player auswählen, Punkt-Tasten nach Wunsch belegen.

Ein vollständiges Beispiel liegt unter examples/example_automation.yaml.

Feste Lautstärke-Schritte

Einstellung	Verhalten
Aus (Standard)	media_player.volume_up / volume_down – der Player bestimmt die Schrittweite
An	media_player.volume_set mit 1 / Anzahl Schritte pro Klick, geklemmt auf 0.0 … 1.0

---

Getestete Hardware

• IKEA SYMFONISK Sound Remote GEN2 (E2123)
• Home Assistant mit ZHA
• Sonos / andere media_player-Entitäten

Die Event-Referenz (Cluster, Command, Params) steht in docs/zha_events.md.

---

Fehlersuche

Symptom	Ursache / Lösung
Nichts passiert	Entwicklerwerkzeuge → Ereignisse → zha_event abonnieren und Tasten drücken. Kommen keine Events, ist das Gerät nicht (mehr) korrekt gepairt.
Punkt-Tasten reagieren nicht	Kommen die Events mit command: shortcut_v1_events und cluster_id: 64639? Ältere ZHA-Quirks melden die Tasten teils abweichend – Event-Ausgabe bitte melden.
Lautstärke springt zu stark	„Feste Lautstärke-Schritte“ aktivieren und Schrittanzahl erhöhen.
Automation läuft, Player reagiert nicht	Prüfen, ob der ausgewählte Media Player die Dienste volume_set / media_next_track unterstützt (Attribut supported_features).

---

Lizenz

MIT – siehe LICENSE.

Basiert auf einem Community-Blueprint für die SYMFONISK GEN2; siehe CHANGELOG.md für die vorgenommenen Korrekturen.