🎛️Konfiguration
Die Konfigurationsseite des Addons läuft auf Port 9874. Hier ist sie als Modell nachgebaut – mit einem erfundenen Musterhaus. Lege Instanzen an, ordne Kanäle zu, veröffentliche sie und beobachte rechts, was in HomeKit ankommt und was in der config.json steht.
🗺️Der rote Faden
Zentrale (CCU) Config-WebUI :9874 HomeKit
┌─────────────────┐ ┌──────────────────────────────┐ ┌────────────────┐
│ Räume │ ─────> │ 1 HomeKit Instanzen │ koppeln ─>│ Bridge je Raum │
│ Geräte / Kanäle │ ─────> │ 2 Geräte > Service > Instanz │ │ │
│ Systemvariablen │ ─────> │ 3 Variablen (+ Trigger) │ veröffent- │ Geräte im Raum │
│ Programme │ ─────> │ 4 Programme │ lichen ─>│ der Bridge │
└─────────────────┘ │ 5 Besondere Geräte │ └────────────────┘
│ 6 Veröffentlichung │
└──────────────┬───────────────┘
│
gespeichert in config.json + persist/🧪Config-WebUI zum Ausprobieren
🏠 HomeKit Instanzen
im Wiki: „HomeKit Instances“Liste der Bridges mit Name, Raum, Port und PinCode. Neu anlegen, bearbeiten, zurücksetzen, deaktivieren; der QR-Code zum Koppeln ist verlinkt.
| Name der Instanz | In HomeKit | Port | PinCode |
|---|---|---|---|
| Wohnzimmer | HomeMatic Wohnzimmer | 9877 | 482-19-365 |
| Kueche | HomeMatic Kueche | 9878 | 492-29-466 |
Namen ohne Sonderzeichen wählen (hier deshalb „Kueche“). Die Bridge heißt in HomeKit „HomeMatic <Name>“; Port = 9877 + Position in der Liste. Die PinCodes sind erfundene Beispiele im Format, das das Addon erzeugt.
{
"useCCCAuthentication": false,
"useTLS": false,
"enableMonitoring": false,
"forceCache": false,
"interfaceWatchdog": 300,
"instances": {
"00000000-0000-4000-8000-000000000001": {
"name": "Wohnzimmer",
"user": "12:34:56:00:00:01",
"pincode": "482-19-365",
"roomId": 1,
"publishDevices": false
},
"00000000-0000-4000-8000-000000000002": {
"name": "Kueche",
"user": "12:34:56:00:00:02",
"pincode": "492-29-466",
"roomId": 2,
"publishDevices": false
}
},
"channels": [],
"mappings": {}
}Aufbau wie in der Konfigurationsseite gespeichert (instances, channels, mappings). Kennungen, Codes und Seriennummern sind erfunden.
🏠Warum eine Bridge je Raum?
Das Problem
Das HomeKit Accessory Protocol kennt keine Räume. Alle Geräte einer Bridge erscheinen zunächst im Raum der Bridge – bei vielen Geräten müsste man jedes einzeln in der Home-App verschieben.
Die Lösung des Addons
Mehrere Bridges („HAP-Instanzen“), eine je Raum. Jede wird einmal gekoppelt und einem Raum zugewiesen. Ein Gerät, das man später der Instanz hinzufügt, landet automatisch dort. Ein Gerät darf auch mehreren Instanzen zugeordnet werden.
Der Preis
Jede Instanz belegt einen eigenen Port ab 9877 und braucht eine Firewall-Freigabe. Viele Räume bedeuten viele Bridges in HomeKit – und viele Kopplungen, die bei einem Verlust des Ordners persist neu gemacht werden müssen.
🔐HTTPS und Anmeldung
/etc/config/server.pem) – der Browser zeigt also dieselbe Zertifikatswarnung.