First draft of new documentation

This commit is contained in:
Magnus Persson
2022-01-06 16:12:44 +01:00
parent 791f5fedd2
commit 0c0e9067f9
17 changed files with 588 additions and 2 deletions

32
docs/source/compiling.rst Normal file
View File

@ -0,0 +1,32 @@
Compiling the software
-----------------------
VSCODE + PlatformIO
=============================
TODO
Targets
=============================
TODO
Source structure
=============================
TODO
Options
=============================
TODO
# Compiling the software
I recommend that VSCODE with PlatformIO and Minfy extensions are used. Minify is used to reduce the size of the HTML files which are embedded into the firmware or uploaded to the file system. When using minify on a file, for example index.htm the output will be called index.min.htm. This is the file that will be used when buildning the image.
By default the html files are embedded but there are options to upload them to the file system to reduce the size of the image if the size becomes to large for OTA.
You can set the SSID and PWD as presets through platformio.ini by adding the settings to the following definitions:
```
-D USER_SSID=\""\"" // =\""myssid\""
-D USER_SSID_PWD=\""\"" // =\""mypwd\""
```
There are more options in teh platform.ini file that enable/disable additional functions for logging level, pushing performance data to InfluxDB and more. If i get the time I will add some documentation around these.