esptouch_flutter

esptouch_flutter

Flutter-Plugin für ESP-Touch, um das Netzwerk für ESP-8266- und ESP-32-Geräte zu konfigurieren. Läuft auf iOS und Android.

esptouch_flutter ist Flutter-Plugin-Paket, das eine API für ESP-Touch enthält, die in Dart geschrieben wurde, kombiniert mit plattformspezifischer Implementierung für Android mit Java und iOS mit Objektiv-C.

Dieses Paket bietet eine hohe Anpassung an die ESP -Touch -Aufgaben und eine idiomatische Dart -Schnittstelle zum Starten von Aufgaben. Benutzerdefinierte Aufgabenparameter ermöglichen es den Benutzern dieses Plugins, wie lange die Aufgabe ausgeführt wird. Sie können sie auf Stunden einstellen, wenn dies Ihr Workflow benötigt.

Wichtige Links

• Sterne das Repo auf Github! Euen
• Scheckpaketinformationen auf pub.dev
• Ein Problem öffnen
• Lesen Sie die Dokumente, die wir in die Dokumente einsetzen. Wenn etwas noch nicht klar ist, öffnen Sie ein Problem. Wir werden versuchen, Ihnen zu helfen und die Dokumente zu aktualisieren.
• Dieses DART -Paket wird vom Smaho -Entwicklungsteam erstellt.

Verwendung

Beispiel App

Eine vollständige Beispiel -App finden Sie im example im Repository.

Mit der Beispiel -App können Sie WiFi SSID, BSSID, Passwort, die Dauer der Aufgabe, die erwartete Aufgabenzahl und viele weitere konfigurieren.

Für eine einfachste mögliche App finden Sie das smaho-engineering/esptouch_flutter_kotlin_example Repository.

Code -Ausschnitte

 import 'package:esptouch_flutter/esptouch_flutter.dart' ;

// Somewhere in your widget...
final ESPTouchTask task = ESPTouchTask (
  ssid : 'My WiFi network' ,
  bssid : 'ab:cd:ef:12:23:34' ,
  password : 'I love SMAHO' ,
);
final Stream < ESPTouchResult > stream = task. execute ();
final printResult = ( ESPTouchResult result) {
 print ( 'IP: ${ result . ip } MAC: ${ result . bssid }' );
};
StreamSubscription < ESPTouchResult > streamSubscription = stream. listen (printResult);

// Don't forget to cancel your stream subscription.
// You might cancel after the UDP wait+send time has passed (default 1 min)
// or you could cancel when the user asked to cancel
// for example, either via X button, or popping a route off the stack.
streamSubscription. cancel ();

Wenn Sie die Aufgabe anpassen möchten, geben Sie eine ESPTouchTaskParameter -Instanz als taskParameter an ESPTouchTask an. Im Codebeispiel geben ich die Typen für Klarheit an, aber Sie können die Typen weglassen, da Dart sie schließen kann.

 final ESPTouchTask task = ESPTouchTask (
  ssid : 'My WiFi network' ,
  bssid : 'ab:cd:ef:12:23:34' ,
  password : 'I love Flutter and ESP-Touch, too' ,
  // Tweak the task using task parameters
  taskParameter : ESPTouchTaskParameter (waitUdpReceiving : Duration (hour : 12 )),
);
// You can still stop the task at any point by calling .cancel on the stream subscription:
streamSubscription. cancel ();

In einem Beispiel in der realen Welt erhalten Sie die WLAN -Anmeldeinformationen vom Benutzer und können entweder das konfigurierte Gerät anzeigen, lokal in SQLite speichern oder an Ihr Backend senden.

Grundlagen

Verwenden Sie ein echtes Telefon zur Entwicklung. Das Plugin funktioniert nicht in Emulatoren und Simulatoren, daher benötigen Sie echte Telefone für die Entwicklung. Führen Sie flutter devices aus, um dies zu überprüfen.

Bereiten Sie Ihre eingebetteten Geräte vor. Um zu überprüfen, ob die ESP-Touch-App funktioniert, benötigen Sie eine Hardware mit ESP8266 und ESP32, um eine Verbindung zu Ihrem WLAN-Netzwerk herzustellen.

connectivity

