Skip to content

An object-oriented implementation of the esp web tools improv serial protocol for provisioning ESP32 devices

License

Notifications You must be signed in to change notification settings

judge2005/ImprovWiFi

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Overview

This library simplies adding the improv serial protocol to your ESP32 projects. When used with esp web tools it fullfills three purposes:

  1. Returns the manifest data when asked
  2. Sets up the wifi connection
  3. Returns the application url

The design is completely non-blocking, even when 'waiting' for a wifi connection, and can be used with any WiFi stack, including WiFi managers.

For those that don't know, esp web tools allows an ESP32 device to be flashed using a web browser that supports serial port access (basically Chrome, Edge and Opera). Improv allows esp web tools to query what firmware is already flashed and to set up a WiFi connection on the device.

How to Use

  1. Declare an instance of the class, constructed with the manifest information
  2. Define a callback to connect to WiFi
  3. Optionally define a callback to display info messages
  4. Optionally define a callback to display debug messages
  5. Call the loop() method every so often. This method never blocks.

Obviously writing messages to the serial port will interefere with the improv messaging, but there are sometimes other ways to get that information in front of a person.

About

An object-oriented implementation of the esp web tools improv serial protocol for provisioning ESP32 devices

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages