Added a README with useful infos.
This commit is contained in:
parent
63bb2b43cf
commit
cc3bcb0370
41
README.md
Normal file
41
README.md
Normal file
@ -0,0 +1,41 @@
|
|||||||
|
# ESPleaf
|
||||||
|
|
||||||
|
## Layout description
|
||||||
|
|
||||||
|
Layout is defined in `LAYOUT` in `config.h`.
|
||||||
|
|
||||||
|
LEDs within a node are supposed to be installed counter-clockwise. The edge where the cables enter the node is node 0. To its right (counter-clockwise, remember) is corner 0. Then edge 1, corner 1, edge 2, corner 2 before coming back to edge 0.
|
||||||
|
|
||||||
|
Thereby, the next panel can either be installed along edge 1 or edge 2. (But the cable has to go corner 0, corner 1, corner 2 first.)
|
||||||
|
|
||||||
|
First panel is ignored in `LAYOUT`. First entry in `LAYOUT` is the edge through which the cable leaves Node 0 to Node 1 - which can be either Edge 1 or Edge 2.
|
||||||
|
|
||||||
|
On the next panel, the edge the cable is coming through is called Edge 0 again. And so on.
|
||||||
|
|
||||||
|
So, `LAYOUT` countains a list of edges the cable takes to leave to the next node.
|
||||||
|
|
||||||
|
## Commands
|
||||||
|
|
||||||
|
Command can be sent via MQTT to `MQTT_TOPIC_COMMANDS`. Syntax is `key=value` or `key=value&key2=value2...`.
|
||||||
|
|
||||||
|
Valid keys are:
|
||||||
|
* `mode` sets a new mode. Valid modes are:
|
||||||
|
* `corners`
|
||||||
|
* `nodes`
|
||||||
|
* `first_corner`
|
||||||
|
* `first_node`
|
||||||
|
* `flash`
|
||||||
|
* `static`
|
||||||
|
* `off`
|
||||||
|
* `brightness` sets the overall brightness of the lamp. Values are from 0 to 255 inclusive.
|
||||||
|
* `duration` if sets, `mode` and `brightness` are set for this amount of seconds only.
|
||||||
|
* `color` sets the color for `static` and `flash` modes. A predefined color name is expected.
|
||||||
|
* `speedup` sets a speedup for faster animations. Default value 1, possible values are 1 to 255. 0 will lead to an exception.
|
||||||
|
|
||||||
|
## Startup sequence
|
||||||
|
|
||||||
|
During startup:
|
||||||
|
* 1 green corner: FastLED is initialized. Layout is now being analyzed.
|
||||||
|
* 2 green corners: Layout is done. WiFi is being connected.
|
||||||
|
* 3 green corners: WiFi connection established. Connecting to MQTT server.
|
||||||
|
* Everything green (quarter of a second): Initialization done.
|
Loading…
Reference in New Issue
Block a user