cvonk / esp32_wifi-connect

Reusable ESP-IDF module for reliable Wi-Fi connect (and if necessary reconnect)

ESP32 - Connect to WiFi Access Point

Goal

The ESP-IDF API

provides support for WiFi Station mode (aka STA mode or WiFi client mode). ESP32 connects to an access point.

This component makes this API available as a component. It connects to a WiFi Access Point, and reconnects when the connection drops.

The user can specify event handlers to respond to connect/disconnect events to e.g. start/stop a HTTP server.

Example

An example can be found in the test directory.

The WIFI_CONNECT_SSID and WIFI_CONNECT_PASSWORD can be provisioned using Kconfig. If empty, the device will use credentials from flash memory instead. Once connected to an WiFi Access Point, it starts a web server.

Usage

The software relies on the master ESP-IDF SDK version v4.3-dev-472-gcf056a7d0 and accompanying tools.

Clone this component in your project's components directory, or use it as a git submodule.

git submodule add -b master https://github.com/cvonk/ESP32_wifi-connect.git components/wifi_connect
git submodule init

Copy the Kconfig.example into your Kconfig and update the configuration.

First initialize non volatile flash memory (nvs_flash_init). Then create invoke the component as

wifi_connect_config_t wifi_connect_config = {
    .onConnect = _wifi_connect_on_connect,
    .onDisconnect = _wifi_connect_on_disconnect,
    .priv = NULL,
};
wifi_connect(&wifi_connect_config);

Here _wifi_connect_on_connect and _wifi_connect_on_disconnect are user supplied callback functions. The element priv is intended to private data used in these callback functions.

Feedback

I love to hear from you. Please use the Github discussion board to contact me.