Update documentation

This commit is contained in:
GitHub Action 2022-01-08 19:24:07 +00:00
parent f42513edd8
commit 9dfd5c498a
7 changed files with 54 additions and 17 deletions

BIN
docs/_images/serial.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 52 KiB

BIN
docs/_images/wifi.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 16 KiB

View File

@ -43,8 +43,6 @@ Source structure
- Directory for flashing device filesystem
* - /doc
- Various external documents used as input
* - /docs
- Folder published to github pages
* - /html
- Source for html files
* - /img

View File

@ -7,14 +7,33 @@ Official esptool
The prefered option for flashing esp8266 device is via the official esptool. Documentation can be found
here; https://docs.espressif.com/projects/esptool/en/latest/esp32/
Windows 10 should install a driver for the USB -> Serial automatically when you connect a esp8266.
Flashing on windows
*******************
The basic command for flashing on Windows is;
``esptool.py --port COM4 write_flash 0 firmware.bin``
``esptool.py --port COM4 write_flash 0x0 firmware.bin``
If there are issues you can try do erase the flash first using this command;
``esptool.py --port COM4 erase_flash``
Serial Monitoring
*******************
To check output from the device (logs) there are several tools out there. I found this simple tool in the Windows Store called ``Serial Port Monitoring``.
Just select a baud rate of 115200, 8N1.
.. image:: images/serial.png
:width: 800
:alt: Serial output
Binaries
********
In the /bin directory you will find 3 different firmware builds;
* **firmware.bin**
@ -47,3 +66,7 @@ If this is not configured in the device it will create an wirless access point c
enter the SSID and password you want to use. If the web page dont open automatically you can enter the following adress
in the browser: **http://192.168.4.1**
.. image:: images/wifi.png
:width: 200
:alt: Wifi page

View File

@ -130,31 +130,28 @@
<tr class="row-even"><td><p>/doc</p></td>
<td><p>Various external documents used as input</p></td>
</tr>
<tr class="row-odd"><td><p>/docs</p></td>
<td><p>Folder published to github pages</p></td>
</tr>
<tr class="row-even"><td><p>/html</p></td>
<tr class="row-odd"><td><p>/html</p></td>
<td><p>Source for html files</p></td>
</tr>
<tr class="row-odd"><td><p>/img</p></td>
<tr class="row-even"><td><p>/img</p></td>
<td><p>Images uses in README.md</p></td>
</tr>
<tr class="row-even"><td><p>/lib</p></td>
<tr class="row-odd"><td><p>/lib</p></td>
<td><p>External libraries used when compiling</p></td>
</tr>
<tr class="row-odd"><td><p>/script</p></td>
<tr class="row-even"><td><p>/script</p></td>
<td><p>Scripts used in build process</p></td>
</tr>
<tr class="row-even"><td><p>/src</p></td>
<tr class="row-odd"><td><p>/src</p></td>
<td><p>Source code for software</p></td>
</tr>
<tr class="row-odd"><td><p>/src_docs</p></td>
<tr class="row-even"><td><p>/src_docs</p></td>
<td><p>Source code for documentation</p></td>
</tr>
<tr class="row-even"><td><p>/stl</p></td>
<tr class="row-odd"><td><p>/stl</p></td>
<td><p>3d models</p></td>
</tr>
<tr class="row-odd"><td><p>/test</p></td>
<tr class="row-even"><td><p>/test</p></td>
<td><p>Test data for developing html files</p></td>
</tr>
</tbody>

View File

