diff --git a/doc/setups/README.MD b/doc/setups/README.MD
new file mode 100644
index 0000000..e109c4c
--- /dev/null
+++ b/doc/setups/README.MD
@@ -0,0 +1,5 @@
+Overview of the default Hachi setup with the Novation LaunchPadPro as gridcontroller.
+
+**Note:** For now Hachi requires an external clocksource (which it does not forward).
+
+![PlantUML model](http://www.plantuml.com/plantuml/png/5Osn3K8n30Lxfe05ubzJ_LM2OqWaVpkAdyNwXEfEkkBEG5t8Is-FOQpP99VUEp3ZIRJgjtm6UhuoPB4Rn53OBuf3nOxHQ4Hqfx16EvimXbjGSwOGvDmgxvgACl-JKwnj_W00?github=PleaseStopChacgingImage)
diff --git a/doc/setups/alt1.puml b/doc/setups/alt1.puml
new file mode 100644
index 0000000..0425cfb
--- /dev/null
+++ b/doc/setups/alt1.puml
@@ -0,0 +1,17 @@
+@startuml
+title
+Hachi Connection Diagram: Alt1 0.0.1
+end title
+
+package alternative_setup? {
+node APCMini as apc
+node synth as synth2
+
+node RPI3 {
+component  "Hachi=clocksource" as hachic
+}
+
+hachic <-up-> apc: midi
+hachic --> synth2: midi
+}
+@enduml
diff --git a/doc/setups/alternative1.md b/doc/setups/alternative1.md
new file mode 100644
index 0000000..f9a028f
--- /dev/null
+++ b/doc/setups/alternative1.md
@@ -0,0 +1,3 @@
+Alternative Hachi setup with eg Akai APC Mini gridcontroller: [**NOT IMPLEMENTED**]
+
+![PlantUML model](http://www.plantuml.com/plantuml/png/5SqnZW8n30NGVay15uY7bcgk4XoBHChOKVwtk3vizSftWdKph_bt7wupc-MUjqukF4Ls_PJtOCzNmhQ6qvn5un8Sq_mOJGRGG-1DDDnDES8XBLHWp0Mfau-o_eVJlFty0W00)
diff --git a/doc/setups/apc_mini_midi.jpg b/doc/setups/apc_mini_midi.jpg
new file mode 100644
index 0000000..15fe9c0
Binary files /dev/null and b/doc/setups/apc_mini_midi.jpg differ
diff --git a/doc/setups/default.puml b/doc/setups/default.puml
new file mode 100644
index 0000000..7e5bede
--- /dev/null
+++ b/doc/setups/default.puml
@@ -0,0 +1,24 @@
+@startuml
+title
+Hachi Connection Diagram: Default 0.0.4
+end title
+
+package default_setup {
+component "clocksource" as clk
+component "midimerge" as mrg
+node LaunchpadPro as lpp
+node synth
+
+node RPI {
+component  "Hachi" as hachi
+}
+
+clk --> mrg: clock
+clk --> hachi: clock
+
+hachi ==> mrg: midi
+
+mrg --> lpp: midi+clock
+lpp --> synth: midi+clock
+}
+@enduml