summaryrefslogtreecommitdiff
path: root/README
blob: 391d04bc11b0b8499499756e87e2ca638f621f67 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
A compiler for the Speevers Click'n'Play light ball system.

A Click'n'Play ball has a micro-USB port in its side. This port is used
for charging. If you connect it to a computer with a data cable it
exposes a device with a single FAT partition (no partition table).

It has a single file called "SPEEVERS.fls". This is the program that the
ball uses.

The site to generate such files: http://www.speevers.com/freack .

As a last resort, there is a small reset button hidden on the board
(near the LEDs. At least on one of the sides).

== Structure

=== Colors
Color sequences are represented by integers, built of two words:
length and color.

* Length: miliseconds
* Color
  * Blue: 0c
  * Red: c0
  * Green: 30
* Each of those has two bits. Is there a single bit for the LED of each
  side?
* Other colors are combinations of the basic colors:
  * Black (none): 00
  * Magenta: cc (red + blue)
  * Turqoise: 3c (red + green)
  * Yellow: f0 (red + green)
  * White: fc (red + green + blue)

=== Single Color

5aa5 SDLY 0101 0101 0001 0000 0000 0000
0000 0000 0001 CLN1 0008 0001 CLR1

CLR1: sequence of colors.

CLN1: length of CLR1 (in integers)

SDLY: integer. shutdown delay, in seconds

=== Two Colors
5aa5 SDLY 0101 0101 0001 0000 0000 0000
0000 0000 0002 CLN1 000e CNT1 CLN2 0010
CNT2 CLR1 CLR2

=== Three Colors

5aa5 SDLY 0101 0101 0001 0000 0000 0000
0000 0000 0003 CLN1 0014 CNT1 CLN2 0016
CNT2 CLN3 001a CNT3 CLR1 CLR2 CLR3

=== Four Colors
5aa5 SDLY 0101 0101 0001 0000 0000 0000
0000 0000 0004 CLN1 001a CNT1 CLN2 001c
CNT2 CLN3 001e CNT3 CLN4 0022 CNT4 CLR1
CLR2 CLR3 CLR4               

=== Five Colors
5aa5 SDLY 0101 0101 0001 0000 0000 0000
0000 0000 0005 CLN1 0020 CNT1 CLN2 0022
CNT2 CLN3 0024 CNT3 CLN4 0026 CNT4 CLN5
0028 CNT5 CLR1 CLR2 CLR3 CLR4 CLR5


=== Index

CLNn: The length (in ints) of CLRn.
CLRn: an integer or two describing the color (and also legth?) of a basic
      color unit (combination of LEDs).
CNTn: the number of times color /n/ will appear.
SDLY: shutdown delay (seconds)


== Web UI Bugs
* Settings => Shutdown delay: claims to be in 1/10 of seconds.
  In practice: seconds.
* Shutdown delay tooltip has an odd floating point rounding bug.
* CNT1: claims to have a maximum of 100. In practice it has a maximum of 96.

=== TODO
* What does Settings => Double click interval have?