Getting started¶
First you need a completed iSpindle hardware, there are several resources 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 Software 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 WIFI compatibility
Note
Since the user interface is built using modern frameworks the device requires access to the internet for the UI to render and data to be populated. The sites that are needed are; https://cdn.jsdelivr.net/npm/bootstrap and https://code.jquery.com
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 address.
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.
In order for the software to work properly there are a few steps that needs to be configured. When you open up the index page a selftest will be run and common issues will be shown for your action.
Configuration - Device Settings - Device Name¶
Give your device a good name.
Configuration - Device Settings - Gyro 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 degrees. 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.
Gyro 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.
There are several guides for how to calibrate the device (iSpindle Calibration)
This will get the data points needed to create the formula, and the data points will be stored on the device so you can adjust them when needed.
Warning
If this step is skipped the device will not enter sleep mode and the battery will be drained.
Calibrate device / Create gravity formula¶
In order to calculate the gravity a formula needs to be added. You can either enter the formula directly or add the measurements and let the device derive the formula for you.
Check battery voltage¶
Check the battery voltage so the value is correctly measured. If the wrong resistor values in the voltage are then the calculation is off. This could block the device from going to sleep properly.
Step 4 - Completed¶
You are now done and can enjoy the GravityMon software. Check out the Configuration 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.