266 lines
6.8 KiB
Markdown
266 lines
6.8 KiB
Markdown
# Tapo-Steckdosen-Steuerung - MYP Platform
|
|
|
|
## Übersicht
|
|
|
|
Die Tapo-Steckdosen-Steuerung ist eine eigenständige Web-Interface für die direkte Kontrolle aller TP-Link Tapo-Steckdosen (P100/P110) über die MYP Platform. Diese Funktion ermöglicht es Benutzern, Smart-Steckdosen unabhängig von den Druckern zu verwalten und zu steuern.
|
|
|
|
## Features
|
|
|
|
### 🔌 Hauptfunktionen
|
|
- **Live-Status-Überwachung**: Echtzeit-Status aller konfigurierten Tapo-Steckdosen
|
|
- **Direkte Steuerung**: Ein- und Ausschalten einzelner Steckdosen
|
|
- **Automatische Erkennung**: Suche nach neuen Tapo-Steckdosen im Netzwerk
|
|
- **Batch-Operationen**: Gleichzeitiges Steuern mehrerer Steckdosen
|
|
- **Verbindungstest**: Testen der Erreichbarkeit einzelner Geräte
|
|
|
|
### 🛡️ Sicherheit & Berechtigungen
|
|
- **Rollenbasierte Zugriffskontrolle**: Nur Benutzer mit `CONTROL_PRINTER` Berechtigung haben Zugriff
|
|
- **Admin-Funktionen**: Erweiterte Funktionen nur für Administratoren
|
|
- **Audit-Logging**: Alle Aktionen werden protokolliert
|
|
- **CSRF-Schutz**: Schutz vor Cross-Site Request Forgery
|
|
|
|
### 📱 Benutzeroberfläche
|
|
- **Responsive Design**: Optimiert für Desktop und Mobile
|
|
- **Live-Updates**: Automatische Status-Aktualisierung alle 30 Sekunden
|
|
- **Moderne UI**: Glassmorphism-Design mit Dark-Mode-Unterstützung
|
|
- **Intuitive Bedienung**: Einfache Ein-Klick-Steuerung
|
|
|
|
## Zugriff & Navigation
|
|
|
|
### Haupt-Dashboard
|
|
```
|
|
URL: /tapo/
|
|
Berechtigung: CONTROL_PRINTER
|
|
```
|
|
|
|
Das Haupt-Dashboard zeigt alle konfigurierten Tapo-Steckdosen mit:
|
|
- Live-Status (Online/Offline, Ein/Aus)
|
|
- Zugehöriger Drucker-Name
|
|
- IP-Adresse
|
|
- Standort-Information
|
|
- Direkte Steuerungsbuttons
|
|
|
|
### Manuelle Steuerung (Admin)
|
|
```
|
|
URL: /tapo/manual-control
|
|
Berechtigung: ADMIN
|
|
```
|
|
|
|
Erweiterte Funktionen für Administratoren:
|
|
- Steuerung beliebiger IP-Adressen
|
|
- Verbindungstests
|
|
- Notaus-Funktion (alle Steckdosen ausschalten)
|
|
- Status-Abfrage ohne Drucker-Zuordnung
|
|
|
|
## API-Endpunkte
|
|
|
|
### Steckdosen-Steuerung
|
|
```http
|
|
POST /tapo/control
|
|
Content-Type: application/json
|
|
|
|
{
|
|
"ip": "192.168.1.100",
|
|
"action": "on|off"
|
|
}
|
|
```
|
|
|
|
### Status abfragen
|
|
```http
|
|
GET /tapo/status/{ip}
|
|
```
|
|
|
|
### Alle Status abrufen
|
|
```http
|
|
GET /tapo/all-status
|
|
```
|
|
|
|
### Automatische Erkennung
|
|
```http
|
|
POST /tapo/discover
|
|
```
|
|
|
|
### Verbindungstest
|
|
```http
|
|
POST /tapo/test/{ip}
|
|
```
|
|
|
|
## Konfiguration
|
|
|
|
### Tapo-Anmeldedaten
|
|
Die globalen Tapo-Anmeldedaten werden in `utils/settings.py` konfiguriert:
|
|
|
|
```python
|
|
TAPO_USERNAME = "ihr_tapo_username"
|
|
TAPO_PASSWORD = "ihr_tapo_passwort"
|
|
```
|
|
|
|
### Standard-IP-Bereiche
|
|
Für die automatische Erkennung können Standard-IP-Adressen definiert werden:
|
|
|
|
```python
|
|
DEFAULT_TAPO_IPS = [
|
|
"192.168.0.100",
|
|
"192.168.0.101",
|
|
"192.168.0.102",
|
|
# weitere IPs...
|
|
]
|
|
```
|
|
|
|
### Timeout-Einstellungen
|
|
```python
|
|
TAPO_TIMEOUT = 5 # Sekunden
|
|
TAPO_RETRY_COUNT = 3 # Wiederholungsversuche
|
|
```
|
|
|
|
## Installation & Setup
|
|
|
|
### 1. Abhängigkeiten installieren
|
|
```bash
|
|
pip install PyP100
|
|
```
|
|
|
|
### 2. Tapo-Steckdosen konfigurieren
|
|
1. Steckdosen über Tapo-App einrichten
|
|
2. Statische IP-Adressen zuweisen
|
|
3. Anmeldedaten in der Plattform konfigurieren
|
|
|
|
### 3. Drucker-Zuordnung
|
|
Steckdosen werden automatisch erkannt wenn sie in den Drucker-Einstellungen konfiguriert sind:
|
|
- Admin → Drucker verwalten → Drucker bearbeiten
|
|
- IP-Adresse der Tapo-Steckdose eingeben
|
|
|
|
## Fehlerbehebung
|
|
|
|
### Häufige Probleme
|
|
|
|
#### Steckdose nicht erreichbar
|
|
1. **Netzwerk-Verbindung prüfen**
|
|
```bash
|
|
ping 192.168.1.100
|
|
```
|
|
|
|
2. **Tapo-App-Konfiguration überprüfen**
|
|
- Steckdose in Tapo-App sichtbar?
|
|
- WLAN-Verbindung stabil?
|
|
- Remote-Zugriff aktiviert?
|
|
|
|
3. **Anmeldedaten verifizieren**
|
|
- Username/Passwort korrekt?
|
|
- Account nicht gesperrt?
|
|
|
|
#### Verbindung funktioniert, aber keine Steuerung
|
|
1. **Berechtigungen prüfen**
|
|
- Hat der Benutzer `CONTROL_PRINTER` Berechtigung?
|
|
- Ist die Steckdose einem aktiven Drucker zugeordnet?
|
|
|
|
2. **Firewall/Router-Einstellungen**
|
|
- Port 9999 (Tapo-Standard) offen?
|
|
- Keine Blockierung zwischen Subnets?
|
|
|
|
#### Performance-Probleme
|
|
1. **Timeout-Werte anpassen**
|
|
```python
|
|
TAPO_TIMEOUT = 10 # Erhöhen bei langsamen Verbindungen
|
|
```
|
|
|
|
2. **Anzahl gleichzeitiger Verbindungen reduzieren**
|
|
3. **WLAN-Signal der Steckdosen verbessern**
|
|
|
|
### Debug-Logging
|
|
Für detaillierte Fehlermeldungen Debug-Logging aktivieren:
|
|
|
|
```python
|
|
# In utils/logging_config.py
|
|
TAPO_LOG_LEVEL = "DEBUG"
|
|
```
|
|
|
|
Logs finden Sie unter:
|
|
```
|
|
backend/logs/tapo_controller/tapo_controller.log
|
|
```
|
|
|
|
## Sicherheitshinweise
|
|
|
|
### Netzwerk-Sicherheit
|
|
- **VLAN-Isolation**: Tapo-Steckdosen in separates VLAN
|
|
- **Firewalling**: Nur notwendige Ports öffnen
|
|
- **Monitoring**: Ungewöhnliche Aktivitäten überwachen
|
|
|
|
### Zugriffskontrolle
|
|
- **Starke Passwörter**: Für Tapo-Accounts verwenden
|
|
- **Berechtigungen**: Minimale notwendige Rechte vergeben
|
|
- **Audit-Logs**: Regelmäßig überprüfen
|
|
|
|
### Physische Sicherheit
|
|
- **Steckdosen-Zugang**: Physischen Zugang beschränken
|
|
- **Reset-Buttons**: Vor unbefugtem Zugriff schützen
|
|
|
|
## Erweiterte Funktionen
|
|
|
|
### Zeitgesteuerte Schaltungen
|
|
```python
|
|
# Beispiel für geplante Abschaltung
|
|
from utils.tapo_controller import tapo_controller
|
|
import schedule
|
|
|
|
def shutdown_all_outlets():
|
|
results = tapo_controller.initialize_all_outlets()
|
|
print(f"Alle Steckdosen ausgeschaltet: {results}")
|
|
|
|
# Jeden Tag um 22:00 alle ausschalten
|
|
schedule.every().day.at("22:00").do(shutdown_all_outlets)
|
|
```
|
|
|
|
### Energiemonitoring (P110)
|
|
```python
|
|
# P110-spezifische Funktionen für Energiemessung
|
|
device_info = tapo_controller._collect_device_info(p100, device_info)
|
|
power_consumption = device_info.get('power_consumption')
|
|
voltage = device_info.get('voltage')
|
|
current = device_info.get('current')
|
|
```
|
|
|
|
### Integration mit anderen Systemen
|
|
Die API-Endpunkte können auch von externen Systemen genutzt werden:
|
|
|
|
```bash
|
|
# cURL-Beispiele
|
|
curl -X POST http://localhost:5000/tapo/control \
|
|
-H "Content-Type: application/json" \
|
|
-d '{"ip": "192.168.1.100", "action": "on"}'
|
|
|
|
curl http://localhost:5000/tapo/status/192.168.1.100
|
|
```
|
|
|
|
## Best Practices
|
|
|
|
### Performance
|
|
1. **Caching nutzen**: Status-Abfragen werden automatisch gecacht
|
|
2. **Batch-Operationen**: Mehrere Steckdosen gleichzeitig steuern
|
|
3. **Timeout-Optimierung**: Für lokale Netzwerke niedrigere Werte
|
|
|
|
### Zuverlässigkeit
|
|
1. **Retry-Mechanismus**: Automatische Wiederholung bei Fehlern
|
|
2. **Fallback-Strategien**: Alternative Steuerungsmethoden vorbereiten
|
|
3. **Monitoring**: Kontinuierliche Überwachung der Verfügbarkeit
|
|
|
|
### Wartung
|
|
1. **Regelmäßige Updates**: Tapo-Firmware aktuell halten
|
|
2. **Log-Rotation**: Große Log-Dateien vermeiden
|
|
3. **Backup**: Konfigurationen sichern
|
|
|
|
## Lizenz & Credits
|
|
|
|
Diese Implementierung basiert auf:
|
|
- **PyP100**: Python-Library für TP-Link Tapo-Geräte
|
|
- **Flask**: Web-Framework
|
|
- **MYP Platform**: 3D-Druck-Management-System
|
|
|
|
Entwickelt für die IHK-Abschlussprüfung 2025.
|
|
|
|
---
|
|
|
|
**Autor**: MYP Development Team
|
|
**Version**: 1.0.0
|
|
**Datum**: Juni 2025 |