Browse Source

begin updating readme

master
Rick Watson 5 years ago
parent
commit
370fef48e8
  1. 41
      README.md
  2. BIN
      screenshots/screenshots.png

41
README.md

@ -1,29 +1,24 @@
# ESP8266 React
A simple, extensible framework for getting up and running with the ESP8266/ESP32 microchip and a react front end.
A simple, extensible framework for IoT projects built on ESP8266/ESP32 platforms with responsive React front-end.
Designed to work with the PlatformIO IDE with limited setup.
Designed to work with the PlatformIO IDE with limited setup, please read below for build and flash instructions.
This project supports ESP8266 and ESP32 devices, see build instruction below for more details.
## Why I made this project
I found I was repeating a lot of work when starting new IoT projects with the ESP8266 chip.
Most of my IoT projects have required:
![Screenshots](/screenshots/screenshots.png?raw=true "Screenshots")
* Configurable WiFi
* Configurable access point
* Synchronization with NTP
* The ability to perform OTA updates
## Features
I also wanted to adopt a decent client side framework so the back end could be simplified to a set of REST endpoints.
Provides many of the features required for IoT projects:
All of the above features are included in this framework, which I plan to use as a basis for my IoT projects.
* Configurable WiFi - Network scanner and WiFi connection screen
* Configurable Access Point - Can be continuous or automatically enabled when WiFi connection fails
* Network Time - Synchronization with NTP
* Remote Firmware Updates - Enable secured OTA updates
* Security - Protected RESTful endpoints and a secured user interface
The interface is responsive and should work well on mobile devices. It also has the prerequisite manifest/icon file, so it can be added to the home screen if desired.
The back-end is provided by a set of RESTful endpoints and the React based front-end is responsive and scales well to various screen sizes.
![Screenshots](/screenshots/screenshots.png?raw=true "Screenshots")
The file system artefact has the prerequisite manifest/icon file, so it can be added to the home screen of a mobile device if required.
## Getting Started
@ -32,14 +27,14 @@ The interface is responsive and should work well on mobile devices. It also has
You will need the following before you can get started.
* [PlatformIO](https://platformio.org/) - IDE for development
* [NPM](https://www.npmjs.com/) - For building the interface
* [Node.js](https://nodejs.org) - For building the interface with npm
* Bash shell, or Git Bash if you are under windows
### Installing in PlatformIO
Pull the project and add it to PlatformIO as a project folder (File > Add Project Folder).
Pull the project and open it in PlatformIO. PlatformIO should download the ESP8266 platform and the project library dependencies automatically.
PlatformIO should download the ESP8266 platform and the project library dependencies automatically.
**NB: If building under Windows you need to delete .piolibdeps/Time/Time.h - due [filesystem case insensitivity](https://github.com/me-no-dev/ESPAsyncWebServer/issues/96)*
Once the platform and libraries are downloaded the back end should be compiling.
@ -99,12 +94,6 @@ platform = espressif32
board = node32s
```
Microcontroller ESP8266
Frequency 80MHz
Flash 4MBl
**NB: If building under Windows you need to delete .piolibdeps/Time/Time.h - due [filesystem case insensitivity](https://github.com/me-no-dev/ESPAsyncWebServer/issues/96)*
## Configuration & Deployment
Standard configuration settings, such as build flags, libraries and device configuration can be found in platformio.ini. See the [PlatformIO docs](http://docs.platformio.org/en/latest/projectconf.html) for full details on what you can do with this.

BIN
screenshots/screenshots.png

Before

Width: 856  |  Height: 523  |  Size: 45 KiB

After

Width: 856  |  Height: 1017  |  Size: 104 KiB

Loading…
Cancel
Save