Einrichtung und Bedienung

Vollständige Bridge-Anleitung

Diese Anleitung beginnt beim unversorgten, nackten Board und führt bis zu gelernten IR-Profilen, zonenbezogenem Routing, Sicherung und signierten Onlineupdates durch RoonPilot.

IR Bridge 1.0.0 · RoonPilot 2.0.2

Nutze den offiziellen Webinstaller für eine Erst- oder Neuinstallation, nachdem du die Verdrahtung weiter unten geprüft hast. Bereits gekoppelte Bridges lassen sich manuell über RoonPilot aktualisieren.

Bridge-Webinstaller öffnen

Vollständiges IR-Bridge-Video ansehen

1. Aufgabe der Bridge

Wenn die native Lautstärkeregelung des Roon-Endpunkts bereits die gewünschte Hardware korrekt bedient, ist sie der bevorzugte Weg. Die Bridge ergänzt nur Funktionen, die der Endpunkt nicht bereitstellt. Wiedergabe, Playlists und Live-Radio bleiben bei Roon; die Bridge überträgt keine Musik.

Beim Abschalten von Bridge & Bluetooth bleiben gespeicherte Kopplungen, Routen und Profile erhalten. Bis zum erneuten Einschalten und Neustart verwenden Zonen mit gespeicherter Route External IR oder Disabled vorübergehend das native Roon-Verhalten. Ist die Bridge-Funktion dagegen eingeschaltet, aber eine zugeordnete Bridge fehlt, erfolgt kein stiller Wechsel von Lautstärke- oder Power-Befehlen zu Roon.

RoonPilot IR Bridge ist eine optionale ESP32-S3-Erweiterung für Geräte, deren Lautstärke oder Stromzustand Roon nicht direkt steuern kann. RoonPilot bleibt die Bedienoberfläche; die Bridge empfängt authentifizierte Lautstärke-, Mute- und Power-Aktionen und sendet die gelernten Befehle der Original-Infrarotfernbedienung.

Der Steuerweg wird für jede Roon-Zone getrennt gewählt. Eine Zone kann die native Roon-Lautstärke nutzen, eine zweite einen DAC per Infrarot regeln und eine weitere die Lautstärkeregelung bewusst deaktivieren. Wird Bridge & Bluetooth abgeschaltet, bleiben nach dem RoonPilot-Neustart Bridge-Scanning, Bluetooth und sämtliche Bridge-Hintergrundaufgaben aus.

Die vollständige Bridge-Oberfläche folgt der globalen Deutsch/Englisch-Einstellung von RoonPilot. Physische Kennungen sowie selbst vergebene Zonen-, Geräte- und Profilnamen bleiben exakt wie eingegeben.

Es gibt kein zweites Produkt zu verwalten.

RoonPilot übernimmt Bridge-Hauptschalter, verschlüsselten BLE-Scan und Pairing, optionale WLAN-Provisionierung, laufenden Transportstatus, IR-Profile, geführtes Lernen, Befehlstests, Zonenrouting, Power-/Mute-Tasten, die gemeinsame Sicherung und signierte Onlineupdates. Die Bridge selbst benötigt weder Cloudkonto noch eine eigene Alltags-Weboberfläche.

Profile pro BridgeBis zu 8
Gespeicherte BridgesBis zu 4
Aktive RoutenAlle benötigten Gruppenmitglieder
BefehleLautstärke ±, Mute, Power ein/aus
PrimärverbindungVerschlüsseltes BLE
FallbackAuthentifiziertes lokales WLAN

Begriffe auf einen Blick

BegriffBedeutung
Gekoppelt / gespeichertRoonPilot und Bridge haben verschlüsselte Schlüssel ausgetauscht; die gespeicherte Bridge kann gerade ausgeschaltet oder außer Reichweite sein.
VerbundenAktuell besteht ein BLE- oder authentifizierter WLAN-Steuerweg.
Automatische ZonensteuerungDie gewählte Roon-Zone oder jedes physische Gruppenmitglied bestimmt die benötigten Bridge-Routen.
WartungsauswahlManage öffnet vorübergehend eine andere gespeicherte Bridge zum Lernen, für Diagnose oder Updates; die Zonenroute bleibt unverändert.
IR-ProfilBenannter Satz gelernter Befehle in RoonPilots Bibliothek, der auf mehrere Bridges übertragen werden kann.
ZonenrouteDie Wahl zwischen nativer Roon-Lautstärke, Bridge/Profil oder deaktivierter Lautstärke für eine Zone.
WLAN-FallbackOptionaler lokaler Netzweg, der über verschlüsseltes BLE eingerichtet wird, die Reichweite erweitert und für Firmwareübertragung bevorzugt wird.

