# krzysztof-szczepanik/stm32-embedded-gui-framework architecture

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

- Interactive diagram: https://gitdiagram.com/krzysztof-szczepanik/stm32-embedded-gui-framework
- Repository: https://github.com/krzysztof-szczepanik/stm32-embedded-gui-framework

## Overview

This is an STM32 embedded GUI framework, demonstrated as a washing-machine controller. The principal workflow is joystick input translated into UI events, routed by the screen manager to the active screen, then represented by screen/widget state and rendered to the LCD. The graph also preserves the example’s modes and settings screens, shared UI data, reusable containers/widgets, and the hardware/render layers described in the README. Some subsystem links are dashed because their implementation was not excerpted; they indicate unverified wiring, not inspected calls.

Main entry points: [`Core/Src/UI/Core/ui_screen_manager.c`](https://github.com/krzysztof-szczepanik/stm32-embedded-gui-framework/blob/main/Core/Src/UI/Core/ui_screen_manager.c) (Screen manager), [`Core/Src/UI/Screens/ui_main_screen.c`](https://github.com/krzysztof-szczepanik/stm32-embedded-gui-framework/blob/main/Core/Src/UI/Screens/ui_main_screen.c) (Main screen), [`Core/Src/UI/Core/ui_widget.c`](https://github.com/krzysztof-szczepanik/stm32-embedded-gui-framework/blob/main/Core/Src/UI/Core/ui_widget.c) (Widget core), [`Core/Src/main.c`](https://github.com/krzysztof-szczepanik/stm32-embedded-gui-framework/blob/main/Core/Src/main.c) (Application loop)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_application["Application and screens"]
  node_main["Application loop<br/>[main.c]"]
  node_main_screen["Main screen<br/>[ui_main_screen.c]"]
  node_modes_screen["Modes screen<br/>[ui_modes_screen.c]"]
  node_settings_screen["Settings screen"]
  node_screen_data["Shared screen data<br/>[ui_screens_data.c]"]
end

subgraph group_ui["UI framework"]
  node_manager["Screen manager"]
  node_screen["Screen base<br/>[ui_screen.c]"]
  node_widget["Widget core<br/>[ui_widget.c]"]
  node_containers["Layout containers"]
  node_widgets["UI widgets"]
end

subgraph group_render["Rendering"]
  node_lcd_api["LCD drawing API<br/>[lcd.c]"]
  node_lcd_buffer["LCD buffer<br/>[lcd_buffer.c]"]
  node_fonts["Bitmap fonts<br/>[fonts.h]"]
end

subgraph group_hardware["Hardware interface"]
  node_joystick["Joystick input<br/>[joystick.c]"]
  node_board_lcd["Board LCD driver"]
  node_timer["Timer hardware<br/>[tim.c]"]
end

node_user(("User"))

node_user -->|"operates"| node_joystick
node_main -->|"reads input"| node_joystick
node_main -.->|"routes events"| node_manager
node_manager -->|"dispatches to"| node_screen
node_manager -.->|"selects screen"| node_main_screen
node_manager -.->|"selects screen"| node_modes_screen
node_manager -.->|"selects screen"| node_settings_screen
node_manager -.->|"refreshes data"| node_screen_data
node_main_screen -->|"controls timer"| node_timer
node_main_screen -->|"builds layout"| node_containers
node_main_screen -->|"composes widgets"| node_widgets
node_screen -->|"uses base"| node_widget
node_containers -->|"extends"| node_widget
node_widgets -->|"extends"| node_widget
node_manager -.->|"redraws through"| node_lcd_buffer
node_lcd_api -.->|"draws via"| node_board_lcd
node_board_lcd -->|"uses glyphs"| node_fonts

click node_joystick "https://github.com/krzysztof-szczepanik/stm32-embedded-gui-framework/blob/main/Core/Src/HW/joystick.c"
click node_main "https://github.com/krzysztof-szczepanik/stm32-embedded-gui-framework/blob/main/Core/Src/main.c"
click node_manager "https://github.com/krzysztof-szczepanik/stm32-embedded-gui-framework/blob/main/Core/Src/UI/Core/ui_screen_manager.c"
click node_main_screen "https://github.com/krzysztof-szczepanik/stm32-embedded-gui-framework/blob/main/Core/Src/UI/Screens/ui_main_screen.c"
click node_modes_screen "https://github.com/krzysztof-szczepanik/stm32-embedded-gui-framework/blob/main/Core/Src/UI/Screens/ui_modes_screen.c"
click node_settings_screen "https://github.com/krzysztof-szczepanik/stm32-embedded-gui-framework/blob/main/Core/Src/UI/Screens/ui_settings_screen.c"
click node_screen_data "https://github.com/krzysztof-szczepanik/stm32-embedded-gui-framework/blob/main/Core/Src/UI/Core/ui_screens_data.c"
click node_screen "https://github.com/krzysztof-szczepanik/stm32-embedded-gui-framework/blob/main/Core/Src/UI/Core/ui_screen.c"
click node_widget "https://github.com/krzysztof-szczepanik/stm32-embedded-gui-framework/blob/main/Core/Src/UI/Core/ui_widget.c"
click node_containers "https://github.com/krzysztof-szczepanik/stm32-embedded-gui-framework/tree/main/Core/Src/UI/Containers"
click node_widgets "https://github.com/krzysztof-szczepanik/stm32-embedded-gui-framework/tree/main/Core/Src/UI/Widgets"
click node_lcd_api "https://github.com/krzysztof-szczepanik/stm32-embedded-gui-framework/blob/main/Core/Src/Render/lcd.c"
click node_lcd_buffer "https://github.com/krzysztof-szczepanik/stm32-embedded-gui-framework/blob/main/Core/Src/Render/lcd_buffer.c"
click node_board_lcd "https://github.com/krzysztof-szczepanik/stm32-embedded-gui-framework/blob/main/Drivers/BSP/STM32F429I-Discovery/stm32f429i_discovery_lcd.c"
click node_fonts "https://github.com/krzysztof-szczepanik/stm32-embedded-gui-framework/blob/main/Utilities/Fonts/fonts.h"
click node_timer "https://github.com/krzysztof-szczepanik/stm32-embedded-gui-framework/blob/main/Core/Src/HW/tim.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_main,node_main_screen,node_modes_screen,node_settings_screen,node_screen_data,node_user toneBlue
class node_manager,node_screen,node_widget,node_containers,node_widgets toneAmber
class node_lcd_api,node_lcd_buffer,node_fonts toneMint
class node_joystick,node_board_lcd,node_timer toneRose
```

## Components

### Application and screens

- [Application loop](https://github.com/krzysztof-szczepanik/stm32-embedded-gui-framework/blob/main/Core/Src/main.c): `Core/Src/main.c`
- [Main screen](https://github.com/krzysztof-szczepanik/stm32-embedded-gui-framework/blob/main/Core/Src/UI/Screens/ui_main_screen.c): `Core/Src/UI/Screens/ui_main_screen.c`
- [Modes screen](https://github.com/krzysztof-szczepanik/stm32-embedded-gui-framework/blob/main/Core/Src/UI/Screens/ui_modes_screen.c): `Core/Src/UI/Screens/ui_modes_screen.c`
- [Settings screen](https://github.com/krzysztof-szczepanik/stm32-embedded-gui-framework/blob/main/Core/Src/UI/Screens/ui_settings_screen.c): `Core/Src/UI/Screens/ui_settings_screen.c`
- [Shared screen data](https://github.com/krzysztof-szczepanik/stm32-embedded-gui-framework/blob/main/Core/Src/UI/Core/ui_screens_data.c): `Core/Src/UI/Core/ui_screens_data.c`

### UI framework

- [Screen manager](https://github.com/krzysztof-szczepanik/stm32-embedded-gui-framework/blob/main/Core/Src/UI/Core/ui_screen_manager.c): `Core/Src/UI/Core/ui_screen_manager.c`
- [Screen base](https://github.com/krzysztof-szczepanik/stm32-embedded-gui-framework/blob/main/Core/Src/UI/Core/ui_screen.c): `Core/Src/UI/Core/ui_screen.c`
- [Widget core](https://github.com/krzysztof-szczepanik/stm32-embedded-gui-framework/blob/main/Core/Src/UI/Core/ui_widget.c): `Core/Src/UI/Core/ui_widget.c`
- [Layout containers](https://github.com/krzysztof-szczepanik/stm32-embedded-gui-framework/tree/main/Core/Src/UI/Containers): `Core/Src/UI/Containers`
- [UI widgets](https://github.com/krzysztof-szczepanik/stm32-embedded-gui-framework/tree/main/Core/Src/UI/Widgets): `Core/Src/UI/Widgets`

### Rendering

- [LCD drawing API](https://github.com/krzysztof-szczepanik/stm32-embedded-gui-framework/blob/main/Core/Src/Render/lcd.c): `Core/Src/Render/lcd.c`
- [LCD buffer](https://github.com/krzysztof-szczepanik/stm32-embedded-gui-framework/blob/main/Core/Src/Render/lcd_buffer.c): `Core/Src/Render/lcd_buffer.c`
- [Bitmap fonts](https://github.com/krzysztof-szczepanik/stm32-embedded-gui-framework/blob/main/Utilities/Fonts/fonts.h): `Utilities/Fonts/fonts.h`

### Hardware interface

- [Joystick input](https://github.com/krzysztof-szczepanik/stm32-embedded-gui-framework/blob/main/Core/Src/HW/joystick.c): `Core/Src/HW/joystick.c`
- [Board LCD driver](https://github.com/krzysztof-szczepanik/stm32-embedded-gui-framework/blob/main/Drivers/BSP/STM32F429I-Discovery/stm32f429i_discovery_lcd.c): `Drivers/BSP/STM32F429I-Discovery/stm32f429i_discovery_lcd.c`
- [Timer hardware](https://github.com/krzysztof-szczepanik/stm32-embedded-gui-framework/blob/main/Core/Src/HW/tim.c): `Core/Src/HW/tim.c`

### Other components

- **User**

## Connections

- User → Joystick input: operates (evidence: `README.md`)
- Application loop → Joystick input: reads input (evidence: `Core/Src/main.c`)
- Application loop → Screen manager: routes events
- Screen manager → Screen base: dispatches to (evidence: `Core/Src/UI/Core/ui_screen_manager.c`)
- Screen manager → Main screen: selects screen
- Screen manager → Modes screen: selects screen
- Screen manager → Settings screen: selects screen
- Screen manager → Shared screen data: refreshes data
- Main screen → Timer hardware: controls timer (evidence: `Core/Src/UI/Screens/ui_main_screen.c`)
- Main screen → Layout containers: builds layout
- Main screen → UI widgets: composes widgets
- Screen base → Widget core: uses base
- Layout containers → Widget core: extends
- UI widgets → Widget core: extends
- Screen manager → LCD buffer: redraws through
- LCD drawing API → Board LCD driver: draws via
- Board LCD driver → Bitmap fonts: uses glyphs (evidence: `Drivers/BSP/STM32F429I-Discovery/stm32f429i_discovery_lcd.c`)
