diff --git a/README.md b/README.md index c9fc5e6..072f2f8 100644 --- a/README.md +++ b/README.md @@ -21,18 +21,24 @@ Note! If Brewflasher being flagged as malware by your antivirus software, try th The main differences: --------------------- -* Modern web based user interface for configuration when connected to WIFI -* Efficient software, long lifespan (+45 days with 5min update frequencey) -* Send data to multiple endpoints (http-post, http-get, influxdb v2, mqtt) -* Instructions for service such as; Brewfather, Fermentrack, Ubidots, Home Assistant, Brewers Friend, Brewspy, Thingspeak, Blynk. -* SSL support for all remote endpoints -* ESP32 support with Bluetooth push -* Customize data format to be pushed -* Automatic temperature adjustment of gravity when enabled -* Use the temperature sensor in gyro instead of DS18B20 -* Built in function to create gravity formulas, no need for additional software, just enter tilt/gravity. -* Visual graph showing how gravity formula will be interpreted -* OTA support or firmware upload via web interface -* REST API for scripting - +* Operates in two modes gravity monitoring and configuration mode +* Gravity mode is comparable to how the iSpindle works when collectintg data +* Configuration mode has a modern HTML5 based web UI. No need to start the access point to change settings +* Offloading some of the functionallity to run in the web browser, this allows for more advanced features. +* REST API to enable scripted configuration +* Send data to multiple endpoints and services at once (2xHTTP POST, HTTP GET, MQTT, INFLUXDB2) +* Directly test all endpoints from user interface with feedback to simplify troubleshooting +* Complete format customization for all endpoints using templates (dont really need to change the software to support new services) +* Setup guides for how to send data to many popular services. Currently 10+ are documented +* Automatic temperature adjustment of gravity (just tick a checkbox) +* OTA support from webserver +* Firmware update via web interface +* Built in function to create gravity formulas, no need for additional software, just enter tilt/gravity and let GravityMon creates a formula +* Visual graph showing how formula will be interpreted based on entered values +* Using the temperature sensor in gyro instead of DS18B20 (faster) +* SSL support in all endpoints (no certificate validation due to limitations on esp8266). +* Built in performance measurements (used to optimise code) +* Storage mode when placed on cap (indefinite sleep) +* Customize various hardware parameters to opimize device functionallity. +* No code has been reused from the iSpindle project. diff --git a/src_docs/source/configuration.rst b/src_docs/source/configuration.rst index 03b41ee..2cf3666 100644 --- a/src_docs/source/configuration.rst +++ b/src_docs/source/configuration.rst @@ -37,8 +37,9 @@ connection. It will show 0 if data has not been collected yet. .. tip:: - The button `view error log` will show the last 15 errors on the device. This can be useful for checking errors without - the need to connect to the serial port or to check what errors has occured while in `gravity mode`. + The button `view error log` will show the last error messages on the device. This can be useful for checking errors without + the need to connect to the serial port or to check what errors has occured while in `gravity mode`. From v1.1 it will also detect + any abnormal restarts or crashes and record these in the logfile. Configuration @@ -215,7 +216,7 @@ build this into the gravity formula. This formula assumes that the calibration has been done at 20°C / 68°F. - Formula used in temperature correction. + Formula used in temperature correction. The calibration temperature can be changed under advanced settings. :: @@ -237,7 +238,8 @@ Factor used to calcualate the battery voltage. If you get a too low/high voltage * **Config voltage:** Defines the level of voltage when the device should enter config mode due to charging. This might vary between different battery manufacturers. -If you dont what the device to go into configuration mode when charging, set this to 6V. +If you dont what the device to go into configuration mode when charging, set this to 6V. This was added since differnt batteries have different +voltages when fully charged. * **Temperature correction:** diff --git a/src_docs/source/index.rst b/src_docs/source/index.rst index cc9aec1..b83fb15 100644 --- a/src_docs/source/index.rst +++ b/src_docs/source/index.rst @@ -9,13 +9,48 @@ Welcome to GravityMon's documentation! .. note:: This documentation reflects **v1.1 BETA 4**. Last updated 2022-08-06 -* Docs for: `v1.0 `_ -* Docs for: `v0.9 `_ +User interface overview +----------------------- + +This animation shows how the user interface is structured, it reflects an older version but the structure is the same. .. image:: images/gravitymon.gif :width: 800 :alt: User Inteface Walkthrough +.. _main_features: + +Main features +------------- + +* Operates in two modes gravity monitoring and configuration mode +* Gravity mode is comparable to how the iSpindle works when collectintg data +* Configuration mode has a modern HTML5 based web UI. No need to start the access point to change settings +* Offloading some of the functionallity to run in the web browser, this allows for more advanced features. +* REST API to enable scripted configuration +* Send data to multiple endpoints and services at once (2xHTTP POST, HTTP GET, MQTT, INFLUXDB2) +* Directly test all endpoints from user interface with feedback to simplify troubleshooting +* Complete format customization for all endpoints using templates (dont really need to change the software to support new services) +* Setup guides for how to send data to many popular services. Currently 10+ are documented +* Automatic temperature adjustment of gravity (just tick a checkbox) +* OTA support from webserver +* Firmware update via web interface +* Built in function to create gravity formulas, no need for additional software, just enter tilt/gravity and let GravityMon creates a formula +* Visual graph showing how formula will be interpreted based on entered values +* Using the temperature sensor in gyro instead of DS18B20 (faster) +* SSL support in all endpoints (no certificate validation due to limitations on esp8266). +* Built in performance measurements (used to optimise code) +* Storage mode when placed on cap (indefinite sleep) +* Customize various hardware parameters to opimize device functionallity. + +For a complete breakdown see the :ref:`functionallity` + +.. note:: + If you are missing some feature, please reach out on `Github `_ or `homebrewtalk.com `_ + +What is GravityMon? +-------------------- + GravityMon is used to measure gravity and temperature during fermentation of beer and report the progress. The graph below is an example on how the fermentation process can be tracked. The graph has been rendered using Fermentrack. @@ -46,35 +81,16 @@ The github repository can be found here; `GravityMon on Github `_ +* Docs for: `v0.9 `_ -For a complete breakdown see the :ref:`functionallity` -.. note:: - If you are missing some feature, please reach out on `Github `_ or `homebrewtalk.com `_ +Software architecture +--------------------- This is a simple overview of the different components that the software contains. The green ones are only active during `configuration mode` in order to save battery.