2. Hardware und sichere Verdrahtung

Der validierte Aufbau nutzt das Waveshare ESP32-S3-Zero mit 4 MB Flash und 2 MB PSRAM, einen AZ-Delivery-KY-022/CHQ1838-Empfänger, den Adafruit High Power Infrared LED Emitter 5639 und USB-Stromversorgung.

Vor jeder Änderung USB abziehen. Die tatsächlichen Beschriftungen S, +, −, V+, GND und SIG auf den gelieferten Modulen ablesen. Kompatible KY-022-Boards besitzen nicht immer dieselbe physische Pinreihenfolge.
Verdrahtungsplan der RoonPilot IR Bridge: beide Module am 3V3-Ausgang; 5V ist ein Eingang
Beide Module werden am 3V3-Ausgang versorgt, auch der Adafruit High Power Infrared LED Emitter 5639.
Bridge-AnschlussZielAufgabe
5VNur Versorgungseingang des BoardsBei USB-Versorgung unbeschaltet lassen; nicht zur Versorgung der Module verwenden
3V3-AusgangAdafruit 5639 V+3,3-V-Versorgung des IR-Hochleistungssenders
GPIO4Sender SIG / S3,3-V-IR-Modulationssignal
3V3-AusgangKY-022 +3,3-V-Empfängerversorgung; hält dessen Digitalausgang im Eingangsbereich des ESP32
GPIO5KY-022 S / OUTDemoduliertes IR-Empfangssignal
GNDBeide ModuleZwingend gemeinsame Masse

Der 5V-Pin des ESP32-S3-Zero ist ein Versorgungseingang, kein 5-V-Ausgang. Alle Plusanschlüsse der Module gehören an den geregelten 3V3-Ausgang des Boards, auch V+ des Adafruit-IR-Hochleistungssenders. Das Board wird über USB mit einem stabilen 5-V-Netzteil mit mindestens 1 A versorgt. Das Adafruit-Modul besitzt einen eigenen Transistortreiber; GPIO4 liefert nur das Steuersignal. Nur kurze Fernbedienungsimpulse senden, alle Masseanschlüsse verbinden und den Keramikantennenbereich des ESP32 von Modulen, Kabeln und Metall freihalten.

Druckbares Bridge-Gehäuse

Zum Projekt gehören ein druckbarer Gehäusekörper, Deckel, eine IR-Senderkappe und zwei alternative Fußlängen. Einen vollständigen Satz aus vier gleich langen Füßen verwenden. Die Fotos zeigen die getestete äußere und innere Anordnung, ersetzen aber keine elektrische Prüfung.

Alle STL-Dateien herunterladen

ZIP mit allen fünf STL-Dateien. Für den Druck einen Satz aus vier gleichen Füßen wählen: lang oder kurz.

Verdrahtung und beaufsichtigte Tests am offenen Aufbau vor dem Schließen vollständig abschließen. Möglichst ein USB-C-Kabel mit kurzem Steckergehäuse verwenden; falls der Stecker dennoch zu lang ist, vier Exemplare des längeren Fußes fuss_1x_drucken_4x.stl einsetzen. Vor dem Aufsetzen des Deckels USB trennen, Adafruit-Sender und optionalen Lernempfänger auf ihre Öffnungen ausrichten, Kabel von Antenne und Kontakten fernhalten und anschließend Reichweite sowie Temperatur am geschlossenen Gehäuse erneut prüfen. Die separate Druck- und Gehäuseanleitung enthält den vollständigen Montageablauf und die Modellmaße.

Statusfarben der Bridge-LED

Die kleine RGB-LED sitzt auf dem ESP32-S3-Zero. Im normalen Betrieb ist sie aus. Für den dauerhaften Verbindungsstatus die Bridge-Seite in RoonPilot verwenden; eine dunkle LED bedeutet nicht, dass die Bridge ausgeschaltet oder getrennt ist.

