Skip to content
pubscout

esp_smartconfig

3.0.0, released 2 years ago by abobija.com

EspTouch and EspTouchV2 smart config provisioning implementations for IoT devices.

$ flutter pub add esp_smartconfig
Source repository

What it does

Provides EspTouch and EspTouchV2 SmartConfig provisioning protocols in plain Dart. It allows configuring Wi-Fi credentials on headless IoT devices over UDP without knowing the network details in advance.

AI-written summary of version 3.0.0, based on the package's README and metadata. Report an inaccuracy

Use it when

  • You need to provision ESP8266 or ESP32 Wi-Fi devices using SmartConfig from a Dart or Flutter application.
  • You want to implement EspTouch or EspTouchV2 protocols without native platform wrappers.

Skip it when

  • You are targeting the Web platform, as browsers do not allow UDP communication.
  • You require automatic provisioning timeouts built into the package.

Strengths

  • Supports multiple platforms including Android, iOS, Windows, Linux, and macOS.
  • Implements both EspTouch and EspTouchV2 protocols.
  • Plain Dart implementation.

Weaknesses

  • Web platform is not supported due to lack of UDP support in browsers.
  • Provisioning has no built-in timeout and must be stopped manually.
  • Requires manual firewall configuration for port 18266 on desktop platforms and special Apple Developer multicast entitlements on iOS.

Setup

Kind
Pure Dart
Effort
Medium
Code generation
No
Direct dependencies
2

On iOS 14.6/16+, a special request for Multicast API access must be made via Apple Developer account. On desktop platforms, ensure UDP port 18266 is open in the firewall for incoming data.

import 'package:esp_smartconfig/esp_smartconfig.dart';

final provisioner = Provisioner.espTouch();

provisioner.listen((response) {
    print("Device ${response.bssidText} connected to WiFi!");
});

try {
    await provisioner.start(ProvisioningRequest.fromStrings(
        ssid: "NETWORK NAME",
        password: "NETWORK PASSWORD",
    ));
    await Future.delayed(Duration(seconds: 10));
} catch (e, s) {
    print(e);
}

provisioner.stop();

Alternatives

Packages that do the same job and could replace esp_smartconfig.

Works with

Packages commonly used together with esp_smartconfig: ones it builds on, ones built on it, and its own family.