Libratone Zipp WLan Lautsprecher

Die WLan Lautsprecher von Libratone (Zipp, Zipp Mini, Zipp 2 und Zipp 2 Mini) lassen sich mit UDP Paketen recht simpel steuern. Einige Nachforschungen via Wireshark, Reverse-Engineering der App und simplen Testverfahren, konnte ich bisher einige Befehle herausfinden, die dann via Loxone steuerbar sind. Die Befehle können via Hex-Code als UDP Paket übermittelt werden. Nachfolgend eine Tabelle mit einem Auszug der möglichen Kommandos mit einer kurzen Beschreibung. In Loxone kann ein Libratone Lautsprecher dann via virtuellem Ausgang und Ausgangsbefehlen verwendet werden. Eine Vorlage dazu habe ich dem Artikel weiter unten angehängt.

Voraussetzung zur Nutzung einer Libratone WLan Box via Loxone:

• Libratone Box ist bereits im gleichen Netzwerk wie Loxone vorhanden (WLan ist bereits eingerichtet)

Auszug einiger Befehle

Nachfolgend befindet sich eine Liste mit möglichen Kommandos, mit denen man die Libratone Box problemlos über WLan steuern kann.

Die Befehle setzen sich aus Füll-Zeichen (irgendein ASCII Zeichen oder leeren Control Characters wie bspw. \x00), aus Control Characters (\x02 für "STX" = "Start of Text", mehr Details hier: https://en.wikipedia.org/wiki/C0_and_C1_control_codes) und der eigentlichen Anweisung (bspw. STOP, also \x53\x54\x4f\x50) zusammen.

Die "Control Codes" werden sehr wirr und eigentlich nicht für die dafür vorgesehenen Zwecke genutzt. Ein richtiges Muster oder einheitliches Vorgehen konnte ich leider nicht entdecken bei der Verwendung einiger Hex-Codes als Steuerzeichen. Also ist die Referenz auf die Control Codes vermutlich nicht zielführend.

Einrichtung in Loxone Config via virtuellem Ausgang (UDP)

Die Einrichtung in Loxone ist denkbar einfach und mit der hier verlinkten XML-Datei schnell erledigt: VO_LibratoneZipp.xml

Schritt-für-Schritt Anleitung:

1. Die XML Datei herunterladen (VO steht für "Virtual Output") und lokal abspeichern.
2. In der Loxone Config dann die xml-Datei importieren über "Virtuelle Ausgänge > Vordefinierte Geräte > Vorlage importieren..."
   
   Screenshot: Vorlage importieren in Loxone Config
   
   
3. Dann die Daten des virtuellen Ausgangs noch entsprechend anpassen (Namen und IP Adresse ändern)
   
   Screenshot: Konfiguration des virtuellen Ausgangs
4. Die Befehle können dann direkt genutzt werden. Bspw. mit einem Langzeitklick des Lichtschalters die Libratone Zipp Lautsprecher einschalten und mit verlassen des Raumes wieder in den Standby versetzen
   
   Screenshot: Nutzung als Radio in Loxone Config, Steuerung über Lichtschalter

Die Befehle können nach Belieben eingebaut und genutzt werden.

Statusinformationen abrufen

Theoretisch kann man ein paar Statusinformationen der Libratone Boxen abrufen, allerdings nicht so komfortabel und der Mehrwert der Informationen hält sich auch in Grenzen. Ich habe deshalb nur mal die Möglichkeiten gesammelt und liste diese hier auf:

• Via HTTP (Webseite): http://192.168.xxx.xxx/cgi?Overview (IP Adresse des Lautsprechers bitte entsprechend anpassen)
• Via HTTP Port 49152 (XML): http://192.168.xxx.xxx:49152/description.xml (IP Adresse des Lautsprechers bitte entsprechend anpassen)
• Via UDP Broadcast Paketen auf Port 1800: 
  NOTIFY * HTTP/1.1
  HOST: 239.255.255.250:1800
  PROTOCOL: Version 1.0
  NTS: ssdp-alive
  DeviceName: ZIPPTWOGREY_xxx
  DeviceID: xxx
  DeviceState: F,S,P
  PORT: 7777
  ZoneID: LINK ZippMiniOne_xxx 
  Creator:
  IPAddr: 192.168.xxx.xxx 
  ColorCode: 2010
  FWVersion: 1508;4450,;400,
  StereoPairID:
  ProVersion: 3.0,3.0
  DeviceType: 310
  AiMicStatus: 1
  Characterstic: 2,100,0,15,7,0,DE,de
  WifiInfo: ,-59,51/70 ,-62,48/70 ,-54,56/70 ,-54,56/70 ,-58,52/70
  VolSync: N

Nutzungsszenarien der Ausgänge in der Loxone Config

Hier ein paar Beispiele zur Einbindung bzw. Nutzung der Befehle.

• Nutzung als "automatisches" Radio im Raum: Dazu muss sich die Box am Strom und im Standby befinden. Der Ausgangsbefehl "Favorit 1" reicht völlig aus, um die Box aus dem Standby zu holen und den Radio-Stream von Favorit 1 direkt zu starten. Beim Verlassen des Raumes kann ein Präsenzmelder oder das Ausschalten des Lichts genutzt werden, um den Lautsprecher wieder in den Standby zu setzen.
  
  Screenshot: Nutzung als Radio in Loxone Config, Steuerung über Lichtschalter
  
  
• Nutzung zum Einschlafen: Dazu kann der eingebaute Standby Timer genutzt werden. Hierzu einfach die gewünschte Dauer als Befehl senden, dann schaltet sich die Box automatisch nach Ablauf der Zeit in den Standby. Kombinieren könnte man das natürlich auch mit dem Betriebsmodus "Schlafen", falls das genutzt wird. Dann geht der Timer automatisch auf 15 oder 30 Minuten des Lautsprechers im Schlafzimmer.
  
  Screenshot: Standby Timer in Loxone Config
  
  
• Nutzung als Wecker: Auch hier könnte man automatisch den Lautsprecher aus dem Standby holen und zum Wecken nutzen. Im Beispiel wird durch den Wecker in Loxone der Favorit 2 gestartet.
  
  Screenshot: Wecker in Loxone Config
  
  

Multiroom Konfiguration

In der Libratone App lassen sich die WLan Lautsprecher per Drag&Drop miteinander zu einem sogenannten "Link" verbinden. Danach läuft auf beiden Boxen derselbe Stream.

Screenshot der Libratone App mit zwei verbundenen Lautsprechern.

Beispielhaft habe ich einen Zipp Mini und eine Zipp 2 Box zu einem Link verknüpft (siehe Screenshot). Hier möchte ich kurz die Szenarien beschreiben, auch hinsichtlich der Befehle oben und wie sich die Boxen dann verhalten:

• Streamänderung: Wenn man bspw. statt Favorit 1, lieber Favorit 3 hören möchte, kann man das an eine beliebige Box innerhalb des Links schicken. Die jeweils andere(n) Box(en) innerhalb des Links werden dann automatisch mit angepasst.
• Lautstärkeänderung: Die Lautstärke ist immer noch pro Box separat einstellbar.
• Lautsprecher einzeln ein-/ausschalten: Der Link bleibt bestehen, auch wenn eine einzelne Box vorrübergehend oder dauerhaft ausgeschalten wird. Sofern man dann eine im Link enthaltene Box wieder einschaltet, so wird diese automatisch von den anderen Boxen "informiert" und passt sich sofort wieder in den Link ein und startet den entsprechenden Stream automatisch.

Testen via PowerShell

Wer gerne selbst etwas testen möchte und sich mit weiteren Funktionen auseinandersetzen möchte, kann das auch ohne Loxone tun. Ich selbst habe zum Testen und Forschen ein PowerShell Script erstellt und genutzt. Nachfolgend das Script mit ein paar Byte Arrays als Test. Mit der Funktion [System.Text.Encoding]::ASCII.GetString($byteArray) kann der Hex-Code auch in ein ASCII String konvertiert werden, wobei hierbei nicht alle benötigten Zeichen angezeigt werden können (bspw. die Steuerzeichen).

function Send-LibratoneCommand {
    param (
       [string]$toIP = "192.168.xxx.xxx",
       [int]$toUDPPort = 7777,
       [int]$fromUDPPort = 58800,
       $send = ""
    )    
    $IP = [System.Net.Dns]::GetHostAddresses($toIP)
    $Address = [System.Net.IPAddress]::Parse($IP)
    $EndPoints = New-Object System.Net.IPEndPoint($Address, $toUDPPort)
    $Socket = New-Object System.Net.Sockets.UDPClient($fromUDPPort)
    $SendMessage = $Socket.Send($send, $send.count, $EndPoints)
    $Socket.Close()
}

# Favorites
#...{"isFromChannel":false,"play_identity":"1","play_subtitle":"1","play_title":"channel","play_type":"channel","token":""}
[Byte[]] $favorites1 = 0xaa, 0xaa, 0x02, 0x01, 0x15, 0x00, 0x1f, 0xdb, 0x00, 0x77, 0x7b, 0x22, 0x69, 0x73, 0x46, 0x72, 0x6f, 0x6d, 0x43, 0x68, 0x61, 0x6e, 0x6e, 0x65, 0x6c, 0x22, 0x3a, 0x66, 0x61, 0x6c, 0x73, 0x65, 0x2c, 0x22, 0x70, 0x6c, 0x61, 0x79, 0x5f, 0x69, 0x64, 0x65, 0x6e, 0x74, 0x69, 0x74, 0x79, 0x22, 0x3a, 0x22, 0x31, 0x22, 0x2c, 0x22, 0x70, 0x6c, 0x61, 0x79, 0x5f, 0x73, 0x75, 0x62, 0x74, 0x69, 0x74, 0x6c, 0x65, 0x22, 0x3a, 0x22, 0x31, 0x22, 0x2c, 0x22, 0x70, 0x6c, 0x61, 0x79, 0x5f, 0x74, 0x69, 0x74, 0x6c, 0x65, 0x22, 0x3a, 0x22, 0x63, 0x68, 0x61, 0x6e, 0x6e, 0x65, 0x6c, 0x22, 0x2c, 0x22, 0x70, 0x6c, 0x61, 0x79, 0x5f, 0x74, 0x79, 0x70, 0x65, 0x22, 0x3a, 0x22, 0x63, 0x68, 0x61, 0x6e, 0x6e, 0x65, 0x6c, 0x22, 0x2c, 0x22, 0x74, 0x6f, 0x6b, 0x65, 0x6e, 0x22, 0x3a, 0x22, 0x22, 0x7d
#...{"isFromChannel":false,"play_identity":"2","play_subtitle":"2","play_title":"channel","play_type":"channel","token":""}
[Byte[]] $favorites2 = 0xaa, 0xaa, 0x02, 0x01, 0x15, 0x00, 0xb7, 0xa2, 0x00, 0x77, 0x7b, 0x22, 0x69, 0x73, 0x46, 0x72, 0x6f, 0x6d, 0x43, 0x68, 0x61, 0x6e, 0x6e, 0x65, 0x6c, 0x22, 0x3a, 0x66, 0x61, 0x6c, 0x73, 0x65, 0x2c, 0x22, 0x70, 0x6c, 0x61, 0x79, 0x5f, 0x69, 0x64, 0x65, 0x6e, 0x74, 0x69, 0x74, 0x79, 0x22, 0x3a, 0x22, 0x32, 0x22, 0x2c, 0x22, 0x70, 0x6c, 0x61, 0x79, 0x5f, 0x73, 0x75, 0x62, 0x74, 0x69, 0x74, 0x6c, 0x65, 0x22, 0x3a, 0x22, 0x32, 0x22, 0x2c, 0x22, 0x70, 0x6c, 0x61, 0x79, 0x5f, 0x74, 0x69, 0x74, 0x6c, 0x65, 0x22, 0x3a, 0x22, 0x63, 0x68, 0x61, 0x6e, 0x6e, 0x65, 0x6c, 0x22, 0x2c, 0x22, 0x70, 0x6c, 0x61, 0x79, 0x5f, 0x74, 0x79, 0x70, 0x65, 0x22, 0x3a, 0x22, 0x63, 0x68, 0x61, 0x6e, 0x6e, 0x65, 0x6c, 0x22, 0x2c, 0x22, 0x74, 0x6f, 0x6b, 0x65, 0x6e, 0x22, 0x3a, 0x22, 0x22, 0x7d

# Volume
[Byte[]] $volume11 = 0xaa, 0xaa, 0x02, 0x00, 0x40, 0x00, 0x6e, 0x61, 0x00, 0x02, 0x31, 0x31
[Byte[]] $volume12 = 0xaa, 0xaa, 0x02, 0x00, 0x40, 0x00, 0x6e, 0x61, 0x00, 0x02, 0x31, 0x32
[Byte[]] $volume13 = 0xaa, 0xaa, 0x02, 0x00, 0x40, 0x00, 0x6e, 0x61, 0x00, 0x02, 0x31, 0x33
[Byte[]] $volume23 = 0xaa, 0xaa, 0x02, 0x00, 0x40, 0x00, 0x6e, 0x61, 0x00, 0x02, 0x32, 0x33

# Pause/Stop Streaming
[Byte[]] $stop = 0x00, 0x00, 0x02, 0x00, 0x28, 0x00, 0x00, 0x00, 0x00, 0x04, 0x53, 0x54, 0x4f, 0x50
[Byte[]] $play = 0x00, 0x00, 0x02, 0x00, 0x28, 0x00, 0x00, 0x00, 0x00, 0x04, 0x50, 0x4c, 0x41, 0x59

# Sending commands to test
Send-LibratoneCommand -toIP "192.168.xxx.xxx" -toUDPPort 7777 -fromUDPPort 58800 -send $favorites1
Send-LibratoneCommand -toIP "192.168.xxx.xxx" -toUDPPort 7777 -fromUDPPort 58800 -send $favorites2
Send-LibratoneCommand -toIP "192.168.xxx.xxx" -toUDPPort 7777 -fromUDPPort 58800 -send $volume12
Send-LibratoneCommand -toIP "192.168.xxx.xxx" -toUDPPort 7777 -fromUDPPort 58800 -send $stop
Send-LibratoneCommand -toIP "192.168.xxx.xxx" -toUDPPort 7777 -fromUDPPort 58800 -send $play

# Convert Byte Arrays to ASCII String to find out more information
[System.Text.Encoding]::ASCII.GetString($favorites1)
[System.Text.Encoding]::ASCII.GetString($favorites2)
[System.Text.Encoding]::ASCII.GetString($stop)