# WiFiManager
## DEVELOPMENT Version
Espressif ESPx WiFi Connection manager with fallback web configuration portal
:warning: This Documentation is out of date, see notes below
![Release](https://img.shields.io/github/v/release/tzapu/WiFiManager?include_prereleases)
[![Build CI Status](https://github.com/tzapu/WiFiManager/actions/workflows/compile_library.yml/badge.svg)](https://github.com/tzapu/WiFiManager/actions/workflows/compile_library.yml)
[![Build CI Status Examples](https://github.com/tzapu/WiFiManager/actions/workflows/compile_examples.yaml/badge.svg)](https://github.com/tzapu/WiFiManager/actions/workflows/compile_examples.yaml)
[![arduino-library-badge](https://www.ardu-badge.com/badge/WiFiManager.svg?)](https://www.ardu-badge.com/WiFiManager)
[![Build with PlatformIO](https://img.shields.io/badge/PlatformIO-Library-orange?)](https://platformio.org/lib/show/567/WiFiManager/installation)
[![ESP8266](https://img.shields.io/badge/ESP-8266-000000.svg?longCache=true&style=flat&colorA=CC101F)](https://www.espressif.com/en/products/socs/esp8266)
[![ESP32](https://img.shields.io/badge/ESP-32-000000.svg?longCache=true&style=flat&colorA=CC101F)](https://www.espressif.com/en/products/socs/esp32)
[![ESP32](https://img.shields.io/badge/ESP-32S2-000000.svg?longCache=true&style=flat&colorA=CC101F)](https://www.espressif.com/en/products/socs/esp32-s2)
[![ESP32](https://img.shields.io/badge/ESP-32C3-000000.svg?longCache=true&style=flat&colorA=CC101F)](https://www.espressif.com/en/products/socs/esp32-c3)
Member to Member Support / Chat
[![Join the chat at https://gitter.im/tablatronix/WiFiManager](https://badges.gitter.im/tablatronix/WiFiManager.svg)](https://gitter.im/tablatronix/WiFiManager?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
[![Discord](https://img.shields.io/badge/Discord-WiFiManager-%237289da.svg?logo=discord)](https://discord.gg/dkjJbHwC)
The configuration portal is of the captive variety, so on various devices it will present the configuration dialogue as soon as you connect to the created access point.
**This works with the ESP8266 Arduino platform**
[https://github.com/esp8266/Arduino](https://github.com/esp8266/Arduino)
**This works with the ESP32 Arduino platform**
[https://github.com/espressif/arduino-esp32](https://github.com/espressif/arduino-esp32)
### Known Issues
* Documentation needs to be updated, see [https://github.com/tzapu/WiFiManager/issues/500](https://github.com/tzapu/WiFiManager/issues/500)
-------
## Contents
- [How it works](#how-it-works)
- [Wishlist](#wishlist)
- [Quick start](#quick-start)
- Installing
- [Arduino - Through Library Manager](#install-through-library-manager)
- [Arduino - From Github](#checkout-from-github)
- [PlatformIO](#install-using-platformio)
- [Using](#using)
- [Documentation](#documentation)
- [Access Point Password](#password-protect-the-configuration-access-point)
- [Callbacks](#callbacks)
- [Configuration Portal Timeout](#configuration-portal-timeout)
- [On Demand Configuration](#on-demand-configuration-portal)
- [Custom Parameters](#custom-parameters)
- [Custom IP Configuration](#custom-ip-configuration)
- [Filter Low Quality Networks](#filter-networks)
- [Debug Output](#debug)
- [Troubleshooting](#troubleshooting)
- [Releases](#releases)
- [Contributors](#contributions-and-thanks)
## How It Works
- When your ESP starts up, it sets it up in Station mode and tries to connect to a previously saved Access Point
- if this is unsuccessful (or no previous network saved) it moves the ESP into Access Point mode and spins up a DNS and WebServer (default ip 192.168.4.1)
- using any wifi enabled device with a browser (computer, phone, tablet) connect to the newly created Access Point
- because of the Captive Portal and the DNS server you will either get a 'Join to network' type of popup or get any domain you try to access redirected to the configuration portal
- choose one of the access points scanned, enter password, click save
- ESP will try to connect. If successful, it relinquishes control back to your app. If not, reconnect to AP and reconfigure.
- There are options to change this behavior or manually start the configportal and webportal independantly as well as run them in non blocking mode.
## How It Looks
![ESP8266 WiFi Captive Portal Homepage](http://i.imgur.com/YPvW9eql.png) ![ESP8266 WiFi Captive Portal Configuration](http://i.imgur.com/oicWJ4gl.png)
## Wishlist
- [x] remove dependency on EEPROM library
- [x] move HTML Strings to PROGMEM
- [x] cleanup and streamline code (although this is ongoing)
- [x] if timeout is set, extend it when a page is fetched in AP mode
- [x] add ability to configure more parameters than ssid/password
- [x] maybe allow setting ip of ESP after reboot
- [x] add to Arduino Library Manager
- [x] add to PlatformIO
- [ ] add multiple sets of network credentials
- [x] allow users to customize CSS
- [ ] rewrite documentation for simplicity, based on scenarios/goals
### Development
- [x] ESP32 support
- [x] rely on the SDK's built in auto connect more than forcing a connect
- [x] add non blocking mode
- [x] easy customization of strings
- [x] hostname support
- [x] fix various bugs and workarounds for esp SDK issues
- [x] additional info page items
- [x] last status display / faiilure reason
- [x] customizeable menu
- [x] seperate custom params page
- [x] ondemand webportal
- [x] complete refactor of code to segment functions
- [x] wiif scan icons or percentage display
- [x] invert class for dark mode
- [x] more template tokens
- [x] progmem for all strings
- [ ] new callbacks
- [ ] new callouts / filters
- [ ] shared web server instance
- [x] latest esp idf/sdk support
- [x] wm is now non persistent, will not erase or change stored esp config on esp8266
- [x] tons of debugging output / levels
- [ ] disable captiveportal
- [ ] preload wiifscans, faster page loads
- [ ] softap stability fixes when sta is not connected
## Quick Start
### Installing
You can either install through the Arduino Library Manager or checkout the latest changes or a release from github
#### Install through Library Manager
__Currently version 0.8+ works with release 2.4.0 or newer of the [ESP8266 core for Arduino](https://github.com/esp8266/Arduino)__
- in Arduino IDE got to Sketch/Include Library/Manage Libraries
![Manage Libraries](http://i.imgur.com/9BkEBkR.png)
- search for WiFiManager
![WiFiManager package](http://i.imgur.com/18yIai8.png)
- click Install and start [using it](#using)
#### Checkout from github
__Github version works with release 2.4.0 or newer of the [ESP8266 core for Arduino](https://github.com/esp8266/Arduino)__
- Checkout library to your Arduino libraries folder
### Using
- Include in your sketch
```cpp
#include <WiFiManager.h> //https://github.com/tzapu/WiFiManager WiFi Configuration Magic
```
- Initialize library, in your setup function add, NOTEif you are using non blocking you will make sure you create this in global scope or handle appropriatly , it will not work if in setup and using non blocking mode.
```cpp
WiFiManager wifiManager;
```
- Also in the setup function add
```cpp
//first parameter is name of access point, second is the password
wifiManager.autoConnect("AP-NAME", "AP-PASSWORD");
```
if you just want an unsecured access point
```cpp
wifiManager.autoConnect("AP-NAME");
```
or if you want to use and auto generated name from 'ESP' and the esp's Chip ID use
```cpp
wifiManager.autoConnect();
```
After you write your sketch and start the ESP, it will try to connect to WiFi. If it fails it starts in Access Point mode.
While in AP mode, connect to it then open a browser to the gateway IP, default 192.168.4.1, configure wifi, save and it should reboot and connect.
Also see [examples](https://github.com/tzapu/WiFiManager/tree/master/examples).
#### Install Using PlatformIO
[PlatformIO](https://platformio.org/) is an emerging ecosys
没有合适的资源?快使用搜索试试~ 我知道了~
基于ESP8266实现的空调助手物联网设备.zip
共1057个文件
cpp:373个
h:201个
hpp:139个
1.该资源内容由用户上传,如若侵权请联系客服进行举报
2.虚拟产品一经售出概不退款(资源遇到问题,请及时私信上传者)
2.虚拟产品一经售出概不退款(资源遇到问题,请及时私信上传者)
版权申诉
0 下载量 135 浏览量
2022-12-01
11:47:16
上传
评论
收藏 2.58MB ZIP 举报
温馨提示
基于ESP8266实现的空调助手物联网设备.zip
资源推荐
资源详情
资源评论
收起资源包目录
基于ESP8266实现的空调助手物联网设备.zip (1057个子文件)
array16 15B
array32 15B
ge_operations.c 348KB
sha256.c 114KB
integer.c 109KB
sha512.c 103KB
cJSON.c 73KB
http_parser.c 70KB
poly1305.c 56KB
random.c 46KB
fe_operations.c 38KB
chacha.c 36KB
hmac.c 27KB
srp.c 21KB
accessories.c 19KB
sha.c 18KB
ed25519.c 15KB
hash.c 14KB
crypto.c 14KB
ge_low_mem.c 13KB
storage.c 13KB
curve25519.c 13KB
fe_low_mem.c 11KB
error.c 11KB
json.c 9KB
chacha20_poly1305.c 8KB
misc.c 7KB
wolfmath.c 6KB
my_accessory.c 5KB
tlv.c 5KB
cQueue.c 5KB
simple_led_accessory.c 4KB
accessory.c 3KB
my_accessory.c 3KB
port.c 3KB
simplest_led_accessory.c 3KB
types.c 3KB
base64.c 2KB
my_accessory.c 2KB
my_accessory.c 2KB
my_accessory.c 2KB
my_accessory.c 2KB
query_params.c 1KB
watchdog.c 1KB
homekit_debug.c 1KB
CPPLINT.cfg 92B
.clang-format 313B
.clang-format 40B
.clang-tidy 62B
CompileOptions.cmake 2KB
IRac.cpp 170KB
ir_Daikin.cpp 146KB
ir_Daikin_test.cpp 145KB
IRac_test.cpp 132KB
WiFiManager.cpp 114KB
ir_Hitachi_test.cpp 113KB
arduino_homekit_server.cpp 108KB
ir_Samsung_test.cpp 86KB
IRrecv.cpp 84KB
ir_Corona_test.cpp 77KB
ir_Haier.cpp 75KB
ir_Hitachi.cpp 74KB
ir_Haier_test.cpp 74KB
ir_Mitsubishi_test.cpp 74KB
ir_Mitsubishi.cpp 69KB
IRrecv_test.cpp 68KB
ir_Panasonic_test.cpp 65KB
ir_Fujitsu_test.cpp 62KB
ir_Midea_test.cpp 58KB
ir_Panasonic.cpp 54KB
IRutils.cpp 51KB
ir_Sharp_test.cpp 44KB
IRsend.cpp 42KB
ir_Coolix_test.cpp 41KB
ir_MitsubishiHeavy.cpp 41KB
ir_Sanyo.cpp 41KB
ir_LG_test.cpp 40KB
filter.cpp 40KB
ir_Samsung.cpp 39KB
ir_Fujitsu.cpp 38KB
ir_Sharp.cpp 37KB
ir_Toshiba_test.cpp 37KB
ir_RC5_RC6_test.cpp 33KB
ir_Sanyo_test.cpp 33KB
ir_LG.cpp 33KB
ir_Midea.cpp 32KB
IRutils_test.cpp 30KB
ir_Mirage.cpp 30KB
ir_MitsubishiHeavy_test.cpp 29KB
IRsend_test.cpp 29KB
ir_Gree.cpp 28KB
IRtext.cpp 27KB
ir_Carrier_test.cpp 27KB
ir_Tcl_test.cpp 27KB
ir_Gree_test.cpp 26KB
ir_Coolix.cpp 26KB
ir_Carrier.cpp 25KB
ir_Sony_test.cpp 25KB
ir_Whirlpool_test.cpp 24KB
ESP8266WiFiGeneric.cpp 24KB
共 1057 条
- 1
- 2
- 3
- 4
- 5
- 6
- 11
资源评论
Java程序员-张凯
- 粉丝: 1w+
- 资源: 6654
上传资源 快速赚钱
- 我的内容管理 展开
- 我的资源 快来上传第一个资源
- 我的收益 登录查看自己的收益
- 我的积分 登录查看自己的积分
- 我的C币 登录后查看C币余额
- 我的收藏
- 我的下载
- 下载帮助
安全验证
文档复制为VIP权益,开通VIP直接复制
信息提交成功