LED-MusterBedeutung
Langsam blau pulsierendEin Pairingfenster ist geöffnet.
Zweimal kurz blauVerschlüsselte Bluetooth-Kopplung erfolgreich.
Mehrfach kurz blau für etwa 1,5 Sekunden„Bridge identifizieren“ wurde in RoonPilot ausgelöst.
Orange pulsierendDie Bridge wartet auf ein IR-Signal oder zeichnet es zum Lernen auf.
Zweimal kurz grünZwei passende IR-Aufnahmen wurden gespeichert. Nach violettem Pulsieren: Firmware angenommen, Neustart folgt.
Zweimal kurz rotIR-Lernen fehlgeschlagen oder abgelaufen. Nach violettem Pulsieren: Firmwareübertragung oder -prüfung fehlgeschlagen.
Violett pulsierendFirmware wird übertragen oder geprüft. Stromversorgung nicht trennen.

Nach einem kurzen Bestätigungssignal geht die LED wieder aus oder zeigt ein noch offenes Pairingfenster an. Wird das IR-Lernen abgebrochen, endet das orange Signal ohne rote Fehlermeldung.

3. Erste Factory-Installation

  1. Verdrahtung bei abgezogenem USB vollständig prüfen. Beim allerersten Boardtest die IR-Module abziehen, solange deren Pinbeschriftung nicht zweifelsfrei feststeht.
  2. Den Bridge-Webinstaller in einem aktuellen Desktop-Chrome oder Edge öffnen. Firefox, Safari, iPhone und iPad besitzen die erforderliche Web-Serial-Schnittstelle nicht.
  3. Das Bridge-Board direkt per USB anschließen. Arduino Serial Monitor, ESP-IDF Monitor und alle anderen Programme schließen, die den Port verwenden.
  4. Im Geräteauswahldialog des Webinstallers unter Windows USB JTAG/serial debug unit (COM…) beziehungsweise unter macOS USB JTAG/serial debug unit (cu.usbmodem…) wählen. Entscheidend ist der Name vor der Klammer. Eine vorherige Suche im Betriebssystem ist nicht nötig; der geöffnete Dialog erkennt ein abgezogenes und wieder angeschlossenes Gerät sofort. USB serial bezeichnet dort einen klassischen ESP32 und ist nicht die Bridge. Während der Installation nur die Bridge per USB anschließen.
  5. Die richtige Hardware, das vollständige Löschen und die Firmwarelizenz bestätigen, dann den Installer starten. USB bis zum vollständigen Abschluss von Installation und Neustart verbunden lassen.
Eine Factory-Installation löscht die komplette Bridge. Kennung, BLE-Bond, WLAN-Fallback und alle gelernten IR-Profile gehen verloren. Der Installer fordert das erforderliche Löschen selbst an; vorher keinen separaten Erase ausführen. Vor der Neuinstallation einer vorhandenen Bridge deren neueste Profile mit RoonPilots Bibliothek abgleichen und unter System → Configuration backup eine vollständige Sicherung erstellen. Beim Export muss die Bridge nicht mehr online sein. Die neu installierte Bridge erneut koppeln und beim Import ausdrücklich als Ziel auswählen; siehe Abschnitt 8.

Nach erfolgreicher Factory-Installation erzeugt die Bridge eine neue zufällige Kennung im Format RPB-XXXX-XXX und erlaubt die erste verschlüsselte Kopplung. Während des offenen Pairings pulsiert die RGB-LED langsam blau.

4. Bridge mit RoonPilot koppeln

Eine Bridge gehört derzeit genau zu einem RoonPilot. Die Kopplung mit einem anderen Controller ist ein bewusster Besitzerwechsel, keine gleichzeitige gemeinsame Nutzung.

  1. Die lokale RoonPilot-Weboberfläche öffnen und IR Bridge auswählen.
  2. Bridge & Bluetooth aktivieren, speichern und RoonPilot neu starten lassen. Bei deaktivierter Funktion wird kein Bridge-Bluetooth-Stack gestartet.
  3. Scan for Bridges wählen und die angezeigte RPB-…-Kennung mit der gewünschten Bridge vergleichen.
  4. Diese Kennung auswählen und das Pairing in RoonPilot bestätigen. Kein unbekanntes Gerät in der Nähe koppeln.
  5. Auf Encrypted and bonded, die installierte Bridge-Version und Ready warten. Zwei kurze blaue LED-Signale bestätigen den Erfolg; danach geht die LED aus.
  6. Vor dem Lernen von Profilen Test connection ausführen.

