# xilinx/embedded-design-tutorials architecture

> Architecture diagram of the GitHub repository xilinx/embedded-design-tutorials, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/xilinx/embedded-design-tutorials
- Repository: https://github.com/xilinx/embedded-design-tutorials

## Overview

This repository is a collection of AMD embedded-design tutorials and guides, rather than an executable product. Engineers use its landing documentation to choose a device or task, then follow a relevant getting-started, debugging, design, or performance guide. The README documents these capability areas, but no source excerpts were provided; the graph therefore shows only those documented entry relationships, not internal tutorial steps.

Main entry points: [`docs/Debugging/README.md`](https://github.com/xilinx/embedded-design-tutorials/blob/master/docs/Debugging/README.md) (Debugging Guides), [`docs/Getting_Started/README.md`](https://github.com/xilinx/embedded-design-tutorials/blob/master/docs/Getting_Started/README.md) (Getting Started), [`docs/Getting_Started/Versal-EDT/Versal-EDT.rst`](https://github.com/xilinx/embedded-design-tutorials/blob/master/docs/Getting_Started/Versal-EDT/Versal-EDT.rst) (Versal Tutorial), [`docs/Debugging/Vitis-Embedded-Software-Debugging/README.md`](https://github.com/xilinx/embedded-design-tutorials/blob/master/docs/Debugging/Vitis-Embedded-Software-Debugging/README.md) (Vitis Debug Guide)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_getting_started["Getting Started"]
  node_getting_started_index["Getting Started<br/>[README.md]"]
  node_versal_tutorial["Versal Tutorial<br/>[Versal-EDT.rst]"]
end

subgraph group_debugging["Debugging"]
  node_debug_index["Debugging Guides<br/>[README.md]"]
  node_debug_guide["Vitis Debug Guide<br/>[README.md]"]
  node_debuggable_fsbl["Debuggable FSBL<br/>[debuggable-fsbl.md]"]
  node_software_profiling["Software Profiling<br/>[sw-profiling.md]"]
end

subgraph group_design["Design Tutorials"]
  node_design_tutorial["Graphic Subsystem<br/>[README.md]"]
end

subgraph group_performance["Performance"]
  node_performance_guides["Performance Guides"]
end

node_engineer(("Embedded engineer"))

node_engineer -->|"chooses device flow"| node_getting_started_index
node_engineer -->|"chooses debug guide"| node_debug_index
node_engineer -->|"explores design tutorial"| node_design_tutorial
node_engineer -->|"chooses analysis guide"| node_performance_guides
node_getting_started_index -->|"opens tutorial"| node_versal_tutorial
node_debug_index -->|"opens guide"| node_debug_guide
node_debug_index -->|"opens guide"| node_debuggable_fsbl
node_debug_index -->|"opens guide"| node_software_profiling

click node_getting_started_index "https://github.com/xilinx/embedded-design-tutorials/blob/master/docs/Getting_Started/README.md"
click node_versal_tutorial "https://github.com/xilinx/embedded-design-tutorials/blob/master/docs/Getting_Started/Versal-EDT/Versal-EDT.rst"
click node_debug_index "https://github.com/xilinx/embedded-design-tutorials/blob/master/docs/Debugging/README.md"
click node_debug_guide "https://github.com/xilinx/embedded-design-tutorials/blob/master/docs/Debugging/Vitis-Embedded-Software-Debugging/README.md"
click node_debuggable_fsbl "https://github.com/xilinx/embedded-design-tutorials/blob/master/docs/Debugging/debuggable-fsbl/debuggable-fsbl.md"
click node_software_profiling "https://github.com/xilinx/embedded-design-tutorials/blob/master/docs/Debugging/sw-profiling/sw-profiling.md"
click node_design_tutorial "https://github.com/xilinx/embedded-design-tutorials/blob/master/docs/Design_Tutorials/MPSoC_Graphic_Subsystem/README.md"
click node_performance_guides "https://github.com/xilinx/embedded-design-tutorials/tree/master/docs/Performance"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_getting_started_index,node_versal_tutorial toneBlue
class node_debug_index,node_debug_guide,node_debuggable_fsbl,node_software_profiling toneAmber
class node_design_tutorial toneMint
class node_performance_guides toneRose
class node_engineer toneIndigo
```

## Components

### Getting Started

- [Getting Started](https://github.com/xilinx/embedded-design-tutorials/blob/master/docs/Getting_Started/README.md): `docs/Getting_Started/README.md`
- [Versal Tutorial](https://github.com/xilinx/embedded-design-tutorials/blob/master/docs/Getting_Started/Versal-EDT/Versal-EDT.rst): `docs/Getting_Started/Versal-EDT/Versal-EDT.rst`

### Debugging

- [Debugging Guides](https://github.com/xilinx/embedded-design-tutorials/blob/master/docs/Debugging/README.md): `docs/Debugging/README.md`
- [Vitis Debug Guide](https://github.com/xilinx/embedded-design-tutorials/blob/master/docs/Debugging/Vitis-Embedded-Software-Debugging/README.md): `docs/Debugging/Vitis-Embedded-Software-Debugging/README.md`
- [Debuggable FSBL](https://github.com/xilinx/embedded-design-tutorials/blob/master/docs/Debugging/debuggable-fsbl/debuggable-fsbl.md): `docs/Debugging/debuggable-fsbl/debuggable-fsbl.md`
- [Software Profiling](https://github.com/xilinx/embedded-design-tutorials/blob/master/docs/Debugging/sw-profiling/sw-profiling.md): `docs/Debugging/sw-profiling/sw-profiling.md`

### Design Tutorials

- [Graphic Subsystem](https://github.com/xilinx/embedded-design-tutorials/blob/master/docs/Design_Tutorials/MPSoC_Graphic_Subsystem/README.md): `docs/Design_Tutorials/MPSoC_Graphic_Subsystem/README.md`

### Performance

- [Performance Guides](https://github.com/xilinx/embedded-design-tutorials/tree/master/docs/Performance): `docs/Performance`

### Other components

- **Embedded engineer**

## Connections

- Embedded engineer → Getting Started: chooses device flow
- Embedded engineer → Debugging Guides: chooses debug guide
- Embedded engineer → Graphic Subsystem: explores design tutorial
- Embedded engineer → Performance Guides: chooses analysis guide
- Getting Started → Versal Tutorial: opens tutorial
- Debugging Guides → Vitis Debug Guide: opens guide
- Debugging Guides → Debuggable FSBL: opens guide
- Debugging Guides → Software Profiling: opens guide