@ -40,7 +40,12 @@
<li class="toctree-l1"><a class="reference internal" href="releases.html">Releases</a></li>
<li class="toctree-l1"><a class="reference internal" href="functionallity.html">Functionallity</a></li>
<li class="toctree-l1 current"><a class="current reference internal" href="#">Installation</a><ul>
<li class="toctree-l2"><a class="reference internal" href="#official-esptool">Official esptool</a></li>
<li class="toctree-l2"><a class="reference internal" href="#official-esptool">Official esptool</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#flashing-on-windows">Flashing on windows</a></li>
<li class="toctree-l3"><a class="reference internal" href="#serial-monitoring">Serial Monitoring</a></li>
<li class="toctree-l3"><a class="reference internal" href="#binaries">Binaries</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#configuring-wifi">Configuring WIFI</a></li>
</ul>
</li>
@ -80,10 +85,22 @@
<h2>Official esptool<a class="headerlink" href="#official-esptool" title="Permalink to this headline"></a></h2>
<p>The prefered option for flashing esp8266 device is via the official esptool. Documentation can be found
here; <a class="reference external" href="https://docs.espressif.com/projects/esptool/en/latest/esp32/">https://docs.espressif.com/projects/esptool/en/latest/esp32/</a></p>
<p>Windows 10 should install a driver for the USB -&gt; Serial automatically when you connect a esp8266.</p>
<div class="section" id="flashing-on-windows">
<h3>Flashing on windows<a class="headerlink" href="#flashing-on-windows" title="Permalink to this headline"></a></h3>
<p>The basic command for flashing on Windows is;</p>
<p><code class="docutils literal notranslate"><span class="pre">esptool.py</span> <span class="pre">--port</span> <span class="pre">COM4</span> <span class="pre">write_flash</span> <span class="pre">0</span> <span class="pre">firmware.bin</span></code></p>
<p><code class="docutils literal notranslate"><span class="pre">esptool.py</span> <span class="pre">--port</span> <span class="pre">COM4</span> <span class="pre">write_flash</span> <span class="pre">0x0</span> <span class="pre">firmware.bin</span></code></p>
<p>If there are issues you can try do erase the flash first using this command;</p>
<p><code class="docutils literal notranslate"><span class="pre">esptool.py</span> <span class="pre">--port</span> <span class="pre">COM4</span> <span class="pre">erase_flash</span></code></p>
</div>
<div class="section" id="serial-monitoring">
<h3>Serial Monitoring<a class="headerlink" href="#serial-monitoring" title="Permalink to this headline"></a></h3>
<p>To check output from the device (logs) there are several tools out there. I found this simple tool in the Windows Store called <code class="docutils literal notranslate"><span class="pre">Serial</span> <span class="pre">Port</span> <span class="pre">Monitoring</span></code>.
Just select a baud rate of 115200, 8N1.</p>
<a class="reference internal image-reference" href="_images/serial.png"><img alt="Serial output" src="_images/serial.png" style="width: 800px;" /></a>
</div>
<div class="section" id="binaries">
<h3>Binaries<a class="headerlink" href="#binaries" title="Permalink to this headline"></a></h3>
<p>In the /bin directory you will find 3 different firmware builds;</p>
<ul>
<li><p><strong>firmware.bin</strong></p>
@ -102,6 +119,7 @@ the configuration file.</p>
default (see compiling for details). This approach makes installation much easier and ensure that html files
and code is in sync.</p>
</div>
</div>
<div class="section" id="configuring-wifi">
<h2>Configuring WIFI<a class="headerlink" href="#configuring-wifi" title="Permalink to this headline"></a></h2>
<p>When the device is flashed it will need to have WIFI configuration in order to work. If you have used other software on
@ -109,6 +127,7 @@ the device its possible that wifi settings exist.</p>
<p>If this is not configured in the device it will create an wirless access point called <cite>GravMon</cite>. Connect to this AP and
enter the SSID and password you want to use. If the web page dont open automatically you can enter the following adress
in the browser: <strong>http://192.168.4.1</strong></p>
<a class="reference internal image-reference" href="_images/wifi.png"><img alt="Wifi page" src="_images/wifi.png" style="width: 200px;" /></a>
</div>
</div>

File diff suppressed because one or more lines are too long