diff --git a/README.md b/README.md
index 6df032a..2a22a7b 100644
--- a/README.md
+++ b/README.md
@@ -1,25 +1,58 @@
-# Parrafraktor
+# Parafraktor
+## Hardware Connections
+- Motor1: P30 (M1)
+- Motor2: P53 (M2)
+- Motor3: P46 (M3A)
+- Motor4: P70 (M4)
+- Motor5: P31 (M5)
+- Motor6: P71 (M7)
+- 24V: Power + -
+- TTL-level DMX: FWS 
+- Limit switches: EXP2 (optional)
+- Address selector: EXP1 (optional)
 
-![schematic](docs/schematic.png)
+## DMX Registers
 
+Control Motors 1 - 6 
 
+| Offset  | Motor | Function     | Values    |                                |
+| ------- | ----- | ------------ | --------- | ------------------------------ |
+| 1       |   1   | Tilt         | 000 - 255 | 8bit Position values can be combined to 16bit value   |
+| 2       |   1   | Tilt fine    | 000 - 255 |         |
+| 3       |   1   | Endless Tilt | 000 - 004 | No function                    |
+|         |       |              | 005 - 121 | Forward Rotation fast -> slow  |
+|         |       |              | 122 - 132 | Stop                           |
+|         |       |              | 133 - 250 | Backward Rotation slow -> fast |
+|         |       |              | 251 - 255 | No function                    |
+| ...     |  ...  | ...          | ...       | ...                            |
+| 16      |   6   | Tilt         |           |                                |
+| 17      |   6   | Tilt fine    |           |                                |
+| 18      |   6   | Endless Tilt |           |                                |
 
-| Channel | Function     | Values    |                                |
-| ------- | ------------ | --------- | ------------------------------ |
-| 1 + i   | Tilt         |           |                                |
-| 2 + i   | Tilt fine    |           |                                |
-| 3 + i   | Endless Tilt | 000 - 005 | No function                    |
-|         |              | 006 - 126 | Forward Rotation fast -> slow  |
-|         |              | 127 - 128 | Stop                           |
-|         |              | 129 - 255 | Backward Rotation slow -> fast |
-| 31      | Auto Mode    | 000 - 004 | No function                    |
-|         |              | 005 - 010 | Go to Reference                |
-|         |              | 015 - 020 | Classic Mode                   |
+## Compile, Flash & Debug
 
+requirements:
+- for compiling: arm-none-eabi-toolchain, gnu-make, git
+- for flashing: SEGGER J-Link, JLinkGDBServer (other Debug Probes can be used, see Makefile)
+
+run gdb-server<br />
+`./gdb.sh`
+
+build and flash firmware with static DMX-Address<br />
+`make program DMX_ADDRESS=99`
+
+build and flash firmware with address selector on EXP1<br />
+`make program`
+
+open serial RTT prints:<br />
+`telnet localhost 9000`
+
+open cgdb debugger:<br />
+`./debug.sh`
 
 ## Hardware
 
 - BIGTREETECH Manta M8P
     - https://github.com/bigtreetech/Manta-M8P/tree/master/V1.0_V1.1/Hardware
     - https://github.com/bigtreetech/Manta-M8P
-    - https://bttwiki.com/M8P.html#product-profile
\ No newline at end of file
+    - https://bttwiki.com/M8P.html#product-profile