esptouch_flutter

Description:

esptouch flutter

esptouch_flutter #

Flutter plugin for ESP-Touch to configure network for ESP-8266 and ESP-32 devices. Runs on iOS and Android.

esptouch_flutter is Flutter plugin package which contains an API for ESP-Touch written in Dart combined with
platform-specific implementation for Android using Java and iOS using Objective-C.
This package provides a high customizability to the ESP Touch tasks and an idiomatic Dart interface for launching tasks. Custom task parameters lets the users of this plugin change how long the task runs, you could set it to hours, if this is what your workflow requires.



Important links #

Star the repo on GitHub! ⭐️
Check package info on pub.dev
Open an issue
Read the docs We put effort into the docs, so if something is still not clear, open an issue. We will try top help you out and update the docs.
This Dart package is created by the SMAHO development team.

Usage #
Example app #

For a complete example app, see the example folder in the repository.
The example app lets you configure WiFi SSID, BSSID, password, the duration of the task, expected task count and many more.
For a simplest possible app, see the smaho-engineering/esptouch_flutter_kotlin_example repository.
Code snippets #
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();
copied to clipboard
If you would like to customize the task, provide an ESPTouchTaskParameter instance as taskParameter to ESPTouchTask. In the code example, I specify the types for clarity but you can omit the types as Dart can infer them.
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();
copied to clipboard
In a real world example, you'd get the WiFi credentials from the user and you could either display the configured device, save it locally in SQLite or send it to your backend.
Fundamentals #
Use a real phone for development. The plugin will not work in emulators and simulators, so you need real phones for development. Run flutter devices to verify.
Prepare your embedded devices. To verify that the ESP-Touch app works, you need some hardware with ESP8266 and ESP32 to connect to your WiFi network.
connectivity #
You may to provide an easy way for getting the current WiFi network's SSID and BSSID. Use the connectivity plugin for discovering the state of the network (WiFi & mobile/cellular) connectivity on Android and iOS.
ESP-Touch #
Using ESP-Touch, you can configure network for ESP8266 and ESP32 devices.

Espressif’s ESP-Touch protocol implements the Smart Config technology to help users connect
ESP8266EX- and ESP32-embedded devices to a Wi-Fi network through simple configuration on a
smartphone.

Resources
You can read more about ESP-Touch here:

Espressif ESP-Touch Overview
ESP-Touch User Guide (.pdf)
Smart config API reference - We don't directly use this in the plugin, but can help you understand how things work
EspressifApp/EsptouchForIOS ESP-Touch for iOS using Objective-C
EspressifApp/EsptouchForAndroid ESP-Touch for Android using Java

The original iOS and
Android modules had to be heavily customized and
tweaked in order to support custom task parameters.
Known issues #

We needed full customizability for the touch task parameters, these made changing a significant
chunk of the Android and iOS platform side code necessary.
We added builders for the task parameters as this looked like a solution that required the least
changes to the platform code.
The only way I could implement this plugin is by pasting the platform-specific code into this
project. One reason for this was that it wasn't published anywhere as easily installable packages,
and the second reason is that I had to tweak the platform code to support configuration of
the ESPTouchTaskParameters. This means that new changes to the original git repositories do not
automatically show up in this project, so we need to manually update the Android and iOS code.
The underlying Android and iOS apps support different task parameters. There were multiple
changes especially around IPv4 vs IPv6 handling. The plugin does not handle all of these
differences.
Keeping track of finished tasks is necessary on Flutter's side.
AES support (last I checked the support differred on Android and iOS, so I haven't added them)

Breaking change in iOS 14.6 #
Starting with iOS 14.6 the com.apple.developer.networking.multicast entitlement is required, to allow the broadcasting of IP packages on iOS, which is used by esptouch.
In order ot enable it, you need to request the entitlemant as an account holder here.
Once you are enrolled, you can configure it here

Contribute #
This is an open-source project built by the SMAHO Engineering team from Munich to wrap Espressif's ESP-Touch mobile app kits.
Flutter #
If you are coming from IoT background, you might not know what Flutter is.
Flutter is Google's UI toolkit for creating beautiful, native experiences for iOS and Android from a single codebase. For help getting started with Flutter, view the online documentation.
This repository contains a Flutter plugin package for ESP-Touch. A plugin package is a specialized package that includes platform-specific implementation code for Android and iOS. The Flutter portion of the app sends messages to its host (iOS or Android) over a platform channel. This plugin relies on platform channels (event channels) heavily.