Für das normale Pairing ist kein von außen erreichbarer BOOT-Taster nötig. Hat später nur eine Seite ihre Bond-Daten verloren, die Bridge innerhalb von 15 Sekunden dreimal aus- und einschalten. Sie löscht dabei nur den Bond und öffnet das Pairing für fünf Minuten; Kennung und IR-Profile bleiben erhalten.

RoonPilot-Suche und verschlüsseltes Pairing mit einer fiktiven Bridge-Kennung
RoonPilot zeigt die eindeutige Factory-Kennung vor dem Bonding. Das Bild nutzt Dummydaten; die echte Kennung gehört zur frisch installierten Bridge.

Gespeichert ist nicht gleich gefunden

Saved IR Bridges zeigt die dauerhaften Kopplungen (bis zu vier). Pair a Bridge zeigt nur Geräte, die beim letzten zehnsekündigen BLE-Scan gehört wurden. „1 found“ kann also korrekt neben „2 / 4“ gespeicherten Bridges stehen. Kommt eine Bridge wieder in BLE-Reichweite, Scan for Bridges erneut drücken. Eine fehlende Fundkarte löscht weder Pairing noch WLAN-Steuerung.

Zwei gekoppelte Bridges, aber nur eine im letzten BLE-Scan gefunden
Beispiel: Wohnzimmer arbeitet außerhalb der BLE-Reichweite über WLAN weiter. Nach Rückkehr wird sie erst durch einen neuen Scan wieder in der Fundliste angezeigt. Schaubild groß öffnen.

Automatische Zonensteuerung und Manage

Die ausgewählte Roon-Zone bestimmt immer die benötigten IR-Routen. Bei einer Gruppe gehören dazu alle zugeordneten Bridges ihrer physischen Mitglieder. Manage öffnet eine andere gespeicherte Bridge nur für Wartung, Lernen, Diagnose oder Update; es ändert keine Zonenroute. Es gibt höchstens einen BLE-Link, aber mehrere getrennt authentifizierte WLAN-Wege. Bevor Manage oder Scan den BLE-Link beansprucht, prüft RoonPilot, dass aktive IR-Routen erreichbar bleiben, und lehnt einen unsicheren Wechsel ab. Nach der Wartung Return to zone control wählen; ohne Aktivität endet die Wartungsauswahl automatisch nach fünf Minuten.

Die ausgewählte Roon-Zone bestimmt die Ziel-Bridge und deren IR-Profil
Die Zonenroute ist unabhängig von der vorübergehenden Wartungsauswahl und vom jeweils benutzten Funkweg.
Wohnzimmer-Zonenbefehle gehen per WLAN an Wohnzimmer, während Arbeitszimmer per BLE verwaltet wird
Ein BLE-Link, zwei gleichzeitige Ziele: Die ausgewählte Zone bleibt über ihr eigenes geprüftes WLAN bedienbar. IR-Befehle werden nicht zur Wartungs-Bridge umgeleitet. Schaubild groß öffnen.

5. Optionaler WLAN-Fallback

Die Bridge hat keinen eigenen Einrichtungs-Access-Point. Aktiver Transport und beide Signalwerte stehen auf der Bridge-Seite von RoonPilot; das Quickmenü am Gerät zeigt ebenfalls den Bridge-Status.

BLE bleibt die bevorzugte Verbindung. Soll die Bridge in einem anderen Zimmer stehen, bei verbundener und gebondeter BLE-Bridge Allow Wi-Fi fallback aktivieren. RoonPilot überträgt dann einmalig seine aktuellen 2,4-GHz-Zugangsdaten und einen neuen 256-Bit-Anwendungsschlüssel durch die verschlüsselte BLE-Verbindung.

  1. Schalter aktivieren und Provisionierung bestätigen.
  2. Auf Connected and verified, Bridge-IP und Signalstärke warten.
  3. Mit Test Wi-Fi path einen authentifizierten WLAN-Befehl erzwingen, obwohl BLE verfügbar ist.

