Personal state API

This implements the personal state API which can run independently of running apps

This fixes #77 (closed)

Documentation/bluetooth/card10.rst

@@ -30,6 +30,51 @@ The current draft uses following service specification:
   UUID: ``42230210-2342-2342-2342-234223422342``
   write
 
+- Background LED Bottom Left characteristic:
+
+  UUID: ``42230211-2342-2342-2342-234223422342``
+  write
+
+- Background LED Bottom Right characteristic:
+
+  UUID: ``42230212-2342-2342-2342-234223422342``
+  write
+
+- Background LED Top Right characteristic:
+
+  UUID: ``42230213-2342-2342-2342-234223422342``
+  write
+
+- Background LED Top Left characteristic:
+
+  UUID: ``42230214-2342-2342-2342-234223422342``
+  write
+
+- LEDS dim bottom characteristic:
+
+  UUID: ``42230215-2342-2342-2342-234223422342``
+  write
+
+- LEDs dim top characteristic:
+
+  UUID: ``42230216-2342-2342-2342-234223422342``
+  write
+
+- LEDs powersafe characteristic:
+
+  UUID: ``42230217-2342-2342-2342-234223422342``
+  write
+
+- Flashlight characteristic:
+
+  UUID: ``42230218-2342-2342-2342-234223422342``
+  write
+
+- LEDs above characteristic:
+
+  UUID: ``42230220-2342-2342-2342-234223422342``
+  write
+
 - Light sensor characteristic:
 
   UUID: ``422302f0-2342-2342-2342-234223422342``
@@ -66,6 +111,55 @@ Rocket0 Rocket1 Rocket2
 - Enable only Rocket0:  ``0xff0000``
 - Enable all rockets with 50% brightness: ``0x7f7f7f``
 
+Background LED <Position> characteristic
+---------------------------------
+
+The Background LEDs <Position> characteristic makes it possible to address the bottom LEDs by position.
+Just write there three ``uint8`` for the rgb color.
+
+Dataformat:
+
+===== ======= =======
+  0      1       2
+----- ------- -------
+ red   green   blue
+===== ======= =======
+
+- set led blue: ``0x0000ff``
+- disabled:  ``0x000000``
+
+LEDs dim <Position> characteristic
+---------------------------------
+
+The LEDs dim <Position> characteristic makes it possible to dim LEDs by position.
+Just write a ``uint8`` between ``1`` and ``8``.
+
+LEDs powersafe characteristic
+---------------------------------
+
+This characteristic makes it possible to set the LEDs in powersafe mode.
+Even when set to zero, the RGB LEDs still individually consume ~1mA.
+Powersave intelligently switches the supply power in groups.
+This introduces delays in the magnitude of ~10µs, so it can be disabled for high speed applications such as POV
+
+- enabled:   ``0x01``
+- disabled:  ``0x00``
+
+Flashlight characteristic
+---------------------------------
+
+This characteristic makes it possible to activate the flashlight.
+
+- enabled:   ``0x01``
+- disabled:  ``0x00``
+
+LEDs above characteristic
+---------------------------------
+This characteristic set every 11 leds on the top module at once.
+By defining 11x rgb from left to right. You need also to set exchange a bigger MTU to use this feature.
+
+- set a rainbow beginnig with red on the right edge: ``0xff0000ff8b00e8ff005dff0000ff2e00ffb900b9ff002eff5d00ffe800ffff008b``
+
 Light sensor characteristic
 ---------------------------------