Das Patami Framework ist eine Bibliothek mit einer Reihe von Modulen und einer Klassenbibliothek für IPS.
Weitere Details und die Dokumentation findest Du hier:
Patami Framework - Patami IP Symcon Framework - Braintower Docs
Hier findest Du immer die aktuellen Release Notes:
Versionshinweise - Patami IP Symcon Framework - Braintower Docs
Zum Einrichten des Frameworks nutze diese Anleitung:
Installation - Patami IP Symcon Framework - Braintower Docs
Konfiguration - Patami IP Symcon Framework - Braintower Docs
Das Framework stellt diese Module zur Verfügung:
[ul]
[li]Patami Framework Modul: Kern-Instanz des Patami Frameworks. Unterhalb der Instanz werden Statusvariablen mit Informationen zum Framework, zu IPS (Version, Lizenz, Subskription, Connect) und zum System angelegt. In den Einstellungen der Instanz wird die globale Konfiguration des Frameworks vorgenommen (z.B. HTTP Proxy, …). Über Treiber werden die verschiedenen von IPS unterstützten Geräte abstrahiert und stehen unter einheitlichen Schnittstellen zur Verfügung.[/li][li]Patami Object Group Modul: Mit diesem Modul können mehrere Objekte zusammengefasst werden. Es bietet drei Modi: Status (z.B. um zu ermitteln ob eine Lampe eingeschaltet ist), Wert (z.B. um die Durchschnittstemperatur im Haus zu berechnen und über Regeln/Schwellwerte zu erkennen, ob es zu warm/kalt ist) und Szene (kann den Zustand der verlinkten Objekte in Szenen abspeichern und wieder abrufen, legt Elemente für die Visualisierung an).[/li][li]Patami Auto Switch Modul: Erlaubt das verzögerte und automatische Ein- und Ausschalten von Geräten bzw. IPS Objekten (und natürlich auch Patami Object Groups im Szene-Modus) in Abhängigkeit von Variablen. Legt Elemente für die Visualisierung an, um die Verzögerungen zu konfigurieren und die Automatik ein- und ausschalten zu können.[/li][li]Patami Split RGB Modul: Bietet die Möglichkeit, RGB Leuchten zu nutzen, deren Farbkanäle über separate IPS Instanzen kontrolliert werden (z.B. bei über KNX-DALI Gateway angebundenen RGB Strips). In der Visualisierung steht das normale Farbauswahlrad zur Verfügung.[/li][li]Alexa Custom Skill Modul / Alexa Custom Skill Intent Modul: Hiermit kannst Du eigene Amazon Alexa Custom Skills in IPS implementieren. Weitere Details findest Du hier: Patami Alexa Skill Framework[/li][/ul]
Die Dokumentation der Alexa Custom Skill Module ist ziemlich komplett. Die Dokumentation der restlichen Module ist noch nicht vorhanden, oder lückenhaft. Dies wird in den kommenden Wochen noch geändert. Allerdings sollte die Nutzung der Module in IPS selbsterklärend sein.
Bei der Entwicklung des Frameworks werden verschiedene Branches genutzt:
[ul]
[li]master: Hier werden alle paar Wochen die stabilen Release Versionen veröffentlicht. Bei jedem Release erhöht sich die Versionsnummer.[/li][li]test: Hier werden neue Features vor einem Release für einige Tage oder Wochen (freiwilligen) Betatestern zur Verfügung gestellt, um möglicherweise noch vorhandene Bugs und fehlende Funktionalitäten zu finden und zu beheben.[/li][li]develop: Hier werden die stabilen Codezweige der Feature- und Bug-Branches gesammelt. Sobald es sinnvoll ist und in der Entwicklungsumgebung keine Fehler mehr gefunden werden, wird die Branch in die test Branch gemerged, um durch ein breiteres Publikum getestet zu werden.[/li][li]feature/*: In diesen Branches werden einzeln neue Features für das Framework bzw. neue Module entwickelt. Sobald diese in der Entwicklungsumgebung fehlerfrei funktionieren und nutzbar sind, wird die entsprechende Branch in develop gemerged.[/li][li]bugfix/*: Hier gilt dasselbe wie bei den feature/* Branches, jedoch hier Bugfixes bei Fehlermeldungen entwickelt.[/li][/ul]
Eine aktuelle und ziemlich vollständige Dokumentation der Klassen findest Du hier: API Documentation
Solltes Du Bugs finden oder Features vorschlagen wollen, so kannst Du das hier tun: patami / IPSPatami / issues / new — Bitbucket
Ich freue mich schon auf reges Feedback. Gerne gesehen sind auch interessierte Programmierer, die sich an dem Projekt aktiv beteiligen wollen.