Die Befehle nutzen AES-256-GCM-Authentifizierung und Wiederholungsschutz. Ein Retry darf nicht unbemerkt einen zweiten IR-Befehl auslösen. Fehlerhafte Zugangsdaten werden nicht behalten, BLE bleibt der Rettungsweg und bei ausgeschaltetem Fallback startet das WLAN-Funkteil der Bridge nach einem Neustart nicht. RoonPilot und Bridge müssen ohne Client-/AP-Isolation im selben lokalen Netz liegen.

RoonPilot-Bridge-Status mit bevorzugtem BLE und aktiviertem authentifiziertem WLAN-Fallback
Auch nach der WLAN-Provisionierung bleibt BLE bevorzugt. Die Statuskarte zeigt aktiven Pfad, Bridge-Adresse, Signal und Schutz und ermöglicht einen erzwungenen WLAN-Test.

Ein schwankender dBm-Wert allein löst keine Umschaltung aus. RoonPilot hält einen funktionierenden Weg stabil, wechselt erst nach wiederholt bestätigten Verbindungsproblemen auf das bereits eingerichtete WLAN und kehrt bei neuer BLE-Nähe nicht sofort zurück. Ein IR-Befehl mit unklarem Ergebnis wird beim Wechsel nicht blind wiederholt.

Vier Phasen vom stabilen BLE-Weg über WLAN-Fallback bis zu einer geprüften BLE-Rückkehr
„Ready via Wi-Fi“ beschreibt den aktuellen Befehlspfad. Kopplung, Profil und Zuordnung zur Roon-Zone bleiben dabei erhalten. Schaubild groß öffnen.

6. IR-Profil erstellen und lernen

Bei mehreren Bridges benötigt nur eine einen IR-Empfänger. Mit dieser Lern-Bridge lassen sich die Profile für alle Zonen anlernen. RoonPilot speichert sie unabhängig von der Lern-Bridge und überträgt sie beim Speichern einer Zonenroute auf die gewünschte Ziel-Bridge – auch wenn diese keinen Empfänger besitzt.

  1. Unter IR profiles ein eindeutig benanntes Profil wie RME ADI-2 DAC anlegen und auf RoonPilot speichern. Dafür ist noch keine Bridge nötig. Üblicherweise 38 kHz Träger und 33 % Duty beibehalten, sofern das Gerät nichts anderes benötigt.
  2. Dieses Profil und eine Lern-Bridge mit IR-Empfänger auswählen. Sie muss nicht die spätere Ziel-Bridge sein. Der Lernmodus reserviert sie; solange er läuft, sendet sie keine normalen IR-Befehle.
  3. Neben Volume up auf Learn drücken. Während des Wartens pulsiert die Lern-Bridge-LED orange.
  4. Originalfernbedienung auf den KY-022 richten und die angeforderte Taste einmal kurz und sauber drücken.
  5. Bei Aufforderung denselben Druck wiederholen. Nur übereinstimmende Aufnahmen werden akzeptiert.
  6. Zwei kurze grüne Signale bedeuten Analyse und Speicherung; zwei rote Signale bedeuten Timeout, Abweichung oder Fehler.
  7. Die übrigen benötigten Tasten anlernen und mit Auf RoonPilot speichern die bestätigten Befehle in die dauerhafte Bibliothek übernehmen. Lernvorgang verwerfen lässt das Bibliotheksprofil unverändert. Erst nach Ende des Lernmodus und der Übertragung per Zonenroute das echte Gerät testen; während des Lernens sind normale IR-Sendebefehle gesperrt. Ein nicht beendeter Lernmodus läuft spätestens nach zehn Minuten automatisch ab.

Bekannte NEC- und Extended-NEC-Signale behalten Protokoll- und Repeat-Informationen; Unbekanntes bleibt als verlustfreies Roh-Timing nutzbar. Duty ist der aktive Anteil jedes Trägerzyklus – weder Tastendauer noch Wiederholungszahl. Beim Standardwert 33 % ist die LED eines 38-kHz-Trägers etwa 8,7 µs von jeweils 26,3 µs eingeschaltet.

