Aprenda a configurar a rede WiFi do ESP32 pelo smartphone 27

Neste tutorial você verá como é possível configurar a rede WiFi do ESP32 pelo smartphone,  sem alterar seu código. Para isso utilizaremos a biblioteca “WiFiManager”.

Figura 1 – Circuito completo

Atualmente no mundo maker diversos projetos são desenvolvidos envolvendo a conexão WiFi. Por meio deles podemos comunicar o hardware com algum servidor na web permitindo o envio e a recepção de dados, e isso é possível através do ESP32. 

Agora, imagine que você tenha feito um projeto no ESP32 que utilize a comunicação WiFi e nele você definiu por meio do código o “SSID” e a “Senha da rede. Esses dados ficarão salvos para que o ESP32 se conecte à rede WiFi definida por você, porém se posteriormente for necessário levar o seu projeto para outro lugar, como você faria para conectá-lo em outra rede? Provavelmente mudaria seu código trocando o “SSID” e a “Senha” e aplicaria o novo código no ESP32, não é mesmo?

Aqui você vai aprender a configurar a rede WiFi do seu ESP32 de maneira mais prática, usando ele e um smartphone. Ficou curioso? Então continue lendo! 

Material necessário

Para fazer o projeto você precisará dos seguintes componentes:

Funcionamento do circuito

O circuito é composto basicamente por dois LEDs, um na cor azul e outro na cor vermelha. Quando o LED na cor vermelha estiver piscando significa que a placa não está conectada na rede. Caso o botão tenha sido pressionado, o LED vermelho ficará aceso indicando que o ESP32 entrou no modo de configuração do “SSID” e da “Senha” da rede. Após configurado os parâmetros  válidos de conexão do ESP32, o LED azul acenderá indicando sucesso na conexão. 

Obs.: Na programação existe uma função que faz com que o ESP32 se reconecte na rede automaticamente assim que estiver próximo da rede a qual foi configurada. Quanto a questão de configuração, os parâmetros do WiFi ficam salvos no ESP32 permanentemente, ou seja, caso o ESP seja desligado assim que ele for ligado novamente continuará com os mesmos parâmetros do wi-fi salvo anteriormente a menos que seja pressionado o botão novamente para alterá-los.

Montagem do circuito

Com todos os componentes em mãos vamos à montagem do circuito. Abaixo temos o esquemático eletrônico montado em uma protoboard.

Esquemático do projeto
Figura 3 – Esquemático eletrônico

Biblioteca WiFiManager

Esta biblioteca permite gerenciar a conexão wi-fi. A partir dela é possível configurar ponto de acesso e/ou modo estação. 

O modo Estação será configurado através de um portal no navegador, onde nós enviaremos para o ESP os dados da rede wi-fi no qual o ESP se conectará.

O que é o Modo Estação (Station Mode) e o Modo AP (Access Point Mode)? Basicamente serão utilizados os dois parâmetros na conexão do ESP. No modo AP o dispositivo se comporta como um roteador wi-fi gerando uma rede com “SSID” e “Senha”, já no modo Estação o dispositivo se comporta como um “cliente sem fio” se conectando a um roteador wireless.

Neste tutorial utilizaremos o modo Estação para receber os dados de conexão wi-fi e depois o ESP entrará no modo AP para se conectar no roteador como cliente.

Bibliotecas e gerenciador de placas

Após a montagem do circuito vamos as configurações e adição de bibliotecas necessárias para o funcionamento do código. Serão necessárias utilizar as bibliotecas WiFiManager, WebServer e DNSServer. Todas as bibliotecas estão disponíveis neste link.

Após o download descompacte os arquivos e cole na pasta de Bibliotecas do Arduino no endereço C:/Arquivos de Programas (x86)/Arduino/libraries

Obs.: Caso você já tenha instalado o ESP 32 na IDE do Arduino, pule esta etapa.

Na Arduino IDE vá em Arquivos > Preferências e adicione o link abaixo em “URLs Adicionais para Gerenciadores de Placas” e clique em OK.

