Integration der Programme auf der CCU.
Inhaltsverzeichnis
- 1. Funktionsumfang
- 2. Installation
- 3. Einrichten der Instanzen in IP-Symcon
- 4. Statusvariablen und Profile
- 5. WebFront
- 6. PHP-Befehlsreferenz
- 7. Lizenz
Abfragen der auf der CCU vorhandenen HM-Programme.
Ausführen der HM-Programme auf der CCU.
Standard Actionhandler für die Bedienung der HM-Programme aus dem IPS-Webfront.
Dieses Modul ist Bestandteil der HomeMaticExtended-Library.
Unter Instanz hinzufügen sind die 'HomeMatic Programme' unter dem Hersteller 'HomeMatic' zu finden.
Nach dem Anlegen der Instanz sollte als übergeordnetes Gerät schon der HomeMatic Socket ausgewählt sein.
Existieren in IPS mehrere Homematic Socket, so ist der auszuwählen, aus welcher CCU die Programme gelesen werden sollen.
Konfigurationsseite:
Dieses Modul hat keinerlei Einstellungen, welche konfiguriert werden müssen.
Im Testcenter ist es jedoch über den Button 'CCU auslesen' möglich, die auf der CCU vorhandenen Programme auszulesen.
Dies erfolgt auch automatisch wenn Symcon die Verbindung zur CCU herstellt und wenn die Instanz angelegt wird.
Die Programme werden als Integer-Variable unterhalb der Instanz erzeugt. Es wird automatisch der Name und die Beschreibung aus der CCU übernommen.
Des weiteren wird ein Standard-Profil 'Execute-HM' angelegt und den Variablen zugeordnet.
Es ist somit sofort möglich die Programme aus dem WebFront heraus zu starten.
Werden in der CCU Programme gelöscht, so müssen die dazugehörigen Variablen in IPS bei Bedarf manuell gelöscht werden.
Die direkte Darstellung im WebFront ist möglich, es wird aber empfohlen mit Links zu arbeiten.
boolean HM_ReadPrograms(int $InstantID /*[HomeMatic Programme]*/)Alle Programme auf der CCU werden ausgelesen und bei Bedarf neu angelegt.
boolean HM_StartProgram(int $InstantID /*[HomeMatic Programme]*/, string $IDENT);Startet ein auf der CCU hinterlegtes Programm. Als $IDENT muss der Ident der Variable des Programmes übergeben werden.
(Die IDENT werden unter dem Reiter 'Statusvariablen' des Einstellungsdialogs der Instanz angezeigt.)
Diese Funktionen liefern einen bool Rückgabewert. True bei Erfolg, im Fehlerfall False.
Beispiele:
$Erfolg = @HM_ReadPrograms(12345 /*[HomeMatic Programme]*/);
if ($Erfolg === false) echo "Fehler beim Lesen der Programme";
$Erfolg = @HM_StartProgram(12345 /*[HomeMatic Programme]*/, '4711' /* IDENT von Programm Licht Alles aus */);
if ($Erfolg === false) echo "Fehler beim starten des Programm";