-
Notifications
You must be signed in to change notification settings - Fork 1
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
9 changed files
with
327 additions
and
136 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,121 @@ | ||
| [](https://www.symcon.de/service/dokumentation/entwicklerbereich/sdk-tools/sdk-php/) | ||
| [](https://community.symcon.de/t/modul-tp-link-tapo-smarthome/131865) | ||
| [](https://www.symcon.de/service/dokumentation/installation/migrationen/v60-v61-q1-2022/) | ||
| [](https://creativecommons.org/licenses/by-nc-sa/4.0/) | ||
| [](https://github.com/Nall-chan/tapo-SmartHome/actions) | ||
| [](https://github.com/Nall-chan/tapo-SmartHome/actions) | ||
| [](#2-spenden) | ||
| [](#2-spenden) | ||
| # tapo Light Color <!-- omit in toc --> | ||
|
|
||
| ## Inhaltsverzeichnis <!-- omit in toc --> | ||
|
|
||
| - [1. Funktionsumfang](#1-funktionsumfang) | ||
| - [2. Voraussetzungen](#2-voraussetzungen) | ||
| - [3. Software-Installation](#3-software-installation) | ||
| - [4. Einrichten der Instanzen in IP-Symcon](#4-einrichten-der-instanzen-in-ip-symcon) | ||
| - [5. Statusvariablen und Profile](#5-statusvariablen-und-profile) | ||
| - [Statusvariablen](#statusvariablen) | ||
| - [Profile](#profile) | ||
| - [6. PHP-Befehlsreferenz](#6-php-befehlsreferenz) | ||
| - [7. Aktionen](#7-aktionen) | ||
| - [8. Anhang](#8-anhang) | ||
| - [1. Changelog](#1-changelog) | ||
| - [2. Spenden](#2-spenden) | ||
| - [9. Lizenz](#9-lizenz) | ||
|
|
||
|
|
||
| ## 1. Funktionsumfang | ||
|
|
||
| - Instanz für Lampen und LED-Stripes | ||
|
|
||
| ## 2. Voraussetzungen | ||
|
|
||
| - IP-Symcon ab Version 6.1 | ||
|
|
||
| ## 3. Software-Installation | ||
|
|
||
| * Dieses Modul ist Bestandteil der [tapo SmartHome-Library](../README.md#3-software-installation). | ||
|
|
||
| ## 4. Einrichten der Instanzen in IP-Symcon | ||
|
|
||
| Eine einfache Einrichtung ist die [Discovery-Instanz](../Tapo%20Discovery/README.md) möglich. | ||
|
|
||
| Bei der manuellen Einrichtung ist das Modul im Dialog `Instanz hinzufügen` unter den Hersteller `TP-Link` zu finden. | ||
|  | ||
|
|
||
| Damit Symcon mit den Geräten kommunizieren können, müssen diese in der TP-Link Cloud angemeldet und registriert sein. | ||
| Die entsprechenden Cloud-Zugangsdaten, die MAC-Adresse und das genutzte Protokoll werden beim anlegen durch die [Discovery-Instanz](../Tapo%20Discovery/README.md) automatisch eingetragen. | ||
|
|
||
| ### Konfigurationsseite <!-- omit in toc --> | ||
|
|
||
|  | ||
|
|
||
| **Benutzername und Passwort sind die Cloud/App Zugangsdaten!** | ||
|
|
||
| | Name | Text | Beschreibung | | ||
| | ---------- | ------------------------------ | ---------------------------------------------------------------------- | | ||
| | Open | Aktiv | Verbindung zu Gerät herstellen | | ||
| | Host | Host | Adresse des Gerätes | | ||
| | Mac | MAC Adresse | MAC Adresse des Gerätes (benötigt die Discovery-Instanz zur Zuordnung) | | ||
| | Protocol | Protokoll | Genutztes Kommunikationsprotokoll (AES oder KLAP) | | ||
| | Username | Benutzername | Benutzername für die Anmeldung (TP-Cloud Benutzername: eMail-Adresse) | | ||
| | Password | Passwort | Passwort für die Anmeldung (TP-Cloud Passwort) | | ||
| | Interval | Leseintervall | Intervall der Abfrage von Status und Energiewerten (in Sekunden) | | ||
| | AutoRename | Instanz automatisch umbenennen | Instanz erhält den Namen, welcher in der App vergeben wurde | | ||
|
|
||
| ## 5. Statusvariablen und Profile | ||
|
|
||
| Die Statusvariablen werden automatisch angelegt. Das Löschen einzelner kann zu Fehlfunktionen führen. | ||
|
|
||
| ### Statusvariablen | ||
| | Ident | Name | Typ | | ||
| | ---------- | -------------- | ------- | | ||
| | device_on | Status | boolean | | ||
| | rssi | Rssi | integer | | ||
| | overheated | Überhitzt | boolean | | ||
| | brightness | Helligkeit | integer | | ||
| | color_temp | Farbtemperatur | integer | | ||
| | color_rgb | Farbe | integer | | ||
|
|
||
|
|
||
| ### Profile | ||
| | Name | Typ | genutzt von | | ||
| | --------------- | ------- | ----------- | | ||
| | Tapo.ColorTemp | integer | color_temp | | ||
| | Tapo.Brightness | integer | brightness | | ||
|
|
||
| ## 6. PHP-Befehlsreferenz | ||
|
|
||
| ``` php | ||
| boolean TAPOSH_RequestState(integer $InstanzID); | ||
| ``` | ||
| --- | ||
| ``` php | ||
| array|false TAPOSH_GetDeviceInfo(integer $InstanzID); | ||
| ``` | ||
|
|
||
| ## 7. Aktionen | ||
|
|
||
| Es gibt keine speziellen Aktionen für dieses Modul. | ||
|
|
||
| ## 8. Anhang | ||
|
|
||
| ### 1. Changelog | ||
|
|
||
| [Changelog der Library](../README.md#1-changelog) | ||
|
|
||
| ### 2. Spenden | ||
|
|
||
| Die Library ist für die nicht kommerzielle Nutzung kostenlos, Schenkungen als Unterstützung für den Autor werden hier akzeptiert: | ||
|
|
||
| <a href="https://www.paypal.com/donate?hosted_button_id=G2SLW2MEMQZH2" target="_blank"><img src="https://www.paypalobjects.com/de_DE/DE/i/btn/btn_donate_LG.gif" border="0" /></a> | ||
|
|
||
| [](https://www.amazon.de/hz/wishlist/ls/YU4AI9AQT9F?ref_=wl_share) | ||
|
|
||
|
|
||
| ## 9. Lizenz | ||
|
|
||
| IPS-Modul: | ||
| [CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/) | ||
|
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,12 @@ | ||
| { | ||
| "id": "{3C59DCC3-4441-4E1C-A59C-9F8D26CE2E82}", | ||
| "name": "tapo Light Color", | ||
| "type": 3, | ||
| "vendor": "TP-Link", | ||
| "aliases": [], | ||
| "parentRequirements": [], | ||
| "childRequirements": [], | ||
| "implemented": [], | ||
| "prefix": "TAPOSH", | ||
| "url": "https://github.com/Nall-chan/tapoSmartHome" | ||
| } |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,157 @@ | ||
| <?php | ||
|
|
||
| declare(strict_types=1); | ||
|
|
||
| require_once dirname(__DIR__) . '/libs/TapoLib.php'; | ||
|
|
||
| /** | ||
| * TapoLightlb Klasse für die Anbindung von TP-Link tapo WiFi Bulbs & Strips. | ||
| * Erweitert IPSModule. | ||
| * | ||
| * @author Michael Tröger <micha@nall-chan.net> | ||
| * @copyright 2024 Michael Tröger | ||
| * @license https://creativecommons.org/licenses/by-nc-sa/4.0/ CC BY-NC-SA 4.0 | ||
| * | ||
| * @version 1.60 | ||
| */ | ||
| class TapoLightColor extends \TpLink\Device | ||
| { | ||
| protected static $ModuleIdents = [ | ||
| '\TpLink\VariableIdent', | ||
| '\TpLink\VariableIdentLightColor' | ||
| ]; | ||
|
|
||
| public function ApplyChanges() | ||
| { | ||
| $this->RegisterProfileInteger(\TpLink\VariableProfile::Brightness, 'Intensity', '', '%', 1, 100, 1); | ||
| $this->RegisterProfileInteger(\TpLink\VariableProfile::ColorTemp, '', '', ' K', 2500, 6500, 1); | ||
| //Never delete this line! | ||
| parent::ApplyChanges(); | ||
| } | ||
|
|
||
| /** | ||
| * HSVtoRGB | ||
| * | ||
| * not static, falls wir doch auf Statusvariablen zurückgreifen müssen | ||
| * | ||
| * @param array $Values | ||
| * @return int | ||
| */ | ||
| protected function HSVtoRGB(array $Values) | ||
| { | ||
| $color_temp = $Values[\TpLink\VariableIdentLightColor::color_temp]; | ||
| if ($color_temp > 0) { | ||
| list($red, $green, $blue) = \TpLink\KelvinTable::ToRGB($color_temp); | ||
| return ($red << 16) ^ ($green << 8) ^ $blue; | ||
| } | ||
| $hue = $Values[\TpLink\VariableIdentLightColor::hue] / 360; | ||
| $saturation = $Values[\TpLink\VariableIdentLightColor::saturation] / 100; | ||
| $value = $Values[\TpLink\VariableIdentLightColor::brightness] / 100; | ||
| if ($saturation == 0) { | ||
| $red = $value * 255; | ||
| $green = $value * 255; | ||
| $blue = $value * 255; | ||
| } else { | ||
| $var_h = $hue * 6; | ||
| $var_i = floor($var_h); | ||
| $var_1 = $value * (1 - $saturation); | ||
| $var_2 = $value * (1 - $saturation * ($var_h - $var_i)); | ||
| $var_3 = $value * (1 - $saturation * (1 - ($var_h - $var_i))); | ||
|
|
||
| switch ($var_i) { | ||
| case 0: | ||
| $var_r = $value; | ||
| $var_g = $var_3; | ||
| $var_b = $var_1; | ||
| break; | ||
| case 1: | ||
| $var_r = $var_2; | ||
| $var_g = $value; | ||
| $var_b = $var_1; | ||
| break; | ||
| case 2: | ||
| $var_r = $var_1; | ||
| $var_g = $value; | ||
| $var_b = $var_3; | ||
| break; | ||
| case 3: | ||
| $var_r = $var_1; | ||
| $var_g = $var_2; | ||
| $var_b = $value; | ||
| break; | ||
| case 4: | ||
| $var_r = $var_3; | ||
| $var_g = $var_1; | ||
| $var_b = $value; | ||
| break; | ||
| default: | ||
| $var_r = $value; | ||
| $var_g = $var_1; | ||
| $var_b = $var_2; | ||
| break; | ||
| } | ||
|
|
||
| $red = (int) round($var_r * 255); | ||
| $green = (int) round($var_g * 255); | ||
| $blue = (int) round($var_b * 255); | ||
| } | ||
|
|
||
| return ($red << 16) ^ ($green << 8) ^ $blue; | ||
| } | ||
|
|
||
| /** | ||
| * RGBtoHSV | ||
| * | ||
| * not static, falls wir doch auf Statusvariablen zurückgreifen müssen | ||
| * | ||
| * @param int $RGB | ||
| * @return array | ||
| */ | ||
| protected function RGBtoHSV(int $RGB) | ||
| { | ||
| $Values[\TpLink\VariableIdentLightColor::color_temp] = 0; | ||
| $Values[\TpLink\VariableIdentLightColor::hue] = 0; | ||
| $Values[\TpLink\VariableIdentLightColor::saturation] = 0; | ||
|
|
||
| $red = ($RGB >> 16) / 255; | ||
| $green = (($RGB & 0x00FF00) >> 8) / 255; | ||
| $blue = ($RGB & 0x0000ff) / 255; | ||
|
|
||
| $min = min($red, $green, $blue); | ||
| $max = max($red, $green, $blue); | ||
|
|
||
| $value = $max; | ||
| $delta = $max - $min; | ||
|
|
||
| if ($delta == 0) { | ||
| $Values[\TpLink\VariableIdentLightColor::brightness] = (int) ($value * 100); | ||
| return $Values; | ||
| } | ||
|
|
||
| $saturation = 0; | ||
|
|
||
| if ($max != 0) { | ||
| $saturation = ($delta / $max); | ||
| } else { | ||
| $Values[\TpLink\VariableIdentLightColor::brightness] = (int) ($value); | ||
| return $Values; | ||
| } | ||
| if ($red == $max) { | ||
| $hue = ($green - $blue) / $delta; | ||
| } else { | ||
| if ($green == $max) { | ||
| $hue = 2 + ($blue - $red) / $delta; | ||
| } else { | ||
| $hue = 4 + ($red - $green) / $delta; | ||
| } | ||
| } | ||
| $hue *= 60; | ||
| if ($hue < 0) { | ||
| $hue += 360; | ||
| } | ||
| $Values[\TpLink\VariableIdentLightColor::hue] = (int) $hue; | ||
| $Values[\TpLink\VariableIdentLightColor::saturation] = (int) ($saturation * 100); | ||
| $Values[\TpLink\VariableIdentLightColor::brightness] = (int) ($value * 100); | ||
| return $Values; | ||
| } | ||
| } |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.