https://dl.espressif.com/dl/package_esp32_index.json

Depois vá em Ferramentas > Placas > Gerenciador de Placas… e pesquise ESP32 e clique em instalar.

Figura 4 – Gerenciador de Placas Arduino

Após instalado a placa vá em Ferramentas > Placa e selecione a placa ESP32 Dev Module.

Figura 5 – Selecionando placa

Código

Com o circuito montado vamos a parte do código que será carregado no ESP32.

//Bibliotecas
#include <HTTPClient.h>
#include <DNSServer.h> 
#include <WebServer.h>
#include <WiFiManager.h>

WiFiManager wifiManager;//Objeto de manipulação do wi-fi

void setup(){
  
  Serial.begin(115200);
  Serial.println();

  //Definição dos pinos
  pinMode(13,INPUT);
  pinMode(26,OUTPUT); 
  pinMode(32,OUTPUT);

  //LEDs apagados
  digitalWrite(26,LOW);
  digitalWrite(32,LOW);
  
  //callback para quando entra em modo de configuração AP
  wifiManager.setAPCallback(configModeCallback); 
  //callback para quando se conecta em uma rede, ou seja, quando passa a trabalhar em modo estação
  wifiManager.setSaveConfigCallback(saveConfigCallback); 

}

void loop() {

   //Se o botão for pressionado
   if (digitalRead(13) == LOW) {
      Serial.println("Abertura Portal"); //Abre o portal
      digitalWrite(26,HIGH); //Acende LED Vermelho
      digitalWrite(32,LOW);
      wifiManager.resetSettings();       //Apaga rede salva anteriormente
      if(!wifiManager.startConfigPortal("ESP32-CONFIG", "12345678") ){ //Nome da Rede e Senha gerada pela ESP
        Serial.println("Falha ao conectar"); //Se caso não conectar na rede mostra mensagem de falha
        delay(2000);
        ESP.restart(); //Reinicia ESP após não conseguir conexão na rede
      }
      else{       //Se caso conectar 
        Serial.println("Conectado na Rede!!!");
        ESP.restart(); //Reinicia ESP após conseguir conexão na rede 
      }
   }

   if(WiFi.status()== WL_CONNECTED){ //Se conectado na rede
      digitalWrite(32,HIGH); //Acende LED AZUL
   }
   else{ //se não conectado na rede
      digitalWrite(32,LOW); //Apaga LED AZUL
      //Pisca LED Vermelho
      digitalWrite(26,HIGH);
      delay(500);
      digitalWrite(26,LOW);
      delay(500);
      wifiManager.autoConnect();//Função para se autoconectar na rede
   }  
}

//callback que indica que o ESP entrou no modo AP
void configModeCallback (WiFiManager *myWiFiManager) {  
  Serial.println("Entrou no modo de configuração");
  Serial.println(WiFi.softAPIP()); //imprime o IP do AP
  Serial.println(myWiFiManager->getConfigPortalSSID()); //imprime o SSID criado da rede
}

//Callback que indica que salvamos uma nova rede para se conectar (modo estação)
void saveConfigCallback () {
  Serial.println("Configuração salva");
}

Configuração da rede WiFi pelo smartphone 

Após carregado o código no seu ESP32 verifique se o LED vermelho está piscando. Se estiver, significa que não está conectado na rede como descrito no tópico funcionamento do circuito. 

Para iniciar a configuração pressione e segure o botão, após pressionado será habilitado o modo de configuração e o LED vermelho ficará acesso. 

Em seu smartphone procure a rede “ESP32-CONFIG” e entre com a senha 12345678. 

Rede ESP32-CONFIG no smartphone
Figura 6 – Selecionando ESP32-CONFIG

Ao conectar o smartphone na rede gerada pelo ESP32 você deverá clicar na notificação “Conecte-se à rede Wi-fi” como mostra a imagem abaixo.

Figura 7 – Notificação da rede

Ao clicar na notificação você será redirecionado para uma página e deverá clicar em “Configure WiFi”.

Figura 8 – Página Web Server

