ADeCS Anbindung Audiogeräte


Übersicht

Dieses Protokoll wird zur Anbindung eines Multiroom-Audiogeräts an die iBricks Cloud.

Hierbei Werden folgende Einheiten verwendet:

Gerät (Device)Gerät, Hauptgerät oder Kommunikationsgateway (Kann auch eine virtuelle Einheit in einem Gateway ein)
ZoneDie Zone bezeichnet eine Abspieleinheit, eine Raumeinheit oder einen Ausgang. Es kann sich hierbei auch um ein Gerät handeln.

Hierbei gibt es grundsätzlich drei verschiedene Vorgehensmodelle:



Protokoll

Es wird das Standard ADeCS Protokoll verwendet. Lesen Sie hierzu bitte ADeCS Protokoll und Sicherheit


Befehle

Register Device

Registriert eine Zone an der Cloud. Dies ist im Prinzip nur einmal notwendig, kann aber auch mehrmals (z.b. bei jedem Einschalten des Systems) ausgeführt werden. Hierbei muss der Zone eine ZoneID übergeben werden. Diese wird dann bei allen weiteren Befehlen benötigt. Die ZoneID darf nicht geändert werden, sonst entsteht in der Cloud ein neues Gerät.

Parameter
<ManufacturerID>Kennung des Herstellers (von iBricks vorgegeben)
<ProductID>Kennung des Produkts (von iBricks vorgegeben)
<DeviceID>Eindeutige Adresse des Geräts (Normalerweise MAC Adersse)
<CloudKonto>eMail-Adresse des angeschlossenen Cloud-Kontos
<ZoneID>Adresse der Zone: Kann vom Gerät beliebig vergeben werden
<Raumbezeichnung>Bezeichnung des Raums in dem sich das Gerät befindet. z.B. “Wohnzimmer”
<Zonenbezeichnung>Bezeichnung des Geräts. z.B. “HomeCinema”


Command

Sendet ein Kommando vom ADeCS Server zum Gerät

Parameter
<ManufacturerID>Kennung des Herstellers (von iBricks vorgegeben)
<ProductID>Kennung des Produkts (von iBricks vorgegeben)
<DeviceID>Eindeutige Adresse des Geräts (Normalerweise MAC Adersse)
<ZoneID>Adresse der Zone
<Kommando>Gewünschtes Kommando:
PLAY
STOP
PAUSE
OFF
PLAY_FAVORITE (Par1 = FavoriteID)
PLAY_RADIO (Par1 = RadioID)
PLAY_PLAYLIST (Par1 = PlaylistID)
PLAY_SONG (Par1 = SongID)
PLAY_URL (Par1 = URL)
SELECT SOURCE (Par1 = SourceID)
NEXT
PREV
FF (Par1 = Anzahl Sek)
RW (Par1 = Anzahl Sek)
F1, F2, F3, F4 (Frei belegbare Zusatzfunktionen)
<Parameter 1>Funktion des Parameters entsprechend Kommando (siehe <Kommando>)
<Parameter 2>Funktion des Parameters entsprechend Kommando (siehe <Kommando>)


SetParameter

Sendet einen Parameter-Wert vom ADeCS Server zum Gerät oder vom Gerät zu Server. Es wird jeweils gesendet wenn sich ein Parameter verändert Zur Synchronisation kann das Gerät beim Einschalten oder in einem Intervall, alle Parameter zum Server senden.

Parameter
<ManufacturerID>Kennung des Herstellers (von iBricks vorgegeben)
<ProductID>Kennung des Produkts (von iBricks vorgegeben)
<DeviceID>Eindeutige Adresse des Geräts (Normalerweise MAC Adersse)
<ZoneID>Adresse der Zone
<ParameterTyp>Gewünschtes Kommando:
VOLUME (0..255)
BASS (-127..+127)
TREBLE (-127..+127)
MIDLE (-127..+127)
BALANCE (-127..+127 / +127=Rechts)
MUTE (0..255 / 0=kein Muting, 255=voll gemutet)
<Parameter Wert>Wert des entsprechenden Parameters. Alle Parameter müssen in den Bereich 0..255 oder -127..+127 entsprechend Tabelle ParameterTyp umgerechnet werden


Status

Wird bei Änderung oder regelmässig vom Gerät zum ADeCS-Server gesendet.

Parameter
<ManufacturerID>Kennung des Herstellers (von iBricks vorgegeben)
<ProductID>Kennung des Produkts (von iBricks vorgegeben)
<DeviceID>Eindeutige Adresse des Geräts (Normalerweise MAC Adersse)
<ZoneID>Adresse der Zone
<Status>Momentaner Status:
PLAY
STOP
PAUSE
OFF
RADIO
SOURCE
OTHER
<Title>String mit den Titel-Angaben des momentan gespielten Song, des Radiokanals oder der Quelle
<Time>String mit Angaben über die Abspielzeit in folgendem Format: h:mm:ss z.B. “0:03:14”
<Track>String mit Angaben zum Track in folgendem Format <Total Tracks>/<Aktueller Track> z.B. “5/2”
<Title>String mit den Titel-Angaben des momentan gespielten Song, des Radiokanals oder der Quelle
<InfoURL>URL zu weiteren Infos zum Song oder zur Radiostation
<Picture>Cover- oder Stationssignet als Bild in Base64-Codierung


Listen

Das Gerät sendet bei Änderungen oder periodisch Listen der aktuellen Playlists, Radiostationen oder Sourcen zum ADeCS-Server gesendet.

Parameter
<ManufacturerID>Kennung des Herstellers (von iBricks vorgegeben)
<ProductID>Kennung des Produkts (von iBricks vorgegeben)
<DeviceID>Eindeutige Adresse des Geräts (Normalerweise MAC Adersse)
<ZoneID>Adresse der Zone
<Part>Wird die Liste in einem Stück übergeben wird hier 0 übergaben. Werden mehrere Übertragungen benötigt. wird die erste mit 0 alle weiteren mit 1…n bezeichnet
<ID>ID des entsprechenden Eintrags. Dieser wird dann mit den Befehlen PLAY_xxx aufgerufen.
<Title>String mit lesbarer Bezeichnung z.B. “SRF 3” oder “My Best Hits”
<Picture>Cover- oder Stationssignet als Bild in Base64-Codierung

Format der Liste: <ID>;<Title>;<Picture>;-;<ID>;<Title>;<Picture>;-;<ID>;<Title>;<Picture>;-;<ID>;<Title>;<Picture>;-;<ID>;<Title>;<Picture>;-; . . .