🚧 Development Release

[tablatronix]

Development is now merged into master
https://github.com/tzapu/WiFiManager/

#499

README NOT FULLY UPDATED

• Create docs for changes, new features functions and known issues

TLDR

• Works (mostly) the same
• No Docs, Source is documentation ATM, especially all public methods
• DEV/ondemand example has pretty much everything
• Debug level is set very high, change it via WM_DEBUG_LEVEL or _debugLevel in source
• There are some experimental options for testing issues that are forever ongoing in esp lib
• all html and strings and in string_en.h and progmem

[tablatronix]

Development Overview

Added Public Methods

setConfigPortalBlocking
setShowStaticFields
setCaptivePortalEnable
setRestorePersistent
setCaptivePortalClientCheck
setWebPortalClientCheck
startWebPortal
stopWebPortal
process
disconnect
erase
debugSoftAPConfig
debugPlatformInfo
setScanDispPerc
setHostname
setMenu(menu_page_t[])
setWiFiAutoReconnect
setSTAStaticIPConfig(..,dns)
setShowDnsFields
getLastConxResult
getWLStatusString
getModeString
getWiFiIsSaved
setShowInfoErase
setEnableConfigPortal
setCountry
setClass
htmleEtities
getWiFiPass
getWiFiSSID
setWiFiAPChannel
setWiFiAPHidden
setParamsPage
setCleanConnect
setHttpPort
getConfigPortalActive
getWebPortalActive

WiFiManagerParameter

WiFiManagerParameter(id,label)
WiFiManagerParameter.setValue(value,length)
getParameters
getParametersCount

Constructors

WiFiManager(Stream& consolePort)

define/build flags

❗️ Defines cannot be set in user sketches, can be used in build_flags
#include <rom/rtc.h> // esp32 info page will show last reset reasons if this file is included
WM_MDNS // use MDNS
WM_FIXERASECONFIG // use erase flash fix, esp8266 2.4.0
WM_ERASE_NVS // esp32 erase(true) will erase NVS
WM_DEBUG_LEVEL // set debug level 0-4
WM_DEBUG_PORT // set debug port eg. Serial1

callbacks

setAPCallback // after ap has started
setWebServerCallback // after webserver is setup
setConfigResetCallback // reset settings
setSaveParamsCallback // after save params from params menu or wifi config
setPreSaveConfigCallback // before saving wifi creds

Changes

• ESP32 support
• complete refactor of strings strings_en.h
• adds new tokens for wifiscan, and some classes (left , invert icons, MSG color)
• adds status callout panel default, primary, special colors
• adds tons of info on info page, and erase capability
• adds signal icons, replaces percentage ( has hover titles )
• adds labels to all inputs (replaces placeholders)
• all html ( and eventually all strings except debug) moved to strings_en.h
• added additional debugging, compressed debug lines, debuglevels
• persistent disabled, and restored via de/con-stuctor (uses setRestorePersistent)
• should retain all user modes including AP, should not overwrite or persist user modes or configs,even STA (storeSTAmode) (BUGGY)
• ⚠️ return values may have changed depending on portal abort, or timeout ( portalTimeoutResult,portalAbortResult)
• params memory is auto allocated by increment of WIFI_MANAGER_MAX_PARAMS(5) when exceeded, user no longer needs to specify this at all.
• addparameter now returns bool, and it returns false if param ID is not alphanum [0-9,A-Z,a-z,_]
• param field ids allow {I} token to use param_n instead of string in case someones wants to change this due to i18n or character issues
• provides #DEFINE FIXERASECONFIG to help deal with Fix erase size in ESP.eraseConfig esp8266/Arduino#3635
• failure reason reporting on portal
• set esp8266 sta hostname, esp32 sta+ap hostname ( DHCP client id)
• pass in debug stream in constructor WiFiManager(Stream& consolePort)
• you can force ip fields off with setShow_X_fields(false) if you set _disableIpFields=true
• param menu/page (setup) added to separate params from wifi page, handled automatically by setMenu
• set custom root menu
• disable configportal on autoconnect
• wm parameters init is now protected, allowing child classes, example included
• wifiscans are precached and async for faster page loads, refresh forces rescan
• adds esp32 gettemperature ( currently commented out, useful for relative measurement only )
• Set AP Channel
• Set AP Hidden
• Change Http Port
• ⚠️ setAPCallback has moved to after startap

[Testato]

Very good,
for the esp32 merge i think it is fundamental and, at least for me, it work very well.
Merge it in the lib will help to have new test/opinion.

[Testato]

• adds signal icons, replaces percentage ( has hover titles )

On this change i do not agree, imho have the percentage is better than a simple icons whit only 4 graphic step, and on mobile lcd you cannot click for see the percentage number.
It is a very important signal, example for decide the post orientation of the Esp on a critical position far away from the wifi-router, sometimes you have very little wifi signsl, and recover 5 or 10% will make the difference.

You should add a public function that the user can use on the .ino sketch for decide himself witch type of data he need ?

I repeat, imho it is a very important info that the user should be decide whitout change the lib code.

[tablatronix]

• include <rom/rtc.h> to get esp32 info to show reset reasons