wirtz
/
AutoConnect
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
128 Commits
3 Branches
19 Tags
22 MiB
 
 
 
 
 
Tag: Branch: Tree: b0fbfc3558
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from 'b0fbfc3558'
${ noResults }
AutoConnect/README.md

6.7 KiB
Raw Blame History Escape

AutoConnect for ESP8266/ESP32

Build Status GitHub release

An Arduino library for ESP8266/ESP32 WLAN configuration at run time with web interface.

Overview

To the dynamic configuration for joining to WLAN with SSID and PSK accordingly. It an Arduino library united with ESP8266WebServer class of ESP8266 or WebServer class of ESP32. Easily implementing the Web interface constituting the WLAN for ESP8266/ESP32 WiFi connection. With this library to make a sketch easily which connects from ESP8266/ESP32 to the access point at runtime by the web interface without hard-coded SSID and password.

Overview   Captiveportal

No need pre-coded SSID & password

It is no needed hard-coding in advance the SSID and Password into the sketch to connect between ESP8266/ESP32 and WLAN. You can input SSID & Password from a smartphone via the web interface at runtime.

Simple usage

AutoConnect control screen will be displayed automatically for establishing new connections. It aids by the captive portal when vested the connection cannot be detected.
By using the AutoConnect menu, to manage the connections convenient.

Store the established connection

The connection authentication data as credentials are saved automatically in EEPROM of ESP8266/ESP32 and You can select the past SSID from the AutoConnect menu.

Easy to embed in

AutoConnect can be embedded easily into your sketch, just "begin" and "handleClient".

Lives with the your sketches

The sketches which provide the web page using ESP8266WebServer/WebServer there is, AutoConnect will not disturb it. AutoConnect can use an already instantiated ESP8266WebServer object(ESP8266) or WebServer object(ESP32), or itself can assign it.

Easily add user-owned web screen and parameters ENHANCED w/ v0.9.7

You can easily add your own web screen that can consist of representative HTML elements as the styled TEXT, INPUT, BUTTON, CHECKBOX, SUBMIT into the menu. It can be invoked from the AutoConnect menu and parameters can be passed.

Just loading the JSON description ENHANCED w/ v0.9.7

These HTML elements that make up the user-owned screen can be easily loaded from the JSON description stored in PROGMEM, SPIFFS or SD.

Supported hardware

Apply the Arduino core of the ESP8266 Community.

  • Generic ESP8266 modules
  • Adafruit HUZZAH ESP8266 (ESP-12)
  • ESP-WROOM-02
  • Heltec WiFi Kit 8
  • NodeMCU 0.9 (ESP-12) / NodeMCU 1.0 (ESP-12E)
  • Olimex MOD-WIFI-ESP8266
  • SparkFun Thing
  • SweetPea ESP-210

Alter the platform applying the arduino-esp32 for the ESP32 modules.

  • ESP32Dev Board
  • SparkFun ESP32 Thing
  • WEMOS LOLIN D32
  • Ai-Thinker NodeMCU-32S
  • Heltec WiFi Kit 32
  • M5Stack
  • And other ESP32 modules supported by the Additional Board Manager URLs of the Arduino-IDE.

Simple usage

The AutoConnect menu

   

How embed the AutoConnect to the sketches you have

Most simple approach to applying AutoConnect for the existing sketches, follow the below steps.

More usages and Documentation

Full documentation is available on https://Hieromon.github.io/AutoConnect, some quick links at the list:

Change log

[0.9.7] Jan. 1, 2019

  • Fixed crash in some environments. Thank you @ageurtse
  • Supports AutoConnect menu extention by user sketch with AutoConnectAux.
  • Supports loading and saving of user-defined parameters with JSON format.
  • Improved the WiFi connection sequence at the first WiFi.begin. Even if AutoConnectConfig::autoReconnect is disabled when SSID and PSK are not specified, it will use the information of the last established access point. The autoReconnect option will achieve trying the connect after a previous connection failed.
  • Supports AutoConnectConfig::immediateStart option, to start the portal immediately without first trying WiFi.begin.
  • Improved boot uri after reset. AutoConnectConfig::bootUri can be specified either /_ac or HOME path as the uri to be accessed after invoking Reset from AutoConnect menu.
  • Improved source code placement of predefined macros. Defined common macros have been moved to AutoConnectDefs.h.
  • Supports AutoConnectConfig::hostName. It activates WiFi.hostname().

[0.9.6] Sept. 27, 2018

  • Improvement of RSSI detection for saved SSIDs.
  • Fixed disconnection SoftAP completely at the first connection phase of the AutoConnect::begin.

[0.9.5] Aug. 27, 2018

  • Supports the espressif arduino-esp32 core.
  • Fixed that crash may occur if the number of stored credentials in the EEPROM is smaller than the number of found WiFi networks.

[0.9.4] May 5, 2018.

  • Automatically focus passphrase after selecting SSID with Configure New AP.
  • Supports AutoConnectConfig::autoReconnect option, it will scan the WLAN when it can not connect to the default SSID, apply the applicable credentials if it is saved, and try reconnecting.

[0.9.3] March 23, 2018.

  • Supports a static IP address assignment.

[0.9.2] March 19, 2018.

  • Improvement of string literal declaration with the examples, no library change.

[0.9.1] March 13, 2018.

  • A release of the stable.

License

License under the MIT license.