# parezj/embo architecture

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

- Interactive diagram: https://gitdiagram.com/parezj/embo
- Repository: https://github.com/parezj/embo

## Overview

EMBO is a PC-controlled embedded measurement system: a user selects a device and connects the desktop application to STM32 firmware, which acquires or generates signals and returns measurement data. The README identifies oscilloscope, logic analyzer, voltmeter, counter, PWM, and signal generator capabilities; it also documents scope analysis, export, and measurement controls. The sampled firmware shows board startup entering the shared FreeRTOS application, whose tasks perform trigger handling and communication. Some UI and device modules are represented by their exact enclosing directories because their implementation excerpts were not supplied; links to unsampled subsystems are omitted or marked unverified.

Main entry points: [`src/software/EMBO/src/windows`](https://github.com/parezj/embo/tree/main/src/software/EMBO/src/windows) (Device selection), [`src/firmware/src/app/app.c`](https://github.com/parezj/embo/blob/main/src/firmware/src/app/app.c) (Firmware tasks), [`src/software/EMBO/src/windows/window_scope.cpp`](https://github.com/parezj/embo/blob/main/src/software/EMBO/src/windows/window_scope.cpp) (Oscilloscope), [`src/firmware/board`](https://github.com/parezj/embo/tree/main/src/firmware/board) (Board startup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["PC application"]
  node_pc_app["Desktop app<br/>[main.cpp]"]
  node_main_window["Device selection"]
end

subgraph group_devices["Measurement devices"]
  node_scope["Oscilloscope<br/>[window_scope.cpp]"]
  node_logic["Logic analyzer"]
  node_voltmeter["Voltmeter"]
  node_counter["Counter"]
  node_pwm["PWM generator<br/>[window_pwm.cpp]"]
  node_signal_gen["Signal generator"]
  node_scope_analysis["Scope analysis<br/>[window_scope.cpp]"]
  node_export["Data export"]
end

subgraph group_firmware["Firmware runtime"]
  node_app_tasks["Firmware tasks<br/>[app.c]"]
  node_daq_trigger["DAQ trigger"]
  node_firmware_comm["Firmware communication"]
  node_freertos["FreeRTOS kernel<br/>[tasks.c]"]
end

subgraph group_platform["Board support"]
  node_board_startup["Board startup"]
  node_usb_device["USB device"]
end

node_user(("Operator"))
node_stm32{{"STM32 device"}}

node_user -->|"starts"| node_pc_app
node_pc_app -->|"opens"| node_main_window
node_main_window -.->|"selects"| node_scope
node_main_window -.->|"selects"| node_logic
node_main_window -.->|"selects"| node_voltmeter
node_main_window -.->|"selects"| node_counter
node_main_window -.->|"selects"| node_pwm
node_main_window -.->|"selects"| node_signal_gen
node_scope -.->|"analyzes"| node_scope_analysis
node_scope -.->|"exports"| node_export
node_board_startup -->|"starts"| node_app_tasks
node_board_startup -.->|"initializes"| node_usb_device
node_app_tasks -->|"starts scheduler"| node_freertos
node_app_tasks -->|"checks trigger"| node_daq_trigger
node_app_tasks -->|"processes messages"| node_firmware_comm
node_stm32 -.->|"runs firmware"| node_board_startup
node_main_window -.->|"connects"| node_stm32
node_stm32 -.->|"returns measurements"| node_main_window

click node_pc_app "https://github.com/parezj/embo/blob/main/src/software/EMBO/src/main.cpp"
click node_main_window "https://github.com/parezj/embo/tree/main/src/software/EMBO/src/windows"
click node_scope "https://github.com/parezj/embo/blob/main/src/software/EMBO/src/windows/window_scope.cpp"
click node_logic "https://github.com/parezj/embo/tree/main/src/software/EMBO/src/windows"
click node_voltmeter "https://github.com/parezj/embo/tree/main/src/software/EMBO/src/windows"
click node_counter "https://github.com/parezj/embo/tree/main/src/software/EMBO/src/windows"
click node_pwm "https://github.com/parezj/embo/blob/main/src/software/EMBO/src/windows/window_pwm.cpp"
click node_signal_gen "https://github.com/parezj/embo/tree/main/src/software/EMBO/src/windows"
click node_scope_analysis "https://github.com/parezj/embo/blob/main/src/software/EMBO/src/windows/window_scope.cpp"
click node_export "https://github.com/parezj/embo/tree/main/src/software/EMBO/src/windows"
click node_board_startup "https://github.com/parezj/embo/tree/main/src/firmware/board"
click node_usb_device "https://github.com/parezj/embo/tree/main/src/firmware/board/STM32F103C8/USB_DEVICE/App"
click node_app_tasks "https://github.com/parezj/embo/blob/main/src/firmware/src/app/app.c"
click node_daq_trigger "https://github.com/parezj/embo/tree/main/src/firmware/src/app"
click node_firmware_comm "https://github.com/parezj/embo/tree/main/src/firmware/src/app"
click node_freertos "https://github.com/parezj/embo/blob/main/src/firmware/src/os/tasks.c"

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_pc_app,node_main_window toneBlue
class node_scope,node_logic,node_voltmeter,node_counter,node_pwm,node_signal_gen,node_scope_analysis,node_export toneAmber
class node_app_tasks,node_daq_trigger,node_firmware_comm,node_freertos toneMint
class node_board_startup,node_usb_device toneRose
class node_user,node_stm32 toneIndigo
```

## Components

### PC application

- [Desktop app](https://github.com/parezj/embo/blob/main/src/software/EMBO/src/main.cpp): `src/software/EMBO/src/main.cpp`
- [Device selection](https://github.com/parezj/embo/tree/main/src/software/EMBO/src/windows): `src/software/EMBO/src/windows`

### Measurement devices

- [Oscilloscope](https://github.com/parezj/embo/blob/main/src/software/EMBO/src/windows/window_scope.cpp): `src/software/EMBO/src/windows/window_scope.cpp`
- [Logic analyzer](https://github.com/parezj/embo/tree/main/src/software/EMBO/src/windows): `src/software/EMBO/src/windows`
- [Voltmeter](https://github.com/parezj/embo/tree/main/src/software/EMBO/src/windows): `src/software/EMBO/src/windows`
- [Counter](https://github.com/parezj/embo/tree/main/src/software/EMBO/src/windows): `src/software/EMBO/src/windows`
- [PWM generator](https://github.com/parezj/embo/blob/main/src/software/EMBO/src/windows/window_pwm.cpp): `src/software/EMBO/src/windows/window_pwm.cpp`
- [Signal generator](https://github.com/parezj/embo/tree/main/src/software/EMBO/src/windows): `src/software/EMBO/src/windows`
- [Scope analysis](https://github.com/parezj/embo/blob/main/src/software/EMBO/src/windows/window_scope.cpp): `src/software/EMBO/src/windows/window_scope.cpp`
- [Data export](https://github.com/parezj/embo/tree/main/src/software/EMBO/src/windows): `src/software/EMBO/src/windows`

### Firmware runtime

- [Firmware tasks](https://github.com/parezj/embo/blob/main/src/firmware/src/app/app.c): `src/firmware/src/app/app.c`
- [DAQ trigger](https://github.com/parezj/embo/tree/main/src/firmware/src/app): `src/firmware/src/app`
- [Firmware communication](https://github.com/parezj/embo/tree/main/src/firmware/src/app): `src/firmware/src/app`
- [FreeRTOS kernel](https://github.com/parezj/embo/blob/main/src/firmware/src/os/tasks.c): `src/firmware/src/os/tasks.c`

### Board support

- [Board startup](https://github.com/parezj/embo/tree/main/src/firmware/board): `src/firmware/board`
- [USB device](https://github.com/parezj/embo/tree/main/src/firmware/board/STM32F103C8/USB_DEVICE/App): `src/firmware/board/STM32F103C8/USB_DEVICE/App`

### Other components

- **Operator**
- **STM32 device**

## Connections

- Operator → Desktop app: starts (evidence: `src/software/EMBO/src/main.cpp`)
- Desktop app → Device selection: opens (evidence: `src/software/EMBO/src/main.cpp`)
- Device selection → Oscilloscope: selects (evidence: `src/software/EMBO/src/windows/window_scope.cpp`)
- Device selection → Logic analyzer: selects
- Device selection → Voltmeter: selects
- Device selection → Counter: selects
- Device selection → PWM generator: selects
- Device selection → Signal generator: selects
- Oscilloscope → Scope analysis: analyzes (evidence: `src/software/EMBO/src/windows/window_scope.cpp`)
- Oscilloscope → Data export: exports (evidence: `src/software/EMBO/src/windows/window_scope.cpp`)
- Board startup → Firmware tasks: starts (evidence: `src/firmware/board/STM32F103C8/Core/Src/main.c`)
- Board startup → USB device: initializes (evidence: `src/firmware/board/STM32F103C8/Core/Src/main.c`)
- Firmware tasks → FreeRTOS kernel: starts scheduler (evidence: `src/firmware/src/app/app.c`)
- Firmware tasks → DAQ trigger: checks trigger (evidence: `src/firmware/src/app/app.c`)
- Firmware tasks → Firmware communication: processes messages (evidence: `src/firmware/src/app/app.c`)
- STM32 device → Board startup: runs firmware
- Device selection → STM32 device: connects
- STM32 device → Device selection: returns measurements