esp_smartconfig

Visão geral do pacote

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

Uma implementação em Dart dos protocolos de configuração inteligente Esptouch e EsptouchV2 para provisionamento de dispositivos IoT. Permite a configuração sem fio contínua de dispositivos ESP8266/ESP32 por meio de smartphones ou aplicativos desktop sem necessidade de acesso direto à rede. Totalmente independente de plataforma, suportando Android, iOS, macOS, Windows e Linux. Projetado para desenvolvedores que desejam integrar emparelhamento de dispositivos zero-touch em aplicações Flutter multiplataforma. O pacote opera totalmente em Dart, sem dependências nativas, garantindo compatibilidade em todas as plataformas suportadas.

Casos de uso

onboarding de dispositivo IoT
configuração de gadget para casa inteligente
Configuração de dispositivo embarcado
Provisionamento de Wi-Fi multiplataforma
Registro automático de dispositivos

Principais recursos

Suporte a Esptouch e EsptouchV2
Implementação pura em Dart
Compatibilidade multiplataforma
Nenhum código nativo necessário
Leve e eficiente
Transferência segura de credenciais de Wi-Fi

Indicado para

Desenvolvedores Flutter construindo aplicativos IoT
Integradores de hardware usando chips ESP
Aplicações que precisam de configuração de dispositivo sem toque
Soluções multiplataforma para móvel/desktop
Projetos evitando código nativo da plataforma

Considerações

Requer firmware compatível com ESP8266/ESP32
Permissões de rede necessárias em plataformas móveis
Limitado a dispositivos que suportam o protocolo Esptouch
Não trata reinicialização do dispositivo após a configuração
Melhor usado em ambientes de rede local

README original

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

Dart implementation of EspTouch provisioner. Supports Android, iOS, Windows, Linux and macOS.

Implemented protocols

EspTouch
EspTouch V2

Supported platforms

All non-web platforms are supported. Web platform is not supported mainly because browsers does not allow UDP communication.

If you are going to use this library on Desktop platforms make sure that UDP port 18266 is open in firewall for incoming data.

Breaking Change iOS 14.6/16

The breaking change was implemented with 14.6. However, it seems to be the case that the mentioned problem only occurs on devices with iOS version 16. It results in the fact that no connection to the ESP can be established.

How to:

You need an Apple-Developer account
After the Dev-Account has been approved, you have to make a request via this form to be allowed to use the Multicast Api.
Then you can follow this guide (new process)

Demo videos

Console App	Flutter Mobile App

Example

Several examples of using this library are available in example folder.

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",
        bssid: "ROUTER BSSID", // Optional
        password: "NETWORK PASSWORD",
    ));

    // If you are going to use this library in Flutter
    // this is good place to show some Dialog and wait for exit
    //
    // Or simply you can delay with Future.delayed function
    await Future.delayed(Duration(seconds: 10));
} catch (e, s) {
    print(e);
}

// Provisioning does not have any timeout so it needs to be
// stopped manually
provisioner.stop();

SmartConfig

The SmartConfig^TM is a provisioning technology to connect a new Wi-Fi device to a Wi-Fi network.

The advantage of this technology is that the device does not need to directly know SSID or password of an Access Point (AP). Those information is provided using this library. This is particularly important to headless device and systems, due to their lack of a user interface.

Author

GitHub: abobija
Homepage: abobija.com

License

MIT

Buscar pacotes, repositórios e categorias de apps

Instalar pacote