Sidebar
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) |
| Zone | Die 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:
- Jedes Gerät (z.B. Zonenplayer) registriert sich als eigenes Gerät an der Cloud. In diesem Fall hat das Gerät nur eine Zone (ZoneID kann dann z.B. “0” sein)
- Ein ganzes System registriert sich als ein Gerät mit mehreren Zonen. In diesem Fall wird nur ein Gerät an der Cloud registriert.
- Ein Gateway wird an der Cloud als Gerät registriert. Dieser führt dann alle Geräte (z.B. Zonenplayer) innerhalb der Anlage gegenüber der Cloud als Zone.
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>;-; . . .
Page Tools
