# simon1903123/eosa_project architecture

> Architecture diagram of the GitHub repository simon1903123/eosa_project, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/simon1903123/eosa_project
- Repository: https://github.com/simon1903123/eosa_project

## Overview

This repository is a small Cortex-M embedded OS: boot initializes the console, clock and MPU, then enters unprivileged tasks through an SVC call. Tasks use system calls for I/O, scheduling, tracing and program-management services; the kernel dispatches those requests and the scheduler switches tasks. The shell and program-loading interface are present, though program execution is explicitly unfinished in the sampled syscall implementation. Relationships below follow the excerpts, SOURCE INDEX references and documented contracts; unsampled runtime wiring is not inferred.

Main entry points: [`project-base/kernel/task.c`](https://github.com/simon1903123/eosa_project/blob/main/project-base/kernel/task.c) (Task scheduler), [`project-base/src/main.c`](https://github.com/simon1903123/eosa_project/blob/main/project-base/src/main.c) (Kernel startup), [`project-base/kernel/syscall.c`](https://github.com/simon1903123/eosa_project/blob/main/project-base/kernel/syscall.c) (System-call dispatch), [`project-base/kernel/kprintf.c`](https://github.com/simon1903123/eosa_project/blob/main/project-base/kernel/kprintf.c) (Kernel printing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_boot_io["Boot and I/O"]
  node_boot["Kernel startup<br/>[main.c]"]
  node_uart["UART driver<br/>[uart.c]"]
  node_clock["SysTick driver<br/>[systick.c]"]
  node_cmsdk["CMSDK registers<br/>[cmsdk.h]"]
  node_kernel_print["Kernel printing<br/>[kprintf.c]"]
end

subgraph group_kernel["Kernel services"]
  node_mpu["Memory protection<br/>[mpu.c]"]
  node_svc["System-call dispatch<br/>[syscall.c]"]
  node_faults["Fault handling<br/>[faults.c]"]
  node_trace["Scheduler tracing<br/>[trace.c]"]
end

subgraph group_tasks["Tasks and scheduling"]
  node_scheduler["Task scheduler<br/>[task.c]"]
  node_idle["Idle task<br/>[idle.c]"]
end

subgraph group_user["User environment"]
  node_shell["Interactive shell<br/>[shell.c]"]
  node_user_printf["User print and timing<br/>[printf.c]"]
  node_format["Text formatting<br/>[format.c]"]
  node_syscall_api["User syscall API<br/>[syscalls.h]"]
  node_programs["Example programs"]
end

node_operator(("Operator"))

node_boot -->|"initializes"| node_uart
node_boot -->|"initializes"| node_clock
node_boot -->|"prints through"| node_kernel_print
node_boot -->|"configures"| node_mpu
node_boot -->|"starts tasks via"| node_svc
node_uart -->|"accesses registers"| node_cmsdk
node_clock -->|"accesses registers"| node_cmsdk
node_clock -->|"ticks scheduler"| node_scheduler
node_kernel_print -->|"prints via"| node_uart
node_kernel_print -->|"formats with"| node_format
node_mpu -->|"configures registers"| node_cmsdk
node_svc -->|"requests task actions"| node_scheduler
node_svc -->|"handles console I/O"| node_uart
node_svc -->|"reads clock services"| node_clock
node_svc -->|"dispatches trace dump"| node_trace
node_scheduler -->|"sets task region"| node_mpu
node_scheduler -->|"records switches"| node_trace
node_scheduler -->|"reports via"| node_kernel_print
node_faults -->|"faults current task"| node_scheduler
node_faults -->|"reports via"| node_kernel_print
node_idle -->|"runs as idle task"| node_scheduler
node_shell -->|"uses services"| node_syscall_api
node_shell -->|"uses task state"| node_scheduler
node_shell -->|"prints with"| node_user_printf
node_user_printf -->|"formats with"| node_format
node_user_printf -->|"uses services"| node_syscall_api
node_programs -->|"invoke services"| node_syscall_api
node_operator -.->|"uses"| node_shell

click node_boot "https://github.com/simon1903123/eosa_project/blob/main/project-base/src/main.c"
click node_uart "https://github.com/simon1903123/eosa_project/blob/main/project-base/drivers/uart.c"
click node_clock "https://github.com/simon1903123/eosa_project/blob/main/project-base/drivers/systick.c"
click node_cmsdk "https://github.com/simon1903123/eosa_project/blob/main/project-base/include/cmsdk.h"
click node_kernel_print "https://github.com/simon1903123/eosa_project/blob/main/project-base/kernel/kprintf.c"
click node_mpu "https://github.com/simon1903123/eosa_project/blob/main/project-base/kernel/mpu.c"
click node_svc "https://github.com/simon1903123/eosa_project/blob/main/project-base/kernel/syscall.c"
click node_faults "https://github.com/simon1903123/eosa_project/blob/main/project-base/kernel/faults.c"
click node_trace "https://github.com/simon1903123/eosa_project/blob/main/project-base/kernel/trace.c"
click node_scheduler "https://github.com/simon1903123/eosa_project/blob/main/project-base/kernel/task.c"
click node_idle "https://github.com/simon1903123/eosa_project/blob/main/project-base/src/idle.c"
click node_shell "https://github.com/simon1903123/eosa_project/blob/main/project-base/src/shell.c"
click node_user_printf "https://github.com/simon1903123/eosa_project/blob/main/project-base/lib/printf.c"
click node_format "https://github.com/simon1903123/eosa_project/blob/main/project-base/lib/format.c"
click node_syscall_api "https://github.com/simon1903123/eosa_project/blob/main/project-base/lib/syscalls.h"
click node_programs "https://github.com/simon1903123/eosa_project/tree/main/project-base/programs"

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_boot,node_uart,node_clock,node_cmsdk,node_kernel_print toneBlue
class node_mpu,node_svc,node_faults,node_trace toneAmber
class node_scheduler,node_idle toneMint
class node_shell,node_user_printf,node_format,node_syscall_api,node_programs toneRose
class node_operator toneIndigo
```

## Components

### Boot and I/O

- [Kernel startup](https://github.com/simon1903123/eosa_project/blob/main/project-base/src/main.c): `project-base/src/main.c`
- [UART driver](https://github.com/simon1903123/eosa_project/blob/main/project-base/drivers/uart.c): `project-base/drivers/uart.c`
- [SysTick driver](https://github.com/simon1903123/eosa_project/blob/main/project-base/drivers/systick.c): `project-base/drivers/systick.c`
- [CMSDK registers](https://github.com/simon1903123/eosa_project/blob/main/project-base/include/cmsdk.h): `project-base/include/cmsdk.h`
- [Kernel printing](https://github.com/simon1903123/eosa_project/blob/main/project-base/kernel/kprintf.c): `project-base/kernel/kprintf.c`

### Kernel services

- [Memory protection](https://github.com/simon1903123/eosa_project/blob/main/project-base/kernel/mpu.c): `project-base/kernel/mpu.c`
- [System-call dispatch](https://github.com/simon1903123/eosa_project/blob/main/project-base/kernel/syscall.c): `project-base/kernel/syscall.c`
- [Fault handling](https://github.com/simon1903123/eosa_project/blob/main/project-base/kernel/faults.c): `project-base/kernel/faults.c`
- [Scheduler tracing](https://github.com/simon1903123/eosa_project/blob/main/project-base/kernel/trace.c): `project-base/kernel/trace.c`

### Tasks and scheduling

- [Task scheduler](https://github.com/simon1903123/eosa_project/blob/main/project-base/kernel/task.c): `project-base/kernel/task.c`
- [Idle task](https://github.com/simon1903123/eosa_project/blob/main/project-base/src/idle.c): `project-base/src/idle.c`

### User environment

- [Interactive shell](https://github.com/simon1903123/eosa_project/blob/main/project-base/src/shell.c): `project-base/src/shell.c`
- [User print and timing](https://github.com/simon1903123/eosa_project/blob/main/project-base/lib/printf.c): `project-base/lib/printf.c`
- [Text formatting](https://github.com/simon1903123/eosa_project/blob/main/project-base/lib/format.c): `project-base/lib/format.c`
- [User syscall API](https://github.com/simon1903123/eosa_project/blob/main/project-base/lib/syscalls.h): `project-base/lib/syscalls.h`
- [Example programs](https://github.com/simon1903123/eosa_project/tree/main/project-base/programs): `project-base/programs`

### Other components

- **Operator**

## Connections

- Kernel startup → UART driver: initializes (evidence: `project-base/src/main.c`)
- Kernel startup → SysTick driver: initializes (evidence: `project-base/src/main.c`)
- Kernel startup → Kernel printing: prints through (evidence: `project-base/src/main.c`)
- Kernel startup → Memory protection: configures (evidence: `project-base/src/main.c`)
- Kernel startup → System-call dispatch: starts tasks via (evidence: `project-base/src/main.c`)
- UART driver → CMSDK registers: accesses registers (evidence: `project-base/drivers/uart.c`)
- SysTick driver → CMSDK registers: accesses registers (evidence: `project-base/drivers/systick.c`)
- SysTick driver → Task scheduler: ticks scheduler (evidence: `project-base/drivers/systick.c`)
- Kernel printing → UART driver: prints via (evidence: `project-base/kernel/kprintf.c`)
- Kernel printing → Text formatting: formats with (evidence: `project-base/kernel/kprintf.c`)
- Memory protection → CMSDK registers: configures registers (evidence: `project-base/kernel/mpu.c`)
- System-call dispatch → Task scheduler: requests task actions (evidence: `project-base/kernel/syscall.c`)
- System-call dispatch → UART driver: handles console I/O (evidence: `project-base/kernel/syscall.c`)
- System-call dispatch → SysTick driver: reads clock services (evidence: `project-base/kernel/syscall.c`)
- System-call dispatch → Scheduler tracing: dispatches trace dump (evidence: `project-base/kernel/syscall.c`)
- Task scheduler → Memory protection: sets task region (evidence: `project-base/kernel/task.c`)
- Task scheduler → Scheduler tracing: records switches (evidence: `project-base/kernel/task.c`)
- Task scheduler → Kernel printing: reports via (evidence: `project-base/kernel/task.c`)
- Fault handling → Task scheduler: faults current task (evidence: `project-base/kernel/faults.c`)
- Fault handling → Kernel printing: reports via (evidence: `project-base/kernel/faults.c`)
- Idle task → Task scheduler: runs as idle task (evidence: `project-base/src/idle.c`)
- Interactive shell → User syscall API: uses services (evidence: `project-base/src/shell.c`)
- Interactive shell → Task scheduler: uses task state (evidence: `project-base/src/shell.c`)
- Interactive shell → User print and timing: prints with (evidence: `project-base/src/shell.c`)
- User print and timing → Text formatting: formats with (evidence: `project-base/lib/printf.c`)
- User print and timing → User syscall API: uses services (evidence: `project-base/lib/printf.c`)
- Example programs → User syscall API: invoke services (evidence: `project-base/programs/explicit_exit.c`)
- Operator → Interactive shell: uses
