esptouch_smartconfig

Visão geral do pacote

Orientação gerada a partir de informações públicas. Apenas para referência.

Um plugin Flutter seguro para nulos que permite dispositivos ESP se conectarem a uma rede Wi-Fi alvo usando o Smart Config. Ele suporta as plataformas Android e iOS, facilitando a configuração contínua de dispositivos IoT baseados em ESP por meio da transmissão de credenciais Wi-Fi pelo aplicativo. O plugin foi projetado para uso com chips ESP que suportam o protocolo Smart Config, permitindo que os usuários configurem dispositivos sem entrada manual. Ideal para desenvolvedores que constroem aplicações IoT que exigem configuração rápida de dispositivos.

Casos de uso

onboarding de dispositivo IoT
configuração de gadget para casa inteligente
Configuração de rede de sensores sem fio
Emparelhamento de dispositivo ESP32/ESP8266
Provisionamento automático de Wi-Fi

Principais recursos

Suporte a null safety
Plataforma cruzada (Android e iOS)
Integração do ESP Smart Config
API simples para transmissão de credenciais de Wi-Fi
Feedback de conexão em tempo real

Indicado para

desenvolvedores de aplicativos IoT
Integradores de hardware
Criadores de produtos para casa inteligente
engenheiro de sistemas embarcados
Equipes de prototipagem

Considerações

Requer dispositivo ESP com firmware de Configuração Inteligente
Limitado a dispositivos com suporte a Smart Config
Permissões de rede necessárias no Android
Restrições de execução em segundo plano no iOS
Dependente da implementação correta do firmware ESP

README original

Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.

Espressif’s ESP-TOUCH protocol implements the Smart Config technology to help users connect ESP8266EX- and ESP32-embedded devices (hereinafter referred to as the device) to a Wi-Fi network through simple configuration on a smartphone flutter app.

Getting Started

Android

Add Permission android/app/src/main/AndroidManifest.xml

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />

iOS

Add ios/Info.plist

<key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
<string>Used to Location's Info always for Using Beacon.</string>
<key>NSLocationAlwaysUsageDescription</key>
<string>Used to Location's Info always for Using Beacon.</string>
<key>NSLocationWhenInUseUsageDescription</key>
<string>Used to Location's Info for Using Beacon when In Use.</string>

Usage

late Stream<ESPTouchResult>? _stream;
final Set<ESPTouchResult> _results = Set();

@override
  void initState() {
    _stream = EsptouchSmartconfig.run(widget.ssid, widget.bssid,
        widget.password, widget.deviceCount, widget.isBroadcast);
    super.initState();
  }
  
@override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        leading: IconButton(
            icon: Icon(Icons.arrow_back),
            onPressed: () {
              Navigator.of(context).pop(_results);
            }),
        backgroundColor: Colors.red,
        title: Text(
          'Task',
        ),
      ),
      body: Container(
        child: StreamBuilder<ESPTouchResult>(
          stream: _stream,
          builder: (context, AsyncSnapshot<ESPTouchResult> snapshot) {
            if (snapshot.hasError) {
              return error(context, 'Error in StreamBuilder');
            }
            switch (snapshot.connectionState) {
              case ConnectionState.active:
                _results.add(snapshot.data!);
                return resultList(context, ConnectionState.active);
              case ConnectionState.none:
                return noneState(context);
              case ConnectionState.done:
                if (snapshot.hasData) {
                  _results.add(snapshot.data!);
                  return resultList(context, ConnectionState.done);
                } else
                  return noneState(context);
              case ConnectionState.waiting:
                return waitingState(context);
            }
          },
        ),
      ),
    );
  }

Reference

ESP Touch

https://github.com/smaho-engineering/esptouch_flutter
https://github.com/kittenbot/flutter_smartconfig
https://github.com/EspressifApp/EsptouchForIOS
https://github.com/EspressifApp/EsptouchForAndroid

Buscar pacotes, repositórios e categorias de apps