mirror of
https://gitlab.com/wirelos/sprocket-lib.git
synced 2025-12-16 13:25:03 +01:00
more infos on lifecycle
This commit is contained in:
12
README.md
12
README.md
@@ -5,7 +5,7 @@ A lightweight Arduino framework for event driven programming.
|
|||||||
## Getting Started
|
## Getting Started
|
||||||
Install sprocket-lib on your favorite dev environment.
|
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.
|
Either by cloning this repository into the Arduino library path or by adding it as a dependency to your platformio.ini file.
|
||||||
In addition, following dependencies need to be installed as well:
|
Additionally, sprocket-lib depends on following libraries:
|
||||||
```
|
```
|
||||||
Hash
|
Hash
|
||||||
TaskScheduler
|
TaskScheduler
|
||||||
@@ -52,12 +52,20 @@ void loop()
|
|||||||
... plugin system
|
... plugin system
|
||||||
|
|
||||||
### Lifecycle
|
### 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.
|
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.
|
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.
|
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
|
### Plugins
|
||||||
To extend the functionality of a Sprocket, plugins can be hooked into the activation lifecycle.
|
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
|
# Useful commands
|
||||||
|
|||||||
Reference in New Issue
Block a user