Änderungen und Kompatibilität

Änderungen seit Version 2.8, die bestehende Integrationen betreffen

Diese Seite sammelt die Änderungen seit Version 2.8, die eine bestehende Integration betreffen können: entfernte Aufrufe, geänderte Formate und neue Anforderungen. Neue Aufrufe stehen in den Versionshinweisen und in der API-Referenz.

Welche Version ein Controller hat, liefert softwareUpdateCheck im Feld versionInstalled. getVersion nennt dagegen die Versionen der einzelnen Bausteine (api, ncd, engine), nicht die des Controllers.

3.1.0

Versionshinweise 3.1.0

• Kennwort für Administratoren: Ein Administratorkonto braucht ein Kennwort mit mindestens 6 Zeichen. Wer eines mit kürzerem oder leerem Kennwort anlegt oder ändert, bekommt Fehlercode 106 („Administratorkonten benötigen ein Kennwort mit mindestens 6 Zeichen“; der Text folgt der Sprache der Verbindung). Bestehende Konten bleiben, wie sie sind.
• Software-Updates: softwareUpdateCheck, getAutoSoftwareUpdateInfo, enableAutoSoftwareUpdate und installSoftwareUpdates unterscheiden zwischen Sicherheits- und Funktionsupdates. Neu ist postponeSoftwareUpdate.
• Node-RED: Version 5.0.7.

3.0.0

Versionshinweise 3.0.0

• Entfernt: getUserAuth, enableUserAuth und disableUserAuth.
• Geändertes Format: getSystemSerialPorts liefert Objekte mit Gerätepfad und Beschreibung der angeschlossenen Hardware statt einer Liste von Gerätepfaden.
• MQTT: Der Controller verwendet nur noch seinen eigenen Broker; ein externer Broker lässt sich nicht mehr einstellen. Controller und Engine melden sich mit eigenen, automatisch verwalteten Konten an, sodass ein Umbenennen des MQTT-Benutzers ihre Verbindung nicht mehr trennt. Siehe MQTT.
• Kameras: Liste und Stream einer Kamera richten sich nach den Raumrechten des Benutzers.
• Kamera- und Coverbilder: Die Weiterleitung der Bilder verlangt eine Anmeldung. Wer keine Sitzung mitschicken kann, holt mit getForwarderToken ein kurzlebiges Token für genau ein Bild.
• Benutzer: Der Anzeigename ist auf 64 Zeichen begrenzt. Mit setCurrentUser ändert ein angemeldeter Benutzer seinen eigenen Anzeigenamen ohne Administratorrechte.

2.8.7

Versionshinweise 2.8.7

• Systemvariablen: Der Parameter defaultValue entfällt bei addSystemVariable und setSystemVariable, in den Antworten von getSystemVariable und getSystemVariables und im Event onSystemVariableAdded.

2.8.5

Versionshinweise 2.8.5

• MQTT: Beim Einschalten des Skills erzeugt der Controller Zugangsdaten, wenn noch keine gesetzt sind. Clients, die sich bisher ohne Anmeldung verbunden haben, brauchen danach Benutzername und Kennwort.

2.8.4

Versionshinweise 2.8.4

• MQTT: Sind Zugangsdaten gesetzt, sichert der Controller den eigenen Broker damit ab und weist Clients ohne Anmeldung ab. Die Sicherheitsprüfung warnt, wenn keine gesetzt sind.
• mRemote: Der Port 5500 für die mRemote-Oberfläche ist geschlossen.

2.8.2

Versionshinweise 2.8.2

• Socket.io v4: Aktuelle Clients verbinden sich mit Socket.io v4 über den Pfad /socket.io-v4. Der Pfad /socket.io für Socket.io v2 bleibt erhalten. Siehe Verbinden und Anmelden.
• Dateien hochladen: Die Aufrufe importKNXProject, importLutronProject, importAddonProfile, importBackup, importRoomImage, importFloorImage, importKeyfile, importLogo und importUpdate nehmen Dateien direkt entgegen, als Alternative zur Bibliothek SocketIOFileUpload.
• MCP: Der Controller bietet einen MCP-Server an (Beta). Siehe MCP.
• Entfernt: setTimerPosition, setNotificationPosition und die Aufrufe für tado°.
• KNX-Projekte: downloadKNXProject, removeKNXProject, getKNXMainGroups, getKNXMiddleGroups, getKNXTopology und getKNXGroupAddresses nehmen den Projektnamen als Parameter und antworten mit Fehlercode 112, wenn es das Projekt nicht gibt.
• Node-RED: node-red-contrib-nomos ab Version 1.5.3 braucht einen Controller ab Version 2.8.2. Siehe Node-RED.

2.8.1

Versionshinweise 2.8.1

• Raum- und Szenenrechte: Rechte lassen sich je Benutzer und Gruppe auf Räume und Szenen einschränken, mit den Aufrufen getUserRoomPermission, setUserRoomPermission, getUserScenePermission, setUserScenePermission und ihren Gegenstücken für Gruppen. Ein eingeschränkter Benutzer liest und schaltet über die API nur, was diese Rechte erlauben.

2.8.0

Versionshinweise 2.8.0

• Hardware: Controller mit ARM-v7-Prozessor werden nicht mehr unterstützt.