# HG changeset patch
# User Tero Marttila <terom@fixme.fi>
# Date 1311709480 -10800
# Node ID e6571a8040aed49c99e4c95ed3d3fad707f11264
# Parent  a0a003083d4c41a15a24820c86ae1c05067ed737# Parent  fe9f354dddd43f7987dce7102b4e89bf74bd0071
merge

diff -r a0a003083d4c -r e6571a8040ae docs/dmx.txt
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/docs/dmx.txt	Tue Jul 26 22:44:40 2011 +0300
@@ -0,0 +1,53 @@
+* 250 kHz clock
+    * 250000 bits / s
+    * 4µs / bit
+* idle line = high (transmitter/master drives line high)
+
+        
+
+Packet structure:
+
+* paket format
+    * break
+    * mark (MAB)
+    * 2-512 frames
+        * frame 0 = start code = 0x00
+        * frame N = channel N = 0-255
+        * 1 start bit, 8 data bits, 2 stop bits, no parity
+        * mark (MTBF)
+    * mark (MTAP)
+
+* break
+    * syncs start of DMX packet
+    * >= 22 low bits (88 µs)
+    * up to 1s
+    * recommended 25 - 30 low bits
+
+* mark after break (MAB)
+    * immediately follows the break
+    * high mark of > 2 bits (8µs)
+    * up to 1s
+    * recommended 3 high bits
+
+* (channel frames)
+    * first frame is start code (SC)
+        * data value = 0x00 signifies dimmer data
+
+    * 11 bits / frame
+        * 1 low bit (start bit)
+        * 8 data bits (0-255)
+        * 2 high bits (stop bits)
+ 
+    * mark time between frames (MTBF)
+        * idle time between frames; line kept high
+        * can be as short as desired
+
+    * between 1 and 512 sequential frames
+
+* mark time between packets (MTBP)
+    * after the last frame's stop bits
+    * same as MTBF
+    * idle time between packets; line kept high
+    * can be as short as desired
+
+