README.md

tapo Smart Energy Socket

Inhaltsverzeichnis

• 1. Funktionsumfang
• 2. Voraussetzungen
• 3. Software-Installation
• 4. Einrichten der Instanzen in IP-Symcon
• 5. Statusvariablen und Profile
  • Statusvariablen
  • Profile
• 6. PHP-Befehlsreferenz
• 7. Aktionen
• 8. Anhang
  • 1. Changelog
  • 2. Spenden
• 9. Lizenz

1. Funktionsumfang

• Instanz für Smarte WiFi Zwischenstecker mit Energiemessung

2. Voraussetzungen

• IP-Symcon ab Version 6.1

3. Software-Installation

• Dieses Modul ist Bestandteil der tapo SmartHome-Library.

4. Einrichten der Instanzen in IP-Symcon

Eine einfache Einrichtung ist die Discovery-Instanz 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 automatisch eingetragen.

Konfigurationsseite

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	Profil
device_on	Status	boolean	~Switch
rssi	Rssi	integer
current_power	Aktuelle Leistung	float	~Watt
today_runtime	Laufzeit Heute	string
today_runtime_raw	Laufzeit Heute (Minuten)	integer	Tapo.Runtime
today_energy	Energie Heute	float	~Electricity.Wh
month_runtime	Laufzeit Monat	string
month_runtime_raw	Laufzeit Monat (Minuten)	integer	Tapo.Runtime
month_energy	Energie Monat	float	~Electricity.Wh

Profile

Name	Typ	genutzt von
Tapo.Runtime	integer	today_runtime_raw, month_runtime_raw

6. PHP-Befehlsreferenz

boolean TAPOSH_SwitchMode(integer $InstanzID, bool $State);

---

boolean TAPOSH_SwitchModeEx(integer $InstanzID, bool $State, integer $Delay);

---

boolean TAPOSH_RequestState(integer $InstanzID);

---

array|false TAPOSH_GetDeviceInfo(integer $InstanzID);

---

array|false TAPOSH_GetEnergyUsage(integer $InstanzID);

7. Aktionen

Es gibt keine speziellen Aktionen für dieses Modul.

8. Anhang

1. Changelog

Changelog der Library

2. Spenden

Die Library ist für die nicht kommerzielle Nutzung kostenlos, Schenkungen als Unterstützung für den Autor werden hier akzeptiert:

9. Lizenz

IPS-Modul:
CC BY-NC-SA 4.0