ESP-IDF component for WiFi connection handling.
Go to file
Morgan 'ARR\!' Allen 826b652994 refactor event group 2023-09-12 14:27:46 -07:00
include refactor event group 2023-09-12 14:27:46 -07:00
main refactor event group 2023-09-12 14:27:46 -07:00
test/wm-test-project make bootstraping code from demo part of component 2019-02-22 15:27:02 -08:00
CMakeLists.txt cmake idf compatibility 2022-04-02 10:35:03 -07:00
Kconfig add connection delay between attempts 2018-09-21 22:12:17 -07:00
README.md include bootstrap in readme 2019-02-22 15:33:46 -08:00
component.mk init skeleton commit 2018-09-02 17:10:41 -07:00

README.md

esp32-wifi-manager

WiFi Manager for ESP32. That's it. No captive portal, no fallback if AP is not available. Just WiFi Management.

Why

Most ESP32 WiFI Manager solutions are just hotspot captive portals that are used to (maybe) scan for and then connect to an Access Point in the area. This is cumbersome if you want your device to be portable, connecting to know APs in the area.

This is intended to do one job. Handle connecting to WiFi. Feeding in the AP config info is up to you. But I trust you and have faith you can do it!

What doeswill it do?

  • Stores info for multiple APs
  • Connects to "best"* AP available
  • Remembers which AP was connected to last
  • Support more than basic auth
  • Tells you you're a pretty alrigh person

* best to be determined

How do I feed this thing?

Only basic ssid and password authenication are supported at the moment but adding will be the same in the future. The API method wifi_manager_add_ap is used to add an Access Point to the config. It is automatically saved and if it is current not connected, it will attempt to make a connection.

API

EventGroupHandle_t wifi_manager_start()

Creates EventGroup and starts main WiFi Manager task loop.

uint8_t wifi_manager_ap_count()

Return number of AP in storage.

uint8_t wifi_manager_add_ap(char *ssid, char *password)

Adds AP to storage. !This will change! Will become a struct config.

uint8_t wifi_manager_bootstrap_config()

Loads build time sdkconfig variables into WiFi Manager.

EventGroupHandle_t wm_event_group Bits

WIFI_CONNECTED

WiFi connected has been successful.

WIFI_CONNECTING

WiFi Manager is attempting to make a connection.

AP_AVAILABLE

AP info has been retreived from storage. This is in flux, the naming is potentially confusing.