Skip to content

Latest commit

 

History

History
121 lines (82 loc) · 4.97 KB

README.md

File metadata and controls

121 lines (82 loc) · 4.97 KB

SDK Version Version License Check Style Run Tests

Onkyo & Pioneer Tuner (Onkyo Tuner)

Bildet einen Tuner eines Gerätes in IP-Symcon ab.

Inhaltsverzeichnis

1. Funktionsumfang

  • Darstellen von Zuständen des Tuner.
  • Bedienung aus dem WebFront.
  • Bereitstellung von PHP-Befehlen zur Steuerung durch Scripte.

2. Voraussetzungen

  • IPS ab Version 5.1
  • kompatibler AV-Receiver mit LAN-Anschluss oder RS232 (RS232 Geräte haben einen eingeschränkten Leistungsumfang)

3. Software-Installation

Dieses Modul ist ein Bestandteil des Symcon-Modul: Onkyo & Pioneer AVR

4. Einrichten der Instanzen in IP-Symcon

Eine einfache Einrichtung ist über die im Objektbaum unter 'Konfigurator' zu findende Instanz Onkyo bzw Pioneer Configurator' möglich.

Bei der manuellen Einrichtung ist das Modul im Dialog 'Instanz hinzufügen' unter den Hersteller 'Onkyo' zu finden.
Instanz hinzufügen

In dem sich öffnenden Konfigurationsformular ist die gewünschte Zone auszuwählen, welche beim senden vom Kommandos an das Gerät benutzt wird.
Konfiguration keine Zone

5. Statusvariablen und Profile

Jede Instanz erstellt einige Profile dynamisch, je nach Fähigkeiten der Geräte.

Statusvariablen MainZone:

Name Typ Ident Beschreibung
Tuner Band integer SLI Aktive Quelle der Zone
Radiosender integer PRS Aktueller Speicherplatz eines Senders
Tuner-Frequenz float TUN Aktuelle Frequenz

Profile:

Alle Profile mit .* am Ende, enthalten immer die InstanzID und sind dynamische Profile.
Diese können sich während des Betriebes, oder beim ändern von Geräteeinstellungen dynamisch verändern.

Name Typ verwendet von Statusvariablen (Ident)
Onkyo.TunerBand.* integer SLI
Onkyo.TunerPreset.* integer PRS
Onkyo.TunerFreq.* float TUN

6. WebFront

Die direkte Darstellung im WebFront ist möglich, es wird aber empfohlen mit Links zu arbeiten.

WebFront Beispiel

7. PHP-Befehlsreferenz

Schaltbare Statusvariablen können universell mit RequestAction angesteuert werden.
Siehe Symcon Dokumentation: RequestAction


Folgende Funktionen liefern 'TRUE' bei Erfolg.
Im Fehlerfall wird eine Warnung erzeugt und 'FALSE' zurückgegeben.

bool OAVR_RequestState(int $InstanzeID, string $Ident);

Fordert den aktuellen Wert einer Statusvariable beim Gerät an.

bool OAVR_SetBand(int $InstanzeID, int $Value);

Schaltes auf das in '$Value' angegeben Frequenzband um.
Hierbei entspricht der Wert 0x24 dem FM und 0x25 dem AM Band.

bool OAVR_SetFrequency(int $InstanzeID, float $Value);

Setzt den Tuner auf die in '$Value' übergebenen Frequenz. '$Value' besitzt keine Einheit, somit sind z.B. 100,2 ein gültiger Wert für 100,2 MHz FM, und 702 ein gültiger Wert für 702 kHz.
Es wird dabei wird automatisch zwischen AM und FM umgeschaltet.

bool OAVR_CallPreset(int $InstanzeID, int $Value);

Ruft direkt den in '$Value' übergeben Sender auf auf.

bool OAVR_SetPreset(int $InstanzeID, int $Value);

Speichert die aktuelle Frequenz in den in '$Value' übergebenen Speicherplatz.

8. Lizenz

IPS-Modul:
CC BY-NC-SA 4.0