From 776569d7c18cc218a6ad0f8574dbd942bc904976 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?King=20K=C3=A9vin?= <kingkevin@cuvoodoo.info>
Date: Thu, 11 Aug 2022 14:23:40 +0200
Subject: [PATCH] doc: add artnet commands

---
 README.md | 72 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 72 insertions(+)

diff --git a/README.md b/README.md
index 3949448..623dcdf 100644
--- a/README.md
+++ b/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
 =====