Após clicar em “Configure WiFi” selecione a rede na qual deseja se conectar clicando na rede sublinhada em azul, logo abaixo ela aparecerá num campo onde você só precisará informar a senha da rede escolhida e clicar em “Save”.

Escolhendo a rede para configurar o ESP32
Figura 9 – Selecionando a rede a ser conectada
Configurando rede do esp32 no smartphone
Figura 10 – Inserindo senha da rede selecionada

Pronto agora aguarde o LED azul acender, se caso acender significa que está conectado a rede.

Conclusão

É possível também fazer esse processo no ESP8266, porém com algumas particularidades. Para realizar este procedimento no ESP8266 é necessário utilizar as bibliotecas WiFiManager, WebServer e DNSServer próprias para ele, já que a que utilizamos neste tutorial é própria para o ESP32. 

No código seriam estas bibliotecas.

#include <ESP8266WiFi.h> 
#include <ESP8266WebServer.h>
#include <DNSServer.h>
#include <WiFiManager.h>

Obs.: Se caso utilizar o ESP8266 não esqueça de alterar os pinos dos LEDs e do botão, uma vez que, o que utilizamos neste tutorial é baseado na pinagem do ESP32.

Bom agora só implementar o código a seus futuros projetos para melhorá-lo dando mais facilidade para você conectar seu projeto em outras redes wi-fi. 

Gostou de aprender a configurar a rede WiFI do ESP32 pelo celular? Deixe seu comentário logo abaixo. Para saber mais sobre o mundo maker, arduino entre outros dispositivos acesse o blog

Faça seu comentário

Acesse sua conta e participe

