This example demonstrates how to connect to the WiFi and manage the status and disconnection from STA.

Currently, this example supports the following targets.

| Supported Targets | ESP32 | ESP32-S2 | ESP32-C3 |

| ----------------- | ----- | -------- | -------- |

* How to install the Arduino IDE: [Install Arduino IDE](https://github.com/espressif/arduino-esp32/tree/master/docs/arduino-ide).

* Before Compile/Verify, select the correct board: `Tools -> Board`.

* Select the COM port: `Tools -> Port: xxx` where the `xxx` is the detected COM port.

* Select the COM port: `Devices` or set the `upload_port`` option on the `platformio.ini` file.

***Important: Be sure you're using a good quality USB cable that has enough power for your project.***

* **Programming Fail:** If the programming/flash procedure fails, try to reduce the serial connection speed.

* **COM port not detected:** Check the USB cable connection and the USB to Serial driver installation.

If the error persists, you can ask for help at the official [ESP32 forum](https://esp32.com) or see [Contribute](#contribute).

To know how to contribute to this project, see [How to contribute.](https://github.com/espressif/arduino-esp32/blob/master/CONTRIBUTING.rst)

If you have any **feedback** or **issue** to report on this example/library, please open an issue or fix it by creating a new PR. Contributions are more than welcome!

Before creating a new issue, be sure to try Troubleshooting and check if the same issue was already created by someone else.

* Arduino-ESP32 Official Repository: [espressif/arduino-esp32](https://github.com/espressif/arduino-esp32)

* ESP32 Datasheet: [Link to datasheet](https://www.espressif.com/sites/default/files/documentation/esp32_datasheet_en.pdf)

* ESP32-S2 Datasheet: [Link to datasheet](https://www.espressif.com/sites/default/files/documentation/esp32-s2_datasheet_en.pdf)

* ESP32-C3 Datasheet: [Link to datasheet](https://www.espressif.com/sites/default/files/documentation/esp32-c3_datasheet_en.pdf)

* Official ESP-IDF documentation: [ESP-IDF](https://idf.espressif.com)

#include <WiFi.h>

const char* ssid = "your-ssid";

const char* password = "your-password";

int btnGPIO = 0;

int btnState = false;

void setup()

{

Serial.begin(115200);

delay(10);

// Set GPIO0 Boot button as input

pinMode(btnGPIO, INPUT);

// We start by connecting to a WiFi network

// To debug, please enable Core Debug Level to Verbose

Serial.println();

Serial.print("[WiFi] Connecting to ");

Serial.println(ssid);

WiFi.begin(ssid, password);

// Will try for about 10 seconds (20x 500ms)

int tryDelay = 500;

int numberOfTries = 20;

// Wait for the WiFi event

while (true) {

switch(WiFi.status()) {

case WL_NO_SSID_AVAIL:

Serial.println("[WiFi] SSID not found");

break;

case WL_CONNECT_FAILED:

Serial.print("[WiFi] Failed - WiFi not connected! Reason: ");

return;

break;

case WL_CONNECTION_LOST:

Serial.println("[WiFi] Connection was lost");

break;

case WL_SCAN_COMPLETED:

Serial.println("[WiFi] Scan is completed");

break;

case WL_DISCONNECTED:

Serial.println("[WiFi] WiFi is disconnected");

break;

case WL_CONNECTED:

Serial.println("[WiFi] WiFi is connected!");

Serial.print("[WiFi] IP address: ");

Serial.println(WiFi.localIP());

return;

break;

default:

Serial.print("[WiFi] WiFi Status: ");

Serial.println(WiFi.status());

break;

}

delay(tryDelay);

if(numberOfTries <= 0){

Serial.print("[WiFi] Failed to connect to WiFi!");

// Use disconnect function to force stop trying to connect

WiFi.disconnect();

return;

} else {

numberOfTries--;

}

}

}

void loop()

{

// Read the button state

btnState = digitalRead(btnGPIO);

if (btnState == LOW) {

// Disconnect from WiFi

Serial.println("[WiFi] Disconnecting from WiFi!");

// This function will disconnect and turn off the WiFi (NVS WiFi data is kept)

if(WiFi.disconnect(true, false)){

Serial.println("[WiFi] Disconnected from WiFi!");

}

delay(1000);

}

}

case WIFI_REASON_UNSPECIFIED: