ESP32-C6 na Prática: Provisionamento de Wi-Fi via Bluetooth Low Energy

Este post faz parte da série ESP32-C6 na Prática

Introdução

Neste artigo, mostraremos como configurar o provisionamento Wi-Fi via BLE na placa de desenvolvimento ESP32-C6 DevKitC-1 com a Arduino IDE.

Nosso projeto terá como objetivo configurar as credenciais de Wi-Fi de forma remota, adaptando o exemplo da biblioteca WiFiProv chamado WiFiProv, que realiza o provisionamento tanto por Wi-Fi quanto por BLE. A mesma ideia utilizada no artigo ESP32-C6 na Prática: ESP RainMaker com Arduino IDE

Para conhecer mais a placa de desenvolvimento consulte nosso artigo Introdução à Placa ESP32-C6-DevKitC-1: Ideal para IoT

O provisionamento BLE

Para provisionar o ESP32-C6 DevKitC-1 via BLE, precisamos usar outro dispositivo com BLE. Podemos usar um aplicativo Android ou iOS, ou um aplicativo Bluetooth da Web e enviar as credenciais de Wi-Fi. 

Materiais Necessários

Para desenvolver nossa aplicação os materiais utilizados foram:

Para configurar o ambiente e instalar o suporte a ESP32-C6 veja o artigo ESP32-C6 na Prática: Seu Primeiro “Hello World”

Circuito

Figura 1: Circuito desenvolvido

Configuração Arduino IDE

Abra a Arduino IDE e siga os passos abaixo:

  1. Em Ferramentas > Partition Scheme > No OTA (2MB APP/2MB SPIFFS

Código

O código completo pode ser acessado em: https://github.com/guilhermefernandesk/ESP32-C6/blob/main/provisioningBLE/provisioningBLE.ino

/*********************************************************
 * Projeto: Provisionamento de Wi-Fi via BLE (Bluetooth Low Energy)
 *
 * Autor: Guilherme Fernandes
 * Data: 15/08/2025
 * Placa: ESP32-C6 DevKitC-1
 *********************************************************/


#include "WiFiProv.h"
#include "WiFi.h"


const char *pop = "abcd1234";           // Proof of possession - otherwise called a PIN - string provided by the device, entered by the user in the phone app
const char *service_name = "PROV_123";  // Name of your device (the Espressif apps expects by default device name starting with "Prov_")
const char *service_key = NULL;         // Password used for SofAP method (NULL = no password needed)
bool reset_provisioned = true;          // When true the library will automatically delete previously provisioned data.


// WARNING: SysProvEvent is called from a separate FreeRTOS task (thread)!
void SysProvEvent(arduino_event_t *sys_event) {
  switch (sys_event->event_id) {
    case ARDUINO_EVENT_WIFI_STA_GOT_IP:
      Serial.print("\nConnected IP address : ");
      Serial.println(IPAddress(sys_event->event_info.got_ip.ip_info.ip.addr));
      break;
    case ARDUINO_EVENT_WIFI_STA_DISCONNECTED: Serial.println("\nDisconnected. Connecting to the AP again... "); break;
    case ARDUINO_EVENT_PROV_START: Serial.println("\nProvisioning started\nGive Credentials of your access point using smartphone app"); break;
    case ARDUINO_EVENT_PROV_CRED_RECV:
      {
        Serial.println("\nReceived Wi-Fi credentials");
        Serial.print("\tSSID : ");
        Serial.println((const char *)sys_event->event_info.prov_cred_recv.ssid);
        Serial.print("\tPassword : ");
        Serial.println((char const *)sys_event->event_info.prov_cred_recv.password);
        break;
      }
    case ARDUINO_EVENT_PROV_CRED_FAIL:
      {
        Serial.println("\nProvisioning failed!\nPlease reset to factory and retry provisioning\n");
        if (sys_event->event_info.prov_fail_reason == NETWORK_PROV_WIFI_STA_AUTH_ERROR) {
          Serial.println("\nWi-Fi AP password incorrect");
        } else {
          Serial.println("\nWi-Fi AP not found....Add API \" nvs_flash_erase() \" before beginProvision()");
        }
        break;
      }
    case ARDUINO_EVENT_PROV_CRED_SUCCESS: Serial.println("\nProvisioning Successful"); break;
    case ARDUINO_EVENT_PROV_END: Serial.println("\nProvisioning Ends"); break;
    default: break;
  }
}


void setup() {
  Serial.begin(115200);
  WiFi.begin();  // no SSID/PWD - get it from the Provisioning APP or from NVS (last successful connection)
  WiFi.onEvent(SysProvEvent);


  Serial.println("Begin Provisioning using BLE");
  // Sample uuid that user can pass during provisioning using BLE
  uint8_t uuid[16] = { 0xb4, 0xdf, 0x5a, 0x1c, 0x3f, 0x6b, 0xf4, 0xbf,
                       0xea, 0x4a, 0x82, 0x03, 0x04, 0x90, 0x1a, 0x02 };
  WiFiProv.beginProvision(
    NETWORK_PROV_SCHEME_BLE, NETWORK_PROV_SCHEME_HANDLER_FREE_BLE, NETWORK_PROV_SECURITY_1, pop, service_name, service_key, uuid, reset_provisioned);
  log_d("ble qr");
  WiFiProv.printQR(service_name, pop, "ble");
}


void loop() {}

Configuração App

  1. Instale o aplicativo ESP BLE Provisioning no seu smartphone
  2. Clique em Provision New Device
  1. Se no monitor serial o QR code não funcionar, clique em “Eu não tenho um QR code”.
  1. Permita que o aplicativo ligue o Bluetooth
  2. Selecione o seu dispositivo “PROV_123”
  1. Coloque a senha de posse do dispositivo “abcd1234”
  2. Após isso irá pedir para configurar as credenciais da rede Wi-Fi

Resultados

Realizado o provisionamento do Wi-Fi, você pode implementar a funcionalidade desejada no loop, além de armazenar as informações conforme desejado.

Conclusão

Neste artigo, mostramos como configurar o provisionamento Wi-Fi via BLE da placa ESP32-C6 DevKitC-1. Essa abordagem permite conectar a rede Wi-Fi remotamente sem regravar firmware ou manter as credenciais no código, tudo realizado pelo aplicativo oficial da Espressif.

Convidamos você a explorar outras aplicações integrando o provisionamento BLE, como: Salvar as informações de rede na memória, implementar web servers, etc.

Sinta-se à vontade para compartilhar seus resultados com a comunidade, seja por artigos, vídeos ou repositórios abertos. Sua experiência pode inspirar e auxiliar muitos outros desenvolvedores.

Referências

ESP32-C6 na Prática

ESP32-C6 na Prática: Usando o Telegram para controlar GPIOs ESP32-C6 na Prática: Log de dados no Google Sheets
Licença Creative Commons Esta obra está licenciada com uma Licença Creative Commons Atribuição-CompartilhaIgual 4.0 Internacional.
Comentários:
Notificações
Notificar
0 Comentários
recentes
antigos mais votados
Inline Feedbacks
View all comments
Home » Internet Das Coisas » ESP32-C6 na Prática: Provisionamento de Wi-Fi via Bluetooth Low Energy

EM DESTAQUE

WEBINARS

VEJA TAMBÉM

JUNTE-SE HOJE À COMUNIDADE EMBARCADOS

Talvez você goste: