Docs update
@ -29,14 +29,9 @@ In the platformio config there are 3 targets defined
|
|||||||
|
|
||||||
* gravity-debug; Maximum logging for trouble shooting, deep sleep is disabled.
|
* gravity-debug; Maximum logging for trouble shooting, deep sleep is disabled.
|
||||||
* gravity-release; Standard release
|
* gravity-release; Standard release
|
||||||
* gravity-perf; Standard release but contains code for measuring performance.
|
* gravity32-release: Version for ESP32 mini.
|
||||||
* gravity32-release: Version for ESP32.
|
* gravity32-c3-release: Version for ESP32 C3 mini.
|
||||||
* gravity32-perf: Version for ESP32 but contains code for measuring performance.
|
* gravity32-s2-release: Version for ESP32 S2 mini.
|
||||||
|
|
||||||
.. note::
|
|
||||||
There is an experimental ESP32 target but since platformio only supports SDK 1.0.6 and the WIFI connection is really slow compared to ESP8266,
|
|
||||||
so the recommendation is to wait for support on 2.0.x branch. With the tested version an wifi connection takes 3-8s on a ESP32 compared
|
|
||||||
to 0.5s on an ESP8266. There is also a bug in OneWire connected to ESP32 that has not been fixed in the main repository yet.
|
|
||||||
|
|
||||||
.. warning::
|
.. warning::
|
||||||
The debug target can be unstable and crash the device under certain circumstanses. Excessive logging to the serial port can cause corruption and crashes.
|
The debug target can be unstable and crash the device under certain circumstanses. Excessive logging to the serial port can cause corruption and crashes.
|
||||||
|
@ -3,36 +3,64 @@
|
|||||||
Hardware
|
Hardware
|
||||||
########
|
########
|
||||||
|
|
||||||
There are lots of resouces out there on how to build the hardware for an iSpindle so I will not go into details on that part. Here are two of my builds using the iSpindle PCB v4.
|
iSpindle based on esp8266
|
||||||
|
=========================
|
||||||
|
|
||||||
.. image:: images/ispindel.jpg
|
There are lots of resouces out there on how to build the hardware for an iSpindle so I will not go into details on that part. I typically use one of the
|
||||||
|
excellent pcb boards that, for example the iSpindel PCB v4.0 from Cherry Philip. Here is one of my standard builds using an esp8266.
|
||||||
|
|
||||||
|
.. image:: images/ispindel_esp8266.jpg
|
||||||
:width: 500
|
:width: 500
|
||||||
:alt: Builds of iSpindel
|
:alt: iSpindle esp8266
|
||||||
|
|
||||||
It's possible to use this PCB and mount an ESP32 on top of that. It must be an pin compatible ESP32 and the one I used was called *ESP32 d1 mini*. Since this is the same width as the PCB you need to
|
|
||||||
mount it really close to the PCB in order for it to fit in the PET tube/container. I also had to smooth the edge of the ESP32 in order for it to fit.
|
|
||||||
|
|
||||||
I would suggest that you try how it fits into the PET tube before soldering it to the PCB. Make sure that the battery is attached since this will be a really tight fit.
|
|
||||||
|
|
||||||
You also need to desolder (remove) the RED ON LED from the ESP32 or the battery power will be reduced a lot.
|
|
||||||
|
|
||||||
Final thing is to add a resistor between A0 (Analog PIN) and ground of 470k. The reason is that the esp8266 has a build in resistor which
|
|
||||||
the esp32 does not have. So in order to get a valid voltage (less than 3.2V) on the A0 pin this is needed. Once the modification is done you might
|
|
||||||
need to adjust the voltage factor so the battery reading is correct.
|
|
||||||
|
|
||||||
.. image:: images/esp32.jpg
|
|
||||||
:width: 500
|
|
||||||
:alt: Mounting esp32
|
|
||||||
|
|
||||||
Schema for esp8266 build
|
Schema for esp8266 build
|
||||||
------------------------
|
++++++++++++++++++++++++
|
||||||
|
|
||||||
.. image:: images/schema_esp8266.png
|
.. image:: images/schema_esp8266.png
|
||||||
:width: 700
|
:width: 700
|
||||||
:alt: Schema esp8266
|
:alt: Schema esp8266
|
||||||
|
|
||||||
|
iSpindle based on esp32
|
||||||
|
=======================
|
||||||
|
|
||||||
|
I've experimented with porting my software version to esp32 and this is a selection of options i have been testing.
|
||||||
|
|
||||||
|
.. image:: images/esp32_hardware.jpg
|
||||||
|
:width: 500
|
||||||
|
:alt: iSpindle esp32 hardware options
|
||||||
|
|
||||||
|
* esp32 mini, this was the first board i tried which is a smaller form factor of the first generetion esp32 with 2 cores. Slow on connecting to wifi is the main downside.
|
||||||
|
* esp32c3 mini, a newer version based on the latest risc v7 architecture, is seen as the replacement for the esp8266 with bluetooth support.
|
||||||
|
* esp32s2 mini, similar to the c3 board but without bluetooth support.
|
||||||
|
|
||||||
|
It's possible to use this PCB and mount an ESP32 mini on top of that (c3 and s2 are prefeered). The esp32 mini is a larger formfactor and can be hard to fit into the tube.
|
||||||
|
|
||||||
|
.. note::
|
||||||
|
You need to add a resistor between A0 (Analog PIN) and ground of 470k. The reason is that the esp8266 has a build in resistor for a voltage divider
|
||||||
|
which the esp32 does not have. So in order to get a valid voltage (less than 3.2V) on the A0 pin this is needed. Once the modification is done you might
|
||||||
|
need to adjust the voltage factor so the battery reading is correct.
|
||||||
|
|
||||||
|
ESP32c3 mini
|
||||||
|
++++++++++++
|
||||||
|
|
||||||
|
Work in progress...
|
||||||
|
|
||||||
|
ESP32s2 mini
|
||||||
|
++++++++++++
|
||||||
|
|
||||||
|
Work in progress...
|
||||||
|
|
||||||
|
ESP32 mini
|
||||||
|
++++++++++
|
||||||
|
|
||||||
|
I would suggest that you try how it fits into the PET tube before soldering it to the PCB. Make sure that the battery is attached since this will be a really tight fit.
|
||||||
|
|
||||||
|
.. image:: images/ispindel_esp32.jpg
|
||||||
|
:width: 500
|
||||||
|
:alt: Esp32 mini build
|
||||||
|
|
||||||
Schema for esp32 build
|
Schema for esp32 build
|
||||||
----------------------
|
++++++++++++++++++++++
|
||||||
|
|
||||||
.. note::
|
.. note::
|
||||||
This schema assumes that an ESP32 D1 Mini (pin compatible with ESP8266 D1 Mini is used)
|
This schema assumes that an ESP32 D1 Mini (pin compatible with ESP8266 D1 Mini is used)
|
||||||
@ -44,8 +72,8 @@ Schema for esp32 build
|
|||||||
:width: 700
|
:width: 700
|
||||||
:alt: Schema esp32
|
:alt: Schema esp32
|
||||||
|
|
||||||
Modifying with reed switch
|
Adding a reed (magnetic) reset switch
|
||||||
--------------------------
|
=====================================
|
||||||
|
|
||||||
A reed switch is a switch that reacts to magnetic fields. The ones I have tested are normally open and close in proximity to
|
A reed switch is a switch that reacts to magnetic fields. The ones I have tested are normally open and close in proximity to
|
||||||
a magnet.
|
a magnet.
|
||||||
|
BIN
src_docs/source/images/esp32_hardware.jpg
Normal file
After Width: | Height: | Size: 2.0 MiB |
BIN
src_docs/source/images/esp32_mini.jpg
Normal file
After Width: | Height: | Size: 898 KiB |
BIN
src_docs/source/images/esp32c3_mini.jpg
Normal file
After Width: | Height: | Size: 661 KiB |
BIN
src_docs/source/images/esp32s2_mini.jpg
Normal file
After Width: | Height: | Size: 596 KiB |
BIN
src_docs/source/images/esp8266.jpg
Normal file
After Width: | Height: | Size: 609 KiB |
Before Width: | Height: | Size: 2.5 MiB |
BIN
src_docs/source/images/ispindel_esp32.jpg
Normal file
After Width: | Height: | Size: 1.0 MiB |
BIN
src_docs/source/images/ispindel_esp8266.jpg
Normal file
After Width: | Height: | Size: 1.2 MiB |
BIN
src_docs/source/images/ispindel_pcb4.jpg
Normal file
After Width: | Height: | Size: 1.3 MiB |
@ -3,6 +3,17 @@
|
|||||||
Releases
|
Releases
|
||||||
########
|
########
|
||||||
|
|
||||||
|
v1.2.0 - beta1
|
||||||
|
==============
|
||||||
|
|
||||||
|
Features
|
||||||
|
++++++++
|
||||||
|
* Added support for the ESP32 C3 mini board
|
||||||
|
|
||||||
|
Issues adressed
|
||||||
|
++++++++++++++++
|
||||||
|
* BUG: The first portion of a format template was lost when doing conversion.
|
||||||
|
|
||||||
v1.1.0
|
v1.1.0
|
||||||
======
|
======
|
||||||
|
|
||||||
|