doc: add artnet commands

README.md

@@ -13,6 +13,78 @@ technology
 
 *described electronic details*
 
+Art-Net
+-------
+
+The Bahn Clock controller gets data over the network using Art-Net.
+The mapping is as follows (universe without offset, channel, target).
+
+clock illumination color (RGBW LED strip):
+
+- 0, 0, red high byte
+- 0, 1, red low byte
+- 0, 2, green high byte
+- 0, 3, green low byte
+- 0, 4, blue high byte
+- 0, 5, blue low byte
+- 0, 4, white high byte
+- 0, 5, white low byte
+
+dials position:
+
+- 1, 0, hours (0-11)
+- 1, 1, minutes (0-59)
+- 1, 2, seconds (0-59)
+- 1, 3, direction
+- 1, 4, speed
+
+text display:
+
+font display, line 1:
+
+- 2, 0, red intensity (0 to use clock illumination color)
+- 2, 1, green intensity (0 to use clock illumination color)
+- 2, 2, blue intensity (0 to use clock illumination color)
+- 2, 3, horizontal position (0 is left), high signed byte
+- 2, 3, horizontal position (0 is left), low byte
+- 2, 4+, text (NULL ended)
+
+font display, line 2:
+
+- 3, 0, red intensity (0 to use clock illumination color)
+- 3, 1, green intensity (0 to use clock illumination color)
+- 3, 2, blue intensity (0 to use clock illumination color)
+- 3, 3, horizontal position (0 is left), high signed byte
+- 3, 3, horizontal position (0 is left), low byte
+- 3, 4+, text (NULL ended)
+
+font display, line 3:
+
+- 4, 0, red intensity (0 to use clock illumination color)
+- 4, 1, green intensity (0 to use clock illumination color)
+- 4, 2, blue intensity (0 to use clock illumination color)
+- 4, 3, horizontal position (0 is left), high signed byte
+- 4, 3, horizontal position (0 is left), low byte
+- 4, 4+, text (NULL ended)
+
+back display, line 1:
+
+- 5, 0, red intensity (0 to use clock illumination color)
+- 5, 1, green intensity (0 to use clock illumination color)
+- 5, 2, blue intensity (0 to use clock illumination color)
+- 5, 3, horizontal position (0 is left), high signed byte
+- 5, 3, horizontal position (0 is left), low byte
+- 5, 4+, text (NULL ended)
+
+back display, line 2:
+
+- 6, 0, red intensity (0 to use clock illumination color)
+- 6, 1, green intensity (0 to use clock illumination color)
+- 6, 2, blue intensity (0 to use clock illumination color)
+- 6, 3, horizontal position (0 is left), high signed byte
+- 6, 3, horizontal position (0 is left), low byte
+- 6, 4+, text (NULL ended)
+
 board
 =====