# Sprocket-Core
A lightweight Arduino framework for event driven programming.  
  

## Getting Started
Install sprocket-lib on your favorite dev environment. 
Either by cloning this repository into the Arduino library path or by adding it as a dependency to your platformio.ini file.  
Additionally, sprocket-lib depends on following libraries:  
```
Hash
TaskScheduler
SPIFFS
ArduinoJson
```
  
Example platformio.ini:  
```
[env:build]
framework = arduino
platform = espressif8266
board = esp12e
upload_speed = 921600
monitor_baud = 115200
lib_deps = 
    Hash
    TaskScheduler
    SPIFFS
    ArduinoJson
    https://gitlab.com/wirelos/sprocket-lib.git#develop
```
   
Example main.cpp:  
```cpp
Sprocket *sprocket;

void setup()
{
    sprocket = new Sprocket({STARTUP_DELAY, SERIAL_BAUD_RATE});
    sprocket->addPlugin(new SomePlugin());
    sprocket->activate();
}

void loop()
{
    sprocket->loop();
    yield();
}
```
  
## Concepts
... topic based event channel / pubsub-pattern  
... plugin system

### Lifecycle
As the initialization order of core components is critical on embedded devices, it has been split up into different phases of a lifecycle.  
In most cases a Sprocket is bootstraped in the setup() method. Addidional plugins are hooked into the Sprocket after initialisation.
During loop, the internal Scheduler needs to be updated by calling the corresponding method.  
See the "Getting Started" section for an example of skeleton Sprocket.  
  
|Phase|Purpose|
|---|---|
|init|Setup Serial and SPIFFS|
|activation|Activate all plugins|
|loop|Update the scheduler|
  
### Plugins
To extend the functionality of a Sprocket, plugins can be hooked into the activation phase with the addPlugin method. They are activated on the order the've been added.  
The Sprocket internal scheduler is passed into the activation method of the plugin in order to add tasks.


# Useful commands
```sh
# erase flash  
esptool --port /dev/ttyUSB0 erase_flash
  
# OTA
~/.platformio/packages/tool-espotapy/espota.py -i <espIP> -p 8266 -a <authPW> -f .pioenvs/ota/firmware.bin 

```