Sie können eine einfache Möglichkeit bieten, die aktuelle SSID und BSSID des aktuellen WLAN -Netzwerks zu erhalten. Verwenden Sie das connectivity -Plugin, um den Zustand des Netzwerks (WLAN & Mobile/Mobile) auf Android und iOS zu ermitteln.

ESP-Touch

Mit ESP-Touch können Sie das Netzwerk für ESP8266- und ESP32-Geräte konfigurieren.

Das ESP-Touch-Protokoll von Espressif implementiert die Smart-Konfigurationstechnologie, damit Benutzer durch einfache Konfiguration auf einem Smartphone ESP8266Ex- und ESP32-Eingebettungsgeräte mit eingebetteten Geräten mit einem Wi-Fi-Netzwerk verbinden können.

Ressourcen

Weitere Informationen zu ESP-Touch finden Sie hier:

• Espresssif ESP-Touch-Übersicht
• ESP-Touch-Benutzerhandbuch ( .pdf )
• Smart Config API Referenz - Wir verwenden dies nicht direkt im Plugin, können Sie jedoch helfen, zu verstehen, wie die Dinge funktionieren
• EspressifApp/EsptouchForIOS ESP-Touch für iOS mit Objective-C
• EspressifApp/EsptouchForAndroid ESP-Touch für Android mit Java

Die ursprünglichen iOS- und Android -Module mussten stark angepasst und optimiert werden, um benutzerdefinierte Aufgabenparameter zu unterstützen.

Bekannte Probleme

• Wir brauchten eine vollständige Anpassungsfähigkeit für die Touch -Task -Parameter, wodurch ein erheblicher Teil des Android- und iOS -Plattform -Seitencodes erforderlich waren. Wir haben Bauherren für die Aufgabenparameter hinzugefügt, da dies wie eine Lösung aussah, die am wenigsten Änderungen am Plattformcode erforderte.
• Die einzige Möglichkeit, dieses Plugin implementieren zu können, besteht darin, den plattformspezifischen Code in dieses Projekt einzufügen. Ein Grund dafür war, dass es nicht so einfach installierbare Pakete veröffentlicht wurde, und der zweite Grund dafür ist, dass ich den Plattformcode optimieren musste, um die Konfiguration der esptouchtaskparameter zu unterstützen. Dies bedeutet, dass neue Änderungen an den ursprünglichen Git -Repositories in diesem Projekt nicht automatisch angezeigt werden. Daher müssen wir den Android- und iOS -Code manuell aktualisieren.
• Die zugrunde liegenden Android- und iOS -Apps unterstützen verschiedene Aufgabenparameter. Es gab mehrere Änderungen, insbesondere um die Handhabung von IPv4 gegen IPv6. Das Plugin behandelt nicht all diese Unterschiede.
• Auf Flutters Seite ist es notwendig, fertige Aufgaben zu verfolgen.
• AES -Unterstützung (Zuletzt habe ich überprüft, ob die Unterstützung auf Android und iOS unterschieden, also habe ich sie nicht hinzugefügt)

Breaking Change in iOS 14.6

Beginnend mit iOS 14.6 Der Anspruch com.apple.developer.networking.multicast ist erforderlich, um die Übertragung von IP -Paketen auf iOS zu ermöglichen, die von esptouch verwendet werden.

Um dies zu aktivieren, müssen Sie den Berechtigten als Kontoinhaber hier anfordern. Sobald Sie eingeschrieben sind, können Sie es hier konfigurieren

Beitragen

Dies ist ein Open-Source-Projekt, das vom Smaho Engineering-Team aus München erstellt wurde, um die ESP-Touch-App-Kits von ESPSIF zu wickeln.

Flattern

Wenn Sie aus IoT -Hintergrund kommen, wissen Sie möglicherweise nicht, was Flattern ist.

Flutter ist das UI -Toolkit von Google, um schöne, native Erlebnisse für iOS und Android aus einer einzigen Codebasis zu erstellen. Um Hilfe mit Flattern zu erhalten, sehen Sie sich die Online -Dokumentation an. Dieses Repository enthält ein Flutter-Plugin-Paket für ESP-Touch. Ein Plugin-Paket ist ein spezielles Paket, das plattformspezifischen Implementierungscode für Android und iOS enthält. Der Flutter -Teil der App sendet Nachrichten an seinen Host (iOS oder Android) über einen Plattformkanal. Dieses Plugin basiert stark auf Plattformkanälen (Ereigniskanälen).