Power besitzt zwei getrennte Slots. Ein kurzer Druck auf RoonPilot sendet Power on, ein langer Druck Power off. Beide Slots getrennt lernen oder prüfen, selbst wenn die Originalfernbedienung dieselbe physische Taste nutzt.
Benanntes IR-Profil in der RoonPilot-Bibliothek und Auswahl einer Lern-Bridge
Das Bibliotheksprofil bleibt auf RoonPilot; für die Aufnahme wird eine beliebige gekoppelte Bridge mit IR-Empfänger gewählt.
Vier Schritte von der Profilanlage über das Lernen bis zur Übertragung auf andere Bridges
Erst der Abschluss des Lernvorgangs sichert die bestätigten Aufnahmen auf RoonPilot. Die spätere Ziel-Bridge wird getrennt über die Zonenroute festgelegt. Schaubild groß öffnen.

7. Jede Zone zuordnen

Ist die Bridge-Steuerung eingeschaltet und eine zugeordnete Bridge nicht erreichbar, bleibt dieser Steuerweg offline. RoonPilot ersetzt den vorgesehenen IR-Lautstärke- oder Power-Befehl nicht unbemerkt durch einen nativen Roon-Befehl.

In Zone Management für jede sichtbare Zone einen Lautstärkeweg auswählen:

  • Roon / endpoint volume sendet die native absolute oder dB-Lautstärke des Endpunkts.
  • External IR Bridge sendet Volume up/down des ausgewählten Profils.
  • Disabled verwirft Lautstärkeaktionen bewusst.

Die Encoder-Schrittzahl wird pro Zone getrennt eingestellt. 2 Steps bedeutet zwei vollständige gelernte IR-Tastendrücke pro RoonPilot-Rastung, nicht einen künstlich gehaltenen Befehl. Beim validierten RME-Profil ergeben zwei physische 0,5-dB-Schritte daher exakt eine 1,0-dB-RoonPilot-Rastung.

Mute und Power lassen sich ebenfalls pro Zone aktivieren. Play/Pause, Previous und Next bleiben native Roon-Aktionen. Da eine inkrementelle IR-Steuerung keinen absoluten Wert zurückmeldet, zeigt das Display einen relativen + / −-Aktionszähler und erfindet keinen Lautstärkewert.

Für External IR Bridge eine gekoppelte Bridge und ein benanntes Profil aus der RoonPilot-Bibliothek wählen. Save überträgt und prüft das Profil automatisch auf der Ziel-Bridge und aktiviert erst danach die Route. Dasselbe Profil kann mehreren Bridges zugeordnet werden; ihre numerischen Profilplätze sind voneinander unabhängig.

Roon-Gruppen und mehrere Bridges

Eine ausgewählte Roon-Gruppe ersetzt die gespeicherten Routen ihrer Mitglieder nicht. RoonPilot löst jeden physischen Ausgang auf und kann deshalb bei derselben Ringbewegung native Zahlenwerte, native dB-Werte, relative Roon-Befehle und IR-Befehle über mehrere Bridges senden. Alle von der Gruppe benötigten Bridges werden überwacht; eine unerreichbare Bridge markiert nur ihr eigenes Mitglied als OFFLINE und führt niemals still auf ein anderes Profil zurück.

Das erste Ringraster öffnet den Gruppenmixer am Gerät, ohne die Lautstärke zu ändern. Weiterdrehen regelt die ganze Gruppe. Eine der großen Mitgliederzeilen antippen, um nur diesen Ausgang zu verändern; ein Tipp auf den Gruppenkopf kehrt zur Gesamtgruppe zurück. Das runde Display bietet bis zu drei einzeln auswählbare Zeilen, während das Drehen für die Gesamtgruppe weiterhin alle geeigneten Ausgänge verarbeitet.

Roon-Gruppe mit nativer Zahlenlautstärke, dB-Lautstärke und einer Infrarot-Bridge
Es gibt höchstens einen BLE-Link; mehrere authentifizierte WLAN-Wege können für dieselbe Gruppe gleichzeitig arbeiten. Schaubild groß öffnen.
RoonPilot-Gruppenmixer für die gesamte Gruppe
Bei der Gesamtgruppe bleiben Gruppenname und ehrliche Einheit jedes Ausgangs sichtbar.
RoonPilot-Gruppenmixer mit einzeln ausgewähltem Ausgang
Nach dem Antippen einer Zeile verändert der Ring nur diesen physischen Ausgang.

