Skip to content

de.md

Latest commit

 

History

History
188 lines (133 loc) · 5.72 KB

de.md

File metadata and controls

188 lines (133 loc) · 5.72 KB

Zendure Lokales Steuersystem

Zendure Logo

📖 Dokumenten­navigation

Dieses Projekt stellt mehrsprachige Dokumente bereit. Wählen Sie Ihre Sprache :

🌟 Überblick

In unserem vorherigen Device-Data-Report-Projekt zeigte sich ein klarer Bedarf an optimierter lokaler Steuerung.Daraufhin entwickelte das Team das IoT-Framework ZenSDK und veröffentlicht nun seine lokale API, mit der Entwickler Folgendes realisieren können :

  • Abruf von Gerätestatus und -eigenschaften in Echtzeit
  • Abonnieren von Geräte-Datenströmen
  • Fernsteuerung von Gerätefunktionen
  • Anbindung beliebiger MQTT-Clients (u. a. Home Assistant)
  • Entwicklung individueller Features über offene APIs zur Steigerung des Benutzererlebnisses

Haben Sie innovative Ideen zu Zendure-Produkten? Kontaktieren Sie uns gern!

🆕 Aktualisierungen

  • Aktualisierung der ZenSDK-MQTT-Client-Verbindung gemäß EN 18031; TLS-Verbindung zum Zendure-MQTT-Server.
  • Bereitstellen eines benutzerkonfigurierbaren MQTT-Clients, ausschließlich ohne TLS; Port 8883 und mqtts:// werden nicht unterstützt.
  • Empfangslänge der lokalen API auf 512 Byte festgelegt.
  • Aktualisierung und Behebung bekannter Probleme.
  • Unter EN 18031 sind HTTP-Anfragen standardmäßig nicht unterstützt.
  • Zum Aktivieren der lokalen API HEMS hinzufügen und anschließend beenden, damit die Änderung wirksam wird.

📌 Unterstützte Produkte

Modell Firmware-Version Status
SolarFlow800 Neueste unterstützt
SolarFlow800 Plus Neueste unterstützt
SolarFlow800 Pro Neueste unterstützt
SolarFlow1600 AC+ Neueste unterstützt
SolarFlow2400 AC Neueste unterstützt
SolarFlow2400 AC+ Neueste unterstützt
SolarFlow2400 Pro Neueste unterstützt
SmartMeter3CT Neueste unterstützt

🚀 Kernarchitektur

Die lokale Steuerung basiert auf der Kombination aus mDNS-Service­-Discovery und HTTP-Server-Kommunikation.

1. Geräteerkennung (mDNS)

Nach dem Netzstart sendet das Gerät mittels mDNS folgende Informationen :

  • Service-Name: Zendure-<Modell>-<letzte12Mac>(z. B. Zendure-SolarFlow800-WOB1NHMAMXXXXX3)
  • IP-Adresse
  • HTTP-Port

Clients im selben LAN können diese Broadcasts empfangen und Geräte automatisch entdecken.

2. Geräteschnittstelle (HTTP-RESTful API)

Jedes Gerät betreibt einen internen HTTP-Server.

Grundoperationen

Methode Zweck Beispiel
GET Gerätestatus / Eigenschaften lesen GET /properties/report (alle Eigenschaften)
POST Steuer- oder Konfig-Befehle senden POST /properties/write (Eigenschaften setzen)

Datenformate

  • GET: Kein Request-Body, Antwort in JSON
  • POST: JSON-Body, Pflichtfeld sn (Seriennummer)

Beispiel 1: Eigenschaften abfragen

GET /properties/report

Beispiel 2: Steuer-/Konfig­-Befehl senden

POST /properties/write
Content-Type: application/json

{
  "sn": "WOB1NHMAMXXXXX3",      // Pflicht
  "properties": {
    "acMode": 2                 // Schreibbare Eigenschaft
  }
}

Beispiel 3: MQTT-Status prüfen

GET /rpc?method=HA.Mqtt.GetStatus

Beispiel 4: MQTT-Konfiguration abrufen

GET /rpc?method=HA.Mqtt.GetConfig

Beispiel 5: MQTT-Konfiguration setzen

POST /rpc
Content-Type: application/json

{
  "sn": "WOB1NHMAMXXXXX3",
  "method": "HA.Mqtt.SetConfig",
  "params": {
    "config": {
        "enable": true,
        "server": "192.168.50.48",
        "port":1883,
        "protocol":"mqtt",
        "username": "zendure",
        "password": "zendure"
      }
  }
}

🛠️ Entwicklungswerkzeuge

mDNS-Erkennung auf Systemebene

Betriebssystem Beispielbefehl Beschreibung
Windows Get-Service | Where-Object { $_.Name -like "*Bonjour*" } Bonjour-Dienst prüfen
macOS dns-sd -B _zendure._tcp Zendure-Geräte durchsuchen
Linux avahi-browse -r _zendure._tcp Services _zendure._tcp entdecken

Code-Beispiele

CLI-Schnelltest

# Alle Eigenschaften abrufen
curl -X GET "http://<gerät-ip>/properties/report"

# MQTT-Status prüfen
curl -X GET "http://<gerät-ip>/rpc?method=HA.Mqtt.GetStatus"

# acMode-Eigenschaft setzen
curl -X POST "http://<gerät-ip>/properties/write" \
  -H "Content-Type: application/json" \
  -d '{"sn": "your_device_sn", "properties": { "acMode": 2 }}'

📚 Eigenschaftsreferenz

Detaillierte Eigenschaftsbeschreibungen je Produkt finden Sie hier : SolarFlow-Serien-Eigenschaften