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:
- Placa ESP23-C6 DevKitC-1
- Cabo USB-C
- Arduino IDE
- App ESP BLE Provisioning (Google PlayStore ou Apple App Store)
Para configurar o ambiente e instalar o suporte a ESP32-C6 veja o artigo ESP32-C6 na Prática: Seu Primeiro “Hello World”
Circuito
Configuração Arduino IDE
Abra a Arduino IDE e siga os passos abaixo:
- 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
- Instale o aplicativo ESP BLE Provisioning no seu smartphone
- Clique em Provision New Device
- Se no monitor serial o QR code não funcionar, clique em “Eu não tenho um QR code”.
- Permita que o aplicativo ligue o Bluetooth
- Selecione o seu dispositivo “PROV_123”
- Coloque a senha de posse do dispositivo “abcd1234”
- 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
- Introdução à Placa ESP32-C6-DevKitC-1: Ideal para IoT
- ESP32-C6 na Prática: Seu Primeiro “Hello World”
- https://github.com/espressif/arduino-esp32/blob/master/libraries/WiFiProv/examples/WiFiProv/WiFiProv.ino
- https://github.com/guilhermefernandesk/ESP32-C6/blob/main/provisioningBLE/provisioningBLE.ino




