Skip to content

Latest commit

 

History

History
214 lines (154 loc) · 8.22 KB

README.md

File metadata and controls

214 lines (154 loc) · 8.22 KB
Raw

IPS-Version Code License

Dokumentation

Inhaltsverzeichnis

  1. Funktionsumfang
  2. Voraussetzungen
  3. Installation
  4. Funktionsreferenz
  5. Konfiguration
  6. Anhang
  7. Versions-Historie

1. Funktionsumfang

Steuerung der Warema WMS-Komponenten, unterstützt wird zur Zeit:

  • Markise, Markise mit Windsensor

Weitere WMS-Komponenten sind grundsätzlich auch ansteuerbar, mangels Verfügbarkeit jedoch noch nicht ausprogrammiert. Bei Bedarf bitte an den Autor wenden.

2. Voraussetzungen

  • IP-Symcon ab Version 6.0
  • Warema WebControl (nicht Warema WebControl Pro via Warema Cloud) eingelernt im WMS

Es ist möglich, das eine WebControl Pro im Hausnetz genauso wie ein WebControl funktioniert, würde ich aber nicht vonb ausgehen.

3. Installation

a. Installation des Moduls

Im Module Store ist das Modul unter dem Suchbegriff Warema WMS zu finden.
Alternativ kann das Modul über Module Control unter Angabe der URL https://github.com/demel42/IPSymconWaremaWMS.git installiert werden.

b. Einrichtung in IPS

Warema WMS IO

In IP-Symcon nun unterhalb von I/O Instanzen die Funktion Instanz hinzufügen auswählen und als Hersteller Warema angeben. In der IO-Instanz muss nur der Hostname/die IP-Adresse des WebControl angegeben werden. Mittels Zugriff prüfen kann getestet werden (Hinweis: dauert ein paar Sekunden)

Warema WMS Config

In IP-Symcon nun unterhalb von Konfigurator Instanzen die Funktion Instanz hinzufügen auswählen und als Hersteller Warema angeben. In dem Konfigurator werden nun alle eingerichteten Räume/Kanäle aufgelistet; eine Anlage der Geräte-Instanz kann entsprechend erfolgen

Warema WMS Device

Die Geräte-Instanz wird über dem Konfigurator angelegt. In der Basis-Konfiguration ist Raum/Kanal sowie der Produkt-Typ eingetragen. Achtung: die Warema-Komponenten werden via Raum+Kanal angesprochen, bei Änderung der Zuordnung muss das ggfs. nachgeführt werden.

4. Funktionsreferenz

alle Funktionen sind über RequestAction der jew. Variablen ansteuerbar

5. Konfiguration

Warema WMS IO

Properties

Eigenschaft Typ Standardwert Beschreibung
Instanz deaktivieren boolean false Instanz temporär deaktivieren
WMS-Schnittstelle integer 0 0=WebControl
Hostname of WebControl string Hostname / ƢP-Adresse des WebControl

Aktionen

Bezeichnung Beschreibung
Zugriff prüfen Auflistung der Konfiguration

WaremaWMSConfig

Properties

Eigenschaft Typ Standardwert Beschreibung
Kategorie integer 0 Kategorie zu Anlage von Instanzen [1]

[1]: nur bis IPS-Version 7 vorhanden, danach ist eine Einstellmöglichkeit Bestandteil des Standard-Konfigurators

WaremaWMSDevice

Properties

Eigenschaft Typ Standardwert Beschreibung
Instanz deaktivieren boolean false Instanz temporär deaktivieren
Raum-ID integer Raum-Index
Kanal-ID integer Kanal-Index
Produkt integer Produkt-Typ
Aktualisierungsintervall integer 15 Intervall in Sekunden

Aktionen

Bezeichnung Beschreibung
Status aktualisieren Abfragen des Status (z.B. Position, Aktivität)

Variablenprofile

Es werden folgende Variablenprofile angelegt:

  • Integer
    WaremaWMS.Activity, WaremaWMS.ControlAwning, WaremaWMS.ControlBlind, WaremaWMS.Position, WaremaWMS.State

6. Anhang

GUIDs

  • Modul: {275F8086-2BAE-0114-374B-B871E0564EAB}
  • Instanzen:
    • WaremaWMSIO: {6A9BBD57-8473-682D-4ABF-009AE8584B2B}
    • WaremaWMSConfig: {657F43A7-9122-0568-5E0C-3301A6DFFAF5}
    • WaremaWMSDevice: {6A9BBD57-8473-682D-4ABF-009AE8584B2B}
  • Nachrichten:
    • {A8C43E67-9C5C-8A22-1F46-69EC56138C81}: an WaremaWMSIO
    • {B78E405B-23E3-10A5-4B26-F24277883F96}: an WaremaWMSConfig, WaremaWMSDevice

7. Versions-Historie

  • 1.9 @ 07.02.2024 17:43

    • Fix: Absicherung von Zugriffen auf andere Instanzen in Konfiguratoren
    • Verbesserung: Angleichung interner Bibliotheken anlässlich IPS 7
    • update submodule CommonStubs

  • 1.8 @ 10.12.2023 15:20

    • Neu: ab IPS-Version 7 ist im Konfigurator die Angabe einer Import-Kategorie integriert, daher entfällt die bisher vorhandene separate Einstellmöglichkeit

  • 1.7 @ 03.11.2023 11:06

    • Neu: Ermittlung von Speicherbedarf und Laufzeit (aktuell und für 31 Tage) und Anzeige im Panel "Information"
    • update submodule CommonStubs

  • 1.6 @ 05.07.2023 11:56

    • Neu: Trennung von Soll- und zurück gemeldeter Position
    • Neu: Schalter, um die Meldung eines inaktiven Gateway zu steuern
    • Vorbereitung auf IPS 7 / PHP 8.2
    • update submodule CommonStubs
      • Absicherung bei Zugriff auf Objekte und Inhalte

  • 1.5.4 @ 12.10.2022 14:44

    • Konfigurator betrachtet nun nur noch Geräte, die entweder noch nicht angelegt wurden oder mit dem gleichen I/O verbunden sind
    • update submodule CommonStubs

  • 1.5.3 @ 07.10.2022 13:59

    • update submodule CommonStubs Fix: Update-Prüfung wieder funktionsfähig

  • 1.5.2 @ 16.08.2022 10:10

    • update submodule CommonStubs Fix: in den Konfiguratoren war es nicht möglich, eine Instanz direkt unter dem Wurzelverzeichnis "IP-Symcon" zu erzeugen

  • 1.5.1 @ 26.07.2022 10:28

    • update submodule CommonStubs Fix: CheckModuleUpdate() nicht mehr aufrufen, wenn das erstmalig installiert wird

  • 1.5 @ 05.07.2022 16:53

    • Verbesserung: IPS-Status wird nur noch gesetzt, wenn er sich ändert

  • 1.4 @ 22.06.2022 10:14

    • Fix: der Update-Timer wurde initial nicht mehr gesetzt
    • Fix: Angabe der Kompatibilität auf 6.2 korrigiert

  • 1.3 @ 29.05.2022 15:51

    • update submodule CommonStubs Fix: Ausgabe des nächsten Timer-Zeitpunkts
    • einige Funktionen (GetFormElements, GetFormActions) waren fehlerhafterweise "protected" und nicht "private"
    • interne Funktionen sind nun entweder private oder nur noch via IPS_RequestAction() erreichbar

  • 1.2.5 @ 22.05.2022 15:48

    • Fix: Schreibfehler bei Konstanten (WIND_ALARM, RAIN_ALARM)

  • 1.2.4 @ 17.05.2022 15:38

    • update submodule CommonStubs Fix: Absicherung gegen fehlende Objekte

  • 1.2.3 @ 10.05.2022 15:06

    • update submodule CommonStubs
    • SetLocation() -> GetConfiguratorLocation()
    • weitere Absicherung ungültiger ID's

  • 1.2.2 @ 29.04.2022 14:20

    • Schreibfehler im Variableprofil 'WaremaWMS.State'

  • 1.2.1 @ 27.04.2022 17:10

    • Korrektur: self::$IS_DEACTIVATED wieder IS_INACTIVE
    • interne Änderungen (Translate überlagert, locale.json in mehㄦere translate.json gesplittet)

  • 1.2 @ 24.04.2022 15:34

    • Übersetzung vervollständigt
    • Implememtierung einer Update-Logik
    • diverse interne Änderungen

  • 1.1.2 @ 16.04.2022 12:02

    • potentieller Namenskonflikt behoben (trait CommonStubs)
    • Aktualisierung von submodule CommonStubs

  • 1.1.1 @ 08.04.2022 16:04

    • Konfigurator zeigt nun auch Instanzen an, die nicht mehr zu den vorhandenen Geräten passen

  • 1.1 @ 08.04.2022 10:12

    • Korrektur bei der Berechnung der Postion(en)

  • 1.0 @ 26.03.2022 17:14

    • Initiale Version