Verwenden mehrere Mitglieder dieselbe physische Bridge, sendet RoonPilot bewusst nur eine IR-Aktion je Raster an diese Bridge. Für unabhängige IR-Ziele sind unabhängige Bridges nötig. Die vollständige Anleitung zu Roon-Gruppen und Gruppenmixer erklärt gemischte Einheiten, Anzeigegrenzen, Fehlerbehandlung und ein ausführliches Beispiel.

BeispielrouteWiiM Ultra → RME ADI-2 DAC

Der Musiktransport läuft weiterhin über Roon und WiiM. Nur Lautstärke, Mute und Power gehen an die Bridge. Damit führt der RME selbst die Hardware-Lautstärkeänderung aus, seine Auto-Ref-Level-Funktion bleibt erhalten und die digitale Roon-Absenkung ersetzt nicht die RME-Regelung.

Zonenrouting mit nativer Roon-Steuerung, externer IR-Regelung und deaktivierter Lautstärke
Jede Zeile arbeitet unabhängig. Das Beispiel nutzt zwei IR-Zonen, einen nativen Roon-Endpunkt und einen bewusst deaktivierten Lautstärkepfad.

8. Gesamte Einrichtung sichern und wiederherstellen

Nach dem Lernen und Prüfen der IR-Befehle System → Configuration backup öffnen und Sicherung erstellen wählen. Eine JSON-Datei enthält RoonPilot-Einstellungen, Zonenrouten, HTTP-Power-Aktionen, jedes benannte IR-Profil einmal und getrennte Bridge-Zuordnungen. Die gelernten Impulse tragen Prüfsummen. Die Profile bleiben zusätzlich in einer Bibliothek auf RoonPilot gespeichert.

Die Sicherung liest die dauerhafte Profilbibliothek auf RoonPilot, nicht die gerade erreichbaren Bridges. Eine ausgeschaltete Bridge verzögert deshalb weder den Download noch macht sie die Datei unvollständig. Noch nicht mit der Bibliothek abgeglichene Änderungen können fehlen. Eine bekannte ältere Profilkopie auf einer Bridge erzeugt einen Warnhinweis; maßgeblich bleibt die Bibliotheksversion.

WLAN-Zugangsdaten, Roon-Autorisierung, Transportschlüssel und BLE-Bonds gehören nicht zur Sicherung. Unter Maintenance gibt es keinen zweiten Sicherungsschritt. Eine kompatible Konfigurationssicherung lässt sich auch bei abgeschaltetem Bridge & Bluetooth importieren. Nach Factory-Installation oder Boardtausch die Bridge erneut koppeln und im Importdialog auswählen. Dasselbe Profil kann an mehrere Bridges übertragen werden, auf jeder mit neuer lokaler Profil-ID. Zonenrouten erfordern ein ausdrücklich gewähltes Ziel; alte numerische IDs gelten nicht automatisch weiter. Mehr dazu in der Anleitung zu Sicherung und Wiederherstellung.

Eine ausgeschaltete Bridge bricht die Wiederherstellung nicht ab. RoonPilot stellt Einstellungen und Profilbibliothek wieder her, fährt mit erreichbaren Bridges fort und nennt unbestätigte Übertragungen zur späteren Vervollständigung. Eine IR-Route ohne geprüfte aktuelle Zuordnung bleibt unverändert. Ist die Bridge wieder erreichbar, den Import wiederholen oder das wiederhergestellte Bibliotheksprofil übertragen und die betroffene Route speichern.

RoonPilot-Systemseite mit gemeinsamer Sicherung und Wiederherstellung
Eine Datei enthält Geräteeinstellungen, Bibliotheksprofile und Bridge-Zuordnungen. Offline-Ziele werden beim Restore zurückgestellt, nicht als fehlgeschlagene Gerätewiederherstellung behandelt.
Schaubild einer Sicherung mit eigenständigen Profilen und getrennten Bridge-Zuordnungen
Bereits abgeglichene Profile bleiben auch bei vorübergehend unerreichbarer Bridge enthalten.

9. Signierte Onlineupdates

