If you like this work, please consider sponsoring this project!

esp-fs-webserver

From FSBrowser.ino example to esp-fs-webserver Arduino library

When you need a webserver running on ESP32 or ESP8266 device, FSBrowser.ino - ESP8266 or FSBrowser.ino - ESP32 are the best examples as start point because you can simply put your webserver HTML/CSS/JavaScript source files in the flash memory of device (for example with filesystem-type dedicated plugins like Arduino ESP8266 LittleFS Filesystem Uploader or Arduino ESP32 filesystem uploader) or in an external SD.

Unfortunately are a little complex examples for a novice due to a lot of handling functions "under the cover". This library makes it easier by incorporating this functions into a specific class and more, it adds some convenience functionality like WiFi / Custom Options manager.

Note: Starting from version 2.0.0 ESP32 core for Aruino introduced the LittlsFS library like ESP8266. The examples in this library is written to work with this for both platform by default. Change according to your needs if you prefer other filesystems.

WiFi, OTA firmware update and Options manager

Thanks to the built-in page /setup (about 8Kb of program space) it is possible to scan and set the WiFi credentials and other freely configurable parameters.

With /setup webpage it is also possible to perform remote firmware update (OTA-update).

This web page can be injected also with custom HTML and Javascript code in order to create very smart and powerful web application.

In the image below, for example, the HTML and Javascript code to provision the devices in the well-known ThingsBoard IoT platform has been added at runtime starting from the Arduino sketch (check example customHTML.ino).

Web server file upload

In addition to built-in firmware update functionality, you can also upload your web server content all at once (typically the files are placed inside the folder data of your sketch).

ACE web file editor/browser

Thanks to the built-in /edit page, it is possible to upload, delete and edit the HTML/CSS/JavaScript source files directly from browser and immediately display the changes introduced at runtime without having to recompile the device firmware. The page can be enabled at runtime using the method enableFsCodeEditor() and it occupies about 6.7Kb of program space.

Documentation

Json Config file

you have a json config file located at /setup/config.json, this file has some reserved configuration keys that can be used to configure how certain aspects of this library will be set.

this library uses ArduinoJson to parse json config file.

Configure WIFI connections settings

setIPaddressAP: used to set the IP of the access point which is set by default to m_captiveIp = IPAddress(192, 168, 4, 1)

check this file for more details esp-fs-webserver.h

• "dhcp": this is a bool variable that will turn on/off dhcp
• "gateway": this is a string variable to set the gateway ip address(only applicable if "dhcp" is set to true)
• "subnet": this is a string variable to set the subnet ip address(only applicable if "dhcp" is set to true)
• "ip_address": this is a string variable to set the static ip address of the esp(only applicable if "dhcp" is set to true)

example:

{
  "wifi-box": "",
  "dhcp": true,
  "gateway": "192.168.1.1",
  "ip_address": "192.168.1.212",
  "subnet": "255.255.255.0",
}

you can check and modify the configuration file on the fly using <ip-address>/edit and open setup/config.json if you enabled the editor page

for more info check FSWebServer::startWiFi() method

Custom configuration

Since this library uses ArduinoJson, you can add your own configuration setting and read them or you can use the provided library interfaces instead.

• getConfigFilepath: will return the path of the config file.
• getOptionValue(label, variable): can be used to read the label and set variable value.
• saveOptionValue(label, variable): can be used to save\create the label value to variable value.
• closeConfiguration: should be called when you're done with config file to save values and release memory.

Check this customOptions example for more details for reading and for writing