KNX-proServ IP entension for SONOS® Version 1.x Bleu Comm’ Azur EURL 180, imp. du Baou 06560 Valbonne FRANCE www.knxware.com 25.04.2014 Inhalt ALLGEMEINES ZU DIESEM GERÄT................................................................................ 3 FUNKTIONEN ......................................................................................................................... 3 INSTALLATION ..................................................................................................................... 4 IP ADRESSVERGABE .................................................................................................................. 4 FESTSTELLEN DER SONOS ZONEN .......................................................................................... 4 RADIOSTATIONEN ...................................................................................................................... 5 KNX KONFIGURATION .............................................................................................................. 5 URL SCHEME 1: .......................................................................................................................... 6 URL SCHEME 2: .......................................................................................................................... 6 URL SCHEME 3: .......................................................................................................................... 7 PROSERV PROGRAMMIEREN ...................................................................................................... 7 IP EXTENSION PROGRAMMIEREN ............................................................................................. 7 WIEDERHERSTELLEN DER IKNIX KONFIGURATION ................................................................. 8 BESCHREIBUNG DER GRUPPENADRESSEN................................................................. 8 SUPPORT FORUM ................................................................................................................. 9 2 Allgemeines zu diesem Gerät Die Software zu dieser proServ IP Extension basiert auf openHAB. Alle Parameter, die zur Kommunikation zwischen den SONOS Systemen und dem KNX Bus erforderlich sind, können über die ETS Produktdatenbank des KNX-proServ festgelegt werden. Es werden weder Kenntnisse zu openHAB oder zu Linux vorausgesetzt. Das Gerät wurde entwickelt, um die SONOS Grundfunktionen über den KNX Bus zu ermöglichen. Sie wurde nicht dafür entwickelt, SONOS über unsere iKnix Applikation zu bedienen! Hierfür ist nach wie vor das URL scheme mit dem Wechsel in die SONOS App bzw SONOPAD App wesentlich leistungsfähiger, da man mit diesen Applikationen insbesondere auch die Musikbibliothek durchsuchen kann. Für Informationen zur Benutzung des URL schemes um in eine andere App zu wechseln und wieder zurückzuspringen verweisen wir z.B. auf http://sonopad.com/improved-homeautomation-integration/ oder http://sonophone.net/home-automation-integration/. Bei der IP-Extension handelt es sich um ein vorkonfektioniertes Hutschienenmodul. Der Lieferumfang beinhaltet: Hutschienenmodul (4TE) 230 VAC Spannungsversorgung als Steckernetzteil (gegen geringen Aufpreis auch als Hutschienenmodul mit 1TE) SD Speicherkarte ETS Softwareprojekt (SONOS.pr5) für ETS3 oder ETS4 Die IP Extension kann nur mit dem KNX proServ konfiguriert werden. Auch der Betrieb ist nur gemeinsam mit dem proServ möglich! Funktionen Es können bis zu fünf SONOS Zonen über den KNX Bus bedient werden. Auch gruppierte Zonen werden erkannt und von den KNX Teilnehmern gemeinsam gesteuert. Folgende Funktionen stehen dafür zur Verfügung: Start/Stop (als Taste mit Rückmeldung) Lauter (als Taste) Leiser (als Taste) Lautstärke als Wert (0...100, 1Byte) Mute/Unmute (als Taste mit Rückmeldung) Next Previous Auswahl Radiostation (1 Byte Wert) Nächste Radiostation (als Taste) Vorherige Radiostation (als Taste) Info (Rückmeldung) zu Radiostation (als 14Byte char) Info (Rückmeldung) zu Titel (als 14Byte char) 3 Info (Rückmeldung) zu Interpret (als 14Byte char) Info (Rückmeldung) zu Album (als 14Byte char) Aktuelle Lautstärke (0...100, 1Byte) Installation Die mitgelieferte SD Karte an der Oberseite des Moduls vor Anschluss der Betriebsspannung einschieben. Darauf achten, dass die Kante mit den Kontakten voraus eingeschoben wird. Die Kontakte müssen einem dabei zugewendet sein. Das Hutschienenmodul wird im Schaltschrank montiert und benötigt nur den Spannungsanschluss (Micro USB Anschluss an der Oberseite des Moduls) und Ethernet Anschluss (Unterseite des Moduls). IP Adressvergabe Das Modul wird im DHCP Modus ausgeliefert und benötigt eine feste IP Adresse im Netzwerk. Die Adressvergabe muss über den verwendeten IP Router vorgenommen werden. Dazu muss die MAC Adresse des Moduls im Router einer IP Adresse zugeordnet werden. Die MAC Adresse ist vorne am Modul abgedruckt. Feststellen der SONOS Zonen Das SONOS System muss vor der Konfiguration der IP Extension korrekt eingerichtet sein. Es können natürlich auch weniger oder mehr Zonen eingerichtet sein, als die fünf vom Gerät gesteuerten Zonen. Wenn mehr Zonen eingerichtet sind, müssen fünf davon ausgewählt werden, die - über KNX gesteuert werden sollen - häufig oder ständig miteinander gruppiert werden Als eine SONOS Zone zählt dabei jeweils - einzelner Play:1, Play:3 oder Play:5 - als Stereo gruppierte Play:1, Play:3, Play:5 Lautsprecher (hier zählt nur der linke Lautsprecher!) - ein ZP90 oder ZP120 - ein Playbar - ein Playbar mit dazu kombinierten Lautsprechern oder ZPs (hier zählt nur der Playbar) Ein Subwoofer oder eine Bridge brauchen nicht gezählt werden Um die SONOS Zonen zu identifizieren, müssen die Seriennummern der Zonen festgestellt werden. Hierzu einen SONOS Controller starten (App iOS, Android oder PC) und in den Einstellungen „über das SONOS-System“ die Seriennummer der zu zählenden Geräte notieren: z.B. „Seriennummer: B8-E9-37-38-0D-2C:F“ Der später zur Konfiguration erforderliche String wird: „RINCON_B8E937380D2C01400“ Nur die rote Buchstaben-/Zahlenkombination austauschen! 4 Radiostationen Fünf verschiedene Radiostationen können direkt über KNX Befehle gestartet werden. Die Stationen müssen zunächst über einen SONOS Controller (iOS, Android oder PC) festgelegt werden. Eine gewünschte Station über die Rubrik „Radio“ zu suchen und auszuwählen. Im anschließenden Dialog ist „Info & Optionen“ und „Meinen Radiosendern hinzufügen“ auszuwählen. Die so ausgesuchten Sender stehen anschließend direkt unter „Radio“ -> „Meine Radiosender“ zur Verfügung. KNX Konfiguration Zur Konfiguration der IP Extension ist ein KNX-proServ notwendig. Dieser kann vom Hersteller iKnix oder BleuCommAzur sein (Hersteller ist auf der Seite des Moduls abgedruckt) Das KNX Projekt unter folgendem Link downloaden: http://www.proknx.com/downloads/pk/SONOS.pr5 Diese Projekt in die ETS3 oder die ETS4 importieren. Achtung: Der Import kann bis zu 30 Minuten dauern!!! Nach dem Import das Projekt „SONOS“ öffnen, den KNX-proServ in der Topologie markieren und kopieren (Strg-C). Achtung: Es ist der proServ auszuwählen, der dem Hersteller des eingebauten proServ entspricht (iKnix oder BCA – BleuCommAzur). Jetzt das Projekt der eigenen Installation öffnen. Achtung: Die Gruppenadressenebene 10/x/x muss frei sein. Sollte dies nicht der Fall sein, muss die vorhandene 10/x/x Ebene auf eine andere Ebene umgelegt werden. Dies kann erfolgen, indem ganz einfach die Hauptebene 10 auf eine andere freie Ebene umgelegt wird. Im Anschluss müssen die Geräte, die mit dieser Ebene kommuniziert haben, wieder neu programmiert werden (nur Applikationsprogramm programmieren, physikalische Adresse kann natürlich beibehalten bleiben). Nun in der Topologie den Linienkopf (z.B. 1.1 Linie) markieren und mit der rechten Maustaste „Inhalte einfügen“ wählen. Im Dialog unter Gruppenadressen „Beibehalten“ anwählen und mit OK bestätigen. Mit dieser Aktion wurden alle Gruppenadressen für die SONOS Steuerung der fünf Zonen angelegt: 5 Ausserdem wurde ein proServ in der Topologie hinzugefügt. Dieser dient zur Konfiguration. In den Parametern des neu eingefügten proServ sind nun folgende Einstellungen durchzuführen: URL scheme 1: #SONOS#<IP-Adresse der IP-Extension>#<Identifikation der Zone1>#<Identifikation der Zone2>#<Identifikation der Zone3>#<Identifikation der Zone4>#<Identifikation der Zone5> Die <IP Adresse der IP-Extension> so eingeben wie unter Kapitel IP-Adressvergabe festgelegt. Die <Identifikation der Zone x> so eingeben, wie in Kapitel Feststellen der SONOS Zonen beschrieben. Es können bis zu fünf RINCON Strings eingegeben werden. Bei weniger Zonen wird entsprechend gekürzt. URL scheme 2: #RADIO#<Name des Radiosenders1>#<Name des Radiosenders2>#<Name des Radiosenders3>#<Name des Radiosenders4>#<Name des Radiosenders5> 6 Der <Name des Radiosenders x> muss buchstabengenau (wie im Kapitel Radiostationen beschrieben) eingegeben werden. Es können bis zu fünf Radiosender eingegeben werden. Bei weniger Sendern wird entsprechend gekürzt. URL scheme 3: [#ALTIP#<IP-Adresse des proServ>] Die alternative IP Adresse <IP Adresse des proServ> ist optional und wird nur dann benötigt, wenn die Kommunikation im Anschluss an die Parametrierung nicht über den proServ laufen soll. Der gesamte Eintrag kann in den meisten Fällen weggelassen werden! proServ programmieren Um nicht die physikalische Adresse des proServ neu zu vergeben, kann der „alte proServ“ im Projekt auf eine freie physikalische Adresse geparkt werden, und der „neue proServ“ mit der dieser Adresse versehen werden. Außerdem muss noch die verwendete, manuell vergebene IP Adresse des alten proServ in den Parametern des neuen proServ eingetragen werden. Nach dieser Parametrierung kann der vorhandene proServ programmiert werden. Hinweis: Die Kommunikation zum KNX Bus erfolgt über den KNXnet/IP „Tunnel“. Der KNX-proServ erlaubt die Kommunikation über bis zu fünf Tunnel. Um gleichzeitig die SONOS Kommunikation und die ETS Programmierung zu ermöglichen, sollte die Programmiertaste des proServ solange gedrückt werden, bis die Programmierled blinkt. Es können weiterhin bis zu 10 iKnix Clients (iOS und Android) gleichzeitig und zusätzlich zur SONOS Kommunikation betrieben werden. IP Extension programmieren Die Programmierung der IP Extension erfolgt nun ganz einfach, indem eine der iKnix Apps gestartet wird und der proServ im Netzwerk gesucht wird (unter (i) bzw. INFO in der App) Nach Bestätigung des gefundenen proServ mit OK wird über einen Dialog mitgeteilt, dass die SONOS Konfiguration übertragen wurde. Jetzt die IP Extension nochmals neu starten, damit die übertragene Konfiguration zum Tragen kommt! (Versorgungsspannung für ein paar Sekunden wegnehmen) Nach dem Neustart dauert der Hochlauf der IP Extension etwa 10 Minuten! Testweise können die verschiedenen SONOS Zonen mit der iKnix Oberfläche bedient werden. 7 Wiederherstellen der iKnix Konfiguration Die SONOS Kommunikation ist nun fertig eingerichtet. Wir empfehlen die physikalische Adresse des „SONOS proServ“ in der ETS nun auf eine freie Adresse zu parken und ihn als „nur zur Konfiguration benötigt“ in der Bemerkung des Gerätes zu kennzeichnen. Der ursprüngliche proServ kann nun wieder seine physikalische Adresse bekommen und programmiert werden. Beschreibung der Gruppenadressen Die folgenden Gruppenadressen wurden durch die Kopie des proServ in das eigene Projekt erzeugt und können nun frei verwendet werden. 8 10/0/0 Diese Adresse schaltet alle Zonen gemeinsam ein oder aus, auch unabhängig von einer Gruppierung 10/x/1 Startbefehl der Zone x mit „1“, Stoppbefehl der Zone x mit „0“. Sollte die Zone mit einer oder mehreren Zonen gruppiert sein, werden auch diese bedient! Status der Zone x (gestartet oder gestoppt) Lautstärkeverstellung der Zone x mit einem 1 Byte Wert. (Wertebereich 0...100) auch wenn die Zone mit einer anderen Zone gruppiert ist, wird die Lautstärke von nur dieser Zone verstellt. Rückmeldung der aktuellen Lautstärke als Wert Lautstärkeverstellung relativ: Mit EIN-Telegramm lauter, mit AUS-Telegramm leiser. Zum kontinuierlichen Verstellen der Lautstärke muss das Telegramm mehrfach gesendet werden. Das EIN-Telegramm löst auch einen Start der Zone aus. Stummschaltung der Zone x mit „EIN“, Normalbetrieb mit „AUS“. Gegenüber dem Start/Stopp ermöglicht dieser Befehl die Stummschaltung auch einer gruppierten Zone, ohne dass andere Zonen gestoppt werden. Rückmeldung der Stummschaltung Info, keine Steuerungsmöglichkeit Titel als 14 Byte Character bei Playlisten, Zusatzinfo bei Radioprogrammen Artist als 14 Byte Character bei Playlisten, Radiostation bei Radioprogrammen Album als 14 Byte Character bei Playlisten, Zusatzinfo bei Radioprogrammen Nächster Titel für Playlisten bei EIN Telegramm Vorheriger Titel für Playlisten bei EIN Telegramm Radiostation Auswahl relativ: Mit EIN-Telegramm nächster Sender, mit AUSTelegramm vorheriger Sender. Wenn eine Playlist angewählt war, wird diese durch das Radioprogramm unterbrochen. Radiostation Auswahl absolut (1 Byte): Mit den Werten 1 ... 5 erfolgt die Direktwahl des hinterlegten Radiosenders. Mit 0 wird die Zone gestoppt. Wenn eine Playlist angewählt war, wird diese durch das Radioprogramm unterbrochen. Die GA ermöglicht auch die Einbindung des Radiosenders in eine Szene. Rückmeldung Aktueller Radiosender (nicht bei gruppierter Zone) 10/x/2 10/x/3 10/x/4 10/x/5 10/x/6 10/x/7 10/x/8 10/x/9 10/x/10 10/x/11 10/x/12 10/x/13 10/x/17 10/1/18 10/x/19 Support Forum If you have any questions or even suggestions, please have a look to our support forum at: www.knx-user-forum.de/proserv/ 9 Christian Kiefel Copyright 2014 The Software that comes with the SD-Card is based on openHAB. The proServ IP-Extension and openHAB are distributed and licensed under the Eclipse Public License (EPL). If you have any suggestions to this software, please don’t hesitate to contact us. This work may be used in whole or part for commercial or non-commercial use. The KNX proServ controller and the IP extension may be ordered directly through our website www.knxware.com. Redistribution of the documentation without the controller is prohibited and requests for same should be sent to the author. 10