README.md

tapo Smart 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 (ohne 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
device_on	Status	boolean
rssi	Rssi	integer

Profile

Dieses Modul erstellt keine Profile.

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);

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