27 Comentários

  1. Tive os mesmo problemas com as bibliotecas, solucionei da seguinte forma:
    – extrai os arquivos e em seguida compactei cada um deles separadamente
    – renomeei os nomes de forma a existirem apenas letras e nada de “-”
    – fui na ide do arduino>sketch>incluir biblioteca>adicionar .zip
    – fiz o upload das mesmas
    – por fim alterei o o começo do código para:
    //Bibliotecas
    #include
    #include
    #include
    #include
    #include

  2. Nossa muito bom o post , parabéns.
    Funcionou aqui perfeito.
    Uma dúvida, quando eu aperto o botão o esp32 gera uma rede Wi-Fi para poder configurar nele, queria poder colocar senha para conectar nesse rede que ele gera.

    Achei que essa linha gerava a senha:

    if(!wifiManager.startConfigPortal(“ESP32-CONFIG”, “12345678”) ){

    Mas quando eu aperto o botão o esp32 gera o Wi-Fi: ESP23-CONFIG
    Eu clico nesse nome é já abre o portal da dele para escolher o Wi-Fi.

    Obrigado….

    1. Olá, Marcio!

      Sim essa linha gera o Wi-Fi ESP32-CONFIG com a senha 12345678, uma vez que você se conectou nessa rede com a senha o smartphone salva a senha.
      Então quando você clica nessa rede vai se conectar automaticamente pois ele pede a senha uma vez, da mesma forma que o Roteador.
      Para pedir a senha novamente você deve esquecer a senha gravada no seu smartphone ou mudar a senha dentro do código.

      Porém recomendo através do seu smartphone ir nessa rede do ESP32-CONFIG e colocar esquecer senha, ao invés de alterá-la no código.

      Abraço!

      Felipe Santos do Nascimento
      1. Olá, muito obrigado pela sua resposta. Eu tentei aqui alterar a senha no código.
        Porem quando a rede aparece lá nas Redes wifi do computador ou do smartphone aparece o nome da rede: ESP32-CONFIG porem não aparece aquele cadeadinho informando que é uma conexão protegida.
        Pode me ajudar com isso?
        Obrigado…

      2. Felipe , eu tinha alterado a senha padrão de: 12345678 para uma palavra, ai não sei por que a rede aparece como aberta. Coloquei um senha com números e apareceu rede protegida.

        Isso está correto?
        Obrigado

        1. Olá,
          A senha deve conter no mínimo 8 caracteres, abaixo deste número a rede fica aberta.
          Abraço!

          Felipe Santos do Nascimento
  3. Olá Felipe, tudo bem?

    Poderia me ajudar com esta mensagem de erro:

    =================================================================

    error: ‘class WiFiClass’ has no member named ‘softAPIP’

    Serial.println(WiFi.softAPIP()); //imprime o IP do AP

    =================================================================

    Já verifiquei a placa usada na compilação (no caso, estou usando “ESP32 Dev Module”)
    Já reinstalei as bibliotecas
    Já tentei usar as bibliotecas declaradas com ” ” colocá-las na mesma pasta do arquivo .ino
    Nada funcionou!! Voc^^e saberia me dizer o que pode estar errado?? E como posso corrigir??

    Fico no aguardo.
    Abraço

    1. Olá Gabriel, faça esse teste deixe esta linha comentada

      Serial.println(WiFi.softAPIP()); //imprime o IP do AP

      e tente rodar o código, para acessar a ESP geralmente é o IP 192.168.4.1

      Abraços!

      Felipe Santos do Nascimento
      1. Olá Felipe, tudo bem?

        Antes de mais nada, obrigado pela atenção.
        Tentei fazer o que você falou (colocar como comentário) e agora aparece outro erro:

        ===================================================
        Erro compilando para a placa ESP32 Dev Module

        C:\Program Files (x86)\Arduino\libraries\WebServer-esp32-master\src/WebServer.h:206:15: error: cannot declare field ‘WebServer::_server’ to be of abstract type ‘WiFiServer’

        WiFiServer _server;

        ===================================================

        Saberia me dizer o que pode ser isso??
        Enfim, vou continuar tentando aqui.. uma hora tem que dar certo.

        Abraço

        1. Olá, bom faça esse teste…

          Retire as bibliotecas da pasta C:/Arquivos de Programas (x86)/Arduino/libraries e coloque na pasta Documentos/Arduino/libraries do seu pc.

          depois tente rodar o código…creio que isso deva resolver!

          Abraço.

          Felipe Santos do Nascimento
  4. Olá Felipe, tudo bem?

    Eu estou com um problema nas bibliotecas. Esse é o erro que está ocorrendo: Ele não está reconhecendo o arquivo WiFiManager.h
    Eu coloquei os arquivos no mesmo diretório do arquivo .ino e mesmo assim ão funcionou. Você sabe o que pode ser?

    ==================================== MENSAGEM DE ERRO ==========================================

    C:\Users\Usuario\ArquivosGabriel\Estagio_DaviTec\BibliotecasArduino_ESP32\Teste\Teste.ino:5:25: fatal error: WiFiManager.h: No such file or directory

    compilation terminated.

    exit status 1
    Erro compilando para a placa ESP32 Dev Module

    1. Boa tarde!

      no lugar de:
      //Bibliotecas
      #include
      #include
      #include
      #include

      utilize:

      //Bibliotecas
      #include “HTTPClient.h”
      #include “DNSServer.h”
      #include “WebServer.h”
      #include “WiFiManager.h”
      #include “WiFi.h”

      para referenciar as bibliotecas dentro da pasta

      Felipe Santos do Nascimento
  5. //Bibliotecas
    #include
    #include
    #include
    #include
    #include

    WiFiManager wifiManager;//Objeto de manipulação do wi-fi

    //callback que indica que o ESP entrou no modo AP
    void configModeCallback (WiFiManager *myWiFiManager) {
    Serial.println(“Entrou no modo de configuração”);
    Serial.println(WiFi.softAPIP()); //imprime o IP do AP
    Serial.println(myWiFiManager->getConfigPortalSSID()); //imprime o SSID criado da rede
    }

    //Callback que indica que salvamos uma nova rede para se conectar (modo estação)
    void saveConfigCallback () {
    Serial.println(“Configuração salva”);
    }

    void setup(){

    Serial.begin(115200);
    Serial.println();

    //Definição dos pinos
    pinMode(13,INPUT);
    pinMode(26,OUTPUT);
    pinMode(32,OUTPUT);

    //LEDs apagados
    digitalWrite(26,LOW);
    digitalWrite(32,LOW);

    //callback para quando entra em modo de configuração AP
    wifiManager.setAPCallback(configModeCallback);
    //callback para quando se conecta em uma rede, ou seja, quando passa a trabalhar em modo estação
    wifiManager.setSaveConfigCallback(saveConfigCallback);

    }

    void loop() {

    //Se o botão for pressionado
    if (digitalRead(13) == LOW) {
    Serial.println(“Abertura Portal”); //Abre o portal
    digitalWrite(26,HIGH); //Acende LED Vermelho
    digitalWrite(32,LOW);
    wifiManager.resetSettings(); //Apaga rede salva anteriormente
    if(!wifiManager.startConfigPortal(“ESP32-CONFIG”, “12345678”) ){ //Nome da Rede e Senha gerada pela ESP
    Serial.println(“Falha ao conectar”); //Se caso não conectar na rede mostra mensagem de falha
    delay(2000);
    ESP.restart(); //Reinicia ESP após não conseguir conexão na rede
    }
    else{ //Se caso conectar
    Serial.println(“Conectado na Rede!!!”);
    ESP.restart(); //Reinicia ESP após conseguir conexão na rede
    }
    }

    if(WiFi.status()== WL_CONNECTED){ //Se conectado na rede
    digitalWrite(32,HIGH); //Acende LED AZUL
    }
    else{ //se não conectado na rede
    digitalWrite(32,LOW); //Apaga LED AZUL
    //Pisca LED Vermelho
    digitalWrite(26,HIGH);
    delay(500);
    digitalWrite(26,LOW);
    delay(500);
    wifiManager.autoConnect();//Função para se autoconectar na rede
    }
    }

    1. No platform IO usando visual code, funcionou o código dessa forma.

    2. //Bibliotecas
      #include “HTTPClient.h”
      #include “DNSServer.h”
      #include “WebServer.h”
      #include “WiFiManager.h”
      #include “WiFi.h”

      No lugar de “”, use

  6. Estimado, al apagarse o reiniciar el router al que está conectado la ESP32, no vuelve a reconectarse al WiFi la ESP32, debo reiniciar la placa ESP32 para que vuelva a conectarse a la red WiFi. Habra alguna manera de que la ESP32 se Reconecte en caso de que se apague o reinicie el router???? Muchas gracias

    1. Olá, Waldo! pelos testes realizados assim que o roteador for ligado novamente o ESP32 se conectará automaticamente, devido a função wifiManager.autoConnect()

  7. Olá Felipe.. eu tive o mesmo erro do Artur, tentei desinstalar bibliotecas mas não obtive resultado.

    Achei a ideia muito boa, mas parece não funcionar bem, até que tenha um bom entendimento sobre as bibliotecas que entram em conflito.

    Não entendi bem esse conflito de bibliotecas.

    1. Olá Paulo! Obrigado pela leitura, bom eu tenho outra alternativa. Minha sugestão é que você pegue essas 3 pastas das bibliotecas que eu disponibilizei e coloque elas na pasta do seu arquivo .ino e altere no seu código

      de:

      //Bibliotecas
      #include
      #include
      #include
      #include

      Para:

      //Bibliotecas
      #include “HTTPClient.h”
      #include “DNSServer.h”
      #include “WebServer.h”
      #include “WiFiManager.h”

      Creio que isso deve resolver, pois vai referenciar as bibliotecas diretamente dentro da sua pasta onde está seu projeto .ino

    2. Olá, Waldo! pelos testes realizados assim que o roteador for ligado novamente o ESP32 se conectará automaticamente, devido a função wifiManager.autoConnect();

  8. Felipe tudo bem?
    Eu segui o tutorial do inicio se pular um passo até refiz, mas sem sucesso veja o erro que me é exibido.
    Se puder me ajudar serei grato.

    In file included from C:\Users\celso\Documents\Arduino\wireless\wireless.ino:4:0:
    C:\Users\celso\AppData\Local\Arduino15\packages\esp32\hardware\esp32\1.0.4\libraries\WebServer\src/WebServer.h:206:15: error: cannot declare field ‘WebServer::_server’ to be of abstract type ‘WiFiServer’
    WiFiServer _server;
    ^
    In file included from C:\Users\celso\AppData\Local\Arduino15\packages\esp32\hardware\esp32\1.0.4\libraries\WiFi\src/WiFi.h:32:0,
    from C:\Users\celso\AppData\Local\Arduino15\packages\esp32\hardware\esp32\1.0.4\libraries\WiFiClientSecure\src/WiFiClientSecure.h:25,
    from C:\Users\celso\AppData\Local\Arduino15\packages\esp32\hardware\esp32\1.0.4\libraries\HTTPClient\src/HTTPClient.h:35,
    from C:\Users\celso\Documents\Arduino\wireless\wireless.ino:2:
    C:\Users\celso\AppData\Local\Arduino15\packages\esp32\hardware\esp32\1.0.4\libraries\WiFi\src/WiFiServer.h:31:7: note: because the following virtual functions are pure within ‘WiFiServer’:
    class WiFiServer : public Server {
    ^
    In file included from C:\Users\celso\AppData\Local\Arduino15\packages\esp32\hardware\esp32\1.0.4\cores\esp32/Arduino.h:152:0,
    from sketch\wireless.ino.cpp:1:
    C:\Users\celso\AppData\Local\Arduino15\packages\esp32\hardware\esp32\1.0.4\cores\esp32/Server.h:28:18: note: virtual void Server::begin(uint16_t)
    virtual void begin(uint16_t port=0) =0;
    ^
    C:\Users\celso\Documents\Arduino\wireless\wireless.ino: In function ‘void configModeCallback(WiFiManager*)’:
    wireless:66:23: error: ‘class WiFiClass’ has no member named ‘softAPIP’
    Serial.println(WiFi.softAPIP()); //imprime o IP do AP
    ^
    exit status 1
    ‘class WiFiClass’ has no member named ‘softAPIP’

  9. Felipe excelente tutorial obrigado.
    Eu tive um problema usando PlatformIO importei as bibliotecas que você deixou no tutorial e sem mudar nada codigo apresentou o seguinte erro.

    src\main.cpp: In function ‘void setup()’:
    src\main.cpp:24:29: error: ‘configModeCallback’ was not declared in this scope
    wifiManager.setAPCallback(configModeCallback);
    ^
    src\main.cpp:26:37: error: ‘saveConfigCallback’ was not declared in this scope
    wifiManager.setSaveConfigCallback(saveConfigCallback);
    ^
    *** [.pio\build\esp32doit-devkit-v1\src\main.cpp.o] Error 1

    Já estou a mais de um dia tentando resolver mas sem sucesso, se você souber o que pode estar ocorrendo e como resolver agradeço.

    1. Boa tarde Celso! Peço desculpas pela demora sua notificação estava na caixa de spam do meu e-mail. Bom eu tive problema similar utilizando a IDE do arduino, você tem mais outras bibliotecas Wi-fi instaladas no plataformio?…Pois eu tive que retirar uma que já utilizava na IDE do arduino pois elas entravam em conflito.

    2. Coloca o Void configModeCallback e saveConfigCallback encima do void setup

  10. Olá Felipe, muito legal essa biblioteca WiFiManager!

    Eu desenvolvi um WiFiManager em Vuejs e BootstrapVue. Apesar de ainda não ser como uma biblioteca, ele tem algumas funcionalidades a mais bem interessantes como status de conexão com o device, visualização do endereço MAC e opção de utilizar endereço IP fixo.

    Tente utilizar e me diga o que achou!

    https://github.com/giobauermeister/esp32-wifi-manager-vuejs

    1. Olá Giovanni, opa vou testar!

    2. Opa, esse seu wifi manager gera ip fixo mesmo desconectado da internet?