# aroesz98/tftlib_8bit architecture

> Architecture diagram of the GitHub repository aroesz98/tftlib_8bit, 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/aroesz98/tftlib_8bit
- Repository: https://github.com/aroesz98/tftlib_8bit

## Overview

TFTLIB_8BIT is an STM32 C++ library for driving LCDs over an 8-bit parallel bus. An application constructs the display object with GPIO pins and a controller choice, initializes it, then issues drawing, image, and text operations that render on the attached panel. The repository also includes controller-specific initialization code, bundled font data, and Arduino-style Print/String utilities. The README documents the user-facing workflow and capabilities; some internal dispatch details are not visible in the sampled excerpts, so those links are left unverified.

Main entry points: [`TFTLIB_8BIT/TFTLIB_8BIT.cpp`](https://github.com/aroesz98/tftlib_8bit/blob/main/TFTLIB_8BIT/TFTLIB_8BIT.cpp) (Drawing and Rasterization), [`TFTLIB_8BIT/TFTLIB_8BIT.hpp`](https://github.com/aroesz98/tftlib_8bit/blob/main/TFTLIB_8BIT/TFTLIB_8BIT.hpp) (Display API), [`TFTLIB_8BIT/Print.cpp`](https://github.com/aroesz98/tftlib_8bit/blob/main/TFTLIB_8BIT/Print.cpp) (Print Formatting), [`TFTLIB_8BIT/String.cpp`](https://github.com/aroesz98/tftlib_8bit/blob/main/TFTLIB_8BIT/String.cpp) (String Utilities)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_display["Display and Drawing"]
  node_display_api["Display API<br/>[TFTLIB_8BIT.hpp]"]
  node_rendering["Drawing and Rasterization<br/>[TFTLIB_8BIT.cpp]"]
end

subgraph group_hardware["Panel Hardware"]
  node_gpio["GPIO Bus Access<br/>[hw_drv.h]"]
  node_ili9327["ILI9327 Driver<br/>[ili9327_drv.h]"]
  node_ili9341["ILI9341 Driver"]
  node_nt35510["NT35510 Driver"]
end

subgraph group_text["Text and Fonts"]
  node_font_data["Bundled Font Data"]
  node_font_format["Font Definitions<br/>[gfxfont.h]"]
end

subgraph group_utility["Print Utilities"]
  node_print["Print Formatting<br/>[Print.cpp]"]
  node_printable["Printable Interface<br/>[Printable.hpp]"]
  node_string["String Utilities<br/>[String.cpp]"]
  node_dtostrf["Float Formatting<br/>[dtostrf.c]"]
end

node_application(("STM32 Application"))
node_lcd_panel["Parallel LCD Panel"]

node_application -->|"constructs and uses"| node_display_api
node_display_api -.->|"exposes drawing"| node_rendering
node_rendering -.->|"uses bus helpers"| node_gpio
node_rendering -.->|"dispatches initialization"| node_ili9327
node_rendering -.->|"dispatches initialization"| node_ili9341
node_rendering -.->|"dispatches initialization"| node_nt35510
node_rendering -.->|"writes pixels"| node_lcd_panel
node_application -->|"connects GPIO bus"| node_lcd_panel
node_display_api -->|"supports font definitions"| node_font_format
node_font_data -.->|"provides font data"| node_font_format
node_print -->|"prints interface values"| node_printable
node_print -->|"prints strings"| node_string
node_string -.->|"formats floats"| node_dtostrf

click node_display_api "https://github.com/aroesz98/tftlib_8bit/blob/main/TFTLIB_8BIT/TFTLIB_8BIT.hpp"
click node_rendering "https://github.com/aroesz98/tftlib_8bit/blob/main/TFTLIB_8BIT/TFTLIB_8BIT.cpp"
click node_gpio "https://github.com/aroesz98/tftlib_8bit/blob/main/TFTLIB_8BIT/hw_drv.h"
click node_ili9327 "https://github.com/aroesz98/tftlib_8bit/blob/main/TFTLIB_8BIT/lcd_drivers/ili9327_drv.h"
click node_ili9341 "https://github.com/aroesz98/tftlib_8bit/blob/main/TFTLIB_8BIT/lcd_drivers/ili9341_parallel_drv.h"
click node_nt35510 "https://github.com/aroesz98/tftlib_8bit/blob/main/TFTLIB_8BIT/lcd_drivers/nt35510_parallel_drv.h"
click node_font_data "https://github.com/aroesz98/tftlib_8bit/tree/main/TFTLIB_8BIT/GFXFF/Custom"
click node_font_format "https://github.com/aroesz98/tftlib_8bit/blob/main/TFTLIB_8BIT/GFXFF/gfxfont.h"
click node_print "https://github.com/aroesz98/tftlib_8bit/blob/main/TFTLIB_8BIT/Print.cpp"
click node_printable "https://github.com/aroesz98/tftlib_8bit/blob/main/TFTLIB_8BIT/Printable.hpp"
click node_string "https://github.com/aroesz98/tftlib_8bit/blob/main/TFTLIB_8BIT/String.cpp"
click node_dtostrf "https://github.com/aroesz98/tftlib_8bit/blob/main/TFTLIB_8BIT/dtostrf.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_display_api,node_rendering toneBlue
class node_gpio,node_ili9327,node_ili9341,node_nt35510 toneAmber
class node_font_data,node_font_format toneMint
class node_print,node_printable,node_string,node_dtostrf toneRose
class node_application,node_lcd_panel toneIndigo
```

## Components

### Display and Drawing

- [Display API](https://github.com/aroesz98/tftlib_8bit/blob/main/TFTLIB_8BIT/TFTLIB_8BIT.hpp): `TFTLIB_8BIT/TFTLIB_8BIT.hpp`
- [Drawing and Rasterization](https://github.com/aroesz98/tftlib_8bit/blob/main/TFTLIB_8BIT/TFTLIB_8BIT.cpp): `TFTLIB_8BIT/TFTLIB_8BIT.cpp`

### Panel Hardware

- [GPIO Bus Access](https://github.com/aroesz98/tftlib_8bit/blob/main/TFTLIB_8BIT/hw_drv.h): `TFTLIB_8BIT/hw_drv.h`
- [ILI9327 Driver](https://github.com/aroesz98/tftlib_8bit/blob/main/TFTLIB_8BIT/lcd_drivers/ili9327_drv.h): `TFTLIB_8BIT/lcd_drivers/ili9327_drv.h`
- [ILI9341 Driver](https://github.com/aroesz98/tftlib_8bit/blob/main/TFTLIB_8BIT/lcd_drivers/ili9341_parallel_drv.h): `TFTLIB_8BIT/lcd_drivers/ili9341_parallel_drv.h`
- [NT35510 Driver](https://github.com/aroesz98/tftlib_8bit/blob/main/TFTLIB_8BIT/lcd_drivers/nt35510_parallel_drv.h): `TFTLIB_8BIT/lcd_drivers/nt35510_parallel_drv.h`

### Text and Fonts

- [Bundled Font Data](https://github.com/aroesz98/tftlib_8bit/tree/main/TFTLIB_8BIT/GFXFF/Custom): `TFTLIB_8BIT/GFXFF/Custom`
- [Font Definitions](https://github.com/aroesz98/tftlib_8bit/blob/main/TFTLIB_8BIT/GFXFF/gfxfont.h): `TFTLIB_8BIT/GFXFF/gfxfont.h`

### Print Utilities

- [Print Formatting](https://github.com/aroesz98/tftlib_8bit/blob/main/TFTLIB_8BIT/Print.cpp): `TFTLIB_8BIT/Print.cpp`
- [Printable Interface](https://github.com/aroesz98/tftlib_8bit/blob/main/TFTLIB_8BIT/Printable.hpp): `TFTLIB_8BIT/Printable.hpp`
- [String Utilities](https://github.com/aroesz98/tftlib_8bit/blob/main/TFTLIB_8BIT/String.cpp): `TFTLIB_8BIT/String.cpp`
- [Float Formatting](https://github.com/aroesz98/tftlib_8bit/blob/main/TFTLIB_8BIT/dtostrf.c): `TFTLIB_8BIT/dtostrf.c`

### Other components

- **STM32 Application**
- **Parallel LCD Panel**

## Connections

- STM32 Application → Display API: constructs and uses (evidence: `README.md`)
- Display API → Drawing and Rasterization: exposes drawing
- Drawing and Rasterization → GPIO Bus Access: uses bus helpers (evidence: `TFTLIB_8BIT/TFTLIB_8BIT.cpp`)
- Drawing and Rasterization → ILI9327 Driver: dispatches initialization (evidence: `TFTLIB_8BIT/TFTLIB_8BIT.cpp`)
- Drawing and Rasterization → ILI9341 Driver: dispatches initialization (evidence: `TFTLIB_8BIT/TFTLIB_8BIT.cpp`)
- Drawing and Rasterization → NT35510 Driver: dispatches initialization (evidence: `TFTLIB_8BIT/TFTLIB_8BIT.cpp`)
- Drawing and Rasterization → Parallel LCD Panel: writes pixels
- STM32 Application → Parallel LCD Panel: connects GPIO bus (evidence: `README.md`)
- Display API → Font Definitions: supports font definitions (evidence: `TFTLIB_8BIT/TFTLIB_8BIT.hpp`)
- Bundled Font Data → Font Definitions: provides font data
- Print Formatting → Printable Interface: prints interface values (evidence: `TFTLIB_8BIT/Print.cpp`)
- Print Formatting → String Utilities: prints strings (evidence: `TFTLIB_8BIT/Print.cpp`)
- String Utilities → Float Formatting: formats floats
