|
13 | 13 | ## Table of Contents
|
14 | 14 |
|
15 | 15 | * [Important Breaking Change from v1.8.0](#Important-Breaking-Change-from-v180)
|
| 16 | + * [For v1.9.0 and up](#For-v190-and-up) |
| 17 | + * [For v1.8.0 only](#For-v180-only) |
16 | 18 | * [Important Note](#important-note)
|
17 | 19 | * [Why do we need the new Async ESPAsync_WiFiManager library](#why-do-we-need-the-new-async-espasync_wifimanager-library)
|
18 | 20 | * [Why do we need this ESP_WiFiManager library](#why-do-we-need-this-esp_wifimanager-library)
|
|
152 | 154 |
|
153 | 155 | ### Important Breaking Change from v1.8.0
|
154 | 156 |
|
| 157 | +#### For v1.9.0 and up |
| 158 | + |
| 159 | +Please have a look at [HOWTO Fix `Multiple Definitions` Linker Error](#howto-fix-multiple-definitions-linker-error) |
| 160 | + |
| 161 | +From v1.9.0, you just use |
| 162 | + |
| 163 | +``` |
| 164 | +#include <ESP_WiFiManager.h> //https://github.com/khoih-prog/ESP_WiFiManager |
| 165 | +``` |
| 166 | + |
| 167 | +instead of both |
| 168 | + |
| 169 | +``` |
| 170 | +#include <ESP_WiFiManager.h> //https://github.com/khoih-prog/ESP_WiFiManager |
| 171 | +
|
| 172 | +// To be included only in main(), .ino with setup() to avoid `Multiple Definitions` Linker Error |
| 173 | +#include <ESP_WiFiManager-Impl.h> //https://github.com/khoih-prog/ESP_WiFiManager |
| 174 | +``` |
| 175 | + |
| 176 | + |
| 177 | +For complex project having `Multiple Definitions Linker Error` issue, you can use in many files (**Be careful**: `.hpp`, not `.h`) |
| 178 | + |
| 179 | +``` |
| 180 | +#include <ESP_WiFiManager.hpp> //https://github.com/khoih-prog/ESP_WiFiManager |
| 181 | +``` |
| 182 | + |
| 183 | +but only in main(), .ino with setup() to avoid `Multiple Definitions Linker Error` |
| 184 | + |
| 185 | + |
| 186 | +``` |
| 187 | +#include <ESP_WiFiManager.h> //https://github.com/khoih-prog/ESP_WiFiManager |
| 188 | +``` |
| 189 | + |
| 190 | +--- |
| 191 | + |
| 192 | + |
| 193 | +#### For v1.8.0 only |
| 194 | + |
| 195 | +It's advisable to use v1.9.0+ |
| 196 | + |
155 | 197 | Please have a look at [HOWTO Fix `Multiple Definitions` Linker Error](#howto-fix-multiple-definitions-linker-error)
|
156 | 198 |
|
157 | 199 | From v1.8.0, you must use
|
@@ -310,14 +352,14 @@ The current library implementation, using `xyz-Impl.h` instead of standard `xyz.
|
310 | 352 | You can use
|
311 | 353 |
|
312 | 354 | ```
|
313 |
| -#include <ESP_WiFiManager.h> //https://github.com/khoih-prog/ESP_WiFiManager |
| 355 | +#include <ESP_WiFiManager.hpp> //https://github.com/khoih-prog/ESP_WiFiManager |
314 | 356 | ```
|
315 | 357 |
|
316 |
| -in many files. But be sure to use the following `#include <ESP_WiFiManager-Impl.h>` **in just 1 `.h`, `.cpp` or `.ino` file**, which must **not be included in any other file**, to avoid `Multiple Definitions` Linker Error |
| 358 | +in many files. But be sure to use the following `#include <ESP_WiFiManager.h>` **in just 1 `.h`, `.cpp` or `.ino` file**, which must **not be included in any other file**, to avoid `Multiple Definitions` Linker Error |
317 | 359 |
|
318 | 360 | ```
|
319 | 361 | // To be included only in main(), .ino with setup() to avoid `Multiple Definitions` Linker Error
|
320 |
| -#include <ESP_WiFiManager-Impl.h> //https://github.com/khoih-prog/ESP_WiFiManager |
| 362 | +#include <ESP_WiFiManager.h> //https://github.com/khoih-prog/ESP_WiFiManager |
321 | 363 | ```
|
322 | 364 |
|
323 | 365 | Check [ConfigOnDoubleReset_Multi](examples/ConfigOnDoubleReset_Multi) for an example how and where to do so.
|
@@ -2151,8 +2193,8 @@ ESP_wifiManager.setRemoveDuplicateAPs(false);
|
2151 | 2193 | #error This code is intended to run on the ESP8266 or ESP32 platform! Please check your Tools->Board setting.
|
2152 | 2194 | #endif
|
2153 | 2195 |
|
2154 |
| -#define ESP_WIFIMANAGER_VERSION_MIN_TARGET "ESP_WiFiManager v1.8.0" |
2155 |
| -#define ESP_WIFIMANAGER_VERSION_MIN 1008000 |
| 2196 | +#define ESP_WIFIMANAGER_VERSION_MIN_TARGET "ESP_WiFiManager v1.9.0" |
| 2197 | +#define ESP_WIFIMANAGER_VERSION_MIN 1009000 |
2156 | 2198 |
|
2157 | 2199 | // Use from 0 to 4. Higher number, more debugging messages and memory usage.
|
2158 | 2200 | #define _WIFIMGR_LOGLEVEL_ 3
|
@@ -2492,7 +2534,9 @@ IPAddress APStaticSN = IPAddress(255, 255, 255, 0);
|
2492 | 2534 | //#define HTTP_PORT 8080
|
2493 | 2535 |
|
2494 | 2536 | #include <ESP_WiFiManager.h> //https://github.com/khoih-prog/ESP_WiFiManager
|
2495 |
| -#include <ESP_WiFiManager-Impl.h> //https://github.com/khoih-prog/ESP_WiFiManager |
| 2537 | + |
| 2538 | +// Redundant, for v1.8.0 only |
| 2539 | +//#include <ESP_WiFiManager-Impl.h> //https://github.com/khoih-prog/ESP_WiFiManager |
2496 | 2540 |
|
2497 | 2541 | #define HTTP_PORT 80
|
2498 | 2542 |
|
@@ -3521,7 +3565,7 @@ This is terminal debug output when running [ConfigOnSwitchFS_MQTT_Ptr](examples/
|
3521 | 3565 |
|
3522 | 3566 | ```
|
3523 | 3567 | Starting ConfigOnSwichFS_MQTT_Ptr using LittleFS on ESP8266_NODEMCU_ESP12E
|
3524 |
| -ESP_WiFiManager v1.8.0 |
| 3568 | +ESP_WiFiManager v1.9.0 |
3525 | 3569 | Configuration file not found
|
3526 | 3570 | Failed to read configuration file, using default values
|
3527 | 3571 | [WM] RFC925 Hostname = ConfigOnSwichFS-MQTT
|
@@ -3633,7 +3677,7 @@ This is terminal debug output when running [ESP32_FSWebServer_DRD](examples/ESP3
|
3633 | 3677 |
|
3634 | 3678 | ```cpp
|
3635 | 3679 | Starting ESP32_FSWebServer_DRD with DoubleResetDetect using SPIFFS on ESP32_DEV
|
3636 |
| -ESP_WiFiManager v1.8.0 |
| 3680 | +ESP_WiFiManager v1.9.0 |
3637 | 3681 | ESP_DoubleResetDetector v1.2.1
|
3638 | 3682 | FS File: /ConfigSW.json, size: 150B
|
3639 | 3683 | FS File: /CanadaFlag_1.png, size: 40.25KB
|
@@ -3698,7 +3742,7 @@ This is terminal debug output when running [ESP32_FSWebServer_DRD](examples/ESP3
|
3698 | 3742 |
|
3699 | 3743 | ```
|
3700 | 3744 | Starting ESP32_FSWebServer_DRD with DoubleResetDetect using LittleFS on ESP32_DEV
|
3701 |
| -ESP_WiFiManager v1.8.0 |
| 3745 | +ESP_WiFiManager v1.9.0 |
3702 | 3746 | ESP_DoubleResetDetector v1.2.1
|
3703 | 3747 | FS File: /CanadaFlag_1.png, size: 40.25KB
|
3704 | 3748 | FS File: /CanadaFlag_2.png, size: 8.12KB
|
@@ -3757,7 +3801,7 @@ This is terminal debug output when running [ConfigOnDRD_FS_MQTT_Ptr_Complex](exa
|
3757 | 3801 |
|
3758 | 3802 | ```
|
3759 | 3803 | Starting ConfigOnDRD_FS_MQTT_Ptr_Complex using LittleFS on ESP32_DEV
|
3760 |
| -ESP_WiFiManager v1.8.0 |
| 3804 | +ESP_WiFiManager v1.9.0 |
3761 | 3805 | ESP_DoubleResetDetector v1.2.1
|
3762 | 3806 | {"AIO_KEY_Label":"aio_key","AIO_SERVER_Label":"io.adafruit.com","AIO_SERVERPORT_Label":"1883","AIO_USERNAME_Label":"user_name"}
|
3763 | 3807 | Config File successfully parsed
|
@@ -3800,7 +3844,7 @@ WWWW WTWWWW WWTWWW WWWTWW WWWWTW WWWWW
|
3800 | 3844 |
|
3801 | 3845 | ```
|
3802 | 3846 | Starting ConfigOnDRD_FS_MQTT_Ptr_Complex using LittleFS on ESP32_DEV
|
3803 |
| -ESP_WiFiManager v1.8.0 |
| 3847 | +ESP_WiFiManager v1.9.0 |
3804 | 3848 | ESP_DoubleResetDetector v1.2.1
|
3805 | 3849 | {"AIO_KEY_Label":"aio_key","AIO_SERVER_Label":"io.adafruit.com","AIO_SERVERPORT_Label":"1883","AIO_USERNAME_Label":"user_name"}
|
3806 | 3850 | Config File successfully parsed
|
@@ -3885,7 +3929,7 @@ This is terminal debug output when running [ConfigOnDRD_FS_MQTT_Ptr_Complex](exa
|
3885 | 3929 |
|
3886 | 3930 | ```
|
3887 | 3931 | Starting ConfigOnDRD_FS_MQTT_Ptr_Medium using LittleFS on ESP8266_NODEMCU_ESP12E
|
3888 |
| -ESP_WiFiManager v1.8.0 |
| 3932 | +ESP_WiFiManager v1.9.0 |
3889 | 3933 | ESP_DoubleResetDetector v1.2.1
|
3890 | 3934 | {"AIO_KEY_Label":"aio_key","AIO_SERVER_Label":"io.adafruit.com","AIO_SERVERPORT_Label":"1883","AIO_USERNAME_Label":"user_name"}
|
3891 | 3935 | Config File successfully parsed
|
@@ -3925,7 +3969,7 @@ TWWWW WTWWWW WWTWWW WWWTWW WWWWTW WWWWW
|
3925 | 3969 |
|
3926 | 3970 | ```
|
3927 | 3971 | Starting ConfigOnDRD_FS_MQTT_Ptr_Medium using LittleFS on ESP8266_NODEMCU_ESP12E
|
3928 |
| -ESP_WiFiManager v1.8.0 |
| 3972 | +ESP_WiFiManager v1.9.0 |
3929 | 3973 | ESP_DoubleResetDetector v1.2.1
|
3930 | 3974 | {"AIO_KEY_Label":"aio_key","AIO_SERVER_Label":"io.adafruit.com","AIO_SERVERPORT_Label":"1883","AIO_USERNAME_Label":"user_name"}
|
3931 | 3975 | Config File successfully parsed
|
@@ -4002,7 +4046,7 @@ This is terminal debug output when running [ConfigOnDoubleReset](examples/Config
|
4002 | 4046 |
|
4003 | 4047 | ```
|
4004 | 4048 | Starting ConfigOnDoubleReset with DoubleResetDetect using LittleFS on ESP32S2_DEV
|
4005 |
| -ESP_WiFiManager v1.8.0 |
| 4049 | +ESP_WiFiManager v1.9.0 |
4006 | 4050 | ESP_DoubleResetDetector v1.2.1
|
4007 | 4051 | [WM] RFC925 Hostname = ConfigOnDoubleReset
|
4008 | 4052 | [WM] setAPStaticIPConfig
|
@@ -4052,7 +4096,7 @@ This is terminal debug output when running [ConfigOnDoubleReset](examples/Config
|
4052 | 4096 |
|
4053 | 4097 | ```
|
4054 | 4098 | Starting ConfigOnDoubleReset with DoubleResetDetect using LittleFS on ESP32_DEV
|
4055 |
| -ESP_WiFiManager v1.8.0 |
| 4099 | +ESP_WiFiManager v1.9.0 |
4056 | 4100 | ESP_DoubleResetDetector v1.2.1
|
4057 | 4101 | [WM] RFC925 Hostname = ConfigOnDoubleReset
|
4058 | 4102 | [WM] Set CORS Header to : Your Access-Control-Allow-Origin
|
@@ -4162,7 +4206,7 @@ Local Date/Time: Thu May 6 21:29:18 2021
|
4162 | 4206 |
|
4163 | 4207 | ```
|
4164 | 4208 | Starting ConfigOnDoubleReset with DoubleResetDetect using LittleFS on ESP32_DEV
|
4165 |
| -ESP_WiFiManager v1.8.0 |
| 4209 | +ESP_WiFiManager v1.9.0 |
4166 | 4210 | ESP_DoubleResetDetector v1.2.1
|
4167 | 4211 | [WM] RFC925 Hostname = ConfigOnDoubleReset
|
4168 | 4212 | [WM] Set CORS Header to : Your Access-Control-Allow-Origin
|
@@ -4213,7 +4257,7 @@ This is terminal debug output when running [ConfigOnDoubleReset](examples/Config
|
4213 | 4257 |
|
4214 | 4258 | ```
|
4215 | 4259 | Starting ConfigOnDoubleReset with DoubleResetDetect using LittleFS on ESP32S2_DEV
|
4216 |
| -ESP_WiFiManager v1.8.0 |
| 4260 | +ESP_WiFiManager v1.9.0 |
4217 | 4261 | ESP_DoubleResetDetector v1.2.1
|
4218 | 4262 | [WM] RFC925 Hostname = ConfigOnDoubleReset
|
4219 | 4263 | [WM] Set CORS Header to : Your Access-Control-Allow-Origin
|
@@ -4359,7 +4403,7 @@ Local Date/Time: Thu May 6 21:29:18 2021
|
4359 | 4403 |
|
4360 | 4404 | ```
|
4361 | 4405 | Starting ConfigOnDoubleReset with DoubleResetDetect using LittleFS on ESP32S2_DEV
|
4362 |
| -ESP_WiFiManager v1.8.0 |
| 4406 | +ESP_WiFiManager v1.9.0 |
4363 | 4407 | ESP_DoubleResetDetector v1.2.1
|
4364 | 4408 | [WM] RFC925 Hostname = ConfigOnDoubleReset
|
4365 | 4409 | [WM] Set CORS Header to : Your Access-Control-Allow-Origin
|
@@ -4412,7 +4456,7 @@ This is terminal debug output when running [ESP32_FSWebServer_DRD](examples/ESP3
|
4412 | 4456 |
|
4413 | 4457 | ```
|
4414 | 4458 | Starting ESP32_FSWebServer_DRD with DoubleResetDetect using SPIFFS on ESP32C3_DEV
|
4415 |
| -ESP_WiFiManager v1.8.0 |
| 4459 | +ESP_WiFiManager v1.9.0 |
4416 | 4460 | ESP_DoubleResetDetector v1.2.1
|
4417 | 4461 | FS File: wm_cp.dat, size: 4B
|
4418 | 4462 | FS File: wm_cp.bak, size: 4B
|
|
0 commit comments