# youssef-fd/stm32-protocols-drivers architecture

> Architecture diagram of the GitHub repository youssef-fd/stm32-protocols-drivers, 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/youssef-fd/stm32-protocols-drivers
- Repository: https://github.com/youssef-fd/stm32-protocols-drivers

## Overview

This repository is a set of bare-metal STM32F429 communication-driver examples for UART, SPI, and I2C. In each example, application code configures pins and peripherals, initializes a driver handle, starts transfers, and routes interrupt handlers to the driver; the driver then performs register-level configuration and transfer handling. The README also describes polling and interrupt modes, protocol-specific configuration, and event-based I2C, though not all APIs or implementations are shown. Edges reflect the sampled calls and register access; broader README capabilities are not expanded into unverified call paths.

Main entry points: [`UART_DRIVER/Src/UART_HAL.c`](https://github.com/youssef-fd/stm32-protocols-drivers/blob/main/UART_DRIVER/Src/UART_HAL.c) (UART driver), [`UART_DRIVER/Src/main.c`](https://github.com/youssef-fd/stm32-protocols-drivers/blob/main/UART_DRIVER/Src/main.c) (UART example), [`I2C_DRIVER/Src/I2C_HAL.c`](https://github.com/youssef-fd/stm32-protocols-drivers/blob/main/I2C_DRIVER/Src/I2C_HAL.c) (I2C driver), [`SPI_DRIVER/Src/SPI_HAL.c`](https://github.com/youssef-fd/stm32-protocols-drivers/blob/main/SPI_DRIVER/Src/SPI_HAL.c) (SPI driver)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_apps["Example applications"]
  node_i2c_app["I2C example<br/>[main.c]"]
  node_spi_app["SPI example<br/>[main.c]"]
  node_uart_app["UART example<br/>[main.c]"]
end

subgraph group_drivers["Protocol drivers"]
  node_i2c_driver["I2C driver<br/>[I2C_HAL.c]"]
  node_i2c_api["I2C API definitions<br/>[I2C_HAL.h]"]
  node_spi_driver["SPI driver<br/>[SPI_HAL.c]"]
  node_spi_api["SPI API definitions<br/>[SPI_HAL.h]"]
  node_uart_driver["UART driver<br/>[UART_HAL.c]"]
  node_uart_api["UART API definitions<br/>[UART_HAL.h]"]
end

subgraph group_hardware["MCU hardware"]
  node_stm32["STM32F429"]
end

node_i2c_app -->|"starts transfers"| node_i2c_driver
node_i2c_app -->|"routes IRQs"| node_i2c_driver
node_i2c_driver -->|"uses declarations"| node_i2c_api
node_i2c_driver -->|"accesses registers"| node_stm32
node_i2c_app -->|"configures pins"| node_stm32
node_spi_app -->|"starts transfers"| node_spi_driver
node_spi_app -->|"routes IRQs"| node_spi_driver
node_spi_driver -->|"uses declarations"| node_spi_api
node_spi_driver -->|"accesses registers"| node_stm32
node_spi_app -->|"configures pins"| node_stm32
node_uart_app -->|"starts transfers"| node_uart_driver
node_uart_app -->|"routes IRQs"| node_uart_driver
node_uart_driver -->|"calls RX callback"| node_uart_app
node_uart_driver -->|"uses declarations"| node_uart_api
node_uart_driver -->|"accesses registers"| node_stm32
node_uart_app -->|"configures pins"| node_stm32

click node_i2c_app "https://github.com/youssef-fd/stm32-protocols-drivers/blob/main/I2C_DRIVER/Src/main.c"
click node_spi_app "https://github.com/youssef-fd/stm32-protocols-drivers/blob/main/SPI_DRIVER/Src/main.c"
click node_uart_app "https://github.com/youssef-fd/stm32-protocols-drivers/blob/main/UART_DRIVER/Src/main.c"
click node_i2c_driver "https://github.com/youssef-fd/stm32-protocols-drivers/blob/main/I2C_DRIVER/Src/I2C_HAL.c"
click node_i2c_api "https://github.com/youssef-fd/stm32-protocols-drivers/blob/main/I2C_DRIVER/Inc/I2C_HAL.h"
click node_spi_driver "https://github.com/youssef-fd/stm32-protocols-drivers/blob/main/SPI_DRIVER/Src/SPI_HAL.c"
click node_spi_api "https://github.com/youssef-fd/stm32-protocols-drivers/blob/main/SPI_DRIVER/Inc/SPI_HAL.h"
click node_uart_driver "https://github.com/youssef-fd/stm32-protocols-drivers/blob/main/UART_DRIVER/Src/UART_HAL.c"
click node_uart_api "https://github.com/youssef-fd/stm32-protocols-drivers/blob/main/UART_DRIVER/Inc/UART_HAL.h"

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_i2c_app,node_spi_app,node_uart_app toneBlue
class node_i2c_driver,node_i2c_api,node_spi_driver,node_spi_api,node_uart_driver,node_uart_api toneAmber
class node_stm32 toneMint
```

## Components

### Example applications

- [I2C example](https://github.com/youssef-fd/stm32-protocols-drivers/blob/main/I2C_DRIVER/Src/main.c): `I2C_DRIVER/Src/main.c`
- [SPI example](https://github.com/youssef-fd/stm32-protocols-drivers/blob/main/SPI_DRIVER/Src/main.c): `SPI_DRIVER/Src/main.c`
- [UART example](https://github.com/youssef-fd/stm32-protocols-drivers/blob/main/UART_DRIVER/Src/main.c): `UART_DRIVER/Src/main.c`

### Protocol drivers

- [I2C driver](https://github.com/youssef-fd/stm32-protocols-drivers/blob/main/I2C_DRIVER/Src/I2C_HAL.c): `I2C_DRIVER/Src/I2C_HAL.c`
- [I2C API definitions](https://github.com/youssef-fd/stm32-protocols-drivers/blob/main/I2C_DRIVER/Inc/I2C_HAL.h): `I2C_DRIVER/Inc/I2C_HAL.h`
- [SPI driver](https://github.com/youssef-fd/stm32-protocols-drivers/blob/main/SPI_DRIVER/Src/SPI_HAL.c): `SPI_DRIVER/Src/SPI_HAL.c`
- [SPI API definitions](https://github.com/youssef-fd/stm32-protocols-drivers/blob/main/SPI_DRIVER/Inc/SPI_HAL.h): `SPI_DRIVER/Inc/SPI_HAL.h`
- [UART driver](https://github.com/youssef-fd/stm32-protocols-drivers/blob/main/UART_DRIVER/Src/UART_HAL.c): `UART_DRIVER/Src/UART_HAL.c`
- [UART API definitions](https://github.com/youssef-fd/stm32-protocols-drivers/blob/main/UART_DRIVER/Inc/UART_HAL.h): `UART_DRIVER/Inc/UART_HAL.h`

### MCU hardware

- **STM32F429**

## Connections

- I2C example → I2C driver: starts transfers (evidence: `I2C_DRIVER/Src/main.c`)
- I2C example → I2C driver: routes IRQs (evidence: `I2C_DRIVER/Src/main.c`)
- I2C driver → I2C API definitions: uses declarations (evidence: `I2C_DRIVER/Src/I2C_HAL.c`)
- I2C driver → STM32F429: accesses registers (evidence: `I2C_DRIVER/Src/I2C_HAL.c`)
- I2C example → STM32F429: configures pins (evidence: `I2C_DRIVER/Src/main.c`)
- SPI example → SPI driver: starts transfers (evidence: `SPI_DRIVER/Src/main.c`)
- SPI example → SPI driver: routes IRQs (evidence: `SPI_DRIVER/Src/main.c`)
- SPI driver → SPI API definitions: uses declarations (evidence: `SPI_DRIVER/Src/SPI_HAL.c`)
- SPI driver → STM32F429: accesses registers (evidence: `SPI_DRIVER/Src/SPI_HAL.c`)
- SPI example → STM32F429: configures pins (evidence: `SPI_DRIVER/Src/main.c`)
- UART example → UART driver: starts transfers (evidence: `UART_DRIVER/Src/main.c`)
- UART example → UART driver: routes IRQs (evidence: `UART_DRIVER/Src/main.c`)
- UART driver → UART example: calls RX callback (evidence: `UART_DRIVER/Src/UART_HAL.c`)
- UART driver → UART API definitions: uses declarations (evidence: `UART_DRIVER/Src/UART_HAL.c`)
- UART driver → STM32F429: accesses registers (evidence: `UART_DRIVER/Src/UART_HAL.c`)
- UART example → STM32F429: configures pins (evidence: `UART_DRIVER/Src/main.c`)
