update book

satrs-book/src/example.md

@@ -9,22 +9,54 @@ software application.
 ## Structure of the example project
 
 The example project contains components which could also be expected to be part of a production
-On-Board Software.
+On-Board Software. A structural diagram of the example application is given to provide
+a brief high-level view of the components used inside the example application:
 
-1. A UDP and TCP server to receive telecommands and poll telemetry from. This might be an optional
-   component for an OBSW which is only used during the development phase on ground. The TCP
-   server parses space packets by using the CCSDS space packet ID as the packet start delimiter.
-2. A PUS service stack which exposes some functionality conformant with the ECSS PUS service. This
-   currently includes the following services:
-   - Service 1 for telecommand verification.
-   - Service 3 for housekeeping telemetry handling.
-   - Service 5 for management and downlink of on-board events.
-   - Service 8 for handling on-board actions.
-   - Service 11 for scheduling telecommands to be released at a specific time.
-   - Service 17 for test purposes (pings)
-3. An event manager component which handles the event IPC mechanism.
-4. A TC source component which demultiplexes and routes telecommands based on parameters like
-   packet APID or PUS service and subservice type.
-5. A TM sink sink component which is the target of all sent telemetry and sends it to downlink
+![satrs-example component structure](images/satrs-example/satrs-example-structure.png)
+
+Some additional explanation is provided for the various components:
+
+### TCP/IP server components
+
+The example includes a UDP and TCP server to receive telecommands and poll telemetry from. This
+might be an optional component for an OBSW which is only used during the development phase on
+ground. The TCP server parses space packets by using the CCSDS space packet ID as the packet
+start delimiter.
+
+### PUS Service Components
+
+A PUS service stack is provided which exposes some functionality conformant with the ECSS PUS
+service. This currently includes the following services:
+
+- Service 1 for telecommand verification.
+- Service 3 for housekeeping telemetry handling.
+- Service 5 for management and downlink of on-board events.
+- Service 8 for handling on-board actions.
+- Service 11 for scheduling telecommands to be released at a specific time.
+- Service 17 for test purposes (pings)
+
+### Event Management Component
+
+An event manager is provided to handle the event IPC and FDIR mechanism.
+
+### TMTC Infrastructure
+
+The most important components of the TMTC infrastructure include the following components:
+
+- A TC source component which demultiplexes and routes telecommands based on parameters like
+  packet APID or PUS service and subservice type.
+- A TM sink sink component which is the target of all sent telemetry and sends it to downlink
    handlers like the UDP and TCP server.
-6. An AOCS example task which can also process some PUS commands.
+
+### Sample Application Components
+
+These components are example mission specific. They provide an idea how mission specific modules
+would look like the sat-rs context. It currently includes the following components:
+
+- An Attitute and Orbit Control (AOCS) example task which can also process some PUS commands.
+
+## Dataflow
+
+The interaction of the various components is provided in the following diagram:
+
+![satrs-example dataflow diagram](images/satrs-example/satrs-example-dataflow.png)