2019-04-25 17:12:58 +02:00

34 lines
1.5 KiB
Markdown

# Usage of the esp8266boilerplate project in your own Arduino ESP8266 projects
Wolfgang Hottgenroth <woho@hottis.de>
* Create an Arduino ESP8266 project in Sloeber
* Add esp8266boilerplate as submodule to your project:
```
git submodule init
git submodule add git@gitlab.com:wolutator/esp8266boilerplate.git
```
* Copy `ConfigGenerator/ConfigDataStructure.py-example` into your project directory,
rename it to `ConfigDataStructure.py`
* Edit `ConfigDataStructure.py` according to your requirements
* Change into directory ConfigGenerator and run `configGen.sh`,
it generates the configuration code for your projects into your
project directory (files `configuration.cpp` and `configuration.h`, do not edit
these files)
* Copy `defines.h-example` into your project directory, rename it to `defines.h` and edit it
according to your requirements
* In to main cpp file of your project you have the functions `setup()` and `loop()`.
Edit this file and call `mainSetup()` from the `setup()` function and `mainLoop()` from
the `loop()` function. Do not change anything else in this file.
* Add the directory `esp8266boilerplate` as an include and a source location in the
properties of your project.
* Create all the code you need for you application. Call your own main setup function
`setupApplication()` and your own main loop function `loopApplication()`. These functions
will be called via mainSetup and mainLoop when the system is running in production
(in contrast to configuration) mode.