From 8e97448101132fee6edca032cd4eebb6c8902e49 Mon Sep 17 00:00:00 2001 From: GitHub Action Date: Sun, 30 Jan 2022 16:24:22 +0000 Subject: [PATCH] Update documentation --- docs/_sources/index.rst.txt | 3 +- docs/_sources/installation.rst.txt | 4 + docs/_sources/intro.rst.txt | 69 ++++++ docs/advanced.html | 3 +- docs/api.html | 3 +- docs/compiling.html | 3 +- docs/configuration.html | 9 +- docs/contributing.html | 3 +- docs/data.html | 3 +- docs/formula.html | 3 +- docs/functionallity.html | 13 +- docs/genindex.html | 3 +- docs/index.html | 26 ++- docs/installation.html | 17 +- docs/intro.html | 327 +++++++++++++++++++++++++++++ docs/license.html | 9 +- docs/objects.inv | Bin 653 -> 718 bytes docs/q_and_a.html | 3 +- docs/releases.html | 13 +- docs/search.html | 3 +- docs/searchindex.js | 2 +- docs/services.html | 3 +- 22 files changed, 473 insertions(+), 49 deletions(-) create mode 100644 docs/_sources/intro.rst.txt create mode 100644 docs/intro.html diff --git a/docs/_sources/index.rst.txt b/docs/_sources/index.rst.txt index eff9733..2313942 100644 --- a/docs/_sources/index.rst.txt +++ b/docs/_sources/index.rst.txt @@ -121,9 +121,10 @@ the following libraries and without these this would have been much more difficu :caption: Contents: license - releases functionallity + intro installation + releases configuration formula services diff --git a/docs/_sources/installation.rst.txt b/docs/_sources/installation.rst.txt index eb6bfda..fbd9a6a 100644 --- a/docs/_sources/installation.rst.txt +++ b/docs/_sources/installation.rst.txt @@ -1,3 +1,5 @@ +.. _installation: + Installation ------------ @@ -57,6 +59,8 @@ Just select a baud rate of 115200, 8N1. :width: 800 :alt: Serial output +.. _setup_wifi: + Configuring WIFI ================ diff --git a/docs/_sources/intro.rst.txt b/docs/_sources/intro.rst.txt new file mode 100644 index 0000000..56c4be1 --- /dev/null +++ b/docs/_sources/intro.rst.txt @@ -0,0 +1,69 @@ +.. _getting_started: + +Getting started +=============== + +First you need a completed iSpindle hardware, there are several resouces around that topic so it +will not be covered in this documentation. Please visit `iSpindel Homepage `_ for +more information. + +Step 1 - Flash the device +------------------------- + +The first step is to flash the firmware, I recommend using Brewflasher as the easy option. Detailed +instructions can be found here :ref:`installation` + +Step 2 - Setup WIFI +------------------- + +When the device starts up the first time it will first start an WIFI access point so that the WIFI Settings +can be configured. The instructions for that can be found here :ref:`_setup_wifi` + +Step 3 - Configuration +---------------------- + +Once the device can connect to WIFI it will go into `configuration mode` and start a web server for +doing the initial configuration. In order to access the device you will need to find its name or ip adress. + +It will broadcast a name like gravitymonXXXXXX.local over mDNS. Where the XXXXXX is the unique device id. You can +find the name via an mDNS browser, check your router or connect the device to a serial monitor. On windows mDNS +might not work so then use the IP address instead. Once connected you will meet a web interface that looks like this. + +.. image:: images/index.png + :width: 800 + :alt: Index page + +The next step is then to configure the device, most settings should work but there are a few that should be changed. + +Configuration - Device Settings - Device Name ++++++++++++++++++++++++++++++++++++++++++++++ + +Give your device a good name. + +Configuration - Device Settings - Calibration ++++++++++++++++++++++++++++++++++++++++++++++ + +You need to place the device on a flat surface and then press the +calibrate button. It will take a few seconds for this to complete and the angle should be close to 90 degress. Without +calibration the device will not go into gravity mode. + +Configuration - Push Settings ++++++++++++++++++++++++++++++ +Add the endpoints where you want data to be transmitted. All URLs that contain a +valid endpoint will receive the data. + +Calibration ++++++++++++ + +I recommend to use the calibration feature to create a gravity formula. If you have values from a +previous calibration then you can add them here, if not follow the calibration guidelines on the iSpindle site. + +Step 4 - Completed +------------------ + +You are now done and can enjoy the GravityMon software. Check out the :ref:`setting-up-device` section for other configuration options. + +If you want to enter the configuration mode place the device flat on a surface and do a reset (or wait until it wakes up). +Its recommended to attach the device to power when you have it in `configuration mode` so the battery is not drained. + +**If you have suggestions for more awesome features, head over to the github repository and make a request.** diff --git a/docs/advanced.html b/docs/advanced.html index 022a4e7..303c07a 100644 --- a/docs/advanced.html +++ b/docs/advanced.html @@ -156,9 +156,10 @@

Contents: