From 1098b99301474b1e9aa79d3318982963ff215350 Mon Sep 17 00:00:00 2001 From: Rick Watson Date: Sat, 1 Jun 2019 19:27:08 +0100 Subject: [PATCH] WIP readme --- README.md | 144 +++++++++++++++++++++++++++-------------------- media/upload.png | Bin 0 -> 12477 bytes 2 files changed, 84 insertions(+), 60 deletions(-) create mode 100644 media/upload.png diff --git a/README.md b/README.md index 83eec5d..ade2cef 100644 --- a/README.md +++ b/README.md @@ -30,28 +30,44 @@ You will need the following before you can get started. * [Node.js](https://nodejs.org) - For building the interface with npm * Bash shell, or [Git Bash](https://gitforwindows.org/) if you are under windows -### Building in PlatformIO +### Building and uploading the firmware Pull the project and open it in PlatformIO. PlatformIO should download the ESP8266 platform and the project library dependencies automatically. -The project directory structure is as follows: +The project structure is as follows: -Directory | Description +Resource | Description ---- | ----------- [data/](data) | The file system image directory [interface/](interface) | React based front end [src/](src) | C++ back end for the ESP8266 device [platformio.ini](platformio.ini) | PlatformIO project configuration file +#### Building the firmware + Once the platform and libraries are downloaded the back end should be compiling. > **WINDOWS BUILDS**: If building under Windows you need to delete .piolibdeps/Time/Time.h - due to a [file system case insensitivity issue](https://github.com/me-no-dev/ESPAsyncWebServer/issues/96) +#### Uploading the firmware + +Standard configuration settings, such as build flags, libraries and device configuration can be found in ['platformio.ini'](platformio.ini). The project is configured to upload via serial by default, you can change the upload mechanism to OTA by uncommenting the relevant lines. + +See the [PlatformIO docs](http://docs.platformio.org/en/latest/projectconf.html) for full details on what you can do with this. + +Click the upload button in PlatformIO, or type the upload command if prefer the command line approach: + +```bash +platformio run -t upload +``` + +![upload](/media/upload.png?raw=true "upload") + ### Building the interface -The interface has been configured with create-react-app and react-app-rewired so the build can customized for the target device. The large artefacts are gzipped and source maps and service worker are excluded from the production build. +The interface has been configured with create-react-app and react-app-rewired so the build can customized for the target device. The large artefacts are gzipped and source maps and service worker are excluded from the production build. This reduces the production build to around ~200k, which easily fits on the device. -Change to this directory with your bash shell (or Git Bash) and use the standard commands you would with any react app built with create-react-app: +Change to the ['interface'](interface) directory with your bash shell (or Git Bash) and use the standard commands you would with any react app built with create-react-app: #### Change to interface directory @@ -73,9 +89,9 @@ npm run build > **Note**: The build command will also delete the previously built interface, in the ['data/www'](data/www) directory, replacing it with the freshly built one ready to upload to the device. -#### Running the interface locally +### Running the interface locally -You can run a local development server during development to preview changes to the front end them without uploading a file system image to the device. +You can run a local development server during development to preview changes to the front end them without the need to upload a file system image to the device after each change. ```bash npm start @@ -83,13 +99,67 @@ npm start > **Note**: To run the interface locally you will need to modify the endpoint root path and enable CORS. -The endpoint root path can be found in .env.development, defined as the environment variable 'REACT_APP_ENDPOINT_ROOT'. This needs to be the root URL of the device running the back end, for example: +#### Changing the endpoint root + +The endpoint root path can be found in ['interface/.env.development'](interface/.env.development), defined as the environment variable 'REACT_APP_ENDPOINT_ROOT'. This needs to be the root URL of the device running the back end, for example: ```js REACT_APP_ENDPOINT_ROOT=http://192.168.0.6/rest/ ``` -CORS can be enabled on the back end by uncommenting the -D ENABLE_CORS build flag in platformio.ini and re-deploying. +#### Enabling CORS + +You can enable CORS on the back end by uncommenting the -D ENABLE_CORS build flag in ['platformio.ini'](platformio.ini) then re-building and uploading the firmware to the device. The default settings assume you will be accessing the development server on the default port on [http://localhost:3000](http://localhost:3000) this can also be changed if required: + +``` +-D ENABLE_CORS +-D CORS_ORIGIN=\"http://localhost:3000\" +``` + +## Device Configuration + +As well as containing the interface, the SPIFFS image (in the ['data'](data) folder) contains a JSON settings file for each of the configurable features. The config files can be found in the ['data/config'](data/config) directory: + +File | Description +---- | ----------- +[apSettings.json](data/config/apSettings.json) | Access point settings +[ntpSettings.json](data/config/ntpSettings.json) | NTP synchronization settings +[otaSettings.json](data/config/otaSettings.json) | OTA update configuration +[securitySettings.json](data/config/securitySettings.json) | Security settings and user credentials +[wifiSettings.json](data/config/wifiSettings.json) | WiFi connection settings + +The default settings configure the device to bring up an access point on start up which can be used to configure the device: + +* SSID: ESP8266-React +* Password: esp-react + +### Building for different devices + +This project supports ESP8266 and ESP32 platforms. To support OTA programming, enough free space to upload the new sketch and file system image will be required. It is recommended that a board with at least 2mb of flash is used. + +By default, the target device is "esp12e". This is a common ESP8266 variant with 4mb of flash: + +![ESP12E](/media/esp12e.jpg?raw=true "ESP12E") + +The settings file ['platformio.ini'](platformio.ini) configures the platform and board: + +``` +[env:esp12e] +platform = espressif8266 +board = esp12e +``` + +If you want to build for an ESP32 device, all you need to do is re-configure ['platformio.ini'](platformio.ini) with your devices settings. + +![ESP32](/media/esp32.jpg?raw=true "ESP32") + +Building for the common esp32 "node32s" board for example requires the following configuration: + +``` +[env:node32s] +platform = espressif32 +board = node32s +``` ## Customizing and theming @@ -97,7 +167,7 @@ The framework, and MaterialUI allows for a good degree of custoimzation with lit ### Theming the app -The app can be easily themed by editing the [MaterialUI theme](https://material-ui.com/customization/themes/). Edit the theme in ./interface/src/App.js as you desire: +The app can be easily themed by editing the [MaterialUI theme](https://material-ui.com/customization/themes/). Edit the theme in ['interface/src/App.js'](interface/src/App.js) as you desire: ```js const theme = createMuiTheme({ @@ -114,18 +184,18 @@ const theme = createMuiTheme({ ### Changing the app icon -You can replace the app icon is located at [./interface/public/app/icon.png](interface/public/app/icon.png) with one of your preference. A 256 x 256 PNG is recommended for best compatibility. +You can replace the app icon is located at ['interface/public/app/icon.png'](interface/public/app/icon.png) with one of your preference. A 256 x 256 PNG is recommended for best compatibility. ### Changing the app name -The app name displayed on the login page and on the menu bar can be modified by editing the REACT_APP_NAME property in [./interface/.env](interface/.env) +The app name displayed on the login page and on the menu bar can be modified by editing the REACT_APP_NAME property in ['interface/.env'](interface/.env) ```js REACT_APP_NAME=Funky IoT Project ``` -There is also a manifest file which contains the app name to use when adding the app to a mobile device, so you may wish to also edit [./interface/public/app/manifest.json](interface/public/app/manifest.json): +There is also a manifest file which contains the app name to use when adding the app to a mobile device, so you may wish to also edit ['interface/public/app/manifest.json'](interface/public/app/manifest.json): ```json { @@ -142,55 +212,9 @@ There is also a manifest file which contains the app name to use when adding the } ``` -## Building for different devices -This project supports ESP8266 and ESP32 platforms. To support OTA programming, enough free space to upload the new sketch and file system image will be required. It is recommended that a board with at least 2mb of flash is used. -By default, the target device is "esp12e". This is a common ESP8266 variant with 4mb of flash: - -![ESP12E](/media/esp12e.jpg?raw=true "ESP12E") - -The settings file platformio.ini configures the platform and board: - -``` -[env:esp12e] -platform = espressif8266 -board = esp12e -``` - -If you want to build for an ESP32 device, all you need to do is re-configure playformio.ini with your devices settings. - -![ESP32](/media/esp32.jpg?raw=true "ESP32") - -Building for the common esp32 "node32s" board for example requires the following configuration: - -``` -[env:node32s] -platform = espressif32 -board = node32s -``` - -## 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. - -***** TODO ****** -The project is configured to upload via serial by default, you can change the upload mechanism to OTA by uncommenting the relevant lines. - -As well as containing the interface, the SPIFFS image (in the ./data folder) contains a JSON settings file for each of the configurable features. The config files can be found in the ./data/config directory: - -File | Description ----- | ----------- -apSettings.json | Access point settings -ntpSettings.json | NTP synchronization settings -otaSettings.json | OTA update configuration -securitySettings.json | Security settings and user credentials -wifiSettings.json | WiFi connection settings - -The default settings configure the device to bring up an access point on start up which can be used to configure the device: - -* SSID: ESP8266-React -* Password: esp-react +******* ## Software Overview diff --git a/media/upload.png b/media/upload.png new file mode 100644 index 0000000000000000000000000000000000000000..64d1448ebbeb9a62d75ea4efb50d4c2d890688ce GIT binary patch literal 12477 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 XcxRSt^-W(6^G97RqX&rl&N2TB58<*j literal 0 HcmV?d00001