khoih-prog / ESPAsync_WiFiManager

This is an ESP32 (including ESP32-S2 and ESP32-C3) / ESP8266 WiFi Connection Manager, using ESPAsyncWebServer, with fallback web configuration portal. Use this library for configuring ESP32, ESP8266 modules' WiFi, etc. Credentials at runtime. You can also specify static DNS servers, personalized HostName, fixed or random AP WiFi channel. With examples supporting ArduinoJson 6.0.0+ as well as 5.13.5- . Using AsyncDNSServer instead of DNSServer now.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Documentation lacking minimal example

positron96 opened this issue · comments

Hello and thanks for the library.

The original ESP8266 WifiManager library can be used with default settings using 3 lines of code: 1 include and 2 lines in setup(). (See example: https://github.com/tzapu/WiFiManager/tree/master/examples/AutoConnect). The example with same name in ESPAsync_WiFiManager has whooping 500 lines of code, and it's not immediately clear what it does and what to pull in my code to have default functionality, e.g. start captive portal and connect the board to WiFi without having to hardcode the ESSID/password.
Please, provide a minimal example of this typical usecase, if one is possible.

I just hope anybody using this library spending some time to look at the examples, understand and test them to have much better knowledge that will definitely benefit in the long run.

I really don't expect any user uses as fast food, without spending any time with it. The versatility and functionality are what I like to provide to the library's users, not just simplicity without any long term benefit.

Anyway, I've just created several dead-simple examples which I just hope anybody could do, simply by deleting the unwanted portions of code


Simplest Possible

  1. Async_AutoConnect_ESP32_minimal
  2. Async_AutoConnect_ESP8266_minimal
  3. Async_ConfigOnDRD_ESP32_minimal
  4. Async_ConfigOnDRD_ESP8266_minimal

Amazing, thank you!