morgan/esp32-wifi-manager
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity
ESP-IDF component for WiFi connection handling.
26 commits 1 branch 0 tags 63 KiB
C 95.1%
Makefile 4.1%
CMake 0.8%
Find a file
Morgan Allen f58c4d63c4 expose _connect for user use
2018-09-21 22:34:24 -07:00
include expose _connect for user use 2018-09-21 22:34:24 -07:00
main go IDLE after all APs have been attempted 2018-09-21 22:33:38 -07:00
test/wm-test-project on no, weve gone idle 2018-09-21 22:34:04 -07:00
component.mk init skeleton commit 2018-09-02 17:10:41 -07:00
Kconfig add connection delay between attempts 2018-09-21 22:12:17 -07:00
README.md what this thing all about? 2018-09-21 22:03:07 -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.

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.