eng: Add BSP build system chapter

Update #3818.

12 files changed, 212 insertions, 0 deletions

diff --git a/images/eng/bld-bsp.dot b/images/eng/bld-bsp.dot
new file mode 100644
index 0000000..4e129c4
--- /dev/null
+++ b/images/eng/bld-bsp.dot
@@ -0,0 +1,34 @@
+# SPDX-License-Identifier: CC-BY-SA-4.0
+
+# Copyright (C) 2019 embedded brains GmbH
+
+digraph {
+  size="4";
+  margin="0";
+  node [shape=box, style="filled, rounded", fontname="Sans serif", margin=0.05,width=0.05,height=0.05];
+  bsp [label="/build/bsps/arch/family/bspxyz", fillcolor=red];
+  oabc [label="optabc", fillcolor=orange];
+  odef [label="optdef", fillcolor=orange];
+  smp [label="objsmp", fillcolor=brown];
+  abi [label="abi", fillcolor=yellow];
+  o2 [label="../../opto2", fillcolor=green];
+  bspopts [label="../../bspopts", fillcolor=green];
+  linkcmds [label="../../linkcmds", fillcolor=green];
+  start [label="../start", fillcolor=green];
+  rankdir=LR
+  bsp -> o2
+  bsp -> abi
+  bsp -> oabc
+  bsp -> odef
+  bsp -> bspopts
+  bsp -> smp
+  bsp -> start
+  bsp -> linkcmds
+  { rank=same; abi -> oabc [style=invis] }
+  { rank=same; oabc -> odef [style=invis] }
+  { rank=same; odef -> o2 [style=invis] }
+  { rank=same; o2 -> bspopts [style=invis] }
+  { rank=same; bspopts -> smp [style=invis] }
+  { rank=same; smp -> start [style=invis] }
+  { rank=same; start -> linkcmds [style=invis] }
+}
diff --git a/images/eng/bld-bsp.pdf b/images/eng/bld-bsp.pdf
new file mode 100644
index 0000000..1c30636
--- /dev/null
+++ b/images/eng/bld-bsp.pdf
diff --git a/images/eng/bld-bsp.png b/images/eng/bld-bsp.png
new file mode 100644
index 0000000..7a0996e
--- /dev/null
+++ b/images/eng/bld-bsp.png
diff --git a/images/eng/bld-bsp2.dot b/images/eng/bld-bsp2.dot
new file mode 100644
index 0000000..e71726b
--- /dev/null
+++ b/images/eng/bld-bsp2.dot
@@ -0,0 +1,43 @@
+# SPDX-License-Identifier: CC-BY-SA-4.0
+
+# Copyright (C) 2019 embedded brains GmbH
+
+digraph {
+  size="4";
+  margin="0";
+  node [shape=box, style="filled, rounded", fontname="Sans serif", margin=0.05,width=0.05,height=0.05];
+  bsp1 [label="/build/bsps/arch/family/bsprst", fillcolor=red];
+  bsp2 [label="/build/bsps/arch/family/bspuvw", fillcolor=red];
+  bsp3 [label="/build/bsps/arch/family/bspxyz", fillcolor=red];
+  oabc [label="optabc", fillcolor=orange];
+  odef [label="optdef", fillcolor=orange];
+  grp [label="grp", fillcolor=magenta];
+  obj [label="obj", fillcolor=brown];
+  smp [label="objsmp", fillcolor=brown];
+  abi [label="abi", fillcolor=yellow];
+  bspopts [label="../../bspopts", fillcolor=green];
+  linkcmds [label="../../linkcmds", fillcolor=green];
+  start [label="../start", fillcolor=green];
+  o2 [label="../../opto2", fillcolor=green];
+  rankdir=LR
+  bsp1 -> grp
+  bsp2 -> grp
+  bsp3 -> grp
+  grp -> o2
+  grp -> abi
+  grp -> oabc
+  grp -> odef
+  grp -> bspopts
+  grp -> obj
+  grp -> smp
+  grp -> start
+  grp -> linkcmds
+  { rank=same; abi -> oabc [style=invis] }
+  { rank=same; oabc -> odef [style=invis] }
+  { rank=same; odef -> o2 [style=invis] }
+  { rank=same; o2 -> bspopts [style=invis] }
+  { rank=same; bspopts -> obj [style=invis] }
+  { rank=same; obj -> smp [style=invis] }
+  { rank=same; smp -> start [style=invis] }
+  { rank=same; start -> linkcmds [style=invis] }
+}
diff --git a/images/eng/bld-bsp2.pdf b/images/eng/bld-bsp2.pdf
new file mode 100644
index 0000000..4ae6a07
--- /dev/null
+++ b/images/eng/bld-bsp2.pdf
diff --git a/images/eng/bld-bsp2.png b/images/eng/bld-bsp2.png
new file mode 100644
index 0000000..af3818b
--- /dev/null
+++ b/images/eng/bld-bsp2.png
diff --git a/images/eng/bld-deps.dot b/images/eng/bld-deps.dot
new file mode 100644
index 0000000..4d707a8
--- /dev/null
+++ b/images/eng/bld-deps.dot
@@ -0,0 +1,65 @@
+# SPDX-License-Identifier: CC-BY-SA-4.0
+
+# Copyright (C) 2019 embedded brains GmbH
+
+digraph {
+  size="4";
+  margin="0";
+  node [shape=box, style="filled, rounded", fontname="Sans serif", margin=0.05,width=0.05,height=0.05];
+  tg [label="Test Group", fillcolor=green];
+  t0 [label="Test Program 0", fillcolor=red];
+  t1 [label="Test Program 1", fillcolor=red];
+  tn [label="Test Program n", fillcolor=red];
+  lb [label="librtemsbsp.a", fillcolor=magenta];
+  lc [label="librtemscpu.a", fillcolor=magenta];
+  b0 [label="BSP 0", fillcolor=orange];
+  b1 [label="BSP 1", fillcolor=orange];
+  bn [label="BSP n", fillcolor=orange];
+  bo0 [label="BSP 0 bspopts.h", fillcolor=brown];
+  o0 [label="BSP 0 Option 0", fillcolor=yellow];
+  o1 [label="BSP 0 Option 1", fillcolor=yellow];
+  on [label="BSP 0 Option n", fillcolor=yellow];
+  abi [label="BSP 0 ABI Flags", fillcolor=blue];
+  s0 [label="BSP 0 Source 0", fillcolor=cyan];
+  s1 [label="BSP 0 Source 1", fillcolor=cyan];
+  sn [label="BSP 0 Source n", fillcolor=cyan];
+  c0 [label="CPU Source 0", fillcolor=cyan];
+  c1 [label="CPU Source 1", fillcolor=cyan];
+  cn [label="CPU Source n", fillcolor=cyan];
+  rankdir=LR
+  tg -> t0
+  tg -> t1
+  tg -> tn
+  t0 -> lb
+  t0 -> lc
+  t1 -> lb
+  t1 -> lc
+  tn -> lb
+  tn -> lc
+  lb -> b0
+  lb -> b1
+  lb -> bn
+  b0 -> s0
+  b0 -> s1
+  b0 -> sn
+  s0 -> abi
+  s1 -> abi
+  sn -> abi
+  c0 -> abi
+  c1 -> abi
+  cn -> abi
+  bo0 -> o0
+  bo0 -> o1
+  bo0 -> on
+  s0 -> bo0
+  s1 -> bo0
+  sn -> bo0
+  lc -> c0
+  lc -> c1
+  lc -> cn
+  {
+    rank=same
+    c0 -> c1 [style=invis]
+    c1 -> cn [style=invis]
+  }
+}
diff --git a/images/eng/bld-deps.pdf b/images/eng/bld-deps.pdf
new file mode 100644
index 0000000..3e75081
--- /dev/null
+++ b/images/eng/bld-deps.pdf
diff --git a/images/eng/bld-deps.png b/images/eng/bld-deps.png
new file mode 100644
index 0000000..c475e6f
--- /dev/null
+++ b/images/eng/bld-deps.png
diff --git a/images/eng/bld-deps2.dot b/images/eng/bld-deps2.dot
new file mode 100644
index 0000000..86d79df
--- /dev/null
+++ b/images/eng/bld-deps2.dot
@@ -0,0 +1,70 @@
+# SPDX-License-Identifier: CC-BY-SA-4.0
+
+# Copyright (C) 2019 embedded brains GmbH
+
+digraph {
+  size="4";
+  margin="0";
+  node [shape=box, style="filled, rounded", fontname="Sans serif", margin=0.05,width=0.05,height=0.05];
+  g [shape=box,label="Top-Level Group", fillcolor=green];
+  tg [label="Test Group", fillcolor=green];
+  t0 [label="Test Program 0", fillcolor=red];
+  t1 [label="Test Program 1", fillcolor=red];
+  tn [label="Test Program n", fillcolor=red];
+  lc [label="librtemscpu.a", fillcolor=magenta];
+  b0 [label="BSP 0", fillcolor=orange];
+  bn [label="BSP n", fillcolor=orange];
+  b1 [label="BSP 1", fillcolor=orange];
+  o0 [label="BSP 0 Option 0", fillcolor=yellow];
+  o1 [label="BSP 0 Option 1", fillcolor=yellow];
+  on [label="BSP 0 Option n", fillcolor=yellow];
+  bo [label="bspopts.h", fillcolor=brown];
+  abi [label="BSP 0 ABI Flags", fillcolor=blue];
+  s0 [label="BSP 0 Source 0", fillcolor=cyan];
+  s1 [label="BSP 0 Source 1", fillcolor=cyan];
+  sn [label="BSP 0 Source n", fillcolor=cyan];
+  c0 [label="CPU Source 0", fillcolor=cyan];
+  c1 [label="CPU Source 1", fillcolor=cyan];
+  cn [label="CPU Source n", fillcolor=cyan];
+  rankdir=LR
+  subgraph {
+    b0 -> abi
+    b0 -> o0
+    b0 -> o1
+    b0 -> on
+    b0 -> bo
+    b0 -> s0
+    b0 -> s1
+    b0 -> sn
+    b1 -> bo
+    bn -> bo
+  }
+  g -> tg
+  g -> lc
+  subgraph {
+    tg -> t0
+    tg -> t1
+    tg -> tn
+  }
+  subgraph {
+    lc -> c0
+    lc -> c1
+    lc -> cn
+  }
+  {
+    rank=same
+    b0 -> b1 [style=invis]
+    b1 -> bn [style=invis]
+  }
+  {
+    rank=same
+    s0 -> s1 [style=invis]
+    s1 -> sn [style=invis]
+    s1 -> abi [style=invis]
+    abi -> o0 [style=invis]
+    o0 -> o1 [style=invis]
+    o1 -> on [style=invis]
+    on -> bo [style=invis]
+    lc -> tg [style=invis]
+  }
+}
diff --git a/images/eng/bld-deps2.pdf b/images/eng/bld-deps2.pdf
new file mode 100644
index 0000000..b5ad3c8
--- /dev/null
+++ b/images/eng/bld-deps2.pdf
diff --git a/images/eng/bld-deps2.png b/images/eng/bld-deps2.png
new file mode 100644
index 0000000..53de075
--- /dev/null
+++ b/images/eng/bld-deps2.png