🧮Port- und Bridge-Planer
Jede HAP-Instanz ist eine eigene Bridge mit eigenem Port. Der Planer rechnet aus, welche Ports dein Aufbau belegt, liefert die Liste für die Firewall der Zentrale und warnt, wenn eine Bridge zu voll wird.
🧱Planer
9874 9875 9877 9878 9879
Die Firewall der Zentrale führt eine Liste benutzerdefinierter Ports. Welches Trennzeichen das Eingabefeld deiner WebUI-Version erwartet, ließ sich für diese App nicht belegen – deshalb mehrere Schreibweisen zur Auswahl. Die Portnummern selbst folgen README und Quelltext.
Rechenregel: Anzahl der Bridges = aufgerundet (Geräte ÷ 149), gleichmäßig verteilt. In der Praxis ergibt sich die Aufteilung meist von selbst, weil man ohnehin je Raum eine Instanz anlegt.
MAX_ACCESSORIES = 149 – „Maximum number of bridged accessories per bridge“. Mit der Bridge selbst sind das die 150 Zubehör-Kennungen, die auch die Home-Assistant-Dokumentation als Grenze der HAP-Spezifikation nennt. In der Dokumentation des Addons wird die Grenze nicht erwähnt.📐Die Regel dahinter
currentPortNum = 9877
für jede Instanz (in der Reihenfolge der config.json):
für jedes nicht gebridgte Gerät der Instanz: Port = currentPortNum; currentPortNum + 1
Bridge der Instanz: Port = currentPortNum; currentPortNum + 1Ohne Einzelgeräte gilt also schlicht Port = 9877 + Nummer der Instanz. Das einzige Gerät, das sich im Quelltext als „nicht gebridgt“ ausweist, ist die Video-Türklingel (HomeMaticSPVideoDoorBellAccessory): Sie wird als eigenständiges Zubehör veröffentlicht und verbraucht einen Port vor ihrer Bridge. Die festen Ports 9874 (Konfigurationsseite) und 9875 (Ereignisserver) stehen direkt im Quelltext; der CUxD-Server nimmt den Ereignisport plus eins.