Brewery/gravitymon
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Doc updates

Browse Source
This commit is contained in:
Magnus Persson 2022-08-09 20:25:17 +02:00
parent d4c88c1200
commit 69f4b8ec3d
3 changed files with 69 additions and 45 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

34
README.md
View File

@ -21,18 +21,24 @@ Note! If Brewflasher being flagged as malware by your antivirus software, try th
The main differences: The main differences:
--------------------- ---------------------
* Modern web based user interface for configuration when connected to WIFI * Operates in two modes gravity monitoring and configuration mode
* Efficient software, long lifespan (+45 days with 5min update frequencey) * Gravity mode is comparable to how the iSpindle works when collectintg data
* Send data to multiple endpoints (http-post, http-get, influxdb v2, mqtt) * Configuration mode has a modern HTML5 based web UI. No need to start the access point to change settings
* Instructions for service such as; Brewfather, Fermentrack, Ubidots, Home Assistant, Brewers Friend, Brewspy, Thingspeak, Blynk. * Offloading some of the functionallity to run in the web browser, this allows for more advanced features.
* SSL support for all remote endpoints * REST API to enable scripted configuration
* ESP32 support with Bluetooth push * Send data to multiple endpoints and services at once (2xHTTP POST, HTTP GET, MQTT, INFLUXDB2)
* Customize data format to be pushed * Directly test all endpoints from user interface with feedback to simplify troubleshooting
* Automatic temperature adjustment of gravity when enabled * Complete format customization for all endpoints using templates (dont really need to change the software to support new services)
* Use the temperature sensor in gyro instead of DS18B20 * Setup guides for how to send data to many popular services. Currently 10+ are documented
* Built in function to create gravity formulas, no need for additional software, just enter tilt/gravity. * Automatic temperature adjustment of gravity (just tick a checkbox)
* Visual graph showing how gravity formula will be interpreted * OTA support from webserver
* OTA support or firmware upload via web interface * Firmware update via web interface
* REST API for scripting * 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. No code has been reused from the iSpindle project.

10
src_docs/source/configuration.rst
View File

@ -37,8 +37,9 @@ connection. It will show 0 if data has not been collected yet.
.. tip:: .. tip::
The button `view error log` will show the last 15 errors on the device. This can be useful for checking errors without 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`. 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 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. 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:** * **Config voltage:**
Defines the level of voltage when the device should enter config mode due to charging. This might vary between different battery manufacturers. 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:** * **Temperature correction:**

70
src_docs/source/index.rst
View File

@ -9,13 +9,48 @@ Welcome to GravityMon's documentation!
.. note:: .. note::
This documentation reflects **v1.1 BETA 4**. Last updated 2022-08-06 This documentation reflects **v1.1 BETA 4**. Last updated 2022-08-06
* Docs for: `v1.0 <https://mp-se.github.io/gravitymon/v1.0/index.html>`_ User interface overview
* Docs for: `v0.9 <https://mp-se.github.io/gravitymon/v0.9/index.html>`_ -----------------------
This animation shows how the user interface is structured, it reflects an older version but the structure is the same.
.. image:: images/gravitymon.gif .. image:: images/gravitymon.gif
:width: 800 :width: 800
:alt: User Inteface Walkthrough :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 <https://github.com/mp-se/gravitymon/discussions>`_ or `homebrewtalk.com <https://www.homebrewtalk.com/threads/replacement-firmware-for-ispindel-gravitymon.698058/>`_
What is GravityMon?
--------------------
GravityMon is used to measure gravity and temperature during fermentation of beer and report the progress. The graph below is 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. 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 <https://github.c
I have tested this software on 40+ brews with good results. I have tested this software on 40+ brews with good results.
.. _main_features:
Main features: Documentation for older versions
-------------- --------------------------------
* Operates in two modes gravity monitoring and configuration mode * Docs for: `v1.0 <https://mp-se.github.io/gravitymon/v1.0/index.html>`_
* Gravity mode is comparable to how the iSpindle works when collectintg data * Docs for: `v0.9 <https://mp-se.github.io/gravitymon/v0.9/index.html>`_
* 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:: Software architecture
If you are missing some feature, please reach out on `Github <https://github.com/mp-se/gravitymon/discussions>`_ or `homebrewtalk.com <https://www.homebrewtalk.com/threads/replacement-firmware-for-ispindel-gravitymon.698058/>`_ ---------------------
This is a simple overview of the different components that the software contains. The green ones are only active during `configuration mode` in 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. order to save battery.