From 449fc7463f77a75d9acc8cd54abffec1825f7e05 Mon Sep 17 00:00:00 2001 From: Sebastian Huber Date: Thu, 7 Nov 2019 11:18:01 +0100 Subject: eng: Add BSP build system chapter Update #3818. --- images/eng/bld-bsp.dot | 34 +++++++++++++++++++++++ images/eng/bld-bsp.pdf | Bin 0 -> 6491 bytes images/eng/bld-bsp.png | Bin 0 -> 24758 bytes images/eng/bld-bsp2.dot | 43 +++++++++++++++++++++++++++++ images/eng/bld-bsp2.pdf | Bin 0 -> 7460 bytes images/eng/bld-bsp2.png | Bin 0 -> 29084 bytes images/eng/bld-deps.dot | 65 +++++++++++++++++++++++++++++++++++++++++++ images/eng/bld-deps.pdf | Bin 0 -> 9563 bytes images/eng/bld-deps.png | Bin 0 -> 14632 bytes images/eng/bld-deps2.dot | 70 +++++++++++++++++++++++++++++++++++++++++++++++ images/eng/bld-deps2.pdf | Bin 0 -> 9025 bytes images/eng/bld-deps2.png | Bin 0 -> 28538 bytes 12 files changed, 212 insertions(+) create mode 100644 images/eng/bld-bsp.dot create mode 100644 images/eng/bld-bsp.pdf create mode 100644 images/eng/bld-bsp.png create mode 100644 images/eng/bld-bsp2.dot create mode 100644 images/eng/bld-bsp2.pdf create mode 100644 images/eng/bld-bsp2.png create mode 100644 images/eng/bld-deps.dot create mode 100644 images/eng/bld-deps.pdf create mode 100644 images/eng/bld-deps.png create mode 100644 images/eng/bld-deps2.dot create mode 100644 images/eng/bld-deps2.pdf create mode 100644 images/eng/bld-deps2.png (limited to 'images/eng') 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 Binary files /dev/null and b/images/eng/bld-bsp.pdf differ diff --git a/images/eng/bld-bsp.png b/images/eng/bld-bsp.png new file mode 100644 index 0000000..7a0996e Binary files /dev/null and b/images/eng/bld-bsp.png differ 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 Binary files /dev/null and b/images/eng/bld-bsp2.pdf differ diff --git a/images/eng/bld-bsp2.png b/images/eng/bld-bsp2.png new file mode 100644 index 0000000..af3818b Binary files /dev/null and b/images/eng/bld-bsp2.png differ 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 Binary files /dev/null and b/images/eng/bld-deps.pdf differ diff --git a/images/eng/bld-deps.png b/images/eng/bld-deps.png new file mode 100644 index 0000000..c475e6f Binary files /dev/null and b/images/eng/bld-deps.png differ 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 Binary files /dev/null and b/images/eng/bld-deps2.pdf differ diff --git a/images/eng/bld-deps2.png b/images/eng/bld-deps2.png new file mode 100644 index 0000000..53de075 Binary files /dev/null and b/images/eng/bld-deps2.png differ -- cgit v1.2.3