Nach der ersten Factory-Installation werden normale Bridge-Updates unter IR Bridge → Bridge firmware update von RoonPilot verwaltet. USB-Zugang und lokale BIN-Auswahl sind im Normalfall nicht mehr nötig.

  1. Bei aktivierter Bridge darf RoonPilot das HTTPS-Manifest nach dem Start und danach höchstens alle 24 Stunden prüfen. Updateprüfung und die tägliche Gerätemeldung sind getrennte Einstellungen.
  2. Installierte und verfügbare Bridge-Version werden auf der Seite angezeigt. Ein auffälliger Hinweis in der Statuszeile führt direkt zur Updatekarte; die quittierbare Gerätemeldung wartet das Ende wichtiger Bedienvorgänge ab.
  3. Die Installation startet niemals automatisch. Download and install muss ausdrücklich gewählt und bestätigt werden.
  4. RoonPilot prüft Kanal, Projekt, Board, Protokollbereich, erforderliche Controller-Version, Größe, SHA-256, ESP32-S3-Ziel und eingebettete Version vor der Übertragung.
  5. Für die Übertragung hat authentifiziertes WLAN Vorrang. Ist das normale Bridge-WLAN ausgeschaltet, BLE aber gebondet, darf RoonPilot WLAN vorübergehend bereitstellen und aktivieren, das Image übertragen und nach der Wiederverbindung den vorherigen Aus-Zustand wiederherstellen. Verschlüsseltes BLE bleibt der langsamere Wiederherstellungsweg, wenn WLAN nicht nutzbar ist.
  6. Die Bridge prüft Reihenfolge, Größe, SHA-256 und RSA-3072-Signatur unabhängig, bevor sie die inaktive A/B-Partition aktiviert.
  7. Erfolg erscheint erst nach der Wiederverbindung mit exakt der angeforderten Version. ESP-IDF-Rollback bleibt verfügbar, falls die neue Anwendung ihren Start nicht bestätigen kann.

Ist Bridge & Bluetooth deaktiviert, erfolgen weder Bridge-Scan noch Updateanfrage, Webhinweis oder Displaymeldung. Der normale RoonPilot-Updatekanal bleibt davon unabhängig.

Von RoonPilot verwaltetes signiertes Onlineupdate der IR Bridge
Installierte und verfügbare Version, tägliche Prüfung, Gerätemeldung und manuelle Installation werden in RoonPilot verwaltet. Der lokale Image-Pfad bleibt ein Wiederherstellungswerkzeug.

10. Fehlerbehebung

Infrarot benötigt Sichtkontakt oder brauchbare Reflexionen. Reagiert das Audiogerät trotz verbundener Bridge nicht, zuerst Senderposition und gelernten Befehl prüfen, bevor die Schrittzahl der Zone verändert wird.

Kein serielles Gerät im Installer

Datenfähiges Kabel verwenden, serielle Monitore schließen, ohne Hub verbinden, dann BOOT beim Einstecken halten und nach Erscheinen des Ports loslassen.

Bridge wird nicht gefunden

Bridge & Bluetooth muss aktiviert und gespeichert sein. Bei früher gekoppelter Bridge die Dreifach-Strom-Recovery nutzen und im fünfminütigen blauen Pairingfenster scannen.

Lernen läuft in einen Timeout

KY-022-Pinbeschriftung prüfen, mit 3,3 V versorgen, Sonnenlicht reduzieren, Originalfernbedienung näher halten und zweimal gleich kurz drücken.

Falscher Lautstärkeschritt

Zuerst genau einen gelernten Befehl mit Test prüfen. Danach die zoneneigene Schrittzahl kontrollieren; eine schlechte Aufnahme nicht durch eine größere Zahl kaschieren.

WLAN-Fallback verbindet nicht

Während gebondetem BLE provisionieren, 2,4 GHz verwenden, beide Geräte ins gleiche LAN bringen und AP-/Client-Isolation abschalten. Nach einem fehlgeschlagenen Ersttest muss BLE weiter erreichbar bleiben.

Kein Update angeboten

Bridge-Funktion und Bridge-Updateprüfung aktivieren, danach die manuelle Prüfung der Updatekarte nutzen. Ein älterer unsignierter Teststand kann zunächst eine kabelgebundene Migration benötigen.

Schritt für Schritt zur eigenen Bridge

Erst nach geprüfter Verdrahtung installieren.

Bridge